REST Resource: advertisers.lineItems.targetingTypes.assignedTargetingOptions

Zasób: AssignedTargetOption

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

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

  // Union field details can be only one of the following:
  "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)
  },
  "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)
  }
  // End of list of possible types for union field details.
}
Pola
name

string

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

assignedTargetingOptionId

string

Tylko dane wyjściowe. Unikalny identyfikator przypisanej opcji kierowania. Identyfikator jest unikalny tylko w obrębie danego zasobu i typu kierowania. Można go użyć w innych kontekstach.

targetingType

enum (TargetingType)

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

inheritance

enum (Inheritance)

Tylko dane wyjściowe. Stan dziedziczenia przypisanej opcji kierowania.

Pole sumy details. Szczegółowe informacje o przypisywanej opcji kierowania. Możesz wypełnić tylko jedno pole w szczegółach, które musi odpowiadać parametrowi targeting_type. details może mieć tylko jedno z tych pól:
channelDetails

object (ChannelAssignedTargetingOptionDetails)

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

appCategoryDetails

object (AppCategoryAssignedTargetingOptionDetails)

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

appDetails

object (AppAssignedTargetingOptionDetails)

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

urlDetails

object (UrlAssignedTargetingOptionDetails)

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

dayAndTimeDetails

object (DayAndTimeAssignedTargetingOptionDetails)

Szczegóły daty i godziny. To pole zostanie wypełnione, gdy targetingType będzie mieć wartość TARGETING_TYPE_DAY_AND_TIME.

ageRangeDetails

object (AgeRangeAssignedTargetingOptionDetails)

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

regionalLocationListDetails

object (RegionalLocationListAssignedTargetingOptionDetails)

Szczegóły regionalnej listy lokalizacji. To pole zostanie wypełnione, gdy targetingType będzie mieć wartość TARGETING_TYPE_REGIONAL_LOCATION_LIST.

proximityLocationListDetails

object (ProximityLocationListAssignedTargetingOptionDetails)

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

genderDetails

object (GenderAssignedTargetingOptionDetails)

Informacje o płci. To pole zostanie wypełnione, gdy targetingType będzie mieć wartość TARGETING_TYPE_GENDER.

videoPlayerSizeDetails

object (VideoPlayerSizeAssignedTargetingOptionDetails)

Informacje o rozmiarze odtwarzacza wideo. To pole zostanie wypełnione, gdy targetingType będzie mieć wartość TARGETING_TYPE_VIDEO_PLAYER_SIZE.

userRewardedContentDetails

object (UserRewardedContentAssignedTargetingOptionDetails)

Szczegółowe informacje o treściach z nagrodą dla użytkowników. To pole zostanie wypełnione, gdy targetingType będzie mieć wartość TARGETING_TYPE_USER_REWARDED_CONTENT.

parentalStatusDetails

object (ParentalStatusAssignedTargetingOptionDetails)

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

contentInstreamPositionDetails

object (ContentInstreamPositionAssignedTargetingOptionDetails)

Szczegóły pozycji treści In-Stream. To pole zostanie wypełnione, gdy targetingType będzie mieć wartość TARGETING_TYPE_CONTENT_INSTREAM_POSITION.

contentOutstreamPositionDetails

object (ContentOutstreamPositionAssignedTargetingOptionDetails)

Szczegóły pozycji treści Out-Stream. To pole zostanie wypełnione, gdy targetingType będzie mieć wartość TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION.

deviceTypeDetails

object (DeviceTypeAssignedTargetingOptionDetails)

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

audienceGroupDetails

object (AudienceGroupAssignedTargetingOptionDetails)

Szczegóły kierowania na odbiorców. To pole zostanie wypełnione, gdy targetingType będzie mieć wartość TARGETING_TYPE_AUDIENCE_GROUP. Możesz kierować reklamy tylko na 1 opcję grupy odbiorców na zasób.

browserDetails

object (BrowserAssignedTargetingOptionDetails)

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

householdIncomeDetails

object (HouseholdIncomeAssignedTargetingOptionDetails)

Szczegóły dochodu gospodarstwa domowego. To pole zostanie wypełnione, gdy targetingType będzie mieć wartość TARGETING_TYPE_HOUSEHOLD_INCOME.

onScreenPositionDetails

object (OnScreenPositionAssignedTargetingOptionDetails)

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

carrierAndIspDetails

object (CarrierAndIspAssignedTargetingOptionDetails)

Szczegółowe informacje o operatorze i dostawcy internetu. To pole zostanie wypełnione, gdy targetingType będzie mieć wartość TARGETING_TYPE_CARRIER_AND_ISP.

keywordDetails

object (KeywordAssignedTargetingOptionDetails)

Szczegóły dotyczące słów kluczowych. To pole zostanie wypełnione, gdy targetingType będzie mieć wartość TARGETING_TYPE_KEYWORD.

Do zasobu można przypisać maksymalnie 5000 bezpośrednich wykluczających słów kluczowych. Brak limitu liczby niewykluczających słów kluczowych, które można przypisać.

negativeKeywordListDetails

object (NegativeKeywordListAssignedTargetingOptionDetails)

Szczegóły dotyczące słów kluczowych. To pole zostanie wypełnione, gdy targetingType będzie mieć wartość 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 targetingType będzie mieć wartość TARGETING_TYPE_OPERATING_SYSTEM.

deviceMakeModelDetails

object (DeviceMakeModelAssignedTargetingOptionDetails)

Informacje o marce i modelu urządzenia. To pole zostanie wypełnione, gdy targetingType będzie mieć wartość TARGETING_TYPE_DEVICE_MAKE_MODEL.

environmentDetails

object (EnvironmentAssignedTargetingOptionDetails)

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

inventorySourceDetails

object (InventorySourceAssignedTargetingOptionDetails)

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

categoryDetails

object (CategoryAssignedTargetingOptionDetails)

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

Kierowanie na kategorię działa też w jej podkategoriach. Jeśli kategoria jest wykluczona z kierowania i uwzględniona jest podkategoria, wykluczenie ma pierwszeństwo.

viewabilityDetails

object (ViewabilityAssignedTargetingOptionDetails)

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

Możesz kierować reklamy tylko na 1 opcję widoczności na zasób.

authorizedSellerStatusDetails

object (AuthorizedSellerStatusAssignedTargetingOptionDetails)

Szczegółowe informacje o stanie autoryzowanego sprzedawcy. To pole zostanie wypełnione, gdy targetingType będzie mieć wartość TARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

Możesz ustawić kierowanie tylko na 1 opcję stanu autoryzowanego sprzedawcy na zasób.

Jeśli zasób nie ma ustawionej opcji stanu autoryzowanego sprzedawcy, domyślnie reklamy są kierowane na wszystkich autoryzowanych sprzedawców oznaczonych w pliku ads.txt jako DIRECT lub RESELLER.

languageDetails

object (LanguageAssignedTargetingOptionDetails)

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

geoRegionDetails

object (GeoRegionAssignedTargetingOptionDetails)

Szczegóły dotyczące regionu geograficznego. To pole zostanie wypełnione, gdy targetingType będzie mieć wartość TARGETING_TYPE_GEO_REGION.

inventorySourceGroupDetails

object (InventorySourceGroupAssignedTargetingOptionDetails)

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

digitalContentLabelExclusionDetails

object (DigitalContentLabelAssignedTargetingOptionDetails)

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

Etykiety treści cyfrowych służą do kierowania na wykluczenia. Jeśli wykluczenia etykiet treści cyfrowych na poziomie reklamodawcy są ustawione, są zawsze stosowane podczas wyświetlania reklam (nawet wtedy, gdy nie są widoczne w ustawieniach zasobów). Ustawienia zasobów oprócz wykluczeń reklamodawców mogą wykluczać etykiety treści, ale nie mogą ich zastąpić. Element zamówienia nie będzie się wyświetlać, jeśli wszystkie etykiety treści cyfrowych są wykluczone.

sensitiveCategoryExclusionDetails

object (SensitiveCategoryAssignedTargetingOptionDetails)

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

Kategorie o charakterze kontrowersyjnym to wykluczenia kierowania. Wykluczenia kategorii reklam o charakterze kontrowersyjnym na poziomie reklamodawcy, jeśli są ustawione, są zawsze stosowane podczas wyświetlania reklam (nawet wtedy, gdy nie są widoczne w ustawieniach zasobów). Ustawienia zasobów mogą oprócz wykluczeń reklamodawców wykluczać kategorie o charakterze kontrowersyjnym, ale nie mogą ich zastąpić.

exchangeDetails

object (ExchangeAssignedTargetingOptionDetails)

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

subExchangeDetails

object (SubExchangeAssignedTargetingOptionDetails)

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

thirdPartyVerifierDetails

object (ThirdPartyVerifierAssignedTargetingOptionDetails)

Szczegóły weryfikacji zewnętrznej. To pole zostanie wypełnione, gdy targetingType będzie mieć wartość TARGETING_TYPE_THIRD_PARTY_VERIFIER.

poiDetails

object (PoiAssignedTargetingOptionDetails)

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

businessChainDetails

object (BusinessChainAssignedTargetingOptionDetails)

Szczegóły sieci firmowej. To pole zostanie wypełnione, gdy targetingType będzie mieć wartość TARGETING_TYPE_BUSINESS_CHAIN.

contentDurationDetails

object (ContentDurationAssignedTargetingOptionDetails)

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

contentStreamTypeDetails

object (ContentStreamTypeAssignedTargetingOptionDetails)

Szczegóły czasu trwania treści. To pole zostanie wypełnione, gdy parametr TargetingType będzie miał wartość TARGETING_TYPE_CONTENT_STREAM_TYPE.

nativeContentPositionDetails

object (NativeContentPositionAssignedTargetingOptionDetails)

Szczegóły pozycji natywnej treści. To pole zostanie wypełnione, gdy targetingType będzie mieć wartość TARGETING_TYPE_NATIVE_CONTENT_POSITION.

omidDetails

object (OmidAssignedTargetingOptionDetails)

Informacje o zasobach reklamowych z włączoną obsługą Open Measurement. To pole zostanie wypełnione, gdy targetingType będzie mieć wartość TARGETING_TYPE_OMID.

audioContentTypeDetails

object (AudioContentTypeAssignedTargetingOptionDetails)

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

contentGenreDetails

object (ContentGenreAssignedTargetingOptionDetails)

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

Metody

create

Przypisuje opcję kierowania do elementu zamówienia.

delete

Usuwa przypisaną opcję kierowania z elementu zamówienia.

get

Pobiera jedną opcję kierowania przypisaną do elementu zamówienia.

list

Zawiera listę opcji kierowania przypisanych do elementu zamówienia.