REST Resource: advertisers.adGroups.targetingTypes.assignedTargetingOptions

Zasób: AssignedKierowanieOption

Jedna 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 ramach danego zasobu i typu kierowania. Można go użyć ponownie w innych kontekstach.

assignedTargetingOptionIdAlias

string

Tylko dane wyjściowe. Alias dla grupy assignedTargetingOptionId. Tej wartości możesz użyć zamiast assignedTargetingOptionId przy pobieraniu lub usuwaniu 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 tych typów kierowania przypisanych do elementu zamówienia:

  • TARGETING_TYPE_CONTENT_INSTREAM_POSITION
  • TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
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 ze szczegółowymi informacjami, które musi odpowiadać wartości targeting_type. details może mieć tylko jedną z tych wartości:
channelDetails

object (ChannelAssignedTargetingOptionDetails)

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

appCategoryDetails

object (AppCategoryAssignedTargetingOptionDetails)

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

appDetails

object (AppAssignedTargetingOptionDetails)

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

urlDetails

object (UrlAssignedTargetingOptionDetails)

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

dayAndTimeDetails

object (DayAndTimeAssignedTargetingOptionDetails)

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

ageRangeDetails

object (AgeRangeAssignedTargetingOptionDetails)

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

regionalLocationListDetails

object (RegionalLocationListAssignedTargetingOptionDetails)

Szczegóły listy lokalizacji regionalnych. To pole zostanie zapeł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 zapełnione, gdy targetingType będzie mieć wartość TARGETING_TYPE_PROXIMITY_LOCATION_LIST.

genderDetails

object (GenderAssignedTargetingOptionDetails)

Szczegółowe informacje o płci. To pole zostanie zapełnione, gdy targetingType będzie mieć wartość TARGETING_TYPE_GENDER.

videoPlayerSizeDetails

object (VideoPlayerSizeAssignedTargetingOptionDetails)

Informacje o rozmiarze odtwarzacza wideo. To pole zostanie zapeł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 zapełnione, gdy targetingType będzie mieć wartość TARGETING_TYPE_USER_REWARDED_CONTENT.

parentalStatusDetails

object (ParentalStatusAssignedTargetingOptionDetails)

Szczegółowe informacje o statusie rodzicielskim. To pole zostanie zapełnione, gdy targetingType będzie mieć wartość TARGETING_TYPE_PARENTAL_STATUS.

contentInstreamPositionDetails

object (ContentInstreamPositionAssignedTargetingOptionDetails)

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

contentOutstreamPositionDetails

object (ContentOutstreamPositionAssignedTargetingOptionDetails)

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

deviceTypeDetails

object (DeviceTypeAssignedTargetingOptionDetails)

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

audienceGroupDetails

object (AudienceGroupAssignedTargetingOptionDetails)

Szczegóły kierowania na odbiorców. To pole zostanie zapeł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 zapełnione, gdy targetingType będzie mieć wartość TARGETING_TYPE_BROWSER.

householdIncomeDetails

object (HouseholdIncomeAssignedTargetingOptionDetails)

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

onScreenPositionDetails

object (OnScreenPositionAssignedTargetingOptionDetails)

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

carrierAndIspDetails

object (CarrierAndIspAssignedTargetingOptionDetails)

Dane operatora i dostawcy internetu. To pole zostanie zapełnione, gdy targetingType będzie mieć wartość TARGETING_TYPE_CARRIER_AND_ISP.

keywordDetails

object (KeywordAssignedTargetingOptionDetails)

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

deviceMakeModelDetails

object (DeviceMakeModelAssignedTargetingOptionDetails)

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

environmentDetails

object (EnvironmentAssignedTargetingOptionDetails)

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

inventorySourceDetails

object (InventorySourceAssignedTargetingOptionDetails)

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

categoryDetails

object (CategoryAssignedTargetingOptionDetails)

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

Kierowanie na kategorię będzie też służyć do kierowania na jej podkategorie. Jeśli kategoria jest wykluczona z kierowania i uwzględniona jest podkategoria, pierwszeństwo ma wykluczenie.

viewabilityDetails

object (ViewabilityAssignedTargetingOptionDetails)

Szczegóły widoczności. To pole zostanie zapeł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)

Informacje o stanie autoryzowanego sprzedawcy. To pole zostanie zapełnione, gdy targetingType będzie mieć wartość TARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

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

Jeśli zasób nie ma opcji stanu autoryzowanego sprzedawcy, domyślnie kierowanie są kierowane na wszystkich autoryzowanych sprzedawców oznaczonych w pliku ads.txt jako BEZPOŚREDNI lub SPRZEDAWCA.

languageDetails

object (LanguageAssignedTargetingOptionDetails)

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

geoRegionDetails

object (GeoRegionAssignedTargetingOptionDetails)

Szczegóły regionu geograficznego. To pole zostanie zapeł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 zapełnione, gdy targetingType będzie mieć wartość TARGETING_TYPE_INVENTORY_SOURCE_GROUP.

digitalContentLabelExclusionDetails

object (DigitalContentLabelAssignedTargetingOptionDetails)

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

Etykiety treści cyfrowych są związane z wykluczeniami w kierowaniu. Wykluczenia etykiet treści cyfrowych na poziomie reklamodawcy, jeśli są ustawione, są zawsze stosowane przy wyświetlaniu (nawet jeśli nie są widoczne w ustawieniach zasobu). Ustawienia zasobów mogą wykluczać etykiety treści razem z wykluczeniami reklamodawców, ale nie można 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 zapełnione, gdy targetingType będzie mieć wartość TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION.

Reklamy o charakterze kontrowersyjnym obejmują wykluczenia kierowania. Jeśli ustawisz wykluczenia kategorii reklam o charakterze kontrowersyjnym na poziomie reklamodawcy, są one zawsze stosowane przy wyświetlaniu (nawet jeśli nie są widoczne w ustawieniach zasobów). Ustawienia zasobów mogą oprócz wykluczeń reklamodawców wykluczać reklamy o charakterze kontrowersyjnym, ale nie można ich zastąpić.

exchangeDetails

object (ExchangeAssignedTargetingOptionDetails)

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

subExchangeDetails

object (SubExchangeAssignedTargetingOptionDetails)

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

thirdPartyVerifierDetails

object (ThirdPartyVerifierAssignedTargetingOptionDetails)

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

poiDetails

object (PoiAssignedTargetingOptionDetails)

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

businessChainDetails

object (BusinessChainAssignedTargetingOptionDetails)

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

contentDurationDetails

object (ContentDurationAssignedTargetingOptionDetails)

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

contentStreamTypeDetails

object (ContentStreamTypeAssignedTargetingOptionDetails)

Szczegóły dotyczące czasu trwania treści. To pole zostanie zapełnione, gdy typ kierowania będzie miał wartość TARGETING_TYPE_CONTENT_STREAM_TYPE.

nativeContentPositionDetails

object (NativeContentPositionAssignedTargetingOptionDetails)

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

omidDetails

object (OmidAssignedTargetingOptionDetails)

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

audioContentTypeDetails

object (AudioContentTypeAssignedTargetingOptionDetails)

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

contentGenreDetails

object (ContentGenreAssignedTargetingOptionDetails)

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

youtubeVideoDetails

object (YoutubeVideoAssignedTargetingOptionDetails)

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

youtubeChannelDetails

object (YoutubeChannelAssignedTargetingOptionDetails)

Informacje o kanale w YouTube. To pole zostanie zapełnione, gdy targetingType będzie mieć wartość TARGETING_TYPE_YOUTUBE_CHANNEL.

sessionPositionDetails

object (SessionPositionAssignedTargetingOptionDetails)

