REST Resource: advertisers.campaigns.targetingTypes.assignedTargetingOptions

Zasób: AssignedTargetingOption

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 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. Ta wartość może być używana zamiast assignedTargetingOptionId podczas pobierania lub usuwania dotychczasowego 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 przypisanej opcji kierowania.
inheritance

enum (Inheritance)

Tylko dane wyjściowe. Stan dziedziczenia przypisanej opcji kierowania.
Pole sumy details. Szczegółowe informacje o przypisanej opcji kierowania. Możesz wypełnić tylko jedno pole ze szczegółami, 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 wypełnione, gdy wartość targetingType to TARGETING_TYPE_CHANNEL.
appCategoryDetails

object (AppCategoryAssignedTargetingOptionDetails)

Szczegóły kategorii aplikacji. To pole zostanie wypełnione, gdy wartość targetingType to 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 dotyczące dnia 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 z uwzględnieniem odległości. To pole zostanie wypełnione, gdy wartość targetingType to TARGETING_TYPE_PROXIMITY_LOCATION_LIST.
genderDetails

object (GenderAssignedTargetingOptionDetails)

Dane o płci. To pole zostanie wypełnione, gdy wartość targetingType to 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 dotyczące treści z nagrodą dla użytkowników. To pole zostanie wypełnione, gdy wartość targetingType to TARGETING_TYPE_USER_REWARDED_CONTENT.
parentalStatusDetails

object (ParentalStatusAssignedTargetingOptionDetails)

Szczegółowe informacje o statusie rodzicielskim. To pole zostanie wypełnione, gdy wartość targetingType to 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 treści w outstreme. To pole zostanie wypełnione, gdy wartość targetingType to TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION.
deviceTypeDetails

object (DeviceTypeAssignedTargetingOptionDetails)

Szczegóły 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 grupę odbiorców na zasób.
browserDetails

object (BrowserAssignedTargetingOptionDetails)

Informacje o przeglądarce. To pole zostanie wypełnione, gdy wartość targetingType to TARGETING_TYPE_BROWSER.
householdIncomeDetails

object (HouseholdIncomeAssignedTargetingOptionDetails)

Szczegóły dochodu gospodarstwa domowego. To pole zostanie wypełnione, gdy wartość targetingType to 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 wypełnione, gdy wartość targetingType to TARGETING_TYPE_CARRIER_AND_ISP.
keywordDetails

object (KeywordAssignedTargetingOptionDetails)

Szczegóły słowa kluczowego. 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 pozytywnych słów kluczowych, które można przypisać.
negativeKeywordListDetails

object (NegativeKeywordListAssignedTargetingOptionDetails)

Szczegóły słowa kluczowego. 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 wypełnione, gdy wartość targetingType to TARGETING_TYPE_DEVICE_MAKE_MODEL.
environmentDetails

object (EnvironmentAssignedTargetingOptionDetails)

Szczegóły środowiska. To pole zostanie wypełnione, gdy wartość targetingType to TARGETING_TYPE_ENVIRONMENT.
inventorySourceDetails

object (InventorySourceAssignedTargetingOptionDetails)

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

object (CategoryAssignedTargetingOptionDetails)

Szczegóły kategorii. To pole zostanie wypełnione, gdy wartość targetingType to 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 ustawić tylko jedną opcję widoczności na zasób.
authorizedSellerStatusDetails

object (AuthorizedSellerStatusAssignedTargetingOptionDetails)

Szczegóły stanu 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 statusu autoryzowanego sprzedawcy, domyślnie docelowymi są wszyscy autoryzowani sprzedawcy wskazani w pliku ads.txt jako DIRECT lub RESELLER.
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 to wykluczenia kierowania. Wykluczenia etykiet treści cyfrowych na poziomie reklamodawcy, jeśli są ustawione, są zawsze stosowane podczas wyświetlania (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 wymiany. To pole zostanie wypełnione, gdy wartość targetingType to 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 przez usługę zewnętrzną. To pole zostanie wypełnione, gdy wartość targetingType to TARGETING_TYPE_THIRD_PARTY_VERIFIER.
poiDetails

object (PoiAssignedTargetingOptionDetails)

Szczegóły ciekawego miejsca. To pole zostanie wypełnione, gdy wartość targetingType to TARGETING_TYPE_POI.
businessChainDetails

object (BusinessChainAssignedTargetingOptionDetails)

Szczegóły sieci firm. To pole zostanie wypełnione, gdy wartość targetingType to TARGETING_TYPE_BUSINESS_CHAIN.
contentDurationDetails

object (ContentDurationAssignedTargetingOptionDetails)

Szczegóły dotyczące czasu trwania treści. To pole zostanie wypełnione, gdy wartość targetingType to TARGETING_TYPE_CONTENT_DURATION.
contentStreamTypeDetails

object (ContentStreamTypeAssignedTargetingOptionDetails)

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

object (NativeContentPositionAssignedTargetingOptionDetails)

Szczegóły pozycji treści natywnych. To pole zostanie wypełnione, gdy wartość targetingType to TARGETING_TYPE_NATIVE_CONTENT_POSITION.
omidDetails

object (OmidAssignedTargetingOptionDetails)

Otwórz szczegóły zasobów reklamowych z obsługą standardu 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 wypełnione, gdy wartość targetingType to TARGETING_TYPE_CONTENT_GENRE.
youtubeVideoDetails

object (YoutubeVideoAssignedTargetingOptionDetails)

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

object (YoutubeChannelAssignedTargetingOptionDetails)

Szczegóły kanału 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 poziomu wyższego.
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 wartość targetingType wynosi TARGETING_TYPE_CHANNEL, to pole zostanie wypełnione w polu szczegółów AssignedTargetingOption.

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

string (int64 format)

Wymagane. Identyfikator kanału. Należy wskazać pole identyfikatora kanału w zasobie Kanał należący do partnera lub Kanał należący do reklamodawcy.
negative

boolean

Wskazuje, czy ta opcja jest objęta kierowaniem negatywnym. 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 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 objęta kierowaniem negatywnym.

AppAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania na aplikację. Gdy wartość targetingType wynosi TARGETING_TYPE_APP, to pole zostanie wypełnione w polu szczegółów AssignedTargetingOption.

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 objęta kierowaniem negatywnym.
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.

AppPlatform

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ść zastępcza jest miejscem zarezerwowanym dla wartości domyślnej i nie reprezentuje rzeczywistej opcji platformy.
APP_PLATFORM_IOS Platforma aplikacji to iOS.
APP_PLATFORM_ANDROID Platforma aplikacji to Android.
APP_PLATFORM_ROKU Platformą aplikacji jest Roku.
APP_PLATFORM_AMAZON_FIRETV Platforma aplikacji to Amazon Fire TV.
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, ta wartość zostanie 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 (1 godzinę przed końcem dnia).
endHour

integer

Wymagane. Godzina zakończenia kierowania na datę i godzinę. Musi się mieścić w przedziale od 1 (1 godzina po rozpoczęciu dnia) do 24 (koniec dnia).
timeZoneResolution

enum (TimeZoneResolution)

Wymagane. Mechanizm służący do określania strefy czasowej, której ma być używana w przypadku tego 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 przekształcany w strefie czasowej reklamodawcy, który wyświetlił reklamę.

AgeRangeAssignedTargetingOptionDetails

Reprezentuje przedział wiekowy, na który można kierować reklamy. Gdy wartość targetingType wynosi TARGETING_TYPE_AGE_RANGE, to pole zostanie wypełnione w polu szczegółów AssignedTargetingOption.

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 stałego kierowania na przedział wiekowy można zwiększyć, kierując reklamy również na odbiorców w nieznanym wieku.

RegionalLocationListAssignedTargetingOptionDetails

Szczegóły kierowania na listę lokalizacji regionalnych. Gdy wartość targetingType wynosi TARGETING_TYPE_REGIONAL_LOCATION_LIST, to pole zostanie wypełnione w polu szczegółów AssignedTargetingOption.

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

string (int64 format)

Wymagane. Identyfikator listy regionalnej lokalizacji. Powinien odwoływać 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ę lokalizacji zbliżonych. Gdy wartość targetingType wynosi TARGETING_TYPE_PROXIMITY_LOCATION_LIST, to pole zostanie wypełnione w polu szczegółów AssignedTargetingOption.

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

string (int64 format)

Wymagane. Identyfikator listy lokalizacji w pobliżu. Powinien odwoływać 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 określonych w parametry 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 odległoś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. Te dane enum są symbolem zastępczym wartości domyślnej i nie odzwierciedlają rzeczywistej jednostki odległości.
PROXIMITY_RADIUS_UNIT_MILES Jednostka odległości promienia 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, ta wartość zostanie 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 to zrobić, usuń wszystkie opcje kierowania na rozmiar odtwarzacza wideo.

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 opcji kierowania na przypisany status rodzicielski. Gdy targetingType ma wartość TARGETING_TYPE_PARENTAL_STATUS, ta wartość zostanie 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 wartość targetingType to 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. Domyślnie tę opcję kierowania odziedziczą tylko zamówienia reklamowe i nowe elementy zamówienia obsługujące określony typ reklamy. Możliwe wartości to:

  • AD_TYPE_VIDEO, to ustawienie zostanie dziedziczone przez nowy element zamówienia, gdy ustawienie lineItemType ma 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ązanej 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. obrazki i HTML5.
AD_TYPE_VIDEO Kreacje wideo, np. reklamy wideo odtwarzane podczas strumieniowego przesyłania treści w odtwarzaczach wideo.
AD_TYPE_AUDIO Kreacje audio, np. reklamy audio odtwarzane w treściach audio.

ContentOutstreamPositionAssignedTargetingOptionDetails

Szczegóły opcji kierowania na pozycję treści outstream. Gdy wartość targetingType to 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 docelowej. 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 dziedziczone przez nowy element zamówienia, gdy ustawienie lineItemType ma 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 wartość targetingType wynosi TARGETING_TYPE_DEVICE_TYPE, to pole zostanie wypełnione w polu szczegółów AssignedTargetingOption.

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. Mnożnik zostanie zastosowany do pierwotnej ceny stawki. Gdy to pole ma wartość 0, oznacza to, że nie ma zastosowania, zamiast mnożenia przez 0 pierwotnej ceny stawki.

Jeśli np. stawka bez mnożnika wynosi 10 PLN, a mnożnik dla tabletu to 1,5, stawka dla tabletu wyniesie 15 PLN.

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

AudienceGroupAssignedTargetingOptionDetails

Szczegóły opcji kierowania na grupę odbiorców. Gdy targetingType ma wartość TARGETING_TYPE_AUDIENCE_GROUP, ta wartość zostanie 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 odbiorcy odbiorców własne i innych firm w grupach odbiorców własnych i zewnętrznych. Każda grupa własnych i zewnętrznych list odbiorców zawiera tylko identyfikatory własnych i zewnętrznych list odbiorców. Relacja między każdą własną i zewnętrzną grupą odbiorców to PRZYŁĄCZENIE, a wynik jest złączany z innymi grupami odbiorców. Powtarzające się grupy z tymi samymi ustawieniami zostaną zignorowane.
includedGoogleAudienceGroup

object (GoogleAudienceGroup)

Identyfikatory Google Audiences uwzględnionej grupy odbiorców Google. Zawiera tylko identyfikatory list 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 identyfikatory połączonych grup odbiorców.
excludedFirstAndThirdPartyAudienceGroup

object (FirstAndThirdPartyAudienceGroup)

Identyfikatory i rekomendacje własnych i innych firm w wykluczonej grupie odbiorców własnych i innych firm. Służy do kierowania wykluczającego. Uzupełnienie zbioru danych 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ą logiczne operatorem logicznym „LUB”.
excludedGoogleAudienceGroup

object (GoogleAudienceGroup)

Identyfikatory odbiorców Google wykluczonej grupy odbiorców Google. Służy do kierowania wykluczającego. Uzupełnienie zbioru danych 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ą logiczne operatorem logicznym „LUB”.

FirstAndThirdPartyAudienceGroup

Szczegóły dotyczące własnej listy odbiorców i listy odbiorców dostarczonej przez firmę zewnętrzną. 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łasnych i na listy odbiorców dostarczone przez inną firmę w grupie odbiorców własnych i na listy odbiorców dostarczone 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ę. Identyfikator to firstAndThirdPartyAudienceId.
recency

enum (Recency)

Czas od poprzedniego ustawienia kierowania na odbiorców własnych i kierowania na odbiorców innych firm. Dotyczy tylko własnych list odbiorców. W innym przypadku jest ignorowany. Więcej informacji znajdziesz na stronie https://support.google.com/displayvideo/answer/2949947#recency. Jeśli nie określisz limitu, nie zostanie on zastosowany.

Czas od poprzedniej wizyty

Wszystkie obsługiwane wartości dotyczące czasu, jaki upłynął od ostatniego działania odbiorcy na własnej lub zewnętrznej liście odbiorców.

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 Aktualność to 5 minut.
RECENCY_10_MINUTES Aktualność 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 Aktualność to 6 godzin.
RECENCY_12_HOURS Czas od poprzedniej wizyty to 12 godzin.
RECENCY_1_DAY Aktualność to 1 dzień.
RECENCY_2_DAYS Aktualność 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 Aktualność 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 Aktualność to 28 dni.
RECENCY_30_DAYS Aktualność to 30 dni.
RECENCY_40_DAYS Aktualność to 40 dni.
RECENCY_45_DAYS Aktualność to 45 dni.
RECENCY_60_DAYS Aktualność to 60 dni.
RECENCY_90_DAYS Czas od poprzedniej wizyty to 90 dni.
RECENCY_120_DAYS Aktualność to 120 dni.
RECENCY_180_DAYS Czas od poprzedniej wizyty to 180 dni.
RECENCY_270_DAYS Aktualność: 270 dni.
RECENCY_365_DAYS Czas od poprzedniej wizyty to 365 dni.

GoogleAudienceGroup

Szczegóły grupy odbiorców Google Wszystkie ustawienia kierowania na listę odbiorców Google są logicznie połączone za pomocą operatora logicznego „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 listy odbiorców Google ustawionej w ustawieniu kierowania na odbiorców zdefiniowanych przez Google. Identyfikator to 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 listy niestandardowe.

Zapis JSON 
{
  "customListId": string
}
Pola
customListId

string (int64 format)

Wymagane. Niestandardowy identyfikator ustawienia kierowania na listę niestandardową. Identyfikator to customListId.

CombinedAudienceGroup

Szczegóły połączonej grupy odbiorców. 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 ustawień kierowania na połączone listy odbiorców.

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 wartość targetingType wynosi TARGETING_TYPE_BROWSER, to pole zostanie wypełnione w polu szczegółów AssignedTargetingOption.

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

string

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

string

Wymagane. targetingOptionId w TargetingOption typu TARGETING_TYPE_BROWSER.
negative

boolean

Wskazuje, czy ta opcja jest objęta kierowaniem negatywnym. Wszystkie przypisane opcje kierowania na przeglądarkę w tym samym zasobie muszą mieć tę samą wartość w tym polu.

HouseholdIncomeAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania na dochód gospodarstwa domowego. Gdy targetingType ma wartość TARGETING_TYPE_HOUSEHOLD_INCOME, ta wartość zostanie 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 wartość targetingType to 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 docelowej. 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 dziedziczone przez nowy element zamówienia, gdy ustawienie lineItemType ma 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 wartość targetingType wynosi TARGETING_TYPE_CARRIER_AND_ISP, to pole zostanie wypełnione w polu szczegółów AssignedTargetingOption.

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

string

Tylko dane wyjściowe. Wyświetlana nazwa operatora lub dostawcy usług internetowych.
targetingOptionId

string

Wymagane. targetingOptionId elementu TargetingOption typu TARGETING_TYPE_CARRIER_AND_ISP.
negative

boolean

Wskazuje, czy ta opcja jest kierowana negatywnie. Wszystkie przypisane opcje kierowania na operatora i dostawcę usług internetowych w tym samym zasobie muszą mieć tę samą wartość w tym polu.

KeywordAssignedTargetingOptionDetails

Szczegóły powiązanej opcji kierowania na słowa kluczowe. Gdy wartość targetingType wynosi TARGETING_TYPE_KEYWORD, to pole zostanie wypełnione w polu szczegółów AssignedTargetingOption.

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 wartość targetingType wynosi TARGETING_TYPE_NEGATIVE_KEYWORD_LIST, to pole zostanie wypełnione w polu szczegółów AssignedTargetingOption.

Zapis JSON 
{
  "negativeKeywordListId": string
}
Pola
negativeKeywordListId

string (int64 format)

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

OperatingSystemAssignedTargetingOptionDetails

Szczegóły opcji kierowania na system operacyjny. Gdy wartość targetingType to 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 objęta kierowaniem negatywnym.

DeviceMakeModelAssignedTargetingOptionDetails

Szczegóły opcji kierowania na markę i model 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 objęta kierowaniem negatywnym.

EnvironmentAssignedTargetingOptionDetails

szczegóły opcji kierowania na środowisko; Gdy targetingType ma wartość TARGETING_TYPE_ENVIRONMENT, ta wartość zostanie 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 wartość targetingType wynosi TARGETING_TYPE_INVENTORY_SOURCE, to pole zostanie wypełnione w polu szczegółów AssignedTargetingOption.

Zapis JSON 
{
  "inventorySourceId": string
}
Pola
inventorySourceId

string (int64 format)

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

CategoryAssignedTargetingOptionDetails

Szczegóły opcji kierowania na przypisaną kategorię. Gdy wartość targetingType to 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 objęta kierowaniem negatywnym.

Widoczność.Opis przypisanej opcji kierowania

szczegóły przypisanej opcji kierowania według widoczności; Gdy targetingType ma wartość TARGETING_TYPE_VIEWABILITY, zostanie 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 wartość targetingType wynosi TARGETING_TYPE_AUTHORIZED_SELLER_STATUS, to pole zostanie wypełnione w polu szczegółów AssignedTargetingOption.

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 docelowego.
targetingOptionId

string

Wymagane. targetingOptionId elementu TargetingOption typu TARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

LanguageAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania na język. Gdy wartość targetingType wynosi TARGETING_TYPE_LANGUAGE, to pole zostanie wypełnione w polu szczegółów AssignedTargetingOption.

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

string

Tylko dane wyjściowe. Wyświetlana nazwa języka (np. „French”).
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 zapełniona w polu szczegółów obiektu AssignedTargetOption.

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 wartość targetingType wynosi TARGETING_TYPE_INVENTORY_SOURCE_GROUP, to pole zostanie wypełnione w polu szczegółów AssignedTargetingOption.

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 na etykietę treści cyfrowych. Gdy wartość targetingType wynosi TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION, to pole zostanie wypełnione w polu szczegółów AssignedTargetingOption.

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

enum (ContentRatingTier)

Wymagane. Wyświetlana nazwa etykiety treści cyfrowych, która ma być WYŁĄCZONA.

SensitiveCategoryAssignedTargetingOptionDetails

Szczegóły kierowania na kategorię reklam o charakterze kontrowersyjnym. Gdy wartość targetingType wynosi TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION, to pole zostanie wypełnione w polu szczegółów AssignedTargetingOption.

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, ta wartość zostanie 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 wartość targetingType wynosi TARGETING_TYPE_SUB_EXCHANGE, to pole zostanie wypełnione w polu szczegółów AssignedTargetingOption.

Zapis JSON 
{
  "targetingOptionId": string
}
Pola
targetingOptionId

string

Wymagane. targetingOptionId elementu TargetingOption typu TARGETING_TYPE_SUB_EXCHANGE.

ThirdPartyVerifierAssignedTargetingOptionDetails

Szczegóły opcji kierowania przypisanej do weryfikatora zewnętrznego. Gdy wartość targetingType wynosi TARGETING_TYPE_THIRD_PARTY_VERIFIER, to pole zostanie wypełnione w polu szczegółów AssignedTargetingOption.

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 być tylko jednym z tych elementów:
adloox

object (Adloox)

Weryfikator zewnętrzny 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 udostępniane przez firmę Adloox.

AdlooxCategory

Możliwe opcje Adloox

Wartości w polu enum
ADLOOX_UNSPECIFIED Ta enumeracja jest tylko miejscem zastępczym 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 i bronie.
LOW_VIEWABILITY_DOMAINS domeny o niskiej widoczności,
FRAUD oszustwa;

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 ustalania stawek za aplikacje z ograniczeniem wiekowym.
appStarRating

object (AppStarRating)

Unikaj ustalania stawek za aplikacje z gwiazdkowymi ocenami.
displayViewability

object (DisplayViewability)

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

object (VideoViewability)

Ustawienia widoczności filmu (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

Nieznany lub niekwalifikujący się do oceny.
avoidedHighSeverityCategories[]

enum (HighSeverityCategory)

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

enum (MediumSeverityCategory)

Średnio poważne kategorie kontroli bezpieczeństwa marki.

HighSeverityCategory

Możliwe opcje w przypadku kategorii o wysokiej wagi.

Wartości w polu enum
HIGHER_SEVERITY_UNSPECIFIED Ten typ danych jest tylko miejscem zastępczym i nie określa żadnych kategorii o wysokiej wagi.
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 Szerzenie nienawiści / 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: wywołana przez człowieka.
DISASTER_NATURAL Katastrofa: naturalne.
DISASTER_TERRORIST_EVENTS Katastrofa: ataki 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: strona z parkingiem.
UNMODERATED_UGC Niemoderowane treści generowane przez użytkowników: fora, obrazy 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 klasyfikacji wiekowej.

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

AppStarRating

Szczegóły ustawień ocen gwiazdkowych DoubleVerify

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

enum (StarRating)

Unikaj ustalania stawek za aplikacje z gwiazdkami.
avoidInsufficientStarRating

boolean

Unikaj określania stawek za zasoby reklamowe w aplikacjach, które mają niewystarczającą liczbę gwiazdek.

StarRating

Możliwe opcje dotyczące gwiazdek.

Wartości w polu enum
APP_STAR_RATE_UNSPECIFIED Ten typ enum jest tylko miejscem zastępczym i nie określa żadnych opcji oceny gwiazdek aplikacji.
APP_STAR_RATE_1_POINT_5_LESS Oficjalne aplikacje z oceną < 1,5 gwiazdki.
APP_STAR_RATE_2_LESS Oficjalne aplikacje z ocena < 2 gwiazdki.
APP_STAR_RATE_2_POINT_5_LESS Oficjalne aplikacje z ocena < 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ą niższą niż 4,5 gwiazdki.

DisplayViewability

Szczegóły ustawień widoczności wyświetlania w 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 widoczności reklamy 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 wyświetlania.

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 na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować czas trwania wyświetlenia widocznego w 100% (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 reklamy na zasoby reklamowe w witrynach, 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 Ten typ enum jest tylko miejscem zastępczym i nie określa żadnych opcji współczynnika widoczności reklam wideo według 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 zasoby reklamowe w internecie, aby zmaksymalizować współczynnik widoczności w 100% do poziomu co najmniej 25%.
VIEWED_PERFORMANCE_20_PERCENT_HIGHER Kieruj na zasoby reklamowe w internecie, aby zmaksymalizować współczynnik widoczności w 100% do poziomu co najmniej 20%.
VIEWED_PERFORMANCE_10_PERCENT_HIGHER Kieruj na zasoby reklamowe w internecie, aby zmaksymalizować współczynnik widoczności w 100% lub wyższy.

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 z ponad 95% wyświetleń.
PLAYER_SIZE_400X300_70 Strony z ponad 70% wyświetleń.
PLAYER_SIZE_400X300_25 Strony generujące co najmniej 25%wyświetleń.
PLAYER_SIZE_400X300_5 Strony z co najmniej 5% wyświetleń.

FraudInvalidTraffic

Oszustwa DoubleVerify Nieprawidłowe ustawienia ruchu.

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

enum (FraudOption)

Unikaj witryn i aplikacji, które mają historyczne statystyki na temat fałszywego i nieprawidłowego ruchu.
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 Ta enumeracja jest tylko miejscem zastępczym i nie określa żadnych opcji dotyczących oszustwa 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% 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% 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ół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 pliki do pobrania.
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 Wyświetlanie widoczności (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 TRAQ (True Advertising Quality) w usłudze Integral Ad Science.

Wartości w polu enum
TRAQ_UNSPECIFIED Ta wartość jest tylko miejscem zastępczym i nie określa żadnych rzeczywistych wyników jakości reklamy.
TRAQ_250 Wynik TRAQ: 250–1000.
TRAQ_500 Wynik TRAQ: 500–1000.
TRAQ_600 Wynik TRAQ to 600–1000.
TRAQ_700 Wynik TRAQ: 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 poziomy wysokiego i umiarkowanego ryzyka.

Alkohol

Możliwe opcje dotyczące alkoholu w 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 ryzyko wysokie i umiarkowane.

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 Ta enumeracja jest tylko miejscem zastępczym i nie określa żadnych opcji nielegalnych pobrań.
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 wysoki poziom ryzyka.
DRUGS_HMR Narkotyki – wyklucz ryzyko wysokie i umiarkowane.

HateSpeech

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

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

OffensiveLanguage

Możliwe opcje Integral Ad Science dotyczące obraźliwego języka.

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 wysoki poziom ryzyka.
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 Ten typ jest tylko miejscem zastępczym i nie określa żadnych opcji przemocy.
VIOLENCE_HR Przemoc – wyklucz wysoki poziom ryzyka.
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 Ten typ jest tylko miejscem zastępczym 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 Oszustwa reklamowe – wyklucz ryzyko wysokie i umiarkowane.

DisplayViewability

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

Wartości w polu enum
PERFORMANCE_VIEWABILITY_UNSPECIFIED Ten typ danych jest tylko zastępnikiem i nie określa żadnych opcji widoczności wyświetlania.
PERFORMANCE_VIEWABILITY_40 Docelowa widoczność co najmniej 40%.
PERFORMANCE_VIEWABILITY_50 Docelowa widoczność co najmniej 50%.
PERFORMANCE_VIEWABILITY_60 Ustaw widoczność na poziomie co najmniej 60%.
PERFORMANCE_VIEWABILITY_70 Ustaw widoczność na poziomie co najmniej 70%.

VideoViewability

Możliwe opcje widoczności w usłudze wideo Integral Ad Science

Wartości w polu enum
VIDEO_VIEWABILITY_UNSPECIFIED Ten typ danych jest tylko miejscem zastępczym i nie określa żadnych opcji widoczności filmu.
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 Widoczność powyżej 60% (standard widoczności reklam wideo IAB).
VIDEO_VIEWABILITY_70 Widoczność na ekranie: co najmniej 70% (standard widoczności reklam wideo IAB).

PoiAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania ciekawych miejsc. Gdy targetingType ma wartość TARGETING_TYPE_POI, ta wartość zostanie 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 punktu zainteresowania, np. „Times Square”, „Space Needle”, a za nią pełny adres (jeśli jest dostępny).
targetingOptionId

string

Wymagane. Wartość 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 kierujesz reklamy na współrzędne geograficzne, które zostały usunięte z adresu lub nazwy punktu zainteresowania, możesz wygenerować niezbędny identyfikator opcji kierowania, zaokrąglając wartości współrzędnych do 6 znaków po przecinku, usuwając wartości dziesiętne i łącząc ciągi znaków rozdzielone średnikami. Możesz na przykład kierować reklamy na parę współrzędnych 40,7414691, -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 punktu POI 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, ta wartość zostanie 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 firmy można pobrać za pomocą SearchTargetingOptions.
proximityRadiusAmount

number

Wymagane. Promień obszaru wokół sieci placówek, na który będzie kierowana reklama. Jednostki promienia są określane przez proximityRadiusUnit. Musi wynosić od 1 do 800, jeśli jednostką jest DISTANCE_UNIT_KILOMETERS, oraz od 1 do 500, jeśli jednostką jest DISTANCE_UNIT_MILES. Minimalny przyrost w obu przypadkach wynosi 0,1. Jeśli dane wejściowe są zbyt szczegółowe, zostaną zaokrąglone do najbliższej dopuszczalnej wartości, np. 15,57 stanie się 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. 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 przypisanej do typu strumienia treści. Gdy wartość targetingType to 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 na pozycję w treści natywnej. Gdy wartość targetingType to 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 pozycję natywnych 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 wartość targetingType wynosi TARGETING_TYPE_OMID, to pole zostanie wypełnione w polu szczegółów AssignedTargetingOption.

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. Kierowanie na wszystkie opcje nie jest obsługiwane. Aby to zrobić, 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 wartość targetingType to TARGETING_TYPE_CONTENT_GENRE, pole contentGenreDetails zostanie wypełnione. Jednoznaczne kierowanie na wszystkie opcje nie jest obsługiwane. Aby to zrobić, 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óły opcji kierowania przypisanej do filmu w YouTube Gdy wartość targetingType to 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óły opcji kierowania przypisanego do kanału w YouTube. Gdy wartość targetingType to TARGETING_TYPE_YOUTUBE_CHANNEL, pole youtubeChannelDetails zostanie wypełnione.

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

string

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

boolean

Wskazuje, czy ta opcja jest objęta kierowaniem negatywnym.

SessionPositionAssignedTargetingOptionDetails

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

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

enum (SessionPosition)

Pozycja, w której reklama będzie się wyświetlać w ramach sesji.

SessionPosition

Możliwe pozycje w sesji.

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

Metody

get

 Pobiera pojedynczą opcję kierowania przypisaną do kampanii.

list

 Zawiera listę opcji kierowania przypisanych do kampanii w określonym typie kierowania.