REST Resource: partners.targetingTypes.assignedTargetingOptions

Zasób: AssignedTargetingOption

Pojedyncza przypisana opcja kierowania, która określa stan opcji kierowania w przypadku jednostki z ustawieniami kierowania.

Zapis JSON 
{
  "name": string,
  "assignedTargetingOptionId": string,
  "assignedTargetingOptionIdAlias": string,
  "targetingType": enum (TargetingType),
  "inheritance": enum (Inheritance),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "channelDetails": {
    object (ChannelAssignedTargetingOptionDetails)
  },
  "appCategoryDetails": {
    object (AppCategoryAssignedTargetingOptionDetails)
  },
  "appDetails": {
    object (AppAssignedTargetingOptionDetails)
  },
  "urlDetails": {
    object (UrlAssignedTargetingOptionDetails)
  },
  "dayAndTimeDetails": {
    object (DayAndTimeAssignedTargetingOptionDetails)
  },
  "ageRangeDetails": {
    object (AgeRangeAssignedTargetingOptionDetails)
  },
  "regionalLocationListDetails": {
    object (RegionalLocationListAssignedTargetingOptionDetails)
  },
  "proximityLocationListDetails": {
    object (ProximityLocationListAssignedTargetingOptionDetails)
  },
  "genderDetails": {
    object (GenderAssignedTargetingOptionDetails)
  },
  "videoPlayerSizeDetails": {
    object (VideoPlayerSizeAssignedTargetingOptionDetails)
  },
  "userRewardedContentDetails": {
    object (UserRewardedContentAssignedTargetingOptionDetails)
  },
  "parentalStatusDetails": {
    object (ParentalStatusAssignedTargetingOptionDetails)
  },
  "contentInstreamPositionDetails": {
    object (ContentInstreamPositionAssignedTargetingOptionDetails)
  },
  "contentOutstreamPositionDetails": {
    object (ContentOutstreamPositionAssignedTargetingOptionDetails)
  },
  "deviceTypeDetails": {
    object (DeviceTypeAssignedTargetingOptionDetails)
  },
  "audienceGroupDetails": {
    object (AudienceGroupAssignedTargetingOptionDetails)
  },
  "browserDetails": {
    object (BrowserAssignedTargetingOptionDetails)
  },
  "householdIncomeDetails": {
    object (HouseholdIncomeAssignedTargetingOptionDetails)
  },
  "onScreenPositionDetails": {
    object (OnScreenPositionAssignedTargetingOptionDetails)
  },
  "carrierAndIspDetails": {
    object (CarrierAndIspAssignedTargetingOptionDetails)
  },
  "keywordDetails": {
    object (KeywordAssignedTargetingOptionDetails)
  },
  "negativeKeywordListDetails": {
    object (NegativeKeywordListAssignedTargetingOptionDetails)
  },
  "operatingSystemDetails": {
    object (OperatingSystemAssignedTargetingOptionDetails)
  },
  "deviceMakeModelDetails": {
    object (DeviceMakeModelAssignedTargetingOptionDetails)
  },
  "environmentDetails": {
    object (EnvironmentAssignedTargetingOptionDetails)
  },
  "inventorySourceDetails": {
    object (InventorySourceAssignedTargetingOptionDetails)
  },
  "categoryDetails": {
    object (CategoryAssignedTargetingOptionDetails)
  },
  "viewabilityDetails": {
    object (ViewabilityAssignedTargetingOptionDetails)
  },
  "authorizedSellerStatusDetails": {
    object (AuthorizedSellerStatusAssignedTargetingOptionDetails)
  },
  "languageDetails": {
    object (LanguageAssignedTargetingOptionDetails)
  },
  "geoRegionDetails": {
    object (GeoRegionAssignedTargetingOptionDetails)
  },
  "inventorySourceGroupDetails": {
    object (InventorySourceGroupAssignedTargetingOptionDetails)
  },
  "digitalContentLabelExclusionDetails": {
    object (DigitalContentLabelAssignedTargetingOptionDetails)
  },
  "sensitiveCategoryExclusionDetails": {
    object (SensitiveCategoryAssignedTargetingOptionDetails)
  },
  "contentThemeExclusionDetails": {
    object (ContentThemeAssignedTargetingOptionDetails)
  },
  "exchangeDetails": {
    object (ExchangeAssignedTargetingOptionDetails)
  },
  "subExchangeDetails": {
    object (SubExchangeAssignedTargetingOptionDetails)
  },
  "thirdPartyVerifierDetails": {
    object (ThirdPartyVerifierAssignedTargetingOptionDetails)
  },
  "poiDetails": {
    object (PoiAssignedTargetingOptionDetails)
  },
  "businessChainDetails": {
    object (BusinessChainAssignedTargetingOptionDetails)
  },
  "contentDurationDetails": {
    object (ContentDurationAssignedTargetingOptionDetails)
  },
  "contentStreamTypeDetails": {
    object (ContentStreamTypeAssignedTargetingOptionDetails)
  },
  "nativeContentPositionDetails": {
    object (NativeContentPositionAssignedTargetingOptionDetails)
  },
  "omidDetails": {
    object (OmidAssignedTargetingOptionDetails)
  },
  "audioContentTypeDetails": {
    object (AudioContentTypeAssignedTargetingOptionDetails)
  },
  "contentGenreDetails": {
    object (ContentGenreAssignedTargetingOptionDetails)
  },
  "youtubeVideoDetails": {
    object (YoutubeVideoAssignedTargetingOptionDetails)
  },
  "youtubeChannelDetails": {
    object (YoutubeChannelAssignedTargetingOptionDetails)
  },
  "sessionPositionDetails": {
    object (SessionPositionAssignedTargetingOptionDetails)
  },
  "youtubeChannelPackDetails": {
    object (YoutubeChannelPackAssignedTargetingOptionDetails)
  }
  // End of mutually exclusive fields.
}
Pola
name