Szczegóły pozycji sesji. To pole zostanie zapeł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 lub reklamodawcy. Dziedziczone przypisane opcje kierowania mają pierwszeństwo, są zawsze stosowane w przypadku wyświetlania zamiast kierowania przypisanego na bieżącym poziomie i nie można ich modyfikować w bieżącej usłudze encji. Należy je zmodyfikować za pomocą usługi encji, z której są dziedziczone. Dziedziczenie obowiązuje tylko w przypadku wykluczeń kanałów z kierowaniem wykluczającym, 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 ona wypełniona w polu szczegółów obiektu AssignedKierowanieOption.

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

string (int64 format)

Wymagane. Identyfikator kanału. Wartość powinna odnosić się do pola identyfikatora kanału w zasobie kanału należącego do partnera lub kanału należącego do reklamodawcy.

negative

boolean

Wskazuje, czy ta opcja jest kierowana negatywnie. W przypadku opcji kierowania przypisanego na poziomie reklamodawcy to pole musi mieć wartość true (prawda).

AppCategoryAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania na kategorię aplikacji. Gdy targetingType ma wartość TARGETING_TYPE_APP_CATEGORY, zostanie ona zapełniona w polu appCategoryDetails obiektu AssignedKierowanieOption.

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

string

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

targetingOptionId

string

Wymagane. Pole targetingOptionId, gdy targetingType ma wartość TARGETING_TYPE_APP_CATEGORY.

negative

boolean

Wskazuje, czy ta opcja jest kierowana negatywnie.

AppAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania na aplikację. Gdy targetingType ma wartość TARGETING_TYPE_APP, zostanie ona wypełniona w polu szczegółów obiektu AssignedKierowanieOption.

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

string

Wymagane. Identyfikator aplikacji.

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

displayName

string

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

negative

boolean

Wskazuje, czy ta opcja jest kierowana negatywnie.

appPlatform

enum (AppPlatform)

Wskazuje platformę aplikacji docelowej. Jeśli nie określisz tego pola, przyjmujemy, że platforma aplikacji jest mobilna (tzn. Androida lub iOS), a odpowiednią platformę mobilną naliczymy z identyfikatora aplikacji.

Platforma aplikacji

Możliwe opcje kierowania na platformę aplikacji.

Wartości w polu enum
APP_PLATFORM_UNSPECIFIED Wartość domyślna, jeśli platforma aplikacji nie jest określona w tej wersji. Ta wartość enum jest symbolem zastępczym wartości domyślnej i nie odzwierciedla 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 Platforma aplikacji to Playstation.
APP_PLATFORM_APPLE_TV Platforma aplikacji to 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.
APP_PLATFORM_LG_TV Platforma aplikacji to LG TV.
APP_PLATFORM_VIZIO_TV Platforma aplikacji to VIZIO TV.

UrlAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania na adres URL. Gdy targetingType ma wartość TARGETING_TYPE_URL, zostanie ona wypełniona w polu szczegółów obiektu AssignedKierowanieOption.

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

string

Wymagane. Adres URL, na przykład 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 ta opcja jest kierowana negatywnie.

DayAndTimeAssignedTargetingOptionDetails

Reprezentacja przedziału czasu zdefiniowanego w konkretnym dniu tygodnia oraz godziny rozpoczęcia i zakończenia. Czas podany w polu startHour musi przypadać przed czasem przedstawionym przez endHour.

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

enum (DayOfWeek)

Wymagane. Dzień tygodnia dla tego ustawienia kierowania na dzień i godzinę.

startHour

integer

Wymagane. Godzina rozpoczęcia kierowania na dzień i godzinę. Musi mieścić się w przedziale od 0 (początek dnia) do 23 (godzinę przed końcem dnia).

endHour

integer

Wymagane. Godzina końcowa kierowania na dzień i godzinę. Musi mieć wartość z zakresu od 1 (godzina po rozpoczęciu dnia) do 24 (koniec dnia).

timeZoneResolution

enum (TimeZoneResolution)

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ę.

DzieńTygodnia

Przedstawia dzień tygodnia.

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

TimeZoneResolution

Możliwe sposoby rozwiązania problemu ze strefą czasową.

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 w strefie czasowej użytkownika, który widział reklamę.
TIME_ZONE_RESOLUTION_ADVERTISER Czas jest podawany 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 ona wypełniona w polu szczegółów obiektu AssignedKierowanieOption.

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

enum (AgeRange)

Wymagane. Przedział wiekowy odbiorców. Obsługujemy tylko kierowanie na odbiorców o stałym przedziale wiekowym. Zatem przedział wiekowy reprezentowany w tym polu może być 1) kierowany wyłącznie lub 2) częścią większego stałego przedziału wiekowego. Zasięg takiego kierowania można zwiększyć, kierując reklamy na odbiorców w nieznanym wieku.

RegionalLocationListAssignedTargetingOptionDetails

Szczegóły kierowania dla listy lokalizacji regionalnych. Gdy targetingType ma wartość TARGETING_TYPE_REGIONAL_LOCATION_LIST, zostanie ona wypełniona w polu szczegółów obiektu AssignedKierowanieOption.

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

string (int64 format)

Wymagane. Identyfikator listy lokalizacji regionalnych. Powinna odnosić się do pola locationListId zasobu LocationList, którego typ to TARGETING_LOCATION_TYPE_REGIONAL.

negative

boolean

Wskazuje, czy ta opcja jest kierowana negatywnie.

ProximityLocationListAssignedTargetingOptionDetails

Szczegóły kierowania na listę przybliżonych lokalizacji. Gdy targetingType ma wartość TARGETING_TYPE_PROXIMITY_LOCATION_LIST, zostanie ona wypełniona w polu szczegółów obiektu AssignedKierowanieOption.

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

string (int64 format)

Wymagane. Identyfikator listy lokalizacji przybliżonych. Powinna odnosić się do pola locationListId zasobu LocationList, którego typ to TARGETING_LOCATION_TYPE_PROXIMITY.

proximityRadius

number

Wymagane. Promień wyrażony w jednostkach odległości ustawionych jako proximityRadiusUnit. Reprezentuje on wielkość obszaru wokół wybranej lokalizacji, na którą będzie kierowana reklama. Promień powinien się mieścić w przedziale od 1 do 500 mil lub 800 kilometrów.

proximityRadiusUnit

enum (ProximityRadiusUnit)

Wymagane. Jednostki długości promienia.

ProximityRadiusUnit

Enum jednostek odległości dla promienia zbliżonego.

Wartości w polu enum
PROXIMITY_RADIUS_UNIT_UNSPECIFIED Wartość domyślna, gdy jednostki odległości nie są określone w tej wersji. To wyliczenie zajmuje miejsce 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 odległości w kilometrach

GenderAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania na płeć. Gdy targetingType ma wartość TARGETING_TYPE_GENDER, zostanie ona wypełniona w polu szczegółów obiektu AssignedKierowanieOption.

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

enum (Gender)

Wymagane. Płeć odbiorców.

VideoPlayerSizeAssignedTargetingOptionDetails

Szczegóły opcji kierowania na rozmiar odtwarzacza wideo. Gdy targetingType ma wartość TARGETING_TYPE_VIDEO_PLAYER_SIZE, pole videoPlayerSizeDetails zostanie wypełnione. Jednoznaczne kierowanie na wszystkie opcje nie jest obsługiwane. Aby osiągnąć ten efekt, usuń wszystkie opcje kierowania na rozmiar odtwarzacza.

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

enum (VideoPlayerSize)

Wymagane. Rozmiar odtwarzacza wideo.

UserRewardedContentAssignedTargetingOptionDetails

Szczegóły opcji kierowania na treści z nagrodą dla użytkowników. Gdy targetingType ma wartość TARGETING_TYPE_USER_REWARDED_CONTENT, pole userRewardedContentDetails zostanie wypełnione.

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

string

Wymagane. Pole 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 przypisanej opcji kierowania na status rodzicielski. Gdy targetingType ma wartość TARGETING_TYPE_PARENTAL_STATUS, zostanie ona wypełniona w polu szczegółów obiektu AssignedKierowanieOption.

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

enum (ParentalStatus)

Wymagane. Status rodzicielski odbiorców.

ContentInstreamPositionAssignedTargetingOptionDetails

Szczegóły opcji kierowania na pozycję In-Stream przypisanych treści. Gdy targetingType ma wartość TARGETING_TYPE_CONTENT_INSTREAM_POSITION, pole contentInstreamPositionDetails zostanie wypełnione.

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

enum (ContentInstreamPosition)

Wymagane. Pozycja In-Stream z treścią w przypadku reklam wideo lub audio.

adType

enum (AdType)

Tylko dane wyjściowe. Typ reklamy, na którą chcesz kierować reklamy. Tę opcję kierowania będą domyślnie dziedziczyć tylko w przypadku kierowania zamówień reklamowych, a nowe elementy zamówienia obsługujące określony typ reklamy odziedziczą domyślnie tę opcję. Możliwe wartości to:

  • AD_TYPE_VIDEO, to ustawienie zostanie odziedziczone przez nowy element zamówienia, gdy pole lineItemType będzie miało wartość LINE_ITEM_TYPE_VIDEO_DEFAULT.
  • AD_TYPE_AUDIO, to ustawienie zostanie odziedziczone przez nowy element zamówienia, gdy pole lineItemType będzie miało wartość 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. obrazu i HTML5.
AD_TYPE_VIDEO Kreacje wideo, np. reklamy wideo wyświetlane podczas strumieniowego przesyłania treści w odtwarzaczach.
AD_TYPE_AUDIO Kreacje audio, np. reklam audio odtwarzanych w treściach audio.

ContentOutstreamPositionAssignedTargetingOptionDetails

Szczegóły opcji kierowania na pozycję Out-Stream w przypadku przypisanych treści. Gdy targetingType ma wartość TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION, pole contentOutstreamPositionDetails zostanie wypełnione.

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

enum (ContentOutstreamPosition)

Wymagane. Pozycja treści Out-Stream.

adType

enum (AdType)

Tylko dane wyjściowe. Typ reklamy, na którą chcesz kierować reklamy. Tę opcję kierowania będą domyślnie dziedziczyć tylko w przypadku kierowania zamówień reklamowych, a nowe elementy zamówienia obsługujące określony typ reklamy odziedziczą domyślnie tę opcję. Możliwe wartości to:

  • AD_TYPE_DISPLAY, to ustawienie zostanie odziedziczone przez nowy element zamówienia, gdy pole lineItemType będzie miało wartość LINE_ITEM_TYPE_DISPLAY_DEFAULT.
  • AD_TYPE_VIDEO, to ustawienie zostanie odziedziczone przez nowy element zamówienia, gdy pole lineItemType będzie miało wartość LINE_ITEM_TYPE_VIDEO_DEFAULT.

DeviceTypeAssignedTargetingOptionDetails

Szczegóły kierowania według typu urządzenia. Gdy targetingType ma wartość TARGETING_TYPE_DEVICE_TYPE, zostanie ona wypełniona w polu szczegółów obiektu AssignedKierowanieOption.

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

enum (DeviceType)

Wymagane. Wyświetlana nazwa typu urządzenia.

youtubeAndPartnersBidMultiplier

number

Tylko dane wyjściowe. Mnożnik stawki pozwala zmieniać częstotliwość wyświetlania reklam w zależności od typu urządzenia. Pierwotna stawka zostanie zastosowana do mnożnika pierwotnej stawki. Gdy to pole ma wartość 0, oznacza to, że pole nie ma zastosowania, zamiast mnożyć 0 w ramach pierwotnej stawki.

Jeśli np. stawka bez mnożnika wynosi 10 zł, a mnożnik 1,5 w przypadku tabletu, wynikowa stawka za tablet wyniesie 15 zł.

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 ona wypełniona w polu szczegółów obiektu AssignedKierowanieOption. Relacja między grupami to UNION, z wyjątkiem grup wykluczonychFirstAndThirdPartyAudienceGroup i excludedGoogleAudienceGroup, których wartość COMPLEMENT jest używana jako punkt wyjścia 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 i listy odbiorców dostarczone przez firmę zewnętrzną oraz własne identyfikatory odbiorców uwzględnione w grupach odbiorców własnych i innych firm. Każda grupa odbiorców (własna i dostarczona przez firmę zewnętrzną) zawiera tylko własne identyfikatory odbiorców i identyfikatory innych firm. Związek między własną grupą odbiorców a grupą odbiorców innej firmy jest sprecyzowany na INTERSECTION – w rezultacie powstaje UNION z innymi grupami odbiorców. Powtarzające się grupy z tymi samymi ustawieniami zostaną zignorowane.

includedGoogleAudienceGroup

object (GoogleAudienceGroup)

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

includedCustomListGroup

object (CustomListGroup)

Identyfikatory niestandardowych list uwzględnionych w grupie niestandardowej. Zawiera tylko niestandardowe identyfikatory list.

includedCombinedAudienceGroup

object (CombinedAudienceGroup)

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

excludedFirstAndThirdPartyAudienceGroup

object (FirstAndThirdPartyAudienceGroup)

Identyfikatory i odbiorcy z wykluczonej grupy odbiorców (własnej i innej firmy) oraz identyfikatory odbiorców dostarczone przez inną firmę. Służy do kierowania wykluczającego. Uzupełnienie UNION tej grupy i innych wykluczonych grup odbiorców służy jako punkt wyjścia dla pozytywnego kierowania na odbiorców. Wszystkie elementy są za siebie logicznie połączone operatorem LUB.

excludedGoogleAudienceGroup

object (GoogleAudienceGroup)

Identyfikatory odbiorców Google w wykluczonej grupie odbiorców Google. Służy do kierowania wykluczającego. Uzupełnienie UNION tej grupy i innych wykluczonych grup odbiorców służy jako punkt wyjścia dla pozytywnego kierowania na odbiorców. Zawiera tylko odbiorców Google o podobnych zainteresowaniach, na odbiorców na rynku i w zainstalowanych aplikacjach. Wszystkie elementy są za siebie 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łasne i innych firm są połączone operatorem logicznym „LUB”.

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

object (FirstAndThirdPartyAudienceTargetingSetting)

Wymagane. Wszystkie ustawienia kierowania na odbiorców własne i innych firm w grupie odbiorców własnej i grupie odbiorców dostarczonych przez inną firmę. Powtarzające się ustawienia o tym samym identyfikatorze są niedozwolone.

FirstAndThirdPartyAudienceTargetingSetting

Szczegółowe informacje o ustawieniu kierowania na odbiorców własnych i dostarczanych przez inne firmy.

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

string (int64 format)

Wymagane. Identyfikatory odbiorców własnych i innych firm dla ustawienia kierowania na odbiorców własnych i dostarczonych przez inną firmę. Ten identyfikator: firstAndThirdPartyAudienceId.

recency

enum (Recency)

Czas od poprzedniego ustawienia kierowania na odbiorców własnych i innych firm. Dotyczy tylko własnych list odbiorców. W przeciwnym razie zostanie zignorowana. Więcej informacji znajdziesz na stronie https://support.google.com/displayvideo/answer/2949947#recency Jeśli nie określono limitu czasu od poprzedniej wizyty, nie jest stosowany żaden limit.

Czas od poprzedniej wizyty

Wszystkie obsługiwane wartości czasu od poprzedniej wizyty (własnej i innej firmy).

Wartości w polu enum
RECENCY_NO_LIMIT Brak limitu czasu od poprzedniej wizyty.
RECENCY_1_MINUTE Czas od poprzedniej wizyty to 1 minuta.
RECENCY_5_MINUTES Czas od poprzedniej wizyty to 5 minut.
RECENCY_10_MINUTES Czas od poprzedniej wizyty to 10 minut.
RECENCY_15_MINUTES Czas od poprzedniej wizyty to 15 minut.
RECENCY_30_MINUTES Czas od poprzedniej wizyty to 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 to 12 godzin.
RECENCY_1_DAY Czas od poprzedniej wizyty to 1 dzień.
RECENCY_2_DAYS Czas od poprzedniej wizyty to 2 dni.
RECENCY_3_DAYS Czas od poprzedniej wizyty to 3 dni.
RECENCY_5_DAYS Czas od poprzedniej wizyty to 5 dni.
RECENCY_7_DAYS Czas od poprzedniej wizyty to 7 dni.
RECENCY_10_DAYS Czas od poprzedniej wizyty to 10 dni.
RECENCY_14_DAYS Czas od poprzedniej wizyty to 14 dni.
RECENCY_15_DAYS Czas od poprzedniej wizyty to 15 dni.
RECENCY_21_DAYS Czas od poprzedniej wizyty to 21 dni.
RECENCY_28_DAYS Czas od poprzedniej wizyty to 28 dni.
RECENCY_30_DAYS Czas od poprzedniej wizyty to 30 dni.
RECENCY_40_DAYS Czas od poprzedniej wizyty to 40 dni.
RECENCY_45_DAYS Czas od poprzedniej wizyty to 45 dni.
RECENCY_60_DAYS Czas od poprzedniej wizyty to 60 dni.
RECENCY_90_DAYS Czas od poprzedniej wizyty to 90 dni.
RECENCY_120_DAYS Czas od poprzedniej wizyty to 120 dni.
RECENCY_180_DAYS Czas od poprzedniej wizyty to 180 dni.
RECENCY_270_DAYS Czas od poprzedniej wizyty to 270 dni.
RECENCY_365_DAYS Czas od poprzedniej wizyty to 365 dni.

GoogleAudienceGroup

Szczegóły grupy odbiorców Google. Wszystkie ustawienia kierowania na odbiorców zdefiniowanych przez Google są połączone operatorem logicznym „LUB”.

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

object (GoogleAudienceTargetingSetting)

Wymagane. Wszystkie ustawienia kierowania na odbiorców Google w grupie odbiorców Google. Powtarzające się ustawienia z tym samym identyfikatorem zostaną zignorowane.

GoogleAudienceTargetingSetting

Szczegóły ustawienia kierowania na odbiorców Google.

Zapis JSON
{
  "googleAudienceId": string
}
Pola
googleAudienceId

string (int64 format)

Wymagane. Identyfikator odbiorców Google określony w ustawieniu kierowania na odbiorców Google. Ten identyfikator: googleAudienceId.

CustomListGroup

Szczegóły niestandardowej grupy list. Wszystkie ustawienia kierowania na listy niestandardowe są logicznie połączone ze sobą za pomocą operatora logicznego „LUB”.

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

object (CustomListTargetingSetting)

Wymagane. Wszystkie ustawienia kierowania na listy niestandardowe w grupie list niestandardowych. Powtarzające się ustawienia z tym samym identyfikatorem zostaną zignorowane.

CustomListTargetingSetting

Szczegóły ustawienia kierowania na niestandardowe listy.

Zapis JSON
{
  "customListId": string
}
Pola
customListId

string (int64 format)

Wymagane. Identyfikator niestandardowy ustawienia kierowania na listy niestandardowe. Ten identyfikator: customListId.

CombinedAudienceGroup

Szczegóły grupy odbiorców z połączonych list. Wszystkie połączone ustawienia kierowania na odbiorców są logicznie połączone ze sobą za pomocą operatora logicznego „LUB”.

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

object (CombinedAudienceTargetingSetting)

Wymagane. Wszystkie ustawienia kierowania na odbiorców z połączonych list w grupie odbiorców z połączonych list. Powtarzające się ustawienia z tym samym identyfikatorem zostaną zignorowane. Liczba ustawień odbiorców z połączonych list nie może być większa niż 5. W przeciwnym razie wystąpi błąd.

CombinedAudienceTargetingSetting

Szczegóły ustawienia kierowania na odbiorców z połączonych list.

Zapis JSON
{
  "combinedAudienceId": string
}
Pola
combinedAudienceId

string (int64 format)

Wymagane. Identyfikator grupy odbiorców z połączonych list w ustawieniu kierowania na odbiorców z połączonych list. Ten identyfikator: combinedAudienceId.

BrowserAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania na przeglądarkę. Gdy targetingType ma wartość TARGETING_TYPE_BROWSER, zostanie ona wypełniona w polu szczegółów obiektu AssignedKierowanieOption.

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

string

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

targetingOptionId

string

Wymagane. targetingOptionId obiektu TargetingOption typu TARGETING_TYPE_BROWSER.

negative

boolean

Wskazuje, czy ta opcja jest kierowana negatywnie. Wszystkie opcje kierowania na przeglądarkę przypisane do tego samego zasobu muszą mieć tę samą wartość w tym polu.

HouseholdIncomeAssignedTargetingOptionDetails

Szczegóły opcji kierowania na przypisany dochód gospodarstwa domowego. Gdy targetingType ma wartość TARGETING_TYPE_HOUSEHOLD_INCOME, zostanie ona wypełniona w polu szczegółów obiektu AssignedKierowanieOption.

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

enum (HouseholdIncome)

Wymagane. Dochód gospodarstwa domowego odbiorców.

OnScreenPositionAssignedTargetingOptionDetails

Szczegóły opcji kierowania na pozycję na ekranie. Gdy targetingType ma wartość TARGETING_TYPE_ON_SCREEN_POSITION, pole onScreenPositionDetails zostanie wypełnione.

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

string

Wymagane. Pole 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ą chcesz kierować reklamy. Tę opcję kierowania będą domyślnie dziedziczyć tylko w przypadku kierowania zamówień reklamowych, a nowe elementy zamówienia obsługujące określony typ reklamy odziedziczą domyślnie tę opcję. Możliwe wartości to:

  • AD_TYPE_DISPLAY, to ustawienie zostanie odziedziczone przez nowy element zamówienia, gdy pole lineItemType będzie miało wartość LINE_ITEM_TYPE_DISPLAY_DEFAULT.
  • AD_TYPE_VIDEO, to ustawienie zostanie odziedziczone przez nowy element zamówienia, gdy pole lineItemType będzie miało wartość LINE_ITEM_TYPE_VIDEO_DEFAULT.

CarrierAndIspAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania na operatora sieci komórkowej i dostawcę usług internetowych. Gdy targetingType ma wartość TARGETING_TYPE_CARRIER_AND_ISP, zostanie ona wypełniona w polu szczegółów obiektu 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

Wymagane. targetingOptionId obiektu TargetingOption typu TARGETING_TYPE_CARRIER_AND_ISP.

negative

boolean

Wskazuje, czy ta opcja jest kierowana negatywnie. Wszystkie opcje kierowania na operatora sieci komórkowej i dostawcę usług internetowych w ramach tego samego zasobu muszą mieć tę samą wartość w tym polu.

KeywordAssignedTargetingOptionDetails

Szczegóły powiązanej opcji kierowania na słowa kluczowe. Gdy targetingType ma wartość TARGETING_TYPE_KEYWORD, zostanie ona wypełniona w polu szczegółów obiektu AssignedKierowanieOption.

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

string

Wymagane. Słowo kluczowe, np. car insurance.

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

negative

boolean

Wskazuje, czy ta opcja jest kierowana negatywnie.

NegativeKeywordListAssignedTargetingOptionDetails

Szczegóły kierowania na listę wykluczających słów kluczowych. Gdy targetingType ma wartość TARGETING_TYPE_NEGATIVE_KEYWORD_LIST, zostanie ona wypełniona w polu szczegółów obiektu AssignedKierowanieOption.

Zapis JSON
{
  "negativeKeywordListId": string
}
Pola
negativeKeywordListId

string (int64 format)

Wymagane. Identyfikator listy wykluczających słów kluczowych. Powinna odnosić się do pola negativeKeywordListId zasobu NegativeKeywordList.

OperatingSystemAssignedTargetingOptionDetails

Szczegóły opcji kierowania na przypisany system operacyjny. Gdy targetingType ma wartość TARGETING_TYPE_OPERATING_SYSTEM, pole operatingSystemDetails zostanie wypełnione.

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

string

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

targetingOptionId

string

Wymagane. Identyfikator opcji kierowania wypełniany w polu targetingOptionId, gdy targetingType ma wartość TARGETING_TYPE_OPERATING_SYSTEM.

negative

boolean

Wskazuje, czy ta opcja jest kierowana negatywnie.

DeviceMakeModelAssignedTargetingOptionDetails

Szczegóły opcji kierowania na markę i model przypisanego urządzenia. Gdy targetingType ma wartość TARGETING_TYPE_DEVICE_MAKE_MODEL, pole deviceMakeModelDetails zostanie wypełnione.

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

Wymagane. Pole targetingOptionId, gdy targetingType ma wartość TARGETING_TYPE_DEVICE_MAKE_MODEL.

negative

boolean

Wskazuje, czy ta opcja jest kierowana negatywnie.

EnvironmentAssignedTargetingOptionDetails

Szczegóły opcji kierowania na środowisko. Gdy targetingType ma wartość TARGETING_TYPE_ENVIRONMENT, zostanie ona wypełniona w polu szczegółów obiektu AssignedKierowanieOption.

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

enum (Environment)

Wymagane. Środowisko obsługi.

InventorySourceAssignedTargetingOptionDetails

Szczegóły kierowania dla źródła zasobów reklamowych. Gdy targetingType ma wartość TARGETING_TYPE_INVENTORY_SOURCE, zostanie ona wypełniona w polu szczegółów obiektu AssignedKierowanieOption.

Zapis JSON
{
  "inventorySourceId": string
}
Pola
inventorySourceId

string (int64 format)

Wymagane. Identyfikator źródła zasobów reklamowych. Powinna odnosić się do pola inventorySourceId zasobu InventorySource.

CategoryAssignedTargetingOptionDetails

Szczegóły opcji kierowania na kategorię. Gdy targetingType ma wartość TARGETING_TYPE_CATEGORY, pole categoryDetails zostanie wypełnione.

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

string

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

targetingOptionId

string

Wymagane. Pole targetingOptionId, gdy targetingType ma wartość TARGETING_TYPE_CATEGORY.

negative

boolean

Wskazuje, czy ta opcja jest kierowana negatywnie.

ViewabilityAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania według widoczności. Gdy targetingType ma wartość TARGETING_TYPE_VIEWABILITY, zostanie ona zapełniona w polu viewabilityDetails obiektu AssignedKierowanieOption.

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

enum (Viewability)

Wymagane. Prognozowany odsetek widoczności.

AuthorizedSellerStatusAssignedTargetingOptionDetails

Reprezentuje przypisany stan autoryzowanego sprzedawcy. Gdy targetingType ma wartość TARGETING_TYPE_AUTHORIZED_SELLER_STATUS, zostanie ona wypełniona w polu szczegółów obiektu AssignedKierowanieOption.

Jeśli zasób nie ma przypisanej opcji kierowania TARGETING_TYPE_AUTHORIZED_SELLER_STATUS, oznacza to, że jest używany przez „Autoryzowani sprzedawcy bezpośredni i pośredni”. .

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

enum (AuthorizedSellerStatus)

Tylko dane wyjściowe. Stan autoryzowanego sprzedawcy, na który chcesz kierować reklamy.

targetingOptionId

string

Wymagane. targetingOptionId obiektu TargetingOption typu TARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

LanguageAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania na język. Gdy targetingType ma wartość TARGETING_TYPE_LANGUAGE, zostanie ona wypełniona w polu szczegółów obiektu 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

Wymagane. targetingOptionId obiektu TargetingOption typu TARGETING_TYPE_LANGUAGE.

negative

boolean

Wskazuje, czy ta opcja jest kierowana negatywnie. Wszystkie opcje kierowania na język przypisane do tego samego zasobu 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 ona wypełniona w polu szczegółów obiektu 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

Wymagane. targetingOptionId obiektu TargetingOption typu TARGETING_TYPE_GEO_REGION.

geoRegionType

enum (GeoRegionType)

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

negative

boolean

Wskazuje, czy ta opcja jest kierowana negatywnie.

InventorySourceGroupAssignedTargetingOptionDetails

Szczegóły kierowania dla grupy źródeł zasobów reklamowych. Gdy targetingType ma wartość TARGETING_TYPE_INVENTORY_SOURCE_GROUP, zostanie ona wypełniona w polu szczegółów obiektu AssignedKierowanieOption.

Zapis JSON
{
  "inventorySourceGroupId": string
}
Pola
inventorySourceGroupId

string (int64 format)

Wymagane. Identyfikator grupy źródeł zasobów reklamowych. Powinna odnosić się do pola inventorySourceGroupId zasobu InventorySourceGroup.

DigitalContentLabelAssignedTargetingOptionDetails

Szczegóły kierowania dla oznaczenia treści cyfrowych. Gdy targetingType ma wartość TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION, zostanie ona wypełniona w polu szczegółów obiektu AssignedKierowanieOption.

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

enum (ContentRatingTier)

Wymagane. Wyświetlana nazwa poziomu oceny etykiet treści cyfrowych do WYKLUCZENIA.

SensitiveCategoryAssignedTargetingOptionDetails

Szczegóły kierowania dotyczące kategorii reklam o charakterze kontrowersyjnym. Gdy targetingType ma wartość TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION, zostanie ona wypełniona w polu szczegółów obiektu AssignedKierowanieOption.

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

enum (SensitiveCategory)

Wymagane. Wartości dotyczące treści o charakterze kontrowersyjnym w DV360 sklasyfikowanych jako WYKLUCZONE.

ExchangeAssignedTargetingOptionDetails

Szczegóły opcji kierowania przypisanej giełdy. Gdy targetingType ma wartość TARGETING_TYPE_EXCHANGE, zostanie ona wypełniona w polu szczegółów obiektu AssignedKierowanieOption.

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

enum (Exchange)

Wymagane. Wartość enum dla giełdy.

SubExchangeAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania na giełdy podrzędne. Gdy targetingType ma wartość TARGETING_TYPE_SUB_EXCHANGE, zostanie ona wypełniona w polu szczegółów obiektu AssignedKierowanieOption.

Zapis JSON
{
  "targetingOptionId": string
}
Pola
targetingOptionId

string

Wymagane. targetingOptionId obiektu TargetingOption typu TARGETING_TYPE_SUB_EXCHANGE.

ThirdPartyVerifierAssignedTargetingOptionDetails

Szczegóły opcji kierowania na weryfikatora zewnętrznego. Gdy targetingType ma wartość TARGETING_TYPE_THIRD_PARTY_VERIFIER, zostanie ona wypełniona w polu szczegółów obiektu 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że kierować reklamy na jednego z zewnętrznych weryfikatorów, aby egzekwować progi bezpieczeństwa marki dotyczące wyświetleń. verifier może mieć tylko jedną z tych wartości:
adloox

object (Adloox)

Zewnętrzny weryfikator marki – Adloox.

doubleVerify

object (DoubleVerify)

Zewnętrzny weryfikator marki – DoubleVerify.

integralAdScience

object (IntegralAdScience)

Zewnętrzny weryfikator marki – Integral Ad Science.

Adloox

Szczegóły ustawień Adloox.

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

enum (AdlooxCategory)

Ustawienia bezpieczeństwa marki w Adloox.

AdlooxCategory

Możliwe opcje Adloox.

Wartości w polu enum
ADLOOX_UNSPECIFIED Jest ona tylko zmienną i nie określa żadnej 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 przedstawiające przemoc broni.
LOW_VIEWABILITY_DOMAINS Domeny o niskiej widoczności.
FRAUD Oszustwo.

DoubleVerify

Szczegóły ustawień 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 DV.

avoidedAgeRatings[]

enum (AgeRating)

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

appStarRating

object (AppStarRating)

Unikaj licytowania aplikacji z oceną w gwiazdkach.

displayViewability

object (DisplayViewability)

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

videoViewability

object (VideoViewability)

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

fraudInvalidTraffic

object (FraudInvalidTraffic)

Unikanie witryn i aplikacji z historycznymi oszustwami wartości nieprawidłowego ruchu.

customSegmentId

string (int64 format)

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

BrandSafetyCategories

Ustawienia kontroli bezpieczeństwa marki.

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

boolean

Nieznane lub niesklasyfikowane.

avoidedHighSeverityCategories[]

enum (HighSeverityCategory)

Kategorie unikania o wysokiej wadze związane z bezpieczeństwem marki.

avoidedMediumSeverityCategories[]

enum (MediumSeverityCategory)

Bezpieczeństwo marki – kategorie unikania o średniej wadze.

HighSeverityCategory

Możliwe opcje dla kategorii o dużej ważności.

Wartości w polu enum
HIGHER_SEVERITY_UNSPECIFIED Jest ona tylko zmienną i nie określa żadnych kategorii o dużej 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/środki odurzające: 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: umiejętności przestępcze.
NUISANCE_INCENTIVIZED_MALWARE_CLUTTER Stosowanie zachęt/złośliwe oprogramowanie/natłok reklam.

MediumSeverityCategory

Możliwe opcje dla kategorii o średniej ważności.

Wartości w polu enum
MEDIUM_SEVERITY_UNSPECIFIED Jest ona tylko zmienną i nie określa żadnych kategorii o średniej ważności.
AD_SERVERS Serwery reklam.
ADULT_CONTENT_SWIMSUIT Treści dla dorosłych: kostiumy 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 Katastrofy: akty 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: zaparkowanie.
UNMODERATED_UGC Niemoderowane treści generowane przez użytkowników: fora, obrazy i Film
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 klasyfikacji wiekowej.

Wartości w polu enum
AGE_RATING_UNSPECIFIED Jest ona tylko wartością zastępczą i nie określa żadnych opcji kategorii wiekowej.
APP_AGE_RATE_UNKNOWN Aplikacje o nieznanej klasyfikacji 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 (od 12 lat).
APP_AGE_RATE_17_PLUS Aplikacje dla dorosłych (od 17 lat).
APP_AGE_RATE_18_PLUS Aplikacje przeznaczone tylko dla dorosłych (powyżej 18 lat).

AppStarRating

Szczegółowe informacje o ustawieniach oceny w gwiazdkach w DoubleVerify.

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

enum (StarRating)

Unikaj licytowania aplikacji z oceną w gwiazdkach.

avoidInsufficientStarRating

boolean

Unikaj licytowania aplikacji z niewystarczającą liczbą gwiazdek.

StarRating

Możliwe opcje oceny w postaci gwiazdek.

Wartości w polu enum
APP_STAR_RATE_UNSPECIFIED Jest ona 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ą < 1,5 gwiazdki.
APP_STAR_RATE_2_LESS Oficjalne aplikacje z oceną < 2 gwiazdki.
APP_STAR_RATE_2_POINT_5_LESS Oficjalne aplikacje z oceną < 2,5 gwiazdki.
APP_STAR_RATE_3_LESS Oficjalne aplikacje z oceną < 3 gwiazdki.
APP_STAR_RATE_3_POINT_5_LESS Oficjalne aplikacje z oceną < 3,5 gwiazdki.
APP_STAR_RATE_4_LESS Oficjalne aplikacje z oceną < 4 gwiazdki.
APP_STAR_RATE_4_POINT_5_LESS Oficjalne aplikacje z oceną < 4,5 gwiazdki.

DisplayViewability

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

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

enum (IAB)

Kieruj reklamy na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować współczynnik widoczności IAB.

viewableDuring

enum (ViewableDuring)

Kieruj reklamy na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować czas wyświetlania widocznych w 100%.

IAB

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

Wartości w polu enum
IAB_VIEWED_RATE_UNSPECIFIED Jest ona tylko wartością zastępczą i nie określa żadnych opcji stawki liczby wyświetleń IAB.
IAB_VIEWED_RATE_80_PERCENT_HIGHER Kieruj reklamy na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 80%.
IAB_VIEWED_RATE_75_PERCENT_HIGHER Kieruj reklamy na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 75%.
IAB_VIEWED_RATE_70_PERCENT_HIGHER Kieruj reklamy na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 70%.
IAB_VIEWED_RATE_65_PERCENT_HIGHER Kieruj reklamy na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 65%.
IAB_VIEWED_RATE_60_PERCENT_HIGHER Kieruj reklamy na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 60%.
IAB_VIEWED_RATE_55_PERCENT_HIGHER Kieruj reklamy na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 55%.
IAB_VIEWED_RATE_50_PERCENT_HIGHER Kieruj reklamy na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 50%.
IAB_VIEWED_RATE_40_PERCENT_HIGHER Kieruj reklamy na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 40%.
IAB_VIEWED_RATE_30_PERCENT_HIGHER Kieruj reklamy na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 30%.

ViewableDuring

Możliwe opcje dotyczące czasu trwania widocznych reklam.

Wartości w polu enum
AVERAGE_VIEW_DURATION_UNSPECIFIED Jest ona tylko zmienną i nie określa żadnych opcji średniego czasu oglądania.
AVERAGE_VIEW_DURATION_5_SEC Kieruj reklamy na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować czas widoczności reklamy wynoszący co najmniej 5 sekund.
AVERAGE_VIEW_DURATION_10_SEC Kieruj reklamy na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować czas widoczności reklamy wynoszący 100%, który wynosi co najmniej 10 sekund.
AVERAGE_VIEW_DURATION_15_SEC Kieruj reklamy na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować czas widoczności reklamy wynoszący co najmniej 15 sekund.

VideoViewability

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

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

enum (VideoIAB)

Kieruj na internetowe zasoby reklamowe, aby zmaksymalizować współczynnik widoczności IAB.

videoViewableRate

enum (VideoViewableRate)

Kieruj na internetowe zasoby reklamowe, aby zmaksymalizować współczynnik pełnej widoczności.

playerImpressionRate

enum (PlayerImpressionRate)

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

VideoIAB

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

Wartości w polu enum
VIDEO_IAB_UNSPECIFIED Jest ona tylko zmienną i nie określa żadnych opcji współczynnika widoczności reklam wideo widocznych dla IAB.
IAB_VIEWABILITY_80_PERCENT_HIGHER Kieruj reklamy na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 80%.
IAB_VIEWABILITY_75_PERCENT_HIGHER Kieruj reklamy na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 75%.
IAB_VIEWABILITY_70_PERCENT_HIGHER Kieruj reklamy na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 70%.
IAB_VIEWABILITY_65_PERCENT_HIHGER Kieruj reklamy na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 65%.
IAB_VIEWABILITY_60_PERCENT_HIGHER Kieruj reklamy na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 60%.
IAB_VIEWABILITY_55_PERCENT_HIHGER Kieruj reklamy na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 55%.
IAB_VIEWABILITY_50_PERCENT_HIGHER Kieruj reklamy na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 50%.
IAB_VIEWABILITY_40_PERCENT_HIHGER Kieruj reklamy na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 40%.
IAB_VIEWABILITY_30_PERCENT_HIHGER Kieruj reklamy na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować współczynnik widoczności 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 Jest ona tylko wartością zastępczą i nie określa żadnych opcji współczynnika widoczności filmu.
VIEWED_PERFORMANCE_40_PERCENT_HIGHER Kieruj na internetowe zasoby reklamowe, aby zmaksymalizować współczynnik pełnej widoczności na poziomie 40% lub wyższym.
VIEWED_PERFORMANCE_35_PERCENT_HIGHER Kieruj na internetowe zasoby reklamowe, aby zmaksymalizować współczynnik pełnej widoczności na poziomie co najmniej 35%.
VIEWED_PERFORMANCE_30_PERCENT_HIGHER Kieruj na internetowe zasoby reklamowe, aby zmaksymalizować współczynnik pełnej widoczności na poziomie co najmniej 30%.
VIEWED_PERFORMANCE_25_PERCENT_HIGHER Kieruj na internetowe zasoby reklamowe, aby zmaksymalizować współczynnik pełnej widoczności na poziomie 25% lub wyższym.
VIEWED_PERFORMANCE_20_PERCENT_HIGHER Kieruj na internetowe zasoby reklamowe, aby zmaksymalizować współczynnik pełnej widoczności na poziomie 20% lub wyższym.
VIEWED_PERFORMANCE_10_PERCENT_HIGHER Kieruj na internetowe zasoby reklamowe, aby zmaksymalizować współczynnik pełnej widoczności na poziomie 10% lub wyższym.

PlayerImpressionRate

Możliwe opcje wyświetleń.

Wartości w polu enum
PLAYER_SIZE_400X300_UNSPECIFIED Jest ona tylko symbolem zastępczym i nie określa żadnych opcji wyświetleń.
PLAYER_SIZE_400X300_95 Strony generujące co najmniej 95%wyświetleń.
PLAYER_SIZE_400X300_70 Witryny 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

Oszustwa DoubleVerify Nieprawidłowe ustawienia ruchu.

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

enum (FraudOption)

Unikanie witryn i aplikacji z historycznymi oszustwami nieprawidłowy ruch.

avoidInsufficientOption

boolean

Niewystarczające dane historyczne Statystyki nieprawidłowego ruchu.

FraudOption

Możliwe opcje historycznych danych o oszustwach Odsetek nieprawidłowego ruchu.

Wartości w polu enum
FRAUD_UNSPECIFIED Jest ona tylko wartością zastępczą i nie określa żadnych opcji oszustwa ani nieprawidłowego ruchu.
AD_IMPRESSION_FRAUD_100 100% Oszustwa nieprawidłowy ruch.
AD_IMPRESSION_FRAUD_50 Oszustwa co najmniej 50% nieprawidłowy ruch.
AD_IMPRESSION_FRAUD_25 Co najmniej 25% oszustwa nieprawidłowy ruch.
AD_IMPRESSION_FRAUD_10 Co najmniej 10% oszustwa nieprawidłowy ruch.
AD_IMPRESSION_FRAUD_8 Co najmniej 8% oszustwa nieprawidłowy ruch.
AD_IMPRESSION_FRAUD_6 Co najmniej 6% oszustwa nieprawidłowy ruch.
AD_IMPRESSION_FRAUD_4 Co najmniej 4% oszustwa nieprawidłowy ruch.
AD_IMPRESSION_FRAUD_2 Co najmniej 2% oszustwa nieprawidłowy ruch.

IntegralAdScience

Szczegóły ustawień 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)

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

excludeUnrateable

boolean

Bezpieczeństwo marki – bez oceny.

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 – narkotyki.

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)

Sekcja „Widoczność reklam displayowych” (dotyczy tylko displayowych elementów zamówienia).

videoViewability

enum (VideoViewability)

Sekcja Widoczność reklamy 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 wyników Integral Ad Science TRAQ (rzeczywista jakość reklam).

Wartości w polu enum
TRAQ_UNSPECIFIED Jest ona tylko wartością zastępczą i nie określa żadnych rzeczywistych wyników jakości reklam.
TRAQ_250 Wynik TRAQ: 250–1000.
TRAQ_500 Wynik TRAQ to 500–1000.
TRAQ_600 Wynik TRAQ to 600–1000.
TRAQ_700 Wynik TRAQ to 700–1000.
TRAQ_750 Wynik TRAQ to 750–1000.
TRAQ_875 Wynik TRAQ: 875–1000.
TRAQ_1000 TRAQ ma wartość 1000.

Dorosły

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

Wartości w polu enum
ADULT_UNSPECIFIED To enum jest tylko wartością zastępczą 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 umiarkowane ryzyko.

Alkohol

Możliwe opcje związane z alkoholem Integral Ad Science.

Wartości w polu enum
ALCOHOL_UNSPECIFIED To enum jest tylko wartością zastępczą i nie określa żadnych opcji dotyczących alkoholu.
ALCOHOL_HR Alkohol – wyklucz wysokie ryzyko.
ALCOHOL_HMR Alkohol – wyklucz wysokie i średnie ryzyko.

IllegalDownloads

Możliwe opcje pobierania treści przez firmę Integral Ad Science w sposób niezgodny z prawem.

Wartości w polu enum
ILLEGAL_DOWNLOADS_UNSPECIFIED Jest ona tylko wartością zastępczą i nie określa żadnych nielegalnych opcji pobierania.
ILLEGAL_DOWNLOADS_HR Nielegalne pobieranie – wyklucz wysokie ryzyko.
ILLEGAL_DOWNLOADS_HMR Nielegalne pobieranie – wyklucz wysokie i średnie ryzyko.

Narkotyki

Możliwe leki Integral Ad Science.

Wartości w polu enum
DRUGS_UNSPECIFIED To enum jest tylko wartością zastępczą i nie określa żadnych opcji związanych z lekami.
DRUGS_HR Narkotyki – wyklucz wysokie ryzyko.
DRUGS_HMR Narkotyki – wyklucz wysokie i średnie ryzyko.

HateSpeech

Możliwe opcje Integral Ad Science dotyczące szerzenia nienawiści.

Wartości w polu enum
HATE_SPEECH_UNSPECIFIED Jest tylko wartością zastępczą i nie określa żadnych opcji 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 językowe Integral Ad Science Offensive.

Wartości w polu enum
OFFENSIVE_LANGUAGE_UNSPECIFIED To enum jest tylko symbolem zastępczym 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 umiarkowane ryzyko.

Przemoc

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

Wartości w polu enum
VIOLENCE_UNSPECIFIED Jest tylko wartością zastępczą i nie określa żadnych opcji związanych z przemocą.
VIOLENCE_HR Przemoc – wyklucz wysokie ryzyko.
VIOLENCE_HMR Przemoc – wyklucz wysokie i umiarkowane ryzyko.

Hazard

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

Wartości w polu enum
GAMBLING_UNSPECIFIED To enum jest tylko wartością zastępczą i nie określa żadnych opcji hazardu.
GAMBLING_HR Hazard – wyklucz wysokie ryzyko.
GAMBLING_HMR Hazard – wyklucz wysokie i średnie ryzyko.

AdFraudPrevention

Możliwe opcje zapobiegania oszustwom reklamowym przez firmę Integral Ad Science.

Wartości w polu enum
SUSPICIOUS_ACTIVITY_UNSPECIFIED Jest ona 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 reklam displayowych Integral Ad Science.

Wartości w polu enum
PERFORMANCE_VIEWABILITY_UNSPECIFIED Jest ona tylko zmienną i nie określa żadnych opcji widoczności reklam displayowych.
PERFORMANCE_VIEWABILITY_40 Docelowa widoczność co najmniej 40%.
PERFORMANCE_VIEWABILITY_50 Docelowa widoczność co najmniej 50%.
PERFORMANCE_VIEWABILITY_60 Docelowa widoczność na poziomie co najmniej 60%.
PERFORMANCE_VIEWABILITY_70 Docelowa widoczność co najmniej 70%.

VideoViewability

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

Wartości w polu enum
VIDEO_VIEWABILITY_UNSPECIFIED Jest ona tylko zmienną 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 ciekawego miejsca. Gdy targetingType ma wartość TARGETING_TYPE_POI, zostanie ona wypełniona w polu szczegółów obiektu 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” z pełnym adresem, jeśli jest dostępny.

targetingOptionId

string

Wymagane. targetingOptionId obiektu TargetingOption typu TARGETING_TYPE_POI.

Akceptowane identyfikatory opcji kierowania ciekawych miejsc można pobrać za pomocą usługi targetingTypes.targetingOptions.search.

Jeśli kierowanie na określoną współrzędnej szerokości i długości geograficznej zostanie usunięte z adresu lub nazwy ciekawego miejsca, możesz wygenerować niezbędny identyfikator opcji kierowania, zaokrąglając wybrane wartości współrzędnych do szóstego miejsca po przecinku, usuwając ułamki dziesiętne i łącząc wartości ciągów rozdzielone średnikami. Możesz np. kierować reklamy na parę szerokość i długość geograficzną 40,7414691 i -74,003387, używając identyfikatora opcji kierowania „40741469;-74003387”. Po utworzeniu ta wartość pola zostanie zaktualizowana, by dołączyć średnik i alfanumeryczną wartość skrótu, jeśli podano tylko współrzędne szerokości i długości geograficznej.

latitude

number

Tylko dane wyjściowe. Szerokość geograficzna ciekawego miejsca z zaokrągleniem do 6 miejsca po przecinku.

longitude

number

Tylko dane wyjściowe. Długość geograficzna ciekawego miejsca zaokrąglona do 6 miejsca po przecinku.

proximityRadiusAmount

number

Wymagane. Promień obszaru wokół ważnego miejsca, na który będzie kierowana reklama. Jednostki promienia są określane przez proximityRadiusUnit. Wartość musi wynosić od 1 do 800, jeśli jednostka to DISTANCE_UNIT_KILOMETERS, a jeśli jednostka to DISTANCE_UNIT_MILES.

proximityRadiusUnit

enum (DistanceUnit)

Wymagane. Jednostka odległości, według 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. Gdy targetingType ma wartość TARGETING_TYPE_BUSINESS_CHAIN, zostanie ona wypełniona w polu szczegółów obiektu 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, np. „KFC”, „Bank Chase Bank”.

targetingOptionId

string

Wymagane. targetingOptionId obiektu TargetingOption typu TARGETING_TYPE_BUSINESS_CHAIN.

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

proximityRadiusAmount

number

Wymagane. Promień obszaru wokół sieci firmowej, na który będzie kierowana reklama. Jednostki promienia są określane przez proximityRadiusUnit. Wartość musi wynosić od 1 do 800, jeśli jednostka to DISTANCE_UNIT_KILOMETERS, a jeśli jednostka to DISTANCE_UNIT_MILES. Minimalny przyrost w obu przypadkach to 0,1. Jeśli dane wejściowe będą zbyt szczegółowe, np. 15.57 zmieni się na 15.6.

proximityRadiusUnit

enum (DistanceUnit)

Wymagane. Jednostka odległości, według której mierzony jest promień kierowania.

ContentDurationAssignedTargetingOptionDetails

Szczegółowe informacje o przypisanej opcji kierowania na czas trwania treści. Gdy targetingType ma wartość TARGETING_TYPE_CONTENT_DURATION, pole contentDurationDetails zostanie wypełnione. Jednoznaczne 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

Wymagane. Pole 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 przypisanego typu strumienia treści. Gdy targetingType ma wartość TARGETING_TYPE_CONTENT_STREAM_TYPE, pole contentStreamTypeDetails zostanie wypełnione. Jednoznaczne kierowanie na wszystkie opcje nie jest obsługiwane. Aby uzyskać ten efekt, usuń wszystkie opcje kierowania na typ strumienia treści.

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

string

Wymagane. Pole 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 pozycji treści natywnej. Gdy targetingType ma wartość TARGETING_TYPE_NATIVE_CONTENT_POSITION, pole nativeContentPositionDetails zostanie wypełnione. Jednoznaczne kierowanie na wszystkie opcje nie jest obsługiwane. Aby osiągnąć ten efekt, usuń wszystkie opcje kierowania na pozycje natywne pod kątem pozycji treści.

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

enum (NativeContentPosition)

Wymagane. Pozycja treści.

OmidAssignedTargetingOptionDetails

Reprezentuje typ zasobów reklamowych z włączoną obsługą Open Measurement, na które można kierować reklamy. Gdy targetingType ma wartość TARGETING_TYPE_OMID, zostanie ona wypełniona w polu szczegółów obiektu AssignedKierowanieOption.

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

enum (Omid)

Wymagane. Typ zasobów reklamowych z włączoną obsługą Open Measurement.

AudioContentTypeAssignedTargetingOptionDetails

Szczegółowe informacje o przypisanej opcji kierowania typu treści audio. Gdy targetingType ma wartość TARGETING_TYPE_AUDIO_CONTENT_TYPE, pole audioContentTypeDetails zostanie wypełnione. Jednoznaczne kierowanie na wszystkie opcje nie jest obsługiwane. Aby uzyskać ten efekt, usuń wszystkie opcje kierowania na typ treści audio.

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

enum (AudioContentType)

Wymagane. Typ treści audio.

ContentGenreAssignedTargetingOptionDetails

Szczegóły opcji kierowania na gatunek treści. Gdy targetingType ma wartość TARGETING_TYPE_CONTENT_GENRE, pole contentGenreDetails zostanie wypełnione. Jednoznaczne kierowanie na wszystkie opcje nie jest obsługiwane. Aby uzyskać ten efekt, usuń wszystkie opcje kierowania na gatunek treści.

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

string

Wymagane. Pole 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 ta opcja jest kierowana negatywnie.

YoutubeVideoAssignedTargetingOptionDetails

Szczegółowe informacje o opcji kierowania przypisanej do filmu w YouTube. Gdy targetingType ma wartość TARGETING_TYPE_YOUTUBE_VIDEO, pole youtubeVideoDetails zostanie wypełnione.

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

string

Identyfikator filmu w YouTube w takiej postaci, w jakiej jest widoczny na stronie odtwarzania filmu w YouTube.

negative

boolean

Wskazuje, czy ta opcja jest kierowana negatywnie.

YoutubeChannelAssignedTargetingOptionDetails

Szczegółowe informacje o opcji kierowania przypisanej do kanału w YouTube. Gdy targetingType ma wartość TARGETING_TYPE_YOUTUBE_CHANNEL, pole youtubeChannelDetails zostanie wypełnione.

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

string

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

negative

boolean

Wskazuje, czy ta opcja jest kierowana negatywnie.

SessionPositionAssignedTargetingOptionDetails

Szczegóły opcji kierowania przypisanej do pozycji sesji. Gdy targetingType ma wartość TARGETING_TYPE_SESSION_POSITION, pole sessionPositionDetails zostanie wypełnione.

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

enum (SessionPosition)

Pozycja, na której reklama pojawi się w sesji.

SessionPosition

Możliwe pozycje w sesji.

Wartości w polu enum
SESSION_POSITION_UNSPECIFIED To jest wartość zastępcza, nie wskazuje żadnych pozycji.
SESSION_POSITION_FIRST_IMPRESSION Pierwsze wyświetlenie sesji.

Metody

get

Pobiera jedną opcję kierowania przypisaną do grupy reklam.

list

Zawiera listę opcji kierowania przypisanych do grupy reklam.