REST Resource: advertisers.campaigns.targetingTypes.assignedTargetingOptions

Zasób: AssignedKierowanieOption

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

Zapis JSON 
{
  "name": string,
  "assignedTargetingOptionId": string,
  "assignedTargetingOptionIdAlias": 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)
  },
  "youtubeVideoDetails": {
    object (YoutubeVideoAssignedTargetingOptionDetails)
  },
  "youtubeChannelDetails": {
    object (YoutubeChannelAssignedTargetingOptionDetails)
  },
  "sessionPositionDetails": {
    object (SessionPositionAssignedTargetingOptionDetails)
  }
  // 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.
assignedTargetingOptionIdAlias

string

Tylko dane wyjściowe. Alias dla assignedTargetingOptionId. Tej wartości możesz używać zamiast assignedTargetingOptionId podczas pobierania lub usuwania istniejących ustawień 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 elementu zamówienia takich 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.
Pole sumy details. Szczegółowe informacje o przypisywanej opcji kierowania. Możesz wypełnić tylko jedno pole w szczegółach. Musi ono odpowiadać wartości 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 przybliżonych. 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óły treści 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 w 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)

Dane operatora 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łowa kluczowego. 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łowa kluczowego. 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ę powoduje też kierowanie na jej podkategorie. 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 przypisanej opcji stanu autoryzowanego sprzedawcy, reklamy są domyślnie 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 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 to wykluczenia kierowania. Wykluczenia etykiet treści cyfrowych na poziomie reklamodawcy, jeśli są ustawione, są zawsze stosowane podczas wyświetlania (mimo że nie są widoczne w ustawieniach zasobów). Ustawienia zasobów mogą wykluczać etykiety treści w uzupełnieniu wykluczeń reklamodawców, ale nie mogą ich zastąpić. Element zamówienia nie będzie wyświetlać reklam, 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. Wykluczone kategorie reklam o charakterze kontrowersyjnym na poziomie reklamodawcy są zawsze stosowane podczas wyświetlania reklam (nawet wtedy, gdy nie są widoczne w ustawieniach zasobów). Ustawienia zasobów mogą wykluczać kategorie o charakterze kontrowersyjnym, ale nie mogą ich zastępować.
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)

Informacje o 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 będzie wypełniane, gdy w polu TargetType będzie wartość TARGETING_TYPE_CONTENT_STREAM_TYPE.
nativeContentPositionDetails

object (NativeContentPositionAssignedTargetingOptionDetails)

Szczegóły pozycji natywnych 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 dotyczące gatunku treści. To pole zostanie wypełnione, gdy targetingType będzie mieć wartość TARGETING_TYPE_CONTENT_GENRE.
youtubeVideoDetails

object (YoutubeVideoAssignedTargetingOptionDetails)

Szczegóły filmu w YouTube. To pole zostanie wypełnione, gdy targetingType będzie mieć wartość TARGETING_TYPE_YOUTUBE_VIDEO.
youtubeChannelDetails

object (YoutubeChannelAssignedTargetingOptionDetails)

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

object (SessionPositionAssignedTargetingOptionDetails)

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

Dziedziczenie

Wskazuje, czy przypisana opcja kierowania jest dziedziczona z elementu wyższego poziomu, np. partnera czy reklamodawcy. Dziedziczone przypisane opcje kierowania mają pierwszeństwo i są zawsze stosowane w wyświetlaniu zamiast kierowania przypisanego na bieżącym poziomie i nie można ich modyfikować za pomocą bieżącej usługi encji. Należy je modyfikować za pomocą usługi encji, z której są dziedziczone. Dziedziczenie obowiązuje tylko w przypadku kanałów, na które są kierowane wykluczone z kierowania, wykluczeń kategorii o charakterze kontrowersyjnym i wykluczeń etykiet treści cyfrowych, jeśli zostały one skonfigurowane na poziomie nadrzędnym.

Wartości w polu enum
INHERITANCE_UNSPECIFIED Dziedziczenie jest nieokreślone lub nieznane.
NOT_INHERITED Przypisana opcja kierowania nie jest dziedziczona z elementu wyższego poziomu.
INHERITED_FROM_PARTNER Przypisana opcja kierowania jest dziedziczona z ustawień kierowania partnera.
INHERITED_FROM_ADVERTISER Przypisana opcja kierowania jest dziedziczona z ustawień kierowania reklamodawcy.

ChannelAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania na kanał. Gdy targetingType ma wartość TARGETING_TYPE_CHANNEL, zostanie ono uzupełnione w polu szczegółów elementu AssignedKierowanieOption.

Zapis JSON 
{
  "channelId": string,
  "negative": boolean
}
Pola
channelId

string (int64 format)

To pole jest wymagane. Identyfikator kanału. Ta wartość powinna się odnosić do pola identyfikatora kanału zasobu kanału należącego do partnera lub kanału należącego do reklamodawcy.
negative

boolean

Wskazuje, czy na tę opcję jest ustawione kierowanie wykluczające. W przypadku opcji kierowania przypisanej na poziomie reklamodawcy to pole musi mieć wartość prawda.

AppCategoryAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania na kategorię aplikacji. Gdy targetingType ma wartość TARGETING_TYPE_APP_CATEGORY, zostanie ono wypełnione w polu appCategoryDetails elementu AssignedKierowanieOption.

Zapis JSON 
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
Pola
displayName

string

Tylko dane wyjściowe. Wyświetlana nazwa kategorii aplikacji.
targetingOptionId

string

To pole jest wymagane. w polu targetingOptionId, gdy targetingType ma wartość TARGETING_TYPE_APP_CATEGORY.
negative

boolean

Wskazuje, czy na tę opcję jest ustawione kierowanie wykluczające.

AppAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania na aplikację. Gdy targetingType ma wartość TARGETING_TYPE_APP, zostanie ono uzupełnione w polu szczegółów elementu AssignedKierowanieOption.

Zapis JSON 
{
  "appId": string,
  "displayName": string,
  "negative": boolean,
  "appPlatform": enum (AppPlatform)
}
Pola
appId

string

To pole jest wymagane. Identyfikator aplikacji.

Aplikacja w Sklepie Play na Androida używa identyfikatora pakietu, np. com.google.android.gm. Identyfikator aplikacji Apple w sklepie App Store używa 9-cyfrowego ciągu znaków, np. 422689480.
displayName

string

Tylko dane wyjściowe. Wyświetlana nazwa aplikacji.
negative

boolean

Wskazuje, czy na tę opcję jest ustawione kierowanie wykluczające.
appPlatform

enum (AppPlatform)

Wskazuje platformę aplikacji, na którą kierowana jest aplikacja. Jeśli nie określisz wartości tego pola, domyślnie będzie używana platforma mobilna (tzn. Androida lub iOS), wskażemy odpowiednią platformę mobilną z identyfikatora aplikacji.

AppPlatform

Możliwe opcje kierowania na platformę aplikacji

Wartości w polu enum
APP_PLATFORM_UNSPECIFIED Wartość domyślna, gdy platforma aplikacji nie jest określona w tej wersji. Ta wyliczenie jest symbolem zastępczym wartości domyślnej i nie reprezentuje rzeczywistej opcji platformy.
APP_PLATFORM_IOS Platforma aplikacji to iOS.
APP_PLATFORM_ANDROID Platformą aplikacji jest Android.
APP_PLATFORM_ROKU Platformą aplikacji jest Roku.
APP_PLATFORM_AMAZON_FIRETV Platformą aplikacji jest Amazon FireTV.
APP_PLATFORM_PLAYSTATION Platformą aplikacji jest Playstation.
APP_PLATFORM_APPLE_TV Platformą aplikacji jest Apple TV.
APP_PLATFORM_XBOX Platforma aplikacji to Xbox.
APP_PLATFORM_SAMSUNG_TV Platformą aplikacji jest Samsung TV.
APP_PLATFORM_ANDROID_TV Platformą aplikacji jest Android TV.
APP_PLATFORM_GENERIC_CTV Platforma aplikacji to platforma CTV, która nie jest wymieniona w innym miejscu.

UrlAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania na adres URL. Gdy targetingType ma wartość TARGETING_TYPE_URL, zostanie ono uzupełnione w polu szczegółów elementu AssignedKierowanieOption.

Zapis JSON 
{
  "url": string,
  "negative": boolean
}
Pola
url

string

To pole jest wymagane. Adres URL, np. example.com.

DV360 obsługuje 2 poziomy kierowania na podkatalogi (np. www.example.com/one-subdirectory-level/second-level) i 5 poziomów kierowania na subdomeny, np. five.four.three.two.one.example.com.
negative

boolean

Wskazuje, czy na tę opcję jest ustawione kierowanie wykluczające.

DayAndTimeAssignedTargetingOptionDetails

Reprezentacja segmentu czasu określonego w konkretnym dniu tygodnia z czasem rozpoczęcia i zakończenia. Czas podany przez startHour musi być wcześniejszy niż czas wskazany przez endHour.

Zapis JSON 
{
  "dayOfWeek": enum (DayOfWeek),
  "startHour": integer,
  "endHour": integer,
  "timeZoneResolution": enum (TimeZoneResolution)
}
Pola
dayOfWeek

enum (DayOfWeek)

To pole jest wymagane. Dzień tygodnia dla tego ustawienia kierowania na dzień i godzinę.
startHour

integer

To pole jest wymagane. Godzina rozpoczęcia kierowania na dzień i godzinę. Wartość musi mieścić się w zakresie od 0 (początek dnia) do 23 (godzinę przed końcem dnia).
endHour

integer

To pole jest wymagane. Godzina zakończenia kierowania na dzień i godzinę. Musi mieścić się w przedziale od 1 (1 godzina od początku dnia) do 24 (koniec dnia).
timeZoneResolution

enum (TimeZoneResolution)

To pole jest wymagane. Mechanizm służący do określania strefy czasowej, która ma być używana w przypadku danego ustawienia kierowania na dzień i godzinę.

DayOfWeek

Reprezentuje dzień tygodnia.

Wartości w polu enum
DAY_OF_WEEK_UNSPECIFIED Dzień tygodnia nie jest określony.
MONDAY Poniedziałek
TUESDAY wtorek
WEDNESDAY Środa
THURSDAY czwartek
FRIDAY piątek
SATURDAY Saturday (sobota)
SUNDAY niedziela

TimeZoneResolution

Możliwe sposoby określenia strefy czasowej.

Wartości w polu enum
TIME_ZONE_RESOLUTION_UNSPECIFIED Rozdzielczość strefy czasowej jest nieokreślona lub nieznana.
TIME_ZONE_RESOLUTION_END_USER Czas jest podawany według strefy czasowej użytkownika, który widział reklamę.
TIME_ZONE_RESOLUTION_ADVERTISER Czas jest ustalany w strefie czasowej reklamodawcy, który wyświetlił reklamę.

AgeRangeAssignedTargetingOptionDetails

Reprezentuje przedział wiekowy, na który można kierować reklamy. Gdy targetingType ma wartość TARGETING_TYPE_AGE_RANGE, zostanie ono uzupełnione w polu szczegółów elementu AssignedKierowanieOption.

Zapis JSON 
{
  "ageRange": enum (AgeRange)
}
Pola
ageRange

enum (AgeRange)

To pole jest wymagane. Przedział wiekowy odbiorców. Obsługujemy tylko kierowanie na stały przedział wiekowy odbiorców. W związku z tym przedział wiekowy przedstawiony w tym polu może być 1) kierowany tylko lub 2) częściowo z większego stałego przedziału wiekowego. Zasięg stałego kierowania na przedziały wiekowe można zwiększyć, kierując reklamy także na odbiorców w nieznanym wieku.

RegionalLocationListAssignedTargetingOptionDetails

Szczegóły kierowania na liście lokalizacji regionalnych. Gdy targetingType ma wartość TARGETING_TYPE_REGIONAL_LOCATION_LIST, zostanie ono uzupełnione w polu szczegółów elementu AssignedKierowanieOption.

Zapis JSON 
{
  "regionalLocationListId": string,
  "negative": boolean
}
Pola
regionalLocationListId

string (int64 format)

To pole jest wymagane. Identyfikator listy lokalizacji regionalnych. Powinna się odwoływać do pola locationListId zasobu LocationList, którego typ to TARGETING_LOCATION_TYPE_REGIONAL.
negative

boolean

Wskazuje, czy na tę opcję jest ustawione kierowanie wykluczające.

ProximityLocationListAssignedTargetingOptionDetails

Szczegóły kierowania na listę zbliżonych lokalizacji. Gdy targetingType ma wartość TARGETING_TYPE_PROXIMITY_LOCATION_LIST, zostanie ono uzupełnione w polu szczegółów elementu AssignedKierowanieOption.

Zapis JSON 
{
  "proximityLocationListId": string,
  "proximityRadius": number,
  "proximityRadiusUnit": enum (ProximityRadiusUnit)
}
Pola
proximityLocationListId

string (int64 format)

To pole jest wymagane. Identyfikator listy lokalizacji przybliżonych. Powinna się odwoływać do pola locationListId zasobu LocationList, którego typ to TARGETING_LOCATION_TYPE_PROXIMITY.
proximityRadius

number

To pole jest wymagane. Promień wyrażony w jednostkach odległości ustawionych w proximityRadiusUnit. Jest to rozmiar obszaru wokół wybranej lokalizacji, na który będą kierowane reklamy. Promień powinien wynosić od 1 do 800 mil.
proximityRadiusUnit

enum (ProximityRadiusUnit)

To pole jest wymagane. Jednostki odległości w promieniu.

ProximityRadiusUnit

Wyliczenie jednostek odległości dla ProximityRadius.

Wartości w polu enum
PROXIMITY_RADIUS_UNIT_UNSPECIFIED Wartość domyślna, gdy jednostki odległości nie są określone w tej wersji. Ta wyliczenie stanowi miejsce dla wartości domyślnej i nie odzwierciedla rzeczywistej jednostki odległości.
PROXIMITY_RADIUS_UNIT_MILES Jednostka odległości w milach.
PROXIMITY_RADIUS_UNIT_KILOMETERS Jednostka długości promienia w kilometrach

GenderAssignedTargetingOptionDetails

Szczegóły opcji kierowania na płeć. Gdy targetingType ma wartość TARGETING_TYPE_GENDER, zostanie ono uzupełnione w polu szczegółów elementu AssignedKierowanieOption.

Zapis JSON 
{
  "gender": enum (Gender)
}
Pola
gender

enum (Gender)

To pole jest wymagane. Płeć odbiorców.

VideoPlayerSizeAssignedTargetingOptionDetails

Szczegóły opcji kierowania na rozmiar odtwarzacza wideo. Zostanie ono wypełnione w polu videoPlayerSizeDetails, gdy targetingType będzie mieć wartość TARGETING_TYPE_VIDEO_PLAYER_SIZE. Bezpośrednie kierowanie na wszystkie opcje nie jest obsługiwane. Aby osiągnąć taki efekt, usuń wszystkie opcje kierowania na rozmiar odtwarzacza wideo.

Zapis JSON 
{
  "videoPlayerSize": enum (VideoPlayerSize)
}
Pola
videoPlayerSize

enum (VideoPlayerSize)

To pole jest wymagane. Rozmiar odtwarzacza wideo.

UserRewardedContentAssignedTargetingOptionDetails

Szczegóły opcji kierowania na treści z nagrodą dla użytkowników. Zostanie ono wypełnione w polu userRewardedContentDetails, gdy targetingType będzie mieć wartość TARGETING_TYPE_USER_REWARDED_CONTENT.

Zapis JSON 
{
  "targetingOptionId": string,
  "userRewardedContent": enum (UserRewardedContent)
}
Pola
targetingOptionId

string

To pole jest wymagane. w polu targetingOptionId, gdy targetingType ma wartość TARGETING_TYPE_USER_REWARDED_CONTENT.
userRewardedContent

enum (UserRewardedContent)

Tylko dane wyjściowe. Stan treści z nagrodą dla użytkowników w reklamach wideo.

ParentalStatusAssignedTargetingOptionDetails

Szczegóły opcji kierowania na status rodzicielski. Gdy targetingType ma wartość TARGETING_TYPE_PARENTAL_STATUS, zostanie ono uzupełnione w polu szczegółów elementu AssignedKierowanieOption.

Zapis JSON 
{
  "parentalStatus": enum (ParentalStatus)
}
Pola
parentalStatus

enum (ParentalStatus)

To pole jest wymagane. Status rodzicielski odbiorców.

ContentInstreamPositionAssignedTargetingOptionDetails

Szczegóły opcji kierowania na pozycję w przypisanej treści w In-Stream. Zostanie ono wypełnione w polu contentInstreamPositionDetails, gdy targetingType będzie mieć wartość TARGETING_TYPE_CONTENT_INSTREAM_POSITION.

Zapis JSON 
{
  "contentInstreamPosition": enum (ContentInstreamPosition),
  "adType": enum (AdType)
}
Pola
contentInstreamPosition

enum (ContentInstreamPosition)

To pole jest wymagane. Pozycja treści In-Stream w przypadku reklam wideo lub audio.
adType

enum (AdType)

Tylko dane wyjściowe. Typ reklamy, na którą ma być kierowana reklama. Ta opcja będzie domyślnie dziedziczona tylko w przypadku kierowania zamówienia reklamowego i nowych elementów zamówienia obsługujących określony typ reklamy. Możliwe wartości to:

  • AD_TYPE_VIDEO, ustawienie zostanie odziedziczone przez nowy element zamówienia, gdy wartość w kolumnie „lineItemType” to „LINE_ITEM_TYPE_VIDEO_DEFAULT”.
  • AD_TYPE_AUDIO, ustawienie zostanie odziedziczone przez nowy element zamówienia, gdy wartość w kolumnie „lineItemType” to „LINE_ITEM_TYPE_AUDIO_DEFAULT”.

AdType

Reprezentuje typ kreacji powiązany z reklamami.

Wartości w polu enum
AD_TYPE_UNSPECIFIED Typ reklamy nie został określony lub jest nieznany w tej wersji.
AD_TYPE_DISPLAY Kreacje displayowe, np. graficzne i HTML5.
AD_TYPE_VIDEO Kreacje wideo, np. reklamy wideo odtwarzane podczas strumieniowego przesyłania treści w odtwarzaczach.
AD_TYPE_AUDIO Kreacje audio, np. reklamy audio odtwarzane w treści audio.

ContentOutstreamPositionAssignedTargetingOptionDetails

Szczegóły opcji kierowania na pozycję Out-Stream przypisanej treści. Zostanie ono wypełnione w polu contentOutstreamPositionDetails, gdy targetingType będzie mieć wartość TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION.

Zapis JSON 
{
  "contentOutstreamPosition": enum (ContentOutstreamPosition),
  "adType": enum (AdType)
}
Pola
contentOutstreamPosition

enum (ContentOutstreamPosition)

To pole jest wymagane. Pozycja treści Out-Stream.
adType

enum (AdType)

Tylko dane wyjściowe. Typ reklamy, na którą ma być kierowana reklama. Ta opcja będzie domyślnie dziedziczona tylko w przypadku kierowania zamówienia reklamowego i nowych elementów zamówienia obsługujących określony typ reklamy. Możliwe wartości to:

  • AD_TYPE_DISPLAY, ustawienie zostanie odziedziczone przez nowy element zamówienia, gdy wartość w kolumnie „lineItemType” to „LINE_ITEM_TYPE_DISPLAY_DEFAULT”.
  • AD_TYPE_VIDEO, ustawienie zostanie odziedziczone przez nowy element zamówienia, gdy wartość w kolumnie „lineItemType” to „LINE_ITEM_TYPE_VIDEO_DEFAULT”.

DeviceTypeAssignedTargetingOptionDetails

Szczegóły kierowania na typ urządzenia. Gdy targetingType ma wartość TARGETING_TYPE_DEVICE_TYPE, zostanie ono uzupełnione w polu szczegółów elementu AssignedKierowanieOption.

Zapis JSON 
{
  "deviceType": enum (DeviceType),
  "youtubeAndPartnersBidMultiplier": number
}
Pola
deviceType

enum (DeviceType)

To pole jest wymagane. Wyświetlana nazwa typu urządzenia.
youtubeAndPartnersBidMultiplier

number

Tylko dane wyjściowe. Mnożnik stawki pozwala zmieniać częstotliwość wyświetlania reklam na podstawie typu urządzenia. Spowoduje to zastosowanie mnożnika pierwotnej stawki. Jeśli pole ma wartość 0, oznacza to, że to pole nie ma zastosowania, zamiast mnożenia 0 przez pierwotną stawkę.

Jeśli np. stawka bez mnożnika wynosi 10 PLN, a mnożnik w przypadku tabletu – 1,5, ostateczna stawka za tablety wyniesie 15 PLN.

Dotyczy tylko elementów zamówienia typu YouTube i sieć partnerów wideo Google.

AudienceGroupAssignedTargetingOptionDetails

Szczegóły opcji kierowania przypisanej grupy odbiorców. Gdy targetingType ma wartość TARGETING_TYPE_AUDIENCE_GROUP, zostanie ono uzupełnione w polu szczegółów elementu AssignedKierowanieOption. Relacja między każdą grupą to UNION, z wyjątkiem wykluczeń FirstAndOtherPartyAudienceGroup i excludedGoogleAudienceGroup, z których COMPLEMENT jest używany jako SKOK razem z innymi grupami.

Zapis JSON 
{
  "includedFirstAndThirdPartyAudienceGroups": [
    {
      object (FirstAndThirdPartyAudienceGroup)
    }
  ],
  "includedGoogleAudienceGroup": {
    object (GoogleAudienceGroup)
  },
  "includedCustomListGroup": {
    object (CustomListGroup)
  },
  "includedCombinedAudienceGroup": {
    object (CombinedAudienceGroup)
  },
  "excludedFirstAndThirdPartyAudienceGroup": {
    object (FirstAndThirdPartyAudienceGroup)
  },
  "excludedGoogleAudienceGroup": {
    object (GoogleAudienceGroup)
  }
}
Pola
includedFirstAndThirdPartyAudienceGroups[]

object (FirstAndThirdPartyAudienceGroup)

Identyfikatory własne i listy odbiorców dostarczone przez inną firmę, a także identyfikatory uwzględnionych grup odbiorców (własnych i zewnętrznych) uwzględnionych w grupie. Każda grupa odbiorców własna i dostarczona przez inną firmę zawiera tylko identyfikatory własne i identyfikatory odbiorców dostarczone przez firmę zewnętrzną. Relacja między pierwszą grupą odbiorców a grupą odbiorców dostarczoną przez inną firmę jest równa EDGE, a wynik jest łączony z innymi grupami odbiorców. Powtarzające się grupy o tych samych ustawieniach będą ignorowane.
includedGoogleAudienceGroup

object (GoogleAudienceGroup)

Identyfikatory odbiorców Google z uwzględnionej grupy odbiorców Google. Zawiera tylko identyfikatory odbiorców Google.
includedCustomListGroup

object (CustomListGroup)

Identyfikatory list niestandardowych uwzględnionej niestandardowej grupy. Zawiera tylko identyfikatory list niestandardowych.
includedCombinedAudienceGroup

object (CombinedAudienceGroup)

Identyfikatory odbiorców z połączonych list uwzględnionych w grupie odbiorców z połączonych list. Zawiera tylko identyfikatory odbiorców z połączonych list.
excludedFirstAndThirdPartyAudienceGroup

object (FirstAndThirdPartyAudienceGroup)

Własne identyfikatory odbiorców i listy odbiorców dostarczone przez inną firmę w przypadku własnej wykluczonej grupy odbiorców oraz grupy odbiorców innej firmy. Służy do kierowania wykluczającego. Uzupełnianie elementu UNION tej grupy i innych wykluczonych grup odbiorców służy jako ZEZWALANIE na kierowanie na odbiorców z pozytywnym kierowaniem. Wszystkie elementy są logicznie połączone operatorem LUB.
excludedGoogleAudienceGroup

object (GoogleAudienceGroup)

Identyfikatory odbiorców Google wykluczonej grupy odbiorców Google. Służy do kierowania wykluczającego. Uzupełnianie elementu UNION tej grupy i innych wykluczonych grup odbiorców służy jako ZEZWALANIE na kierowanie na odbiorców z pozytywnym kierowaniem. Obejmuje tylko odbiorców Google o podobnych zainteresowaniach, odbiorców na rynku i odbiorców „Zainstalowane aplikacje”. Wszystkie elementy są logicznie połączone operatorem LUB.

FirstAndThirdPartyAudienceGroup

Szczegółowe informacje o własnej grupie odbiorców i grupie odbiorców dostarczonej przez inną firmę. Wszystkie ustawienia kierowania na odbiorców własnych i na listy odbiorców dostarczane przez inne firmy są logicznie połączone operatorem LUB.

Zapis JSON 
{
  "settings": [
    {
      object (FirstAndThirdPartyAudienceTargetingSetting)
    }
  ]
}
Pola
settings[]

object (FirstAndThirdPartyAudienceTargetingSetting)

To pole jest wymagane. Wszystkie ustawienia kierowania na odbiorców własnych i na listy odbiorców dostarczone przez inną firmę w grupie odbiorców własnej i innej firmy. Powtarzające się ustawienia o tym samym identyfikatorze są niedozwolone.

FirstAndThirdPartyAudienceTargetingSetting

Szczegółowe informacje o ustawieniach kierowania na odbiorców własnych i innych firm.

Zapis JSON 
{
  "firstAndThirdPartyAudienceId": string,
  "recency": enum (Recency)
}
Pola
firstAndThirdPartyAudienceId

string (int64 format)

To pole jest wymagane. Identyfikator własnej listy odbiorców i identyfikatora innej firmy powiązany z ustawieniem kierowania na odbiorców własnych i zewnętrznych. Ten identyfikator to firstAndThirdPartyAudienceId.
recency

enum (Recency)

Czas od ostatniego użycia ustawienia kierowania na odbiorców (własna i dostarczona przez firmę zewnętrzną). Dotyczy tylko własnych list odbiorców. W przeciwnym razie zostanie zignorowany. Więcej informacji znajdziesz na stronie https://support.google.com/displayvideo/answer/2949947#recency. Jeśli nie określono tego limitu, nie będzie używany limit czasu od poprzedniej wizyty.

Czas od poprzedniej wizyty

Wszystkie obsługiwane wartości czasu od poprzedniej wizyty w przypadku własnej listy odbiorców i listy odbiorców dostarczonych przez firmę zewnętrzną.

Wartości w polu enum
RECENCY_NO_LIMIT Brak limitu czasu od poprzedniej wizyty.
RECENCY_1_MINUTE Czas od poprzedniej wizyty wynosi 1 minutę.
RECENCY_5_MINUTES Czas od poprzedniej wizyty wynosi 5 minut.
RECENCY_10_MINUTES Czas od poprzedniej wizyty wynosi 10 minut.
RECENCY_15_MINUTES Czas od poprzedniej wizyty wynosi 15 minut.
RECENCY_30_MINUTES Czas od poprzedniej wizyty wynosi 30 minut.
RECENCY_1_HOUR Czas od poprzedniej wizyty to 1 godzina.
RECENCY_2_HOURS Czas od poprzedniej wizyty to 2 godziny.
RECENCY_3_HOURS Czas od poprzedniej wizyty to 3 godziny.
RECENCY_6_HOURS Czas od poprzedniej wizyty to 6 godzin.
RECENCY_12_HOURS Czas od poprzedniej wizyty wynosi 12 godzin.
RECENCY_1_DAY Czas od poprzedniej wizyty to 1 dzień.
RECENCY_2_DAYS Czas od poprzedniej wizyty wynosi 2 dni.
RECENCY_3_DAYS Czas od poprzedniej wizyty wynosi 3 dni.
RECENCY_5_DAYS Czas od poprzedniej wizyty wynosi 5 dni.
RECENCY_7_DAYS Czas od poprzedniej wizyty wynosi 7 dni.
RECENCY_10_DAYS Czas od poprzedniej wizyty wynosi 10 dni.
RECENCY_14_DAYS Czas od poprzedniej wizyty wynosi 14 dni.
RECENCY_15_DAYS Czas od poprzedniej wizyty wynosi 15 dni.
RECENCY_21_DAYS Czas od poprzedniej wizyty wynosi 21 dni.
RECENCY_28_DAYS Czas od poprzedniej wizyty wynosi 28 dni.
RECENCY_30_DAYS Czas od poprzedniej wizyty wynosi 30 dni.
RECENCY_40_DAYS Czas od poprzedniej wizyty wynosi 40 dni.
RECENCY_45_DAYS Czas od poprzedniej wizyty wynosi 45 dni.
RECENCY_60_DAYS Czas od poprzedniej wizyty wynosi 60 dni.
RECENCY_90_DAYS Czas od poprzedniej wizyty wynosi 90 dni.
RECENCY_120_DAYS Czas od poprzedniej wizyty wynosi 120 dni.
RECENCY_180_DAYS Czas od poprzedniej wizyty wynosi 180 dni.
RECENCY_270_DAYS Czas od poprzedniej wizyty wynosi 270 dni.
RECENCY_365_DAYS Czas od poprzedniej wizyty wynosi 365 dni.

GoogleAudienceGroup

Szczegółowe informacje o grupie odbiorców Google. Wszystkie ustawienia kierowania na odbiorców Google są połączone operatorem logicznym „LUB”.

Zapis JSON 
{
  "settings": [
    {
      object (GoogleAudienceTargetingSetting)
    }
  ]
}
Pola
settings[]

object (GoogleAudienceTargetingSetting)

To pole jest wymagane. Wszystkie ustawienia kierowania na odbiorców Google w grupie odbiorców Google. Powtarzające się ustawienia o tym samym identyfikatorze zostaną zignorowane.

GoogleAudienceTargetingSetting

Szczegółowe informacje o ustawieniach kierowania na odbiorców Google.

Zapis JSON 
{
  "googleAudienceId": string
}
Pola
googleAudienceId

string (int64 format)

To pole jest wymagane. Identyfikator odbiorców Google powiązany z ustawieniem kierowania na odbiorców Google. Ten identyfikator to googleAudienceId.

CustomListGroup

Szczegóły niestandardowej grupy. Wszystkie ustawienia kierowania na listy niestandardowe są połączone operatorem logicznym „LUB”.

Zapis JSON 
{
  "settings": [
    {
      object (CustomListTargetingSetting)
    }
  ]
}
Pola
settings[]

object (CustomListTargetingSetting)

To pole jest wymagane. Wszystkie ustawienia kierowania na listy niestandardowe w grupie listy niestandardowej. Powtarzające się ustawienia o tym samym identyfikatorze zostaną zignorowane.

CustomListTargetingSetting

Szczegóły ustawienia kierowania na listy niestandardowe.

Zapis JSON 
{
  "customListId": string
}
Pola
customListId

string (int64 format)

To pole jest wymagane. Identyfikator niestandardowy ustawienia kierowania na listy niestandardowe. Ten identyfikator to customListId.

CombinedAudienceGroup

Szczegółowe informacje o grupie odbiorców z połączonych list. Wszystkie ustawienia kierowania na odbiorców z połączonych list są połączone operatorem logicznym „LUB”.

Zapis JSON 
{
  "settings": [
    {
      object (CombinedAudienceTargetingSetting)
    }
  ]
}
Pola
settings[]

object (CombinedAudienceTargetingSetting)

To pole jest wymagane. Wszystkie ustawienia kierowania na odbiorców z połączonych list w grupie odbiorców z połączonych list. Powtarzające się ustawienia o tym samym identyfikatorze zostaną zignorowane. Liczba ustawień połączonych odbiorców nie powinna przekraczać 5. W przeciwnym razie wystąpi błąd.

CombinedAudienceTargetingSetting

Szczegółowe informacje o ustawieniach kierowania na odbiorców z połączonych list.

Zapis JSON 
{
  "combinedAudienceId": string
}
Pola
combinedAudienceId

string (int64 format)

To pole jest wymagane. Połączony identyfikator odbiorców w przypadku ustawienia kierowania na odbiorców z połączonych list. Ten identyfikator to combinedAudienceId.

BrowserAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania na przeglądarkę. Gdy targetingType ma wartość TARGETING_TYPE_BROWSER, zostanie ono uzupełnione w polu szczegółów elementu AssignedKierowanieOption.

Zapis JSON 
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
Pola
displayName

string

Tylko dane wyjściowe. Wyświetlana nazwa przeglądarki.
targetingOptionId

string

To pole jest wymagane. Wartość targetingOptionId elementu TargetingOption typu TARGETING_TYPE_BROWSER.
negative

boolean

Wskazuje, czy na tę opcję jest ustawione kierowanie wykluczające. Wszystkie przypisane opcje kierowania na przeglądarkę w tym samym zasobie muszą mieć taką samą wartość w tym polu.

HouseholdIncomeAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania na dochód gospodarstwa domowego. Gdy targetingType ma wartość TARGETING_TYPE_HOUSEHOLD_INCOME, zostanie ono uzupełnione w polu szczegółów elementu AssignedKierowanieOption.

Zapis JSON 
{
  "householdIncome": enum (HouseholdIncome)
}
Pola
householdIncome

enum (HouseholdIncome)

To pole jest wymagane. Dochód gospodarstwa domowego odbiorcy.

OnScreenPositionAssignedTargetingOptionDetails

Szczegóły opcji kierowania na pozycję na ekranie. Zostanie ono wypełnione w polu onScreenPositionDetails, gdy targetingType będzie mieć wartość TARGETING_TYPE_ON_SCREEN_POSITION.

Zapis JSON 
{
  "targetingOptionId": string,
  "onScreenPosition": enum (OnScreenPosition),
  "adType": enum (AdType)
}
Pola
targetingOptionId

string

To pole jest wymagane. w polu targetingOptionId, gdy targetingType ma wartość TARGETING_TYPE_ON_SCREEN_POSITION.
onScreenPosition

enum (OnScreenPosition)

Tylko dane wyjściowe. Pozycja na ekranie.
adType

enum (AdType)

Tylko dane wyjściowe. Typ reklamy, na którą ma być kierowana reklama. Ta opcja będzie domyślnie dziedziczona tylko w przypadku kierowania zamówienia reklamowego i nowych elementów zamówienia obsługujących określony typ reklamy. Możliwe wartości to:

  • AD_TYPE_DISPLAY, ustawienie zostanie odziedziczone przez nowy element zamówienia, gdy wartość w kolumnie „lineItemType” to „LINE_ITEM_TYPE_DISPLAY_DEFAULT”.
  • AD_TYPE_VIDEO, ustawienie zostanie odziedziczone przez nowy element zamówienia, gdy wartość w kolumnie „lineItemType” to „LINE_ITEM_TYPE_VIDEO_DEFAULT”.

CarrierAndIspAssignedTargetingOptionDetails

Szczegóły opcji kierowania na operatora sieci komórkowej i dostawcę internetu. Gdy targetingType ma wartość TARGETING_TYPE_CARRIER_AND_ISP, zostanie ono uzupełnione w polu szczegółów elementu AssignedKierowanieOption.

Zapis JSON 
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
Pola
displayName

string

Tylko dane wyjściowe. Wyświetlana nazwa operatora lub dostawcy internetu.
targetingOptionId

string

To pole jest wymagane. Wartość targetingOptionId elementu TargetingOption typu TARGETING_TYPE_CARRIER_AND_ISP.
negative

boolean

Wskazuje, czy na tę opcję jest ustawione kierowanie wykluczające. Wszystkie opcje kierowania na operatora i dostawcę internetu przypisane do tego samego zasobu muszą mieć taką samą wartość w tym polu.

KeywordAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania na słowa kluczowe. Gdy targetingType ma wartość TARGETING_TYPE_KEYWORD, zostanie ono uzupełnione w polu szczegółów elementu AssignedKierowanieOption.

Zapis JSON 
{
  "keyword": string,
  "negative": boolean
}
Pola
keyword

string

To pole jest wymagane. Słowo kluczowe, na przykład car insurance.

Niewykluczające słowo kluczowe nie może być obraźliwym słowem. Musi być zakodowany w formacie UTF-8 o maksymalnym rozmiarze 255 bajtów. Maksymalna liczba znaków to 80. Maksymalna liczba słów to 10.
negative

boolean

Wskazuje, czy na tę opcję jest ustawione kierowanie wykluczające.

NegativeKeywordListAssignedTargetingOptionDetails

Szczegóły kierowania na listę wykluczających słów kluczowych. Gdy targetingType ma wartość TARGETING_TYPE_NEGATIVE_KEYWORD_LIST, zostanie ono uzupełnione w polu szczegółów elementu AssignedKierowanieOption.

Zapis JSON 
{
  "negativeKeywordListId": string
}
Pola
negativeKeywordListId

string (int64 format)

To pole jest wymagane. Identyfikator listy wykluczających słów kluczowych. Powinna się odwoływać do pola negativeKeywordListId zasobu NegativeKeywordList.

OperatingSystemAssignedTargetingOptionDetails

Szczegóły opcji kierowania przypisanego systemu operacyjnego. Zostanie ono wypełnione w polu operatingSystemDetails, gdy targetingType będzie mieć wartość TARGETING_TYPE_OPERATING_SYSTEM.

Zapis JSON 
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
Pola
displayName

string

Tylko dane wyjściowe. Wyświetlana nazwa systemu operacyjnego.
targetingOptionId

string

To pole jest wymagane. Identyfikator opcji kierowania wpisany w polu targetingOptionId, gdy targetingType ma wartość TARGETING_TYPE_OPERATING_SYSTEM.
negative

boolean

Wskazuje, czy na tę opcję jest ustawione kierowanie wykluczające.

DeviceMakeModelAssignedTargetingOptionDetails

Szczegóły opcji kierowania na markę i model urządzenia. Zostanie ono wypełnione w polu deviceMakeModelDetails, gdy targetingType będzie mieć wartość TARGETING_TYPE_DEVICE_MAKE_MODEL.

Zapis JSON 
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
Pola
displayName

string

Tylko dane wyjściowe. Wyświetlana nazwa marki i modelu urządzenia.
targetingOptionId

string

To pole jest wymagane. w polu targetingOptionId, gdy targetingType ma wartość TARGETING_TYPE_DEVICE_MAKE_MODEL.
negative

boolean

Wskazuje, czy na tę opcję jest ustawione kierowanie wykluczające.

EnvironmentAssignedTargetingOptionDetails

Szczegóły opcji kierowania na środowisko. Gdy targetingType ma wartość TARGETING_TYPE_ENVIRONMENT, zostanie ono uzupełnione w polu szczegółów elementu AssignedKierowanieOption.

Zapis JSON 
{
  "environment": enum (Environment)
}
Pola
environment

enum (Environment)

To pole jest wymagane. Środowisko wyświetlania.

InventorySourceAssignedTargetingOptionDetails

Szczegóły kierowania na źródło zasobów reklamowych. Gdy targetingType ma wartość TARGETING_TYPE_INVENTORY_SOURCE, zostanie ono uzupełnione w polu szczegółów elementu AssignedKierowanieOption.

Zapis JSON 
{
  "inventorySourceId": string
}
Pola
inventorySourceId

string (int64 format)

To pole jest wymagane. Identyfikator źródła zasobów reklamowych. Powinna się odwoływać do pola inventorySourceId zasobu InventorySource.

CategoryAssignedTargetingOptionDetails

Szczegóły opcji kierowania przypisanej kategorii. Zostanie ono wypełnione w polu categoryDetails, gdy targetingType będzie mieć wartość TARGETING_TYPE_CATEGORY.

Zapis JSON 
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
Pola
displayName

string

Tylko dane wyjściowe. Wyświetlana nazwa kategorii.
targetingOptionId

string

To pole jest wymagane. w polu targetingOptionId, gdy targetingType ma wartość TARGETING_TYPE_CATEGORY.
negative

boolean

Wskazuje, czy na tę opcję jest ustawione kierowanie wykluczające.

ViewabilityAssignedTargetingOptionDetails

Szczegóły opcji kierowania przypisanej widoczności. Gdy targetingType ma wartość TARGETING_TYPE_VIEWABILITY, zostanie ono wypełnione w polu viewabilityDetails elementu AssignedKierowanieOption.

Zapis JSON 
{
  "viewability": enum (Viewability)
}
Pola
viewability

enum (Viewability)

To pole jest wymagane. Odsetek prognozowanej widoczności.

AuthorizedSellerStatusAssignedTargetingOptionDetails

Reprezentuje przypisany stan autoryzowanego sprzedawcy. Gdy targetingType ma wartość TARGETING_TYPE_AUTHORIZED_SELLER_STATUS, zostanie ono uzupełnione w polu szczegółów elementu AssignedKierowanieOption.

Jeśli zasób nie ma przypisanej opcji kierowania TARGETING_TYPE_AUTHORIZED_SELLER_STATUS, używa opcji „Autoryzowani sprzedawcy i sprzedawcy bezpośredni”.

Zapis JSON 
{
  "authorizedSellerStatus": enum (AuthorizedSellerStatus),
  "targetingOptionId": string
}
Pola
authorizedSellerStatus

enum (AuthorizedSellerStatus)

Tylko dane wyjściowe. Stan autoryzowanego sprzedawcy, na który mają być kierowane reklamy.
targetingOptionId

string

To pole jest wymagane. Wartość targetingOptionId elementu TargetingOption typu TARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

LanguageAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania na język. Gdy targetingType ma wartość TARGETING_TYPE_LANGUAGE, zostanie ono uzupełnione w polu szczegółów elementu AssignedKierowanieOption.

Zapis JSON 
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
Pola
displayName

string

Tylko dane wyjściowe. Wyświetlana nazwa języka (np. „francuski”).
targetingOptionId

string

To pole jest wymagane. Wartość targetingOptionId elementu TargetingOption typu TARGETING_TYPE_LANGUAGE.
negative

boolean

Wskazuje, czy na tę opcję jest ustawione kierowanie wykluczające. Wszystkie przypisane opcje kierowania na język w tym samym zasobie muszą mieć tę samą wartość w tym polu.

GeoRegionAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania na region geograficzny. Gdy targetingType ma wartość TARGETING_TYPE_GEO_REGION, zostanie ono uzupełnione w polu szczegółów elementu AssignedKierowanieOption.

Zapis JSON 
{
  "displayName": string,
  "targetingOptionId": string,
  "geoRegionType": enum (GeoRegionType),
  "negative": boolean
}
Pola
displayName

string

Tylko dane wyjściowe. Wyświetlana nazwa regionu geograficznego (np. „Ontario, Kanada”).
targetingOptionId

string

To pole jest wymagane. Wartość targetingOptionId elementu TargetingOption typu TARGETING_TYPE_GEO_REGION.
geoRegionType

enum (GeoRegionType)

Tylko dane wyjściowe. Typ kierowania na region geograficzny.
negative

boolean

Wskazuje, czy na tę opcję jest ustawione kierowanie wykluczające.

InventorySourceGroupAssignedTargetingOptionDetails

Szczegóły kierowania grupy źródeł zasobów reklamowych. Gdy targetingType ma wartość TARGETING_TYPE_INVENTORY_SOURCE_GROUP, zostanie ono uzupełnione w polu szczegółów elementu AssignedKierowanieOption.

Zapis JSON 
{
  "inventorySourceGroupId": string
}
Pola
inventorySourceGroupId

string (int64 format)

To pole jest wymagane. Identyfikator grupy źródeł zasobów reklamowych. Powinna się odwoływać do pola inventorySourceGroupId zasobu InventorySourceGroup.

DigitalContentLabelAssignedTargetingOptionDetails

Szczegóły kierowania etykiet treści cyfrowych. Gdy targetingType ma wartość TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION, zostanie ono uzupełnione w polu szczegółów elementu AssignedKierowanieOption.

Zapis JSON 
{
  "excludedContentRatingTier": enum (ContentRatingTier)
}
Pola
excludedContentRatingTier

enum (ContentRatingTier)

To pole jest wymagane. Wyświetlana nazwa poziomu oceny treści cyfrowych do WYKLUCZENIA.

SensitiveCategoryAssignedTargetingOptionDetails

Szczegóły kierowania reklam o charakterze kontrowersyjnym. Gdy targetingType ma wartość TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION, zostanie ono uzupełnione w polu szczegółów elementu AssignedKierowanieOption.

Zapis JSON 
{
  "excludedSensitiveCategory": enum (SensitiveCategory)
}
Pola
excludedSensitiveCategory

enum (SensitiveCategory)

To pole jest wymagane. Wyliczenie treści o charakterze kontrowersyjnym w DV360, które zostały sklasyfikowane jako WYKLUCZONE.

ExchangeAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania na giełdę. Gdy targetingType ma wartość TARGETING_TYPE_EXCHANGE, zostanie ono uzupełnione w polu szczegółów elementu AssignedKierowanieOption.

Zapis JSON 
{
  "exchange": enum (Exchange)
}
Pola
exchange

enum (Exchange)

To pole jest wymagane. Wartość enum dla giełdy.

SubExchangeAssignedTargetingOptionDetails

Szczegóły opcji kierowania na giełdy podrzędne. Gdy targetingType ma wartość TARGETING_TYPE_SUB_EXCHANGE, zostanie ono uzupełnione w polu szczegółów elementu AssignedKierowanieOption.

Zapis JSON 
{
  "targetingOptionId": string
}
Pola
targetingOptionId

string

To pole jest wymagane. Wartość targetingOptionId elementu TargetingOption typu TARGETING_TYPE_SUB_EXCHANGE.

ThirdPartyVerifierAssignedTargetingOptionDetails

Szczegóły opcji kierowania przypisanego weryfikatora zewnętrznego. Gdy targetingType ma wartość TARGETING_TYPE_THIRD_PARTY_VERIFIER, zostanie ono uzupełnione w polu szczegółów elementu AssignedKierowanieOption.

Zapis JSON 
{

  // Union field verifier can be only one of the following:
  "adloox": {
    object (Adloox)
  },
  "doubleVerify": {
    object (DoubleVerify)
  },
  "integralAdScience": {
    object (IntegralAdScience)
  }
  // End of list of possible types for union field verifier.
}
Pola
Pole sumy verifier. Możesz ustawić kierowanie na weryfikatora zewnętrznego, aby egzekwować progi bezpieczeństwa marki dotyczące wyświetleń. verifier może być tylko jedną z tych wartości:
adloox

object (Adloox)

Weryfikator marki zewnętrzny – Adloox.
doubleVerify

object (DoubleVerify)

Weryfikator marki zewnętrzny – DoubleVerify.
integralAdScience

object (IntegralAdScience)

Weryfikator marki zewnętrzny – Integral Ad Science.

Adloox

Szczegółowe informacje o ustawieniach Adloox.

Zapis JSON 
{
  "excludedAdlooxCategories": [
    enum (AdlooxCategory)
  ]
}
Pola
excludedAdlooxCategories[]

enum (AdlooxCategory)

Ustawienia bezpieczeństwa marki Adloox.

AdlooxCategory

Możliwe opcje Adloox.

Wartości w polu enum
ADLOOX_UNSPECIFIED Ta wyliczenie jest tylko zmienną i nie określa żadnych opcji Adloox.
ADULT_CONTENT_HARD Treści dla dorosłych (twarde).
ADULT_CONTENT_SOFT Treści dla dorosłych (miękkie).
ILLEGAL_CONTENT Treści niezgodne z prawem.
BORDERLINE_CONTENT Treści bliskie łamania wytycznych.
DISCRIMINATORY_CONTENT Treści dyskryminujące.
VIOLENT_CONTENT_WEAPONS Treści związane z przemocą i bronią.
LOW_VIEWABILITY_DOMAINS Domeny o niskiej widoczności.
FRAUD Oszustwo.

DoubleVerify

Szczegółowe informacje o ustawieniach DoubleVerify.

Zapis JSON 
{
  "brandSafetyCategories": {
    object (BrandSafetyCategories)
  },
  "avoidedAgeRatings": [
    enum (AgeRating)
  ],
  "appStarRating": {
    object (AppStarRating)
  },
  "displayViewability": {
    object (DisplayViewability)
  },
  "videoViewability": {
    object (VideoViewability)
  },
  "fraudInvalidTraffic": {
    object (FraudInvalidTraffic)
  },
  "customSegmentId": string
}
Pola
brandSafetyCategories

object (BrandSafetyCategories)

Ustawienia bezpieczeństwa marki w DVD.
avoidedAgeRatings[]

enum (AgeRating)

Unikaj licytacji dotyczących aplikacji z odpowiednią kategorią wiekową.
appStarRating

object (AppStarRating)

Unikaj licytacji dotyczących aplikacji z gwiazdką.
displayViewability

object (DisplayViewability)

Ustawienia widoczności reklam displayowych (dotyczy tylko displayowych elementów zamówienia).
videoViewability

object (VideoViewability)

Ustawienia widoczności reklamy wideo (dotyczy tylko elementów zamówienia wideo).
fraudInvalidTraffic

object (FraudInvalidTraffic)

Unikaj witryn i aplikacji z historycznymi wskaźnikami fałszywego i nieprawidłowego ruchu z reklam.
customSegmentId

string (int64 format)

Niestandardowy identyfikator segmentu dostarczony przez DoubleVerify. Identyfikator musi zaczynać się od „51” i składać się z 8 cyfr. Identyfikator segmentu niestandardowego nie może być określony w żadnym z tych pól:

BrandSafetyCategories

Ustawienia opcji bezpieczeństwa marki.

Zapis JSON 
{
  "avoidUnknownBrandSafetyCategory": boolean,
  "avoidedHighSeverityCategories": [
    enum (HighSeverityCategory)
  ],
  "avoidedMediumSeverityCategories": [
    enum (MediumSeverityCategory)
  ]
}
Pola
avoidUnknownBrandSafetyCategory

boolean

Nieznany lub bez oceny.
avoidedHighSeverityCategories[]

enum (HighSeverityCategory)

Kategorie, do których należy unikać o dużej ważności w zakresie bezpieczeństwa marki.
avoidedMediumSeverityCategories[]

enum (MediumSeverityCategory)

Kategorie unikania o średnim poziomie ważności w związku z bezpieczeństwem marki.

HighSeverityCategory

Możliwe opcje dotyczące kategorii o wysokim poziomie ważności.

Wartości w polu enum
HIGHER_SEVERITY_UNSPECIFIED Ta wyliczenie jest tylko zmienną i nie określa żadnych kategorii o wysokim poziomie ważności.
ADULT_CONTENT_PORNOGRAPHY Treści dla dorosłych: pornografia, tematy dla dorosłych i nagość.
COPYRIGHT_INFRINGEMENT Naruszenie praw autorskich.
SUBSTANCE_ABUSE Narkotyki/alkohol/substancje kontrolowane: nadużywanie środków odurzających.
GRAPHIC_VIOLENCE_WEAPONS Drastyczne sceny/skrajna przemoc/broń.
HATE_PROFANITY Nienawiść/wulgaryzmy.
CRIMINAL_SKILLS Działania niezgodne z prawem: metody popełniania przestępstw.
NUISANCE_INCENTIVIZED_MALWARE_CLUTTER Zachęta do działania/złośliwe oprogramowanie/natłok.

MediumSeverityCategory

Możliwe opcje dla kategorii o średniej wadze.

Wartości w polu enum
MEDIUM_SEVERITY_UNSPECIFIED Ta wyliczenie jest tylko wartością zastępczą i nie określa żadnych kategorii o średniej wadze.
AD_SERVERS Serwery reklam.
ADULT_CONTENT_SWIMSUIT Treści dla dorosłych: stroje kąpielowe.
ALTERNATIVE_LIFESTYLES Kontrowersyjne tematy: alternatywne style życia.
CELEBRITY_GOSSIP Kontrowersyjne tematy: plotki o celebrytach.
GAMBLING Kontrowersyjne tematy: hazard.
OCCULT Kontrowersyjne tematy: okultyzm.
SEX_EDUCATION Kontrowersyjne tematy: edukacja seksualna.
DISASTER_AVIATION Katastrofa: lotnictwo.
DISASTER_MAN_MADE Katastrofa: stworzona przez człowieka.
DISASTER_NATURAL Katastrofa: naturalne.
DISASTER_TERRORIST_EVENTS Katastrofa: zdarzenia terrorystyczne.
DISASTER_VEHICLE Katastrofa: pojazd.
ALCOHOL Narkotyki/alkohol/substancje kontrolowane: alkohol.
SMOKING Narkotyki/alkohol/substancje kontrolowane: palenie.
NEGATIVE_NEWS_FINANCIAL Negatywne wiadomości: finansowe.
NON_ENGLISH Niestandardowe treści: w języku innym niż angielski.
PARKING_PAGE Niestandardowe treści: zaparkowane domeny.
UNMODERATED_UGC Niemoderowane treści użytkowników: fora, zdjęcia i filmy
INFLAMMATORY_POLITICS_AND_NEWS Kontrowersyjne tematy: wiadomości i treści polityczne mające na celu podburzanie
NEGATIVE_NEWS_PHARMACEUTICAL Negatywne wiadomości: farmaceutyczne.

AgeRating

Możliwe opcje kategorii wiekowych.

Wartości w polu enum
AGE_RATING_UNSPECIFIED Ta wyliczenie jest tylko wartością zastępczą i nie określa żadnych opcji klasyfikacji wiekowej.
APP_AGE_RATE_UNKNOWN Aplikacje o nieznanej kategorii wiekowej.
APP_AGE_RATE_4_PLUS Aplikacje dla wszystkich (od 4 lat).
APP_AGE_RATE_9_PLUS Aplikacje dla wszystkich (od 9 lat).
APP_AGE_RATE_12_PLUS Aplikacje dla nastolatków (powyżej 12 roku życia).
APP_AGE_RATE_17_PLUS Aplikacje dla dorosłych (od 17 roku życia).
APP_AGE_RATE_18_PLUS Aplikacje przeznaczone tylko dla dorosłych (od 18 lat).

AppStarRating

Szczegółowe informacje o ustawieniach liczby gwiazdek DoubleVerify.

Zapis JSON 
{
  "avoidedStarRating": enum (StarRating),
  "avoidInsufficientStarRating": boolean
}
Pola
avoidedStarRating

enum (StarRating)

Unikaj licytacji dotyczących aplikacji z gwiazdką.
avoidInsufficientStarRating

boolean

Unikaj licytacji w przypadku aplikacji z niewystarczającą liczbą gwiazdek.

StarRating

Możliwe opcje przyznawania gwiazdek.

Wartości w polu enum
APP_STAR_RATE_UNSPECIFIED Ta wyliczenie jest tylko wartością zastępczą i nie określa żadnych opcji oceny aplikacji w gwiazdkach.
APP_STAR_RATE_1_POINT_5_LESS Oficjalne aplikacje z oceną poniżej 1,5 gwiazdki.
APP_STAR_RATE_2_LESS Oficjalne aplikacje z oceną poniżej 2 gwiazdek.
APP_STAR_RATE_2_POINT_5_LESS Oficjalne aplikacje z oceną poniżej 2,5 gwiazdki.
APP_STAR_RATE_3_LESS Oficjalne aplikacje z oceną poniżej 3 gwiazdek.
APP_STAR_RATE_3_POINT_5_LESS Oficjalne aplikacje z oceną poniżej 3,5 gwiazdki.
APP_STAR_RATE_4_LESS Oficjalne aplikacje z oceną poniżej 4 gwiazdek.
APP_STAR_RATE_4_POINT_5_LESS Oficjalne aplikacje z oceną poniżej 4,5 gwiazdki.

DisplayViewability

Szczegółowe informacje o ustawieniach widoczności reklam displayowych opracowanych przez firmę DoubleVerify.

Zapis JSON 
{
  "iab": enum (IAB),
  "viewableDuring": enum (ViewableDuring)
}
Pola
iab

enum (IAB)

Kieruj na zasoby reklamowe na stronach internetowych i w aplikacjach, by zmaksymalizować współczynnik widoczności IAB.
viewableDuring

enum (ViewableDuring)

Kieruj na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować czas trwania widoczności w 100%.

IAB

Możliwe opcje współczynnika widoczności IAB.

Wartości w polu enum
IAB_VIEWED_RATE_UNSPECIFIED Ta wyliczenie jest tylko wartością zastępczą i nie określa żadnych opcji IAB związanych ze współczynnikiem wyświetleń.
IAB_VIEWED_RATE_80_PERCENT_HIGHER Kieruj na zasoby reklamowe na stronach internetowych i w aplikacjach, by zmaksymalizować współczynnik widoczności reklam według IAB na poziomie co najmniej 80%.
IAB_VIEWED_RATE_75_PERCENT_HIGHER Kieruj na zasoby reklamowe na stronach internetowych i w aplikacjach, by zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 75%.
IAB_VIEWED_RATE_70_PERCENT_HIGHER Kieruj na zasoby reklamowe na stronach internetowych i w aplikacjach, by zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 70%.
IAB_VIEWED_RATE_65_PERCENT_HIGHER Kieruj na zasoby reklamowe na stronach internetowych i w aplikacjach, by zmaksymalizować współczynnik widoczności reklam według IAB na poziomie co najmniej 65%.
IAB_VIEWED_RATE_60_PERCENT_HIGHER Kieruj na zasoby reklamowe na stronach internetowych i w aplikacjach, by zmaksymalizować współczynnik widoczności reklam według IAB na poziomie co najmniej 60%.
IAB_VIEWED_RATE_55_PERCENT_HIGHER Kieruj na zasoby reklamowe na stronach internetowych i w aplikacjach, by zmaksymalizować współczynnik widoczności reklam według IAB na poziomie co najmniej 55%.
IAB_VIEWED_RATE_50_PERCENT_HIGHER Kieruj na zasoby reklamowe na stronach internetowych i w aplikacjach, by zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 50%.
IAB_VIEWED_RATE_40_PERCENT_HIGHER Kieruj na zasoby reklamowe na stronach internetowych i w aplikacjach, by zmaksymalizować współczynnik widoczności reklam według IAB na poziomie co najmniej 40%.
IAB_VIEWED_RATE_30_PERCENT_HIGHER Kieruj na zasoby reklamowe na stronach internetowych i w aplikacjach, by zmaksymalizować współczynnik widoczności reklam według IAB na poziomie co najmniej 30%.

ViewableDuring

Możliwe opcje czasu widoczności reklamy.

Wartości w polu enum
AVERAGE_VIEW_DURATION_UNSPECIFIED Ta wyliczenie jest tylko wartością zastępczą i nie określa żadnych opcji średniego czasu oglądania.
AVERAGE_VIEW_DURATION_5_SEC Kieruj reklamy na zasoby reklamowe w witrynach i aplikacjach, by zmaksymalizować czas wyświetlania w 100% przez co najmniej 5 sekund.
AVERAGE_VIEW_DURATION_10_SEC Kieruj reklamy na zasoby reklamowe w witrynach i aplikacjach, by zmaksymalizować czas wyświetlania w 100% przez co najmniej 10 sekund.
AVERAGE_VIEW_DURATION_15_SEC Kieruj na zasoby reklamowe w witrynach i aplikacjach, by zmaksymalizować czas trwania wyświetlenia reklamy w 100% przez co najmniej 15 sekund.

VideoViewability

Szczegółowe informacje o ustawieniach widoczności reklam wideo firmy DoubleVerify.

Zapis JSON 
{
  "videoIab": enum (VideoIAB),
  "videoViewableRate": enum (VideoViewableRate),
  "playerImpressionRate": enum (PlayerImpressionRate)
}
Pola
videoIab

enum (VideoIAB)

Kieruj na zasoby reklamowe w internecie, by zmaksymalizować współczynnik widoczności IAB.
videoViewableRate

enum (VideoViewableRate)

Kieruj na zasoby reklamowe w internecie, aby zmaksymalizować współczynnik w pełni widocznych reklam.
playerImpressionRate

enum (PlayerImpressionRate)

Kieruj na zasoby reklamowe, by zmaksymalizować liczbę wyświetleń w odtwarzaczu o rozmiarze co najmniej 400 x 300.

VideoIAB

Możliwe opcje współczynnika widoczności IAB.

Wartości w polu enum
VIDEO_IAB_UNSPECIFIED Ta wyliczenie jest tylko wartością zastępczą i nie określa żadnych opcji współczynnika widoczności według IAB.
IAB_VIEWABILITY_80_PERCENT_HIGHER Kieruj na zasoby reklamowe na stronach internetowych i w aplikacjach, by zmaksymalizować współczynnik widoczności reklam według IAB na poziomie co najmniej 80%.
IAB_VIEWABILITY_75_PERCENT_HIGHER Kieruj na zasoby reklamowe na stronach internetowych i w aplikacjach, by zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 75%.
IAB_VIEWABILITY_70_PERCENT_HIGHER Kieruj na zasoby reklamowe na stronach internetowych i w aplikacjach, by zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 70%.
IAB_VIEWABILITY_65_PERCENT_HIHGER Kieruj na zasoby reklamowe na stronach internetowych i w aplikacjach, by zmaksymalizować współczynnik widoczności reklam według IAB na poziomie co najmniej 65%.
IAB_VIEWABILITY_60_PERCENT_HIGHER Kieruj na zasoby reklamowe na stronach internetowych i w aplikacjach, by zmaksymalizować współczynnik widoczności reklam według IAB na poziomie co najmniej 60%.
IAB_VIEWABILITY_55_PERCENT_HIHGER Kieruj na zasoby reklamowe na stronach internetowych i w aplikacjach, by zmaksymalizować współczynnik widoczności reklam według IAB na poziomie co najmniej 55%.
IAB_VIEWABILITY_50_PERCENT_HIGHER Kieruj na zasoby reklamowe na stronach internetowych i w aplikacjach, by zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 50%.
IAB_VIEWABILITY_40_PERCENT_HIHGER Kieruj na zasoby reklamowe na stronach internetowych i w aplikacjach, by zmaksymalizować współczynnik widoczności reklam według IAB na poziomie co najmniej 40%.
IAB_VIEWABILITY_30_PERCENT_HIHGER Kieruj na zasoby reklamowe na stronach internetowych i w aplikacjach, by zmaksymalizować współczynnik widoczności reklam według IAB na poziomie co najmniej 30%.

VideoViewableRate

Możliwe opcje współczynnika pełnej widoczności.

Wartości w polu enum
VIDEO_VIEWABLE_RATE_UNSPECIFIED Ta wyliczenie jest tylko wartością zastępczą i nie określa żadnych opcji współczynnika widoczności filmu.
VIEWED_PERFORMANCE_40_PERCENT_HIGHER Kieruj na zasoby reklamowe w internecie, aby zmaksymalizować współczynnik w pełni widocznych reklam na poziomie co najmniej 40%.
VIEWED_PERFORMANCE_35_PERCENT_HIGHER Kieruj na zasoby reklamowe w internecie, aby zmaksymalizować współczynnik w pełni widocznych reklam na poziomie co najmniej 35%.
VIEWED_PERFORMANCE_30_PERCENT_HIGHER Kieruj na zasoby reklamowe w internecie, aby zmaksymalizować współczynnik w pełni widocznych reklam na poziomie co najmniej 30%.
VIEWED_PERFORMANCE_25_PERCENT_HIGHER Kieruj na zasoby reklamowe w internecie, aby zmaksymalizować współczynnik w pełni widocznych reklam na poziomie co najmniej 25%.
VIEWED_PERFORMANCE_20_PERCENT_HIGHER Kieruj na zasoby reklamowe w internecie, by zmaksymalizować współczynnik w pełni widocznych reklam na poziomie co najmniej 20%.
VIEWED_PERFORMANCE_10_PERCENT_HIGHER Kieruj na zasoby reklamowe w internecie, by zmaksymalizować współczynnik w pełni widocznych reklam na poziomie co najmniej 10%.

PlayerImpressionRate

Możliwe opcje wyświetleń.

Wartości w polu enum
PLAYER_SIZE_400X300_UNSPECIFIED Jest to tylko wartość zastępcza i nie określa żadnych opcji wyświetleń.
PLAYER_SIZE_400X300_95 Strony generujące co najmniej 95%wyświetleń.
PLAYER_SIZE_400X300_70 Strony generujące co najmniej 70%wyświetleń.
PLAYER_SIZE_400X300_25 Strony generujące co najmniej 25%wyświetleń.
PLAYER_SIZE_400X300_5 Strony generujące co najmniej 5%wyświetleń.

FraudInvalidTraffic

Ustawienia DoubleVerify dotyczące oszustw i nieprawidłowego ruchu.

Zapis JSON 
{
  "avoidedFraudOption": enum (FraudOption),
  "avoidInsufficientOption": boolean
}
Pola
avoidedFraudOption

enum (FraudOption)

Unikaj witryn i aplikacji z historycznymi oszustwami i nieprawidłowym ruchem.
avoidInsufficientOption

boolean

Niewystarczające statystyki dotyczące oszustw i nieprawidłowego ruchu z reklam historycznych.

FraudOption

Możliwe opcje dotyczące historycznego współczynnika oszustw i nieprawidłowego ruchu z reklam.

Wartości w polu enum
FRAUD_UNSPECIFIED Ta wyliczenie jest tylko wartością zastępczą i nie określa żadnych opcji dotyczących oszustw ani nieprawidłowego ruchu.
AD_IMPRESSION_FRAUD_100 100% fałszywego i nieprawidłowego ruchu z reklam.
AD_IMPRESSION_FRAUD_50 Co najmniej 50% fałszywego i nieprawidłowego ruchu z reklam.
AD_IMPRESSION_FRAUD_25 Co najmniej 25% fałszywego i nieprawidłowego ruchu z reklam.
AD_IMPRESSION_FRAUD_10 Co najmniej 10% fałszywego i nieprawidłowego ruchu z reklam.
AD_IMPRESSION_FRAUD_8 Co najmniej 8% fałszywego i nieprawidłowego ruchu z reklam.
AD_IMPRESSION_FRAUD_6 Co najmniej 6% fałszywego i nieprawidłowego ruchu z reklam.
AD_IMPRESSION_FRAUD_4 Co najmniej 4% fałszywego i nieprawidłowego ruchu z reklam.
AD_IMPRESSION_FRAUD_2 Co najmniej 2% fałszywego i nieprawidłowego ruchu z reklam.

IntegralAdScience

Szczegółowe informacje o ustawieniach Integral Ad Science.

Zapis JSON 
{
  "traqScoreOption": enum (TRAQScore),
  "excludeUnrateable": boolean,
  "excludedAdultRisk": enum (Adult),
  "excludedAlcoholRisk": enum (Alcohol),
  "excludedIllegalDownloadsRisk": enum (IllegalDownloads),
  "excludedDrugsRisk": enum (Drugs),
  "excludedHateSpeechRisk": enum (HateSpeech),
  "excludedOffensiveLanguageRisk": enum (OffensiveLanguage),
  "excludedViolenceRisk": enum (Violence),
  "excludedGamblingRisk": enum (Gambling),
  "excludedAdFraudRisk": enum (AdFraudPrevention),
  "displayViewability": enum (DisplayViewability),
  "videoViewability": enum (VideoViewability),
  "customSegmentId": [
    string
  ]
}
Pola
traqScoreOption

enum (TRAQScore)

Faktyczna jakość reklam (dotyczy tylko displayowych elementów zamówienia).
excludeUnrateable

boolean

Bezpieczeństwo marki – nie można ocenić.
excludedAdultRisk

enum (Adult)

Bezpieczeństwo marki – treści dla dorosłych.
excludedAlcoholRisk

enum (Alcohol)

Bezpieczeństwo marki – Alkohol.
excludedIllegalDownloadsRisk

enum (IllegalDownloads)

Bezpieczeństwo marki – nielegalne pobieranie plików.
excludedDrugsRisk

enum (Drugs)

Bezpieczeństwo marki – Leki.
excludedHateSpeechRisk

enum (HateSpeech)

Bezpieczeństwo marki – szerzenie nienawiści.
excludedOffensiveLanguageRisk

enum (OffensiveLanguage)

Bezpieczeństwo marki – obraźliwy język.
excludedViolenceRisk

enum (Violence)

Bezpieczeństwo marki – przemoc.
excludedGamblingRisk

enum (Gambling)

Bezpieczeństwo marki – hazard.
excludedAdFraudRisk

enum (AdFraudPrevention)

Ustawienia oszustw reklamowych.
displayViewability

enum (DisplayViewability)

sekcję Widoczność w sieci reklamowej (dotyczy tylko displayowych elementów zamówienia).
videoViewability

enum (VideoViewability)

Sekcja widoczności reklam wideo (dotyczy tylko elementów zamówienia wideo).
customSegmentId[]

string (int64 format)

Niestandardowy identyfikator segmentu dostarczony przez Integral Ad Science. Identyfikator musi mieścić się w zakresie od 1000001 do 1999999 włącznie.

TRAQScore

Możliwe zakresy wyniku Integral Ad Science TRAQ (prawdziwa jakość reklam).

Wartości w polu enum
TRAQ_UNSPECIFIED Ta wyliczenie jest tylko wartością zastępczą i nie określa żadnych prawdziwych wyników jakości reklam.
TRAQ_250 Wskaźnik TRAQ: 250-1000.
TRAQ_500 Wskaźnik TRAQ: 500–1000.
TRAQ_600 Wskaźnik TRAQ: 600–1000.
TRAQ_700 Wskaźnik TRAQ: 700–1000.
TRAQ_750 Wskaźnik TRAQ: 750-1000.
TRAQ_875 Wskaźnik TRAQ: 875-1000.
TRAQ_1000 Wskaźnik TRAQ: 1000.

Dorosły

Możliwe opcje Integral Ad Science dla dorosłych.

Wartości w polu enum
ADULT_UNSPECIFIED Ta wyliczenie jest tylko zmienną i nie określa żadnych opcji dla dorosłych.
ADULT_HR Dla dorosłych – wyklucz wysokie ryzyko.
ADULT_HMR Dla dorosłych – wyklucz wysokie i średnie ryzyko.

Alkohol

Możliwe opcje reklamowania alkoholu w Integral Ad Science.

Wartości w polu enum
ALCOHOL_UNSPECIFIED Ta wyliczenie jest tylko zmienną i nie określa żadnych opcji alkoholu.
ALCOHOL_HR Alkohol – wyklucz wysokie ryzyko.
ALCOHOL_HMR Alkohol – wyklucz wysokie i umiarkowane ryzyko.

IllegalDownloads

Możliwe opcje Integral Ad Science niezgodne z prawem.

Wartości w polu enum
ILLEGAL_DOWNLOADS_UNSPECIFIED Ta wyliczenie jest tylko symbolem zastępczym i nie określa żadnych niedozwolonych opcji pobierania.
ILLEGAL_DOWNLOADS_HR Niedozwolone pobieranie plików – wyklucz wysokie ryzyko.
ILLEGAL_DOWNLOADS_HMR Niedozwolone pobieranie plików – wyklucz wysokie i średnie ryzyko.

Leki

Możliwe opcje leków Integral Ad Science.

Wartości w polu enum
DRUGS_UNSPECIFIED Ta wyliczenie jest tylko symbolem zastępczym i nie określa żadnych opcji leków.
DRUGS_HR Leki – wyklucz wysokie ryzyko.
DRUGS_HMR Leki – wyklucz wysokie i średnie ryzyko.

HateSpeech

Możliwe opcje Integral Ad Science szerzące nienawiść.

Wartości w polu enum
HATE_SPEECH_UNSPECIFIED Ta wyliczenie jest tylko symbolem zastępczym i nie określa żadnych opcji dotyczących szerzenia nienawiści.
HATE_SPEECH_HR Szerzenie nienawiści – wyklucz wysokie ryzyko.
HATE_SPEECH_HMR Szerzenie nienawiści – wyklucz wysokie i średnie ryzyko.

OffensiveLanguage

Możliwe opcje obraźliwe dla języka Integral Ad Science.

Wartości w polu enum
OFFENSIVE_LANGUAGE_UNSPECIFIED Jest to tylko zmienna i nie określa żadnych opcji językowych.
OFFENSIVE_LANGUAGE_HR Obraźliwy język – wyklucz wysokie ryzyko.
OFFENSIVE_LANGUAGE_HMR Obraźliwy język – wyklucz wysokie i średnie ryzyko.

Przemoc

Możliwe opcje dotyczące przemocy w Integral Ad Science.

Wartości w polu enum
VIOLENCE_UNSPECIFIED Ta wyliczenie jest tylko zmienną i nie określa żadnych opcji przemocy.
VIOLENCE_HR Przemoc – wyklucz wysokie ryzyko.
VIOLENCE_HMR Przemoc – wyklucz wysokie i umiarkowane ryzyko.

Hazard

Możliwe opcje reklamowania hazardu dostępne w Integral Ad Science.

Wartości w polu enum
GAMBLING_UNSPECIFIED Ta wyliczenie jest tylko symbolem zastępczym i nie określa żadnych opcji hazardu.
GAMBLING_HR Hazard – wyklucz wysokie ryzyko.
GAMBLING_HMR Hazard – wyklucz wysokie i umiarkowane ryzyko.

AdFraudPrevention

Możliwe opcje zapobiegania oszustwom w reklamie Integral Ad Science.

Wartości w polu enum
SUSPICIOUS_ACTIVITY_UNSPECIFIED Ta wyliczenie jest tylko wartością zastępczą i nie określa żadnych opcji zapobiegania oszustwom reklamowym.
SUSPICIOUS_ACTIVITY_HR Oszustwo reklamowe – wyklucz wysokie ryzyko.
SUSPICIOUS_ACTIVITY_HMR Oszustwo reklamowe – wyklucz wysokie i umiarkowane ryzyko.

DisplayViewability

Możliwe opcje widoczności w sieci reklamowej Integral Ad Science.

Wartości w polu enum
PERFORMANCE_VIEWABILITY_UNSPECIFIED Ta wyliczenie jest tylko wartością zastępczą i nie określa żadnych opcji widoczności reklam displayowych.
PERFORMANCE_VIEWABILITY_40 Docelowa widoczność na poziomie co najmniej 40%
PERFORMANCE_VIEWABILITY_50 Docelowa widoczność na poziomie co najmniej 50%
PERFORMANCE_VIEWABILITY_60 Docelowa widoczność na poziomie co najmniej 60%
PERFORMANCE_VIEWABILITY_70 Docelowa widoczność na poziomie co najmniej 70%

VideoViewability

Możliwe opcje widoczności reklam wideo Integral Ad Science.

Wartości w polu enum
VIDEO_VIEWABILITY_UNSPECIFIED Jest to tylko wartość zastępcza i nie określa żadnych opcji widoczności reklam wideo.
VIDEO_VIEWABILITY_40 Ponad 40%widoczne (standard IAB widoczności reklam wideo).
VIDEO_VIEWABILITY_50 Ponad 50%widoczne (standard IAB widoczności reklam wideo).
VIDEO_VIEWABILITY_60 Ponad 60%widoczne (standard IAB widoczności reklam wideo).
VIDEO_VIEWABILITY_70 Ponad 70%widoczne (standard IAB widoczności reklam wideo).

PoiAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania ciekawych miejsc. Gdy targetingType ma wartość TARGETING_TYPE_POI, zostanie ono uzupełnione w polu szczegółów elementu AssignedKierowanieOption.

Zapis JSON 
{
  "displayName": string,
  "targetingOptionId": string,
  "latitude": number,
  "longitude": number,
  "proximityRadiusAmount": number,
  "proximityRadiusUnit": enum (DistanceUnit)
}
Pola
displayName

string

Tylko dane wyjściowe. Wyświetlana nazwa ciekawego miejsca, np. „Times Square”, „Space Needle”, a następnie jego pełny adres, jeśli jest dostępny.
targetingOptionId

string

To pole jest wymagane. Wartość targetingOptionId elementu TargetingOption typu TARGETING_TYPE_POI.

Zaakceptowane identyfikatory opcji kierowania na ważne miejsca można pobrać przy użyciu: targetingTypes.targetingOptions.search.

Jeśli z adresu lub nazwy ciekawego miejsca chcesz usunąć określony element szerokości i długości geograficznej, możesz wygenerować niezbędny identyfikator opcji kierowania, zaokrąglając odpowiednie wartości współrzędnych do 6 miejsca po przecinku, usuwając miejsca dziesiętne i łącząc wartości w postaci ciągów rozdzielone średnikami. Możesz np. kierować reklamy na parę szerokości i długości geograficznej o wartości 40,7414691, -74,003387, używając identyfikatora opcji kierowania „40741469;-74003387”. Po utworzeniu wartości tego pola wartość tego pola zostanie zaktualizowana, tak aby zawierała średnik oraz alfanumeryczną wartość skrótu, jeśli podane są tylko współrzędne szerokości i długości geograficznej.
latitude

number

Tylko dane wyjściowe. Szerokość ciekawego miejsca w zaokrągleniu do 6 miejsca po przecinku.
longitude

number

Tylko dane wyjściowe. Długość geograficzna ważnego miejsca w zaokrągleniu do 6. miejsca po przecinku.
proximityRadiusAmount

number

To pole jest wymagane. Promień obszaru wokół ważnego miejsca, na który będzie kierowany element. Jednostki promienia są określane przez proximityRadiusUnit. Wartość musi mieścić się w przedziale od 1 do 800, jeśli jednostka to DISTANCE_UNIT_KILOMETERS, i od 1 do 500, jeśli jednostka to DISTANCE_UNIT_MILES.
proximityRadiusUnit

enum (DistanceUnit)

To pole jest wymagane. Jednostka odległości, w której mierzony jest promień kierowania.

DistanceUnit

Możliwe opcje jednostek odległości.

Wartości w polu enum
DISTANCE_UNIT_UNSPECIFIED Wartość typu nie jest określona lub jest nieznana w tej wersji.
DISTANCE_UNIT_MILES Mile.
DISTANCE_UNIT_KILOMETERS Kilometry.

BusinessChainAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania na sieć placówek firmy. Gdy targetingType ma wartość TARGETING_TYPE_BUSINESS_CHAIN, zostanie ono uzupełnione w polu szczegółów elementu AssignedKierowanieOption.

Zapis JSON 
{
  "displayName": string,
  "targetingOptionId": string,
  "proximityRadiusAmount": number,
  "proximityRadiusUnit": enum (DistanceUnit)
}
Pola
displayName

string

Tylko dane wyjściowe. Wyświetlana nazwa sieci placówek firm, np. „KFC”, „Biało dużo pieniędzy”.
targetingOptionId

string

To pole jest wymagane. Wartość targetingOptionId elementu TargetingOption typu TARGETING_TYPE_BUSINESS_CHAIN.

Akceptowane identyfikatory opcji kierowania na sieć placówek firmy można pobrać za pomocą funkcji SearchTargetingOptions.
proximityRadiusAmount

number

To pole jest wymagane. Promień obszaru wokół sieci placówek, na który będzie kierowana reklama. Jednostki promienia są określane przez proximityRadiusUnit. Wartość musi mieścić się w przedziale od 1 do 800, jeśli jednostka to DISTANCE_UNIT_KILOMETERS, i od 1 do 500, jeśli jednostka to DISTANCE_UNIT_MILES. Minimalny przyrost w obu przypadkach to 0,1. Dane wejściowe zostaną zaokrąglone do najbliższej dopuszczalnej wartości, jeśli będą zbyt szczegółowe, np. 15,57 zmieni się na 15,6.
proximityRadiusUnit

enum (DistanceUnit)

To pole jest wymagane. Jednostka odległości, w której mierzony jest promień kierowania.

ContentDurationAssignedTargetingOptionDetails

Szczegóły opcji kierowania, do której przypisano czas trwania treści. Zostanie ono wypełnione w polu contentDurationDetails, gdy targetingType będzie mieć wartość TARGETING_TYPE_CONTENT_DURATION. Bezpośrednie kierowanie na wszystkie opcje nie jest obsługiwane. Aby osiągnąć ten efekt, usuń wszystkie opcje kierowania na czas trwania treści.

Zapis JSON 
{
  "targetingOptionId": string,
  "contentDuration": enum (ContentDuration)
}
Pola
targetingOptionId

string

To pole jest wymagane. w polu targetingOptionId, gdy targetingType ma wartość TARGETING_TYPE_CONTENT_DURATION.
contentDuration

enum (ContentDuration)

Tylko dane wyjściowe. Czas trwania treści.

ContentStreamTypeAssignedTargetingOptionDetails

Szczegóły opcji kierowania przypisanej do typu strumienia treści. Zostanie ono wypełnione w polu contentStreamTypeDetails, gdy targetingType będzie mieć wartość TARGETING_TYPE_CONTENT_STREAM_TYPE. Bezpośrednie kierowanie na wszystkie opcje nie jest obsługiwane. Aby osiągnąć ten efekt, usuń wszystkie opcje kierowania na typ strumienia treści.

Zapis JSON 
{
  "targetingOptionId": string,
  "contentStreamType": enum (ContentStreamType)
}
Pola
targetingOptionId

string

To pole jest wymagane. w polu targetingOptionId, gdy targetingType ma wartość TARGETING_TYPE_CONTENT_STREAM_TYPE.
contentStreamType

enum (ContentStreamType)

Tylko dane wyjściowe. Typ strumienia treści.

NativeContentPositionAssignedTargetingOptionDetails

Szczegóły opcji kierowania przypisanej do pozycji natywnej treści. Zostanie ono wypełnione w polu nativeContentPositionDetails, gdy targetingType będzie mieć wartość TARGETING_TYPE_NATIVE_CONTENT_POSITION. Bezpośrednie kierowanie na wszystkie opcje nie jest obsługiwane. Aby osiągnąć ten efekt, usuń wszystkie opcje kierowania na pozycję treści natywnych.

Zapis JSON 
{
  "contentPosition": enum (NativeContentPosition)
}
Pola
contentPosition

enum (NativeContentPosition)

To pole jest wymagane. Pozycja treści.

OmidAssignedTargetingOptionDetails

Reprezentuje typ zasobów reklamowych z obsługą Open Measurement, na który można kierować reklamy. Gdy targetingType ma wartość TARGETING_TYPE_OMID, zostanie ono uzupełnione w polu szczegółów elementu AssignedKierowanieOption.

Zapis JSON 
{
  "omid": enum (Omid)
}
Pola
omid

enum (Omid)

To pole jest wymagane. Typ zasobów reklamowych z włączoną obsługą Open Measurement.

AudioContentTypeAssignedTargetingOptionDetails

Szczegóły opcji kierowania przypisanej do typu treści audio. Zostanie ono wypełnione w polu audioContentTypeDetails, gdy targetingType będzie mieć wartość TARGETING_TYPE_AUDIO_CONTENT_TYPE. Bezpośrednie kierowanie na wszystkie opcje nie jest obsługiwane. Aby osiągnąć ten efekt, usuń wszystkie opcje kierowania na typ treści audio.

Zapis JSON 
{
  "audioContentType": enum (AudioContentType)
}
Pola
audioContentType

enum (AudioContentType)

To pole jest wymagane. Typ treści audio.

ContentGenreAssignedTargetingOptionDetails

Szczegóły opcji kierowania przypisanej do gatunku treści. Zostanie ono wypełnione w polu contentGenreDetails, gdy targetingType będzie mieć wartość TARGETING_TYPE_CONTENT_GENRE. Bezpośrednie kierowanie na wszystkie opcje nie jest obsługiwane. Aby osiągnąć ten efekt, usuń wszystkie opcje kierowania na gatunki treści.

Zapis JSON 
{
  "targetingOptionId": string,
  "displayName": string,
  "negative": boolean
}
Pola
targetingOptionId

string

To pole jest wymagane. w polu targetingOptionId, gdy targetingType ma wartość TARGETING_TYPE_CONTENT_GENRE.
displayName

string

Tylko dane wyjściowe. Wyświetlana nazwa gatunku treści.
negative

boolean

Wskazuje, czy na tę opcję jest ustawione kierowanie wykluczające.

YoutubeVideoAssignedTargetingOptionDetails

Szczegóły opcji kierowania przypisanej do filmu w YouTube. Zostanie ono wypełnione w polu youtubeVideoDetails, gdy targetingType będzie mieć wartość TARGETING_TYPE_YOUTUBE_VIDEO.

Zapis JSON 
{
  "videoId": string,
  "negative": boolean
}
Pola
videoId

string

Identyfikator filmu w YouTube widoczny na stronie odtwarzania filmu w YouTube.
negative

boolean

Wskazuje, czy na tę opcję jest ustawione kierowanie wykluczające.

YoutubeChannelAssignedTargetingOptionDetails

Szczegóły opcji kierowania przypisanej do kanału YouTube. Zostanie ono wypełnione w polu youtubeChannelDetails, gdy targetingType będzie mieć wartość TARGETING_TYPE_YOUTUBE_CHANNEL.

Zapis JSON 
{
  "channelId": string,
  "negative": boolean
}
Pola
channelId

string

Identyfikator kanału YouTube przesyłającego lub kod kanału w YouTube.
negative

boolean

Wskazuje, czy na tę opcję jest ustawione kierowanie wykluczające.

SessionPositionAssignedTargetingOptionDetails

Szczegóły opcji kierowania przypisanej do pozycji sesji. Zostanie ono wypełnione w polu sessionPositionDetails, gdy targetingType będzie mieć wartość TARGETING_TYPE_SESSION_POSITION.

Zapis JSON 
{
  "sessionPosition": enum (SessionPosition)
}
Pola
sessionPosition

enum (SessionPosition)

Pozycja, na której reklama będzie wyświetlana w sesji.

SessionPosition

Możliwe pozycje w sesji.

Wartości w polu enum
SESSION_POSITION_UNSPECIFIED Pamiętaj, że jest to wartość zastępcza, nie wskazuje ona żadnych pozycji.
SESSION_POSITION_FIRST_IMPRESSION Pierwsze wrażenie w sesji.

Metody

get

 Pobiera jedną opcję kierowania przypisaną do kampanii.

list

 Zawiera listę opcji kierowania przypisanych do kampanii w przypadku określonego typu kierowania.