string

Tylko dane wyjściowe. Nazwa zasobu tej przypisanej opcji kierowania.
assignedTargetingOptionId

string

Tylko dane wyjściowe. Unikalny identyfikator przypisanej opcji kierowania. Identyfikator jest unikalny tylko w ramach danego zasobu i typu kierowania. Może być ponownie użyty w innych kontekstach.
assignedTargetingOptionIdAlias

string

Tylko dane wyjściowe. Alias dla assignedTargetingOptionId. Tej wartości można używać zamiast assignedTargetingOptionId podczas pobierania lub usuwania istniejącego kierowania.

To pole będzie obsługiwane tylko w przypadku wszystkich przypisanych opcji kierowania tych typów kierowania:

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
  • TARGETING_TYPE_ENVIRONMENT
  • TARGETING_TYPE_EXCHANGE
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_NATIVE_CONTENT_POSITION
  • TARGETING_TYPE_OMID
  • TARGETING_TYPE_PARENTAL_STATUS
  • TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
  • TARGETING_TYPE_VIDEO_PLAYER_SIZE
  • TARGETING_TYPE_VIEWABILITY

To pole jest też obsługiwane w przypadku opcji kierowania przypisanych do elementów zamówienia tych typów kierowania:

  • TARGETING_TYPE_CONTENT_INSTREAM_POSITION
  • TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
targetingType

enum (TargetingType)

Tylko dane wyjściowe. Określa typ przypisanej opcji kierowania.
inheritance

enum (Inheritance)

Tylko dane wyjściowe. Stan dziedziczenia przypisanej opcji kierowania.
Szczegółowe informacje o przypisywanej opcji kierowania. Można wypełnić tylko 1 pole w sekcji szczegółów, które musi odpowiadać polu targeting_type. Poniżej znajduje się lista wzajemnie wykluczających się pól. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
channelDetails

object (ChannelAssignedTargetingOptionDetails)

Szczegóły kanału. To pole zostanie wypełnione, gdy wartość targetingType będzie równa TARGETING_TYPE_CHANNEL.
appCategoryDetails

object (AppCategoryAssignedTargetingOptionDetails)

Szczegóły kategorii aplikacji. To pole zostanie wypełnione, gdy wartość targetingType będzie równa TARGETING_TYPE_APP_CATEGORY.
appDetails

object (AppAssignedTargetingOptionDetails)

Szczegóły aplikacji. To pole zostanie wypełnione, gdy wartość targetingType będzie równa TARGETING_TYPE_APP.
urlDetails

object (UrlAssignedTargetingOptionDetails)

Szczegóły adresu URL. To pole zostanie wypełnione, gdy wartość targetingType będzie równa TARGETING_TYPE_URL.
dayAndTimeDetails

object (DayAndTimeAssignedTargetingOptionDetails)

Szczegóły dnia i godziny. To pole zostanie wypełnione, gdy wartość targetingType będzie równa TARGETING_TYPE_DAY_AND_TIME.
ageRangeDetails

object (AgeRangeAssignedTargetingOptionDetails)

Szczegóły przedziału wiekowego. To pole zostanie wypełnione, gdy wartość targetingType będzie równa TARGETING_TYPE_AGE_RANGE.
regionalLocationListDetails

object (RegionalLocationListAssignedTargetingOptionDetails)

Szczegóły listy lokalizacji regionalnych. To pole zostanie wypełnione, gdy wartość targetingType będzie równa TARGETING_TYPE_REGIONAL_LOCATION_LIST.
proximityLocationListDetails

object (ProximityLocationListAssignedTargetingOptionDetails)

Szczegóły listy lokalizacji w pobliżu. To pole zostanie wypełnione, gdy wartość targetingType będzie równa TARGETING_TYPE_PROXIMITY_LOCATION_LIST.
genderDetails

object (GenderAssignedTargetingOptionDetails)

Szczegóły dotyczące płci. To pole zostanie wypełnione, gdy wartość targetingType będzie równa TARGETING_TYPE_GENDER.
videoPlayerSizeDetails

object (VideoPlayerSizeAssignedTargetingOptionDetails)

Szczegóły rozmiaru odtwarzacza wideo. To pole zostanie wypełnione, gdy wartość targetingType będzie równa TARGETING_TYPE_VIDEO_PLAYER_SIZE.
userRewardedContentDetails

object (UserRewardedContentAssignedTargetingOptionDetails)

Szczegóły dotyczące treści z nagrodą dla użytkowników. To pole zostanie wypełnione, gdy wartość targetingType będzie równa TARGETING_TYPE_USER_REWARDED_CONTENT.
parentalStatusDetails

object (ParentalStatusAssignedTargetingOptionDetails)

Szczegóły statusu rodzicielskiego. To pole zostanie wypełnione, gdy wartość targetingType będzie równa TARGETING_TYPE_PARENTAL_STATUS.
contentInstreamPositionDetails

object (ContentInstreamPositionAssignedTargetingOptionDetails)

Szczegóły pozycji treści w strumieniu. To pole zostanie wypełnione, gdy wartość targetingType będzie równa TARGETING_TYPE_CONTENT_INSTREAM_POSITION.
contentOutstreamPositionDetails

object (ContentOutstreamPositionAssignedTargetingOptionDetails)

Szczegóły pozycji reklamy typu out-stream w treści. To pole zostanie wypełnione, gdy wartość targetingType będzie równa TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION.
deviceTypeDetails

object (DeviceTypeAssignedTargetingOptionDetails)

Szczegóły typu urządzenia. To pole zostanie wypełnione, gdy wartość targetingType będzie równa TARGETING_TYPE_DEVICE_TYPE.
audienceGroupDetails

object (AudienceGroupAssignedTargetingOptionDetails)

Szczegóły kierowania na odbiorców. To pole zostanie wypełnione, gdy wartość targetingType będzie równa TARGETING_TYPE_AUDIENCE_GROUP. W przypadku każdego zasobu możesz kierować reklamy tylko na 1 opcję grupy odbiorców.
browserDetails

object (BrowserAssignedTargetingOptionDetails)

Szczegóły przeglądarki. To pole zostanie wypełnione, gdy wartość targetingType będzie równa TARGETING_TYPE_BROWSER.
householdIncomeDetails

object (HouseholdIncomeAssignedTargetingOptionDetails)

Szczegóły dotyczące dochodu gospodarstwa domowego. To pole zostanie wypełnione, gdy wartość targetingType będzie równa TARGETING_TYPE_HOUSEHOLD_INCOME.
onScreenPositionDetails

object (OnScreenPositionAssignedTargetingOptionDetails)

Szczegóły pozycji na ekranie. To pole zostanie wypełnione, gdy wartość targetingType będzie równa TARGETING_TYPE_ON_SCREEN_POSITION.
carrierAndIspDetails

object (CarrierAndIspAssignedTargetingOptionDetails)

szczegóły operatora sieci komórkowej i dostawcy internetu; To pole zostanie wypełnione, gdy wartość targetingType będzie równa TARGETING_TYPE_CARRIER_AND_ISP.
keywordDetails

object (KeywordAssignedTargetingOptionDetails)

Szczegóły słowa kluczowego. To pole zostanie wypełnione, gdy wartość targetingType będzie równa TARGETING_TYPE_KEYWORD.

Do zasobu można przypisać maksymalnie 5000 bezpośrednich wykluczających słów kluczowych. Nie ma limitu liczby słów kluczowych z dopasowaniem ścisłym, które można przypisać.
negativeKeywordListDetails

object (NegativeKeywordListAssignedTargetingOptionDetails)

Szczegóły słowa kluczowego. To pole zostanie wypełnione, gdy wartość targetingType będzie równa TARGETING_TYPE_NEGATIVE_KEYWORD_LIST.

Do zasobu można przypisać maksymalnie 4 listy wykluczających słów kluczowych.
operatingSystemDetails

object (OperatingSystemAssignedTargetingOptionDetails)

Szczegóły systemu operacyjnego. To pole zostanie wypełnione, gdy wartość targetingType będzie równa TARGETING_TYPE_OPERATING_SYSTEM.
deviceMakeModelDetails

object (DeviceMakeModelAssignedTargetingOptionDetails)

Szczegóły dotyczące marki i modelu urządzenia. To pole zostanie wypełnione, gdy wartość targetingType będzie równa TARGETING_TYPE_DEVICE_MAKE_MODEL.
environmentDetails

object (EnvironmentAssignedTargetingOptionDetails)

Szczegóły środowiska. To pole zostanie wypełnione, gdy wartość targetingType będzie równa TARGETING_TYPE_ENVIRONMENT.
inventorySourceDetails

object (InventorySourceAssignedTargetingOptionDetails)

Szczegóły źródła zasobów reklamowych. To pole zostanie wypełnione, gdy wartość targetingType będzie równa TARGETING_TYPE_INVENTORY_SOURCE.
categoryDetails

object (CategoryAssignedTargetingOptionDetails)

Szczegóły kategorii. To pole zostanie wypełnione, gdy wartość targetingType będzie równa TARGETING_TYPE_CATEGORY.

Kierowanie na kategorię spowoduje też kierowanie na jej podkategorie. Jeśli kategoria jest wykluczona z kierowania, a podkategoria jest uwzględniona, pierwszeństwo ma wykluczenie.
viewabilityDetails

object (ViewabilityAssignedTargetingOptionDetails)

Szczegóły widoczności. To pole zostanie wypełnione, gdy wartość targetingType będzie równa TARGETING_TYPE_VIEWABILITY.

W przypadku każdego zasobu możesz kierować reklamy tylko na 1 opcję widoczności.
authorizedSellerStatusDetails

object (AuthorizedSellerStatusAssignedTargetingOptionDetails)

Szczegóły stanu autoryzowanego sprzedawcy. To pole zostanie wypełnione, gdy wartość targetingType będzie równa TARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

W przypadku każdego zasobu możesz kierować reklamy tylko na 1 opcję stanu autoryzowanego sprzedawcy.

Jeśli zasób nie ma opcji stanu autoryzowanego sprzedawcy, domyślnie kierujemy reklamy na wszystkich autoryzowanych sprzedawców wskazanych w pliku ads.txt jako DIRECT lub RESELLER.
languageDetails

object (LanguageAssignedTargetingOptionDetails)

Szczegóły języka. To pole zostanie wypełnione, gdy wartość targetingType będzie równa TARGETING_TYPE_LANGUAGE.
geoRegionDetails

object (GeoRegionAssignedTargetingOptionDetails)

Szczegóły regionu geograficznego. To pole zostanie wypełnione, gdy wartość targetingType będzie równa TARGETING_TYPE_GEO_REGION.
inventorySourceGroupDetails

object (InventorySourceGroupAssignedTargetingOptionDetails)

Szczegóły grupy źródeł zasobów reklamowych. To pole zostanie wypełnione, gdy wartość targetingType będzie równa TARGETING_TYPE_INVENTORY_SOURCE_GROUP.
digitalContentLabelExclusionDetails

object (DigitalContentLabelAssignedTargetingOptionDetails)

Szczegóły etykiety treści cyfrowych. To pole zostanie wypełnione, gdy wartość targetingType będzie równa TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION.

Etykiety treści cyfrowych to wykluczenia z kierowania. Wykluczenia etykiet treści cyfrowych na poziomie reklamodawcy, jeśli są ustawione, są zawsze stosowane podczas wyświetlania reklam (nawet jeśli nie są widoczne w ustawieniach zasobów). Ustawienia zasobu mogą wykluczać etykiety treści oprócz wykluczeń reklamodawcy, ale nie mogą ich zastępować. Jeśli wykluczysz wszystkie etykiety treści cyfrowych, element zamówienia nie będzie wyświetlać reklam.
sensitiveCategoryExclusionDetails

object (SensitiveCategoryAssignedTargetingOptionDetails)

Szczegóły kategorii reklam o charakterze kontrowersyjnym. To pole zostanie wypełnione, gdy wartość targetingType będzie równa TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION.

Reklamy o charakterze kontrowersyjnym to wykluczenia kierowania. Wykluczenia kategorii o charakterze kontrowersyjnym na poziomie reklamodawcy, jeśli są skonfigurowane, są zawsze stosowane podczas wyświetlania reklam (nawet jeśli nie są widoczne w ustawieniach zasobu). Ustawienia zasobu mogą wykluczać reklamy o charakterze kontrowersyjnym oprócz wykluczeń reklamodawcy, ale nie mogą ich zastępować.
contentThemeExclusionDetails

object (ContentThemeAssignedTargetingOptionDetails)

Szczegóły tematu treści. To pole zostanie wypełnione, gdy wartość targetingType będzie równa TARGETING_TYPE_CONTENT_THEME_EXCLUSION.

Tematy treści to wykluczenia kierowania. Wykluczenia tematów treści na poziomie reklamodawcy, jeśli są ustawione, są zawsze stosowane podczas wyświetlania reklam (nawet jeśli nie są widoczne w ustawieniach zasobu). Ustawienia zasobu mogą wykluczać tematy treści oprócz wykluczeń reklamodawcy.
exchangeDetails

object (ExchangeAssignedTargetingOptionDetails)

Szczegóły giełdy. To pole zostanie wypełnione, gdy wartość targetingType będzie równa TARGETING_TYPE_EXCHANGE.
subExchangeDetails

object (SubExchangeAssignedTargetingOptionDetails)

Szczegóły giełdy podrzędnej. To pole zostanie wypełnione, gdy wartość targetingType będzie równa TARGETING_TYPE_SUB_EXCHANGE.
thirdPartyVerifierDetails

object (ThirdPartyVerifierAssignedTargetingOptionDetails)

Szczegóły weryfikacji przez firmę zewnętrzną. To pole zostanie wypełnione, gdy wartość targetingType będzie równa TARGETING_TYPE_THIRD_PARTY_VERIFIER.
poiDetails

object (PoiAssignedTargetingOptionDetails)

Szczegóły ciekawego miejsca. To pole zostanie wypełnione, gdy wartość targetingType będzie równa TARGETING_TYPE_POI.
businessChainDetails

object (BusinessChainAssignedTargetingOptionDetails)

Szczegóły sieci placówek firmy. To pole zostanie wypełnione, gdy wartość targetingType będzie równa TARGETING_TYPE_BUSINESS_CHAIN.
contentDurationDetails

object (ContentDurationAssignedTargetingOptionDetails)

Szczegóły czasu trwania treści. To pole zostanie wypełnione, gdy wartość targetingType będzie równa TARGETING_TYPE_CONTENT_DURATION.
contentStreamTypeDetails

object (ContentStreamTypeAssignedTargetingOptionDetails)

Szczegóły czasu trwania treści. To pole zostanie wypełnione, gdy wartość TargetingType to TARGETING_TYPE_CONTENT_STREAM_TYPE.
nativeContentPositionDetails

object (NativeContentPositionAssignedTargetingOptionDetails)

Szczegóły pozycji treści natywnych. To pole zostanie wypełnione, gdy wartość targetingType będzie równa TARGETING_TYPE_NATIVE_CONTENT_POSITION.
omidDetails

object (OmidAssignedTargetingOptionDetails)

Szczegóły zasobów reklamowych z włączonym Open Measurement. To pole zostanie wypełnione, gdy wartość targetingType będzie równa TARGETING_TYPE_OMID.
audioContentTypeDetails

object (AudioContentTypeAssignedTargetingOptionDetails)

Szczegóły typu treści audio. To pole zostanie wypełnione, gdy wartość targetingType będzie równa TARGETING_TYPE_AUDIO_CONTENT_TYPE.
contentGenreDetails

object (ContentGenreAssignedTargetingOptionDetails)

Szczegóły gatunku treści. To pole zostanie wypełnione, gdy wartość targetingType będzie równa TARGETING_TYPE_CONTENT_GENRE.
youtubeVideoDetails

object (YoutubeVideoAssignedTargetingOptionDetails)

szczegóły filmu na YouTube; To pole zostanie wypełnione, gdy wartość targetingType będzie równa TARGETING_TYPE_YOUTUBE_VIDEO.
youtubeChannelDetails

object (YoutubeChannelAssignedTargetingOptionDetails)

Szczegóły kanału w YouTube. To pole zostanie wypełnione, gdy wartość targetingType będzie równa TARGETING_TYPE_YOUTUBE_CHANNEL.
sessionPositionDetails

object (SessionPositionAssignedTargetingOptionDetails)

Szczegóły pozycji sesji. To pole zostanie wypełnione, gdy wartość targetingType będzie równa TARGETING_TYPE_SESSION_POSITION.
youtubeChannelPackDetails

object (YoutubeChannelPackAssignedTargetingOptionDetails)

Szczegóły pakietu kanałów w YouTube. To pole zostanie wypełnione, gdy wartość targetingType będzie równa TARGETING_TYPE_YOUTUBE_CHANNEL_PACK.
Koniec pól wykluczających się nawzajem.

Metody

create

 Przypisuje opcję kierowania do partnera.

delete

 Usuwa przypisaną opcję kierowania od partnera.

get

 Pobiera pojedynczą opcję kierowania przypisaną do partnera.

list

 Zawiera listę opcji kierowania przypisanych do partnera.