REST Resource: advertisers.adGroups.targetingTypes.assignedTargetingOptions

Zasób: AssignedTargetingOption

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

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

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

string

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

string

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

string

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

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

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

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

  • TARGETING_TYPE_CONTENT_INSTREAM_POSITION
  • TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
targetingType

enum (TargetingType)

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

enum (Inheritance)

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

object (ChannelAssignedTargetingOptionDetails)

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

object (AppCategoryAssignedTargetingOptionDetails)

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

object (AppAssignedTargetingOptionDetails)

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

object (UrlAssignedTargetingOptionDetails)

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

object (DayAndTimeAssignedTargetingOptionDetails)

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

object (AgeRangeAssignedTargetingOptionDetails)

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

object (RegionalLocationListAssignedTargetingOptionDetails)

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

object (ProximityLocationListAssignedTargetingOptionDetails)

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

object (GenderAssignedTargetingOptionDetails)

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

object (VideoPlayerSizeAssignedTargetingOptionDetails)

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

object (UserRewardedContentAssignedTargetingOptionDetails)

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

object (ParentalStatusAssignedTargetingOptionDetails)

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

object (ContentInstreamPositionAssignedTargetingOptionDetails)

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

object (ContentOutstreamPositionAssignedTargetingOptionDetails)

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

object (DeviceTypeAssignedTargetingOptionDetails)

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

object (AudienceGroupAssignedTargetingOptionDetails)

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

object (BrowserAssignedTargetingOptionDetails)

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

object (HouseholdIncomeAssignedTargetingOptionDetails)

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

object (OnScreenPositionAssignedTargetingOptionDetails)

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

object (CarrierAndIspAssignedTargetingOptionDetails)

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

object (KeywordAssignedTargetingOptionDetails)

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

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

object (NegativeKeywordListAssignedTargetingOptionDetails)

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

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

object (OperatingSystemAssignedTargetingOptionDetails)

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

object (DeviceMakeModelAssignedTargetingOptionDetails)

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

object (EnvironmentAssignedTargetingOptionDetails)

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

object (InventorySourceAssignedTargetingOptionDetails)

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

object (CategoryAssignedTargetingOptionDetails)

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

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

object (ViewabilityAssignedTargetingOptionDetails)

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

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

object (AuthorizedSellerStatusAssignedTargetingOptionDetails)

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

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

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

object (LanguageAssignedTargetingOptionDetails)

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

object (GeoRegionAssignedTargetingOptionDetails)

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

object (InventorySourceGroupAssignedTargetingOptionDetails)

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

object (DigitalContentLabelAssignedTargetingOptionDetails)

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

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

object (SensitiveCategoryAssignedTargetingOptionDetails)

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

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

object (ContentThemeAssignedTargetingOptionDetails)

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

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

object (ExchangeAssignedTargetingOptionDetails)

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

object (SubExchangeAssignedTargetingOptionDetails)

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

object (ThirdPartyVerifierAssignedTargetingOptionDetails)

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

object (PoiAssignedTargetingOptionDetails)

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

object (BusinessChainAssignedTargetingOptionDetails)

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

object (ContentDurationAssignedTargetingOptionDetails)

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

object (ContentStreamTypeAssignedTargetingOptionDetails)

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

object (NativeContentPositionAssignedTargetingOptionDetails)

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

object (OmidAssignedTargetingOptionDetails)

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

object (AudioContentTypeAssignedTargetingOptionDetails)

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

object (ContentGenreAssignedTargetingOptionDetails)

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

object (YoutubeVideoAssignedTargetingOptionDetails)

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

object (YoutubeChannelAssignedTargetingOptionDetails)

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

object (SessionPositionAssignedTargetingOptionDetails)

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

object (YoutubeChannelPackAssignedTargetingOptionDetails)

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

ChannelAssignedTargetingOptionDetails

Szczegóły opcji kierowania na przypisany kanał. To pole zostanie wypełnione w polu szczegółów obiektu AssignedTargetingOption, gdy wartość targetingType to TARGETING_TYPE_CHANNEL.

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

string (int64 format)

Wymagane. Identyfikator kanału. Powinien 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 objęta kierowaniem negatywnym. W przypadku opcji kierowania przypisanej na poziomie reklamodawcy to pole musi mieć wartość „true”.

AppCategoryAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania na kategorię aplikacji. To pole zostanie wypełnione w polu appCategoryDetails obiektu AssignedTargetingOption, gdy wartość targetingType to TARGETING_TYPE_APP_CATEGORY.

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 opcji kierowania na przypisaną aplikację. To pole zostanie wypełnione w polu szczegółów obiektu AssignedTargetingOption, gdy wartość targetingType to TARGETING_TYPE_APP.

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 Apple App Store to ciąg 9 cyfr, 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ę docelowej aplikacji. Jeśli to pole nie jest określone, przyjmuje się, że platformą aplikacji jest platforma mobilna (tzn. Android lub iOS), a odpowiednią platformę mobilną wywnioskujemy na podstawie identyfikatora aplikacji.

AppPlatform

Możliwe opcje kierowania na platformę aplikacji.

Wartości w polu enum
APP_PLATFORM_UNSPECIFIED Wartość domyślna, gdy platforma aplikacji nie jest określona w tej wersji. Ten typ wyliczeniowy jest symbolem zastępczym wartości domyślnej i nie reprezentuje rzeczywistej opcji platformy.
APP_PLATFORM_IOS Platformą aplikacji jest iOS.
APP_PLATFORM_ANDROID Platformą aplikacji jest Android.
APP_PLATFORM_ROKU Platformą aplikacji jest Roku.
APP_PLATFORM_AMAZON_FIRETV Platforma aplikacji to Amazon FireTV.
APP_PLATFORM_PLAYSTATION Platformą aplikacji jest PlayStation.
APP_PLATFORM_APPLE_TV Platformą aplikacji jest Apple TV.
APP_PLATFORM_XBOX Platformą aplikacji jest 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 wyraźnie wymieniona w innych miejscach.
APP_PLATFORM_LG_TV Platformą aplikacji jest LG TV.
APP_PLATFORM_VIZIO_TV Platforma aplikacji to VIZIO TV.
APP_PLATFORM_VIDAA Platformą aplikacji jest Vidaa.

UrlAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania na adres URL. To pole zostanie wypełnione w polu szczegółów obiektu AssignedTargetingOption, gdy wartość targetingType to TARGETING_TYPE_URL.

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

string

Wymagane. Adres URL, np. example.com.

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

boolean

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

DayAndTimeAssignedTargetingOptionDetails

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

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

enum (DayOfWeek)

Wymagane. Dzień tygodnia w tym ustawieniu kierowania na dzień i godzinę.
startHour

integer

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

integer

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

enum (TimeZoneResolution)

Wymagane. Mechanizm używany do określania strefy czasowej, która ma być używana w przypadku tego ustawienia kierowania na dzień i godzinę.

W przypadku elementów zamówienia generujących popyt to pole ma zawsze wartość TIME_ZONE_RESOLUTION_ADVERTISER.

DzieńTygodnia

Reprezentuje 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 określania strefy czasowej.

Wartości w polu enum
TIME_ZONE_RESOLUTION_UNSPECIFIED Rozdzielczość strefy czasowej jest nieokreślona lub nieznana.
TIME_ZONE_RESOLUTION_END_USER Czas jest podawany w strefie czasowej użytkownika, który zobaczył 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. To pole zostanie wypełnione w polu szczegółów obiektu AssignedTargetingOption, gdy wartość targetingType to TARGETING_TYPE_AGE_RANGE.

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

enum (AgeRange)

Wymagane. Przedział wiekowy odbiorców. Obsługujemy tylko kierowanie na ciągły przedział wiekowy odbiorców. Dlatego przedział wiekowy reprezentowany w tym polu może być 1) wybrany jako jedyny lub 2) częścią większego, ciągłego przedziału wiekowego. Zasięg ciągł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. To pole zostanie wypełnione w polu szczegółów obiektu AssignedTargetingOption, gdy wartość targetingType to TARGETING_TYPE_REGIONAL_LOCATION_LIST.

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

string (int64 format)

Wymagane. Identyfikator listy lokalizacji regionalnych. Powinien odwoływać się do pola locationListId zasobu LocationList, którego typ to TARGETING_LOCATION_TYPE_REGIONAL.
negative

boolean

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

ProximityLocationListAssignedTargetingOptionDetails

Szczegóły kierowania na listę lokalizacji w pobliżu. To pole zostanie wypełnione w polu szczegółów obiektu AssignedTargetingOption, gdy wartość targetingType to TARGETING_TYPE_PROXIMITY_LOCATION_LIST.

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 ustawionych w proximityRadiusUnit. Określa rozmiar obszaru wokół wybranej lokalizacji, na który będą kierowane reklamy. Promień powinien wynosić od 1 do 500 mil lub 800 kilometrów.
proximityRadiusUnit

enum (ProximityRadiusUnit)

Wymagane. Jednostki promienia.

ProximityRadiusUnit

Enum jednostek odległości dla parametru ProximityRadius.

Wartości w polu enum
PROXIMITY_RADIUS_UNIT_UNSPECIFIED Wartość domyślna, gdy w tej wersji nie określono jednostek odległości. Ten typ wyliczeniowy jest symbolem zastępczym wartości domyślnej i nie reprezentuje rzeczywistej jednostki odległości.
PROXIMITY_RADIUS_UNIT_MILES Jednostka promienia w milach.
PROXIMITY_RADIUS_UNIT_KILOMETERS Jednostka promienia w kilometrach

GenderAssignedTargetingOptionDetails

Szczegóły opcji kierowania na płeć przypisaną przez system. To pole zostanie wypełnione w polu szczegółów obiektu AssignedTargetingOption, gdy wartość targetingType to TARGETING_TYPE_GENDER.

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

enum (Gender)

Wymagane. Płeć odbiorców.

VideoPlayerSizeAssignedTargetingOptionDetails

Szczegóły opcji kierowania na rozmiar odtwarzacza wideo. To pole zostanie wypełnione w polu videoPlayerSizeDetails, gdy wartość targetingType będzie równa TARGETING_TYPE_VIDEO_PLAYER_SIZE. Kierowanie na wszystkie opcje nie jest obsługiwane. Aby uzyskać 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ść strony z nagrodą dla użytkowników. To pole zostanie wypełnione w polu userRewardedContentDetails, gdy wartość targetingType będzie równa TARGETING_TYPE_USER_REWARDED_CONTENT.

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 przypadku reklam wideo.

ParentalStatusAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania na status rodzicielski. To pole zostanie wypełnione w polu szczegółów obiektu AssignedTargetingOption, gdy wartość targetingType to TARGETING_TYPE_PARENTAL_STATUS.

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

enum (ParentalStatus)

Wymagane. Status rodzicielski odbiorców.

ContentInstreamPositionAssignedTargetingOptionDetails

Szczegóły opcji kierowania na pozycję w treści przypisanej. To pole zostanie wypełnione w polu contentInstreamPositionDetails, gdy wartość targetingType będzie równa TARGETING_TYPE_CONTENT_INSTREAM_POSITION.

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

enum (ContentInstreamPosition)

Wymagane. Pozycja reklamy wideo lub audio In-Stream w treści.
adType

enum (AdType)

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

  • AD_TYPE_VIDEO, nowe elementy zamówienia będą dziedziczyć to ustawienie, gdy lineItemType będzie mieć wartość LINE_ITEM_TYPE_VIDEO_DEFAULT.
  • AD_TYPE_AUDIO, nowe elementy zamówienia będą dziedziczyć to ustawienie, gdy lineItemType będzie mieć wartość LINE_ITEM_TYPE_AUDIO_DEFAULT.

AdType

Określa typ kreacji powiązany z reklamami.

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

ContentOutstreamPositionAssignedTargetingOptionDetails

Szczegóły opcji kierowania na pozycję w treści w przypadku przypisanych treści. To pole zostanie wypełnione w polu contentOutstreamPositionDetails, gdy wartość targetingType będzie równa TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION.

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

enum (ContentOutstreamPosition)

Wymagane. Pozycja reklamy out-stream w treści.
adType

enum (AdType)

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

  • AD_TYPE_DISPLAY, nowe elementy zamówienia będą dziedziczyć to ustawienie, gdy lineItemType będzie mieć wartość LINE_ITEM_TYPE_DISPLAY_DEFAULT.
  • AD_TYPE_VIDEO, nowe elementy zamówienia będą dziedziczyć to ustawienie, gdy lineItemType będzie mieć wartość LINE_ITEM_TYPE_VIDEO_DEFAULT.

DeviceTypeAssignedTargetingOptionDetails

Szczegóły kierowania według typu urządzenia. To pole zostanie wypełnione w polu szczegółów obiektu AssignedTargetingOption, gdy wartość targetingType to TARGETING_TYPE_DEVICE_TYPE.

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. Zastosuje mnożnik do pierwotnej ceny. Gdy to pole ma wartość 0, oznacza to, że nie ma zastosowania, zamiast mnożyć 0 przez pierwotną cenę oferty.

Jeśli na przykład cena stawki bez mnożnika wynosi 10,00 PLN, a mnożnik dla tabletów to 1,5, to cena stawki dla tabletów wyniesie 15,00 PLN.

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

AudienceGroupAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania na grupę odbiorców. To pole zostanie wypełnione w polu szczegółów obiektu AssignedTargetingOption, gdy wartość targetingType to TARGETING_TYPE_AUDIENCE_GROUP. Relacja między poszczególnymi grupami to UNION, z wyjątkiem grup excludedFirstAndThirdPartyAudienceGroup i excludedGoogleAudienceGroup, w przypadku których COMPLEMENT jest używany jako INTERSECTION z innymi grupami.

Zapis JSON 
{
  "includedGoogleAudienceGroup": {
    object (GoogleAudienceGroup)
  },
  "includedCustomListGroup": {
    object (CustomListGroup)
  },
  "includedCombinedAudienceGroup": {
    object (CombinedAudienceGroup)
  },
  "excludedGoogleAudienceGroup": {
    object (GoogleAudienceGroup)
  },
  "includedFirstPartyAndPartnerAudienceGroups": [
    {
      object (FirstPartyAndPartnerAudienceGroup)
    }
  ],
  "excludedFirstPartyAndPartnerAudienceGroup": {
    object (FirstPartyAndPartnerAudienceGroup)
  }
}
Pola
includedGoogleAudienceGroup

object (GoogleAudienceGroup)

Opcjonalnie: Identyfikatory grup odbiorców Google, które zostały uwzględnione. Zawiera tylko identyfikatory odbiorców Google.
includedCustomListGroup

object (CustomListGroup)

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

object (CombinedAudienceGroup)

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

object (GoogleAudienceGroup)

Opcjonalnie: Identyfikatory odbiorców Google wykluczonej grupy odbiorców Google. Używane do kierowania wykluczającego. DOPEŁNIENIE SUMY tej grupy i innych wykluczonych grup odbiorców jest używane jako ILOCZYN z dowolnym pozytywnym kierowaniem na odbiorców. Zawiera tylko odbiorców Google typu Odbiorcy o podobnych zainteresowaniach, Odbiorcy na rynku i Zainstalowane aplikacje. Wszystkie elementy są połączone logicznym operatorem „LUB”.
includedFirstPartyAndPartnerAudienceGroups[]

object (FirstPartyAndPartnerAudienceGroup)

Opcjonalnie: Identyfikatory własnych list odbiorców i list odbiorców partnera oraz okresy ważności uwzględnionych grup własnych list odbiorców i list odbiorców partnera. Każda grupa odbiorców własnych i partnera zawiera tylko identyfikatory odbiorców własnych i partnera. Relacja między poszczególnymi grupami odbiorców własnych i partnera to INTERSECTION, a wynik jest łączony z innymi grupami odbiorców za pomocą operatora UNION. Powtarzające się grupy z tymi samymi ustawieniami będą ignorowane.
excludedFirstPartyAndPartnerAudienceGroup

object (FirstPartyAndPartnerAudienceGroup)

Opcjonalnie: Identyfikatory własnych list odbiorców i list odbiorców partnera oraz ich aktualność w przypadku wykluczonej grupy odbiorców własnych list i list partnera. Używane do kierowania wykluczającego. DOPEŁNIENIE SUMY tej grupy i innych wykluczonych grup odbiorców jest używane jako ILOCZYN z dowolnym pozytywnym kierowaniem na odbiorców. Wszystkie elementy są połączone logicznym operatorem „LUB”.

GoogleAudienceGroup

Szczegóły grupy odbiorców Google. Wszystkie ustawienia kierowania na odbiorców w 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 w Google.

Zapis JSON 
{
  "googleAudienceId": string
}
Pola
googleAudienceId

string (int64 format)

Wymagane. Identyfikator odbiorców Google w ustawieniu kierowania na odbiorców zdefiniowanych przez Google. Ten identyfikator to googleAudienceId.

CustomListGroup

Szczegóły grupy list niestandardowych. Wszystkie ustawienia kierowania na listy niestandardowe są logicznie połączone operatorem „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 listy niestandardowe. Ten identyfikator to customListId.

CombinedAudienceGroup

Szczegóły połączonej grupy odbiorców. Wszystkie ustawienia kierowania na odbiorców z połączonych list są logicznie połączone operatorem „OR”.

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 powinna przekraczać 5. W przeciwnym razie zostanie zgłoszony 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 to combinedAudienceId.

FirstPartyAndPartnerAudienceGroup

Szczegóły własnej grupy odbiorców i grupy odbiorców partnera. Wszystkie ustawienia kierowania na własne listy odbiorców i listy odbiorców partnera są połączone ze sobą za pomocą operatora logicznego „LUB”.

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

object (FirstPartyAndPartnerAudienceTargetingSetting)

Wymagane. Wszystkie ustawienia kierowania na własne listy odbiorców i listy odbiorców partnera w grupie odbiorców własnych list i list partnera. Powtarzające się ustawienia o tym samym identyfikatorze są niedozwolone.

FirstPartyAndPartnerAudienceTargetingSetting

Szczegóły ustawienia kierowania na własne listy odbiorców i listy odbiorców partnera.

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

string (int64 format)

Wymagane. Identyfikator własnej listy odbiorców i listy odbiorców partnera w ustawieniu kierowania na własne listy odbiorców i listy odbiorców partnera. Ten identyfikator to firstPartyAndPartnerAudienceId.
recency

enum (Recency)

Wymagane. Aktualność ustawienia kierowania na własne listy odbiorców i listy odbiorców partnera. Dotyczy tylko własnych list odbiorców. W innym przypadku jest ignorowana. Więcej informacji znajdziesz na stronie https://support.google.com/displayvideo/answer/2949947#recency. Jeśli nie podasz limitu, nie będzie on używany.

Czas od poprzedniej wizyty

Wszystkie obsługiwane wartości czasu od poprzedniej wizyty własnych list odbiorców i list odbiorców partnera.

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

BrowserAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania na przeglądarkę. To pole zostanie wypełnione w polu szczegółów obiektu AssignedTargetingOption, gdy wartość targetingType to TARGETING_TYPE_BROWSER.

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

string

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

string

Wymagane. targetingOptionId 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ść tego pola.

HouseholdIncomeAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania na dochód gospodarstwa domowego. To pole zostanie wypełnione w polu szczegółów obiektu AssignedTargetingOption, gdy wartość targetingType to TARGETING_TYPE_HOUSEHOLD_INCOME.

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

enum (HouseholdIncome)

Wymagane. Dochód gospodarstwa domowego w grupie odbiorców.

OnScreenPositionAssignedTargetingOptionDetails

Szczegóły opcji kierowania na pozycję na ekranie. To pole zostanie wypełnione w polu onScreenPositionDetails, gdy wartość targetingType będzie równa TARGETING_TYPE_ON_SCREEN_POSITION.

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

  • AD_TYPE_DISPLAY, nowe elementy zamówienia będą dziedziczyć to ustawienie, gdy lineItemType będzie mieć wartość LINE_ITEM_TYPE_DISPLAY_DEFAULT.
  • AD_TYPE_VIDEO, nowe elementy zamówienia będą dziedziczyć to ustawienie, gdy lineItemType będzie mieć wartość LINE_ITEM_TYPE_VIDEO_DEFAULT.

CarrierAndIspAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania na operatora sieci komórkowej i dostawcę internetu. To pole zostanie wypełnione w polu szczegółów obiektu AssignedTargetingOption, gdy wartość targetingType to TARGETING_TYPE_CARRIER_AND_ISP.

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

string

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

string

Wymagane. targetingOptionId TargetingOption typu TARGETING_TYPE_CARRIER_AND_ISP.
negative

boolean

Wskazuje, czy ta opcja jest objęta kierowaniem negatywnym. Wszystkie przypisane opcje kierowania na operatora i dostawcę internetu w tym samym zasobie muszą mieć tę samą wartość tego pola.

KeywordAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania na słowa kluczowe. To pole zostanie wypełnione w polu szczegółów obiektu AssignedTargetingOption, gdy wartość targetingType to TARGETING_TYPE_KEYWORD.

Zapis JSON 
{
  "keyword": string,
  "negative": boolean,
  "exemptedPolicyNames": [
    string
  ]
}
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 formacie UTF-8 i mieć maksymalny rozmiar 255 bajtów. Maksymalna liczba znaków to 80. Maksymalna liczba słów to 10.
negative

boolean

Wskazuje, czy ta opcja jest objęta kierowaniem negatywnym.
exemptedPolicyNames[]

string

Opcjonalnie: Nazwy zasad, z których wykluczone jest słowo kluczowe.

Podczas próby kierowania na słowo kluczowe, które narusza zasady, zwracany błąd będzie zawierać nazwę odpowiednich zasad. Użyj tej nazwy w tym polu, aby wyłączyć wybrane słowo kluczowe z zasad.

To pole dotyczy tylko słów kluczowych kierowanych na plus, które są przypisane do zasobów kampanii generującej popyt.

NegativeKeywordListAssignedTargetingOptionDetails

Szczegóły kierowania na listę wykluczających słów kluczowych. To pole zostanie wypełnione w polu szczegółów obiektu AssignedTargetingOption, gdy wartość targetingType to TARGETING_TYPE_NEGATIVE_KEYWORD_LIST.

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 przypisanej opcji kierowania na system operacyjny. To pole zostanie wypełnione w polu operatingSystemDetails, gdy wartość targetingType będzie równa TARGETING_TYPE_OPERATING_SYSTEM.

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

string

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

string

Wymagane. Identyfikator opcji kierowania wypełniony 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 przypisane urządzenie (marka i model). To pole zostanie wypełnione w polu deviceMakeModelDetails, gdy wartość targetingType będzie równa TARGETING_TYPE_DEVICE_MAKE_MODEL.

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

string

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

string

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 przypisanej opcji kierowania na środowisko. To pole zostanie wypełnione w polu szczegółów obiektu AssignedTargetingOption, gdy wartość targetingType to TARGETING_TYPE_ENVIRONMENT.

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

enum (Environment)

Wymagane. Środowisko wyświetlania.

InventorySourceAssignedTargetingOptionDetails

Szczegóły kierowania na źródło zasobów reklamowych. To pole zostanie wypełnione w polu szczegółów obiektu AssignedTargetingOption, gdy wartość targetingType to TARGETING_TYPE_INVENTORY_SOURCE.

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 przypisanej opcji kierowania na kategorię. To pole zostanie wypełnione w polu categoryDetails, gdy wartość targetingType będzie równa TARGETING_TYPE_CATEGORY.

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.

ViewabilityAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania według widoczności. To pole zostanie wypełnione w polu viewabilityDetails obiektu AssignedTargetingOption, gdy wartość targetingType to TARGETING_TYPE_VIEWABILITY.

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

enum (Viewability)

Wymagane. Prognozowany odsetek widoczności.

AuthorizedSellerStatusAssignedTargetingOptionDetails

Reprezentuje przypisany stan autoryzowanego sprzedawcy. To pole zostanie wypełnione w polu szczegółów obiektu AssignedTargetingOption, gdy wartość targetingType to TARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

Jeśli zasób nie ma przypisanej opcji kierowania TARGETING_TYPE_AUTHORIZED_SELLER_STATUS, korzysta z opcji „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 TargetingOption typu TARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

LanguageAssignedTargetingOptionDetails

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

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 TargetingOption typu TARGETING_TYPE_LANGUAGE.
negative

boolean

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

GeoRegionAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania na region geograficzny. To pole zostanie wypełnione w polu szczegółów obiektu AssignedTargetingOption, gdy wartość targetingType to TARGETING_TYPE_GEO_REGION.

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 TargetingOption typu TARGETING_TYPE_GEO_REGION.
geoRegionType

enum (GeoRegionType)

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

boolean

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

InventorySourceGroupAssignedTargetingOptionDetails

Szczegóły kierowania na grupę źródeł zasobów reklamowych. To pole zostanie wypełnione w polu szczegółów obiektu AssignedTargetingOption, gdy wartość targetingType to TARGETING_TYPE_INVENTORY_SOURCE_GROUP.

Zapis JSON 
{
  "inventorySourceGroupId": string
}
Pola
inventorySourceGroupId

string (int64 format)

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

DigitalContentLabelAssignedTargetingOptionDetails

Szczegóły kierowania na etykietę treści cyfrowych. To pole zostanie wypełnione w polu szczegółów obiektu AssignedTargetingOption, gdy wartość targetingType to TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION.

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

enum (ContentRatingTier)

Wymagane. Wyświetlana nazwa poziomu oceny etykiety treści cyfrowych, który ma zostać WYKLUCZONY.

To pole akceptuje tylko wartość CONTENT_RATING_TIER_UNRATED.

SensitiveCategoryAssignedTargetingOptionDetails

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

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

enum (SensitiveCategory)

Wymagane. Wyliczenie kategorii treści o charakterze kontrowersyjnym w Display & Video 360, które zostały sklasyfikowane jako WYKLUCZONE.

To pole akceptuje tylko te wartości:

  • SENSITIVE_CATEGORY_EMBEDDED_VIDEO
  • SENSITIVE_CATEGORY_LIVE_STREAMING_VIDEO

ContentThemeAssignedTargetingOptionDetails

Szczegóły kierowania na temat treści. To pole zostanie wypełnione w polu szczegółów obiektu AssignedTargetingOption, gdy wartość targetingType to TARGETING_TYPE_CONTENT_THEME_EXCLUSION.

Zapis JSON 
{
  "excludedTargetingOptionId": string,
  "contentTheme": enum (ContentTheme),
  "excludedContentTheme": enum (ContentTheme)
}
Pola
excludedTargetingOptionId

string

Wymagane. Identyfikator tematu treści, który ma zostać WYKLUCZONY.
contentTheme

enum (ContentTheme)

Tylko dane wyjściowe. Wyliczenie klasyfikatora motywów treści DV360.
excludedContentTheme

enum (ContentTheme)

Wymagane. Wartość wyliczeniowa tematyki treści DV360, która została sklasyfikowana jako WYKLUCZONA.

ExchangeAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania na giełdę. To pole zostanie wypełnione w polu szczegółów obiektu AssignedTargetingOption, gdy wartość targetingType to TARGETING_TYPE_EXCHANGE.

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

enum (Exchange)

Wymagane. Wartość typu wyliczeniowego dla pakietu wymiany.

SubExchangeAssignedTargetingOptionDetails

Szczegóły opcji kierowania na przypisaną giełdę podrzędną. To pole zostanie wypełnione w polu szczegółów obiektu AssignedTargetingOption, gdy wartość targetingType to TARGETING_TYPE_SUB_EXCHANGE.

Zapis JSON 
{
  "targetingOptionId": string
}
Pola
targetingOptionId

string

Wymagane. targetingOptionId TargetingOption typu TARGETING_TYPE_SUB_EXCHANGE.

ThirdPartyVerifierAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania na weryfikatora zewnętrznego. To pole zostanie wypełnione w polu szczegółów obiektu AssignedTargetingOption, gdy wartość targetingType to TARGETING_TYPE_THIRD_PARTY_VERIFIER.

Zapis JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "adloox": {
    object (Adloox)
  },
  "doubleVerify": {
    object (DoubleVerify)
  },
  "integralAdScience": {
    object (IntegralAdScience)
  }
  // End of mutually exclusive fields.
}
Pola
Może kierować reklamy na jednego z weryfikatorów zewnętrznych, aby egzekwować progi bezpieczeństwa marki w przypadku wyświetleń. Poniżej znajduje się lista pól, które się wzajemnie wykluczają. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
adloox

object (Adloox)

Zewnętrzny weryfikator marki – Scope3 (wcześniej Adloox).
doubleVerify

object (DoubleVerify)

Weryfikator marki firmy zewnętrznej – DoubleVerify.
integralAdScience

object (IntegralAdScience)

Weryfikator marki firmy zewnętrznej – Integral Ad Science.
Koniec pól wykluczających się nawzajem.

Adloox

Szczegółowe informacje o ustawieniach bezpieczeństwa marki udostępnianych przez firmę Scope3 (wcześniej Adloox).

Zapis JSON 
{
  "excludedAdlooxCategories": [
    enum (AdlooxCategory)
  ],
  "excludedFraudIvtMfaCategories": [
    enum (FraudIvtMfaCategory)
  ],
  "adultExplicitSexualContent": enum (GarmRiskExclusion),
  "crimeHarmfulActsIndividualsSocietyHumanRightsViolationsContent": enum (GarmRiskExclusion),
  "armsAmmunitionContent": enum (GarmRiskExclusion),
  "deathInjuryMilitaryConflictContent": enum (GarmRiskExclusion),
  "debatedSensitiveSocialIssueContent": enum (GarmRiskExclusion),
  "illegalDrugsTobaccoEcigarettesVapingAlcoholContent": enum (GarmRiskExclusion),
  "onlinePiracyContent": enum (GarmRiskExclusion),
  "hateSpeechActsAggressionContent": enum (GarmRiskExclusion),
  "obscenityProfanityContent": enum (GarmRiskExclusion),
  "spamHarmfulContent": enum (GarmRiskExclusion),
  "terrorismContent": enum (GarmRiskExclusion),
  "misinformationContent": enum (GarmRiskExclusion),
  "displayIabViewability": enum (DisplayIabViewability),
  "videoIabViewability": enum (VideoIabViewability)
}
Pola
excludedAdlooxCategories[]

enum (AdlooxCategory)

Kategorie Scope3 do wykluczenia.
excludedFraudIvtMfaCategories[]

enum (FraudIvtMfaCategory)

Opcjonalnie: Kategorie MFA dotyczące fałszywego i nieprawidłowego ruchu od Scope3, które chcesz wykluczyć.
adultExplicitSexualContent

enum (GarmRiskExclusion)

Opcjonalnie: Zakresy ryzyka GARM, które należy wykluczyć w przypadku treści dla dorosłych i treści o charakterze jednoznacznie seksualnym.
crimeHarmfulActsIndividualsSocietyHumanRightsViolationsContent

enum (GarmRiskExclusion)

Opcjonalnie: Zakresy ryzyka GARM, które należy wykluczyć w przypadku treści związanych z przestępstwami i szkodliwymi działaniami.
armsAmmunitionContent

enum (GarmRiskExclusion)

Opcjonalnie: Zakresy ryzyka GARM dotyczące treści związanych z bronią i amunicją, które należy wykluczyć.
deathInjuryMilitaryConflictContent

enum (GarmRiskExclusion)

Opcjonalnie: Treści związane ze śmiercią, obrażeniami lub konfliktami wojskowymi GARM: zakresy ryzyka do wykluczenia.
debatedSensitiveSocialIssueContent

enum (GarmRiskExclusion)

Opcjonalnie: Zakresy ryzyka GARM, które należy wykluczyć w przypadku treści związanych z drażliwymi problemami społecznymi.
illegalDrugsTobaccoEcigarettesVapingAlcoholContent

enum (GarmRiskExclusion)

Opcjonalnie: Zakresy ryzyka GARM, które należy wykluczyć w przypadku treści związanych z narkotykami i alkoholem.
onlinePiracyContent

enum (GarmRiskExclusion)

Opcjonalnie: Zakresy ryzyka GARM, które należy wykluczyć w przypadku treści związanych z piractwem online.
hateSpeechActsAggressionContent

enum (GarmRiskExclusion)

Opcjonalnie: Zakresy ryzyka GARM, które należy wykluczyć w przypadku treści związanych z szerzeniem nienawiści i aktami agresji.
obscenityProfanityContent

enum (GarmRiskExclusion)

Opcjonalnie: Zakresy ryzyka GARM, które należy wykluczyć w przypadku treści nieprzyzwoitych i wulgaryzmów.
spamHarmfulContent

enum (GarmRiskExclusion)

Opcjonalnie: Zakresy ryzyka GARM, które należy wykluczyć.
terrorismContent

enum (GarmRiskExclusion)

Opcjonalnie: Zakresy ryzyka GARM dotyczące treści związanych z terroryzmem, które chcesz wykluczyć.
misinformationContent

enum (GarmRiskExclusion)

Opcjonalnie: Zakresy ryzyka GARM dotyczące treści zawierających nieprawdziwe informacje, które należy wykluczyć.
displayIabViewability

enum (DisplayIabViewability)

Opcjonalnie: Próg widoczności reklam displayowych określony przez IAB.
videoIabViewability

enum (VideoIabViewability)

Opcjonalnie: Próg widoczności reklam wideo określony przez IAB.

AdlooxCategory

Dostępne kategorie Scope3 (wcześniej Adloox).

Wartości w polu enum
ADLOOX_UNSPECIFIED Wartość domyślna, gdy w tej wersji nie określono kategorii Scope3 lub jest ona nieznana.
ADULT_CONTENT_HARD treści dla dorosłych (hard);
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 broń.
LOW_VIEWABILITY_DOMAINS domeny o niskiej widoczności,
FRAUD oszustwa,

FraudIvtMfaCategory

Dostępne kategorie dotyczące oszustw, nieprawidłowego ruchu i wieloczynnikowego uwierzytelniania w usłudze Scope3 (wcześniej Adloox).

Wartości w polu enum
FRAUD_IVT_MFA_CATEGORY_UNSPECIFIED Wartość domyślna, gdy w tej wersji nie określono kategorii Scope3 Fraud, IVT ani MFA lub jest ona nieznana.
FRAUD_IVT_MFA FRAUD, IVT, MFA.

GarmRiskExclusion

Dostępne opcje wykluczania poziomu ryzyka GARM.

Wartości w polu enum
GARM_RISK_EXCLUSION_UNSPECIFIED Ten typ wyliczeniowy jest tylko symbolem zastępczym i nie określa żadnej opcji wykluczania ryzyka GARM.
GARM_RISK_EXCLUSION_FLOOR Wyklucz skrajny poziom ryzyka.
GARM_RISK_EXCLUSION_HIGH Wyklucz wysokie i skrajne ryzyko.
GARM_RISK_EXCLUSION_MEDIUM Wyklucz średni, wysoki i skrajny poziom ryzyka.
GARM_RISK_EXCLUSION_LOW Wyklucz wszystkie poziomy ryzyka (niski, średni, wysoki i skrajny).

DisplayIabViewability

Dostępne progi widoczności reklam displayowych IAB Scope3 (wcześniej Adloox).

Wartości w polu enum
DISPLAY_IAB_VIEWABILITY_UNSPECIFIED Wartość domyślna, gdy w tej wersji nie jest określona lub jest nieznana.
DISPLAY_IAB_VIEWABILITY_10 10%+ widocznych (standard widoczności reklam displayowych IAB).
DISPLAY_IAB_VIEWABILITY_20 20%+ widocznych (standard widoczności reklam displayowych IAB).
DISPLAY_IAB_VIEWABILITY_35 co najmniej 35%widoczności (standard widoczności reklam displayowych IAB);
DISPLAY_IAB_VIEWABILITY_50 50%+ widocznych (standard widoczności reklam displayowych IAB).
DISPLAY_IAB_VIEWABILITY_75 co najmniej 75%w widoku (standard widoczności reklam displayowych IAB);

VideoIabViewability

Dostępne progi widoczności reklam wideo IAB w przypadku Scope3 (wcześniej Adloox).

Wartości w polu enum
VIDEO_IAB_VIEWABILITY_UNSPECIFIED Wartość domyślna, gdy w tej wersji nie jest określona lub jest nieznana.
VIDEO_IAB_VIEWABILITY_10 10%+ widoczności (standard widoczności reklam wideo IAB).
VIDEO_IAB_VIEWABILITY_20 20%+ widoczności (standard widoczności reklam wideo IAB).
VIDEO_IAB_VIEWABILITY_35 35%+ widoczności (standard widoczności reklam wideo IAB).
VIDEO_IAB_VIEWABILITY_50 50%lub więcej widocznych pikseli (standard widoczności reklam wideo IAB).
VIDEO_IAB_VIEWABILITY_75 75%+ widoczności (standard widoczności reklam wideo IAB).

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 określania stawek w przypadku aplikacji o tej kategorii wiekowej.
appStarRating

object (AppStarRating)

Unikaj określania stawek w przypadku aplikacji o określonej liczbie gwiazdek.
displayViewability

object (DisplayViewability)

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

object (VideoViewability)

Ustawienia widoczności filmu (dotyczą tylko elementów zamówienia wideo).
fraudInvalidTraffic

object (FraudInvalidTraffic)

Unikaj witryn i aplikacji, których historyczny wskaźnik fałszywego i nieprawidłowego ruchu z reklam jest wysoki.
customSegmentId

string (int64 format)

Identyfikator segmentu niestandardowego podany 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 bezpieczeństwa marki.

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

boolean

Nieznane lub nie można ocenić.
avoidedHighSeverityCategories[]

enum (HighSeverityCategory)

Kategorie kontroli bezpieczeństwa marki o wysokim poziomie ryzyka.
avoidedMediumSeverityCategories[]

enum (MediumSeverityCategory)

Kategorie kontroli bezpieczeństwa marki o średnim poziomie ryzyka.

HighSeverityCategory

Możliwe opcje w przypadku kategorii o wysokim poziomie ważności.

Wartości w polu enum
HIGHER_SEVERITY_UNSPECIFIED Ten wyliczenie jest tylko symbolem zastępczym i nie określa żadnych kategorii o wysokim poziomie ważności.
ADULT_CONTENT_PORNOGRAPHY Treści dla dorosłych: pornografia, tematy tylko dla dorosłych i nagość.
COPYRIGHT_INFRINGEMENT naruszenie praw autorskich;
SUBSTANCE_ABUSE Narkotyki, alkohol lub środki odurzające: nadużywanie środków odurzających.
GRAPHIC_VIOLENCE_WEAPONS Drastyczne sceny, skrajna przemoc lub broń.
HATE_PROFANITY Wypowiedzi szerzące nienawiść lub wulgaryzmy.
CRIMINAL_SKILLS Działania niezgodne z prawem: metody popełniania przestępstw.
NUISANCE_INCENTIVIZED_MALWARE_CLUTTER Stosowanie zachęt, złośliwe oprogramowanie lub natłok reklam.

MediumSeverityCategory

Możliwe opcje w przypadku kategorii o średnim poziomie ważności.

Wartości w polu enum
MEDIUM_SEVERITY_UNSPECIFIED Ten typ wyliczeniowy jest tylko symbolem zastępczym i nie określa żadnych kategorii o średnim poziomie 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: spowodowana przez człowieka.
DISASTER_NATURAL Katastrofa: naturalna.
DISASTER_TERRORIST_EVENTS Katastrofy: akty terroryzmu.
DISASTER_VEHICLE Katastrofa: pojazd.
ALCOHOL Narkotyki, alkohol lub środki odurzające: alkohol.
SMOKING Narkotyki, alkohol lub środki odurzające: palenie tytoniu.
NEGATIVE_NEWS_FINANCIAL Negatywne wiadomości: finansowe.
NON_ENGLISH Niestandardowe treści: w języku innym niż angielski.
PARKING_PAGE Niestandardowe treści: strona parkingowa.
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 kategorii wiekowych.

Wartości w polu enum
AGE_RATING_UNSPECIFIED Ten wyliczeniowy typ danych jest tylko symbolem zastępczym i nie określa żadnych opcji kategorii wiekowych.
APP_AGE_RATE_UNKNOWN Aplikacje o nieznanej kategorii wiekowej.
APP_AGE_RATE_4_PLUS Aplikacje z oceną Dla wszystkich (4+).
APP_AGE_RATE_9_PLUS Aplikacje z oceną Dla wszystkich (od 9 lat).
APP_AGE_RATE_12_PLUS Aplikacje dla nastolatków (od 12 lat).
APP_AGE_RATE_17_PLUS Aplikacje dla starszych odbiorców (od 17 lat).
APP_AGE_RATE_18_PLUS Aplikacje z oceną Tylko dla dorosłych (18+).

AppStarRating

Szczegóły ustawień ocen gwiazdkowych DoubleVerify.

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

enum (StarRating)

Unikaj określania stawek w przypadku aplikacji o określonej liczbie gwiazdek.
avoidInsufficientStarRating

boolean

Unikaj określania stawek w przypadku aplikacji o niewystarczającej liczbie gwiazdek.

StarRating

Możliwe opcje ocen w formie gwiazdek.

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

DisplayViewability

Szczegóły ustawień widoczności wyświetleń DoubleVerify.

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

enum (IAB)

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

enum (ViewableDuring)

Kieruj na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować czas trwania wyświetlenia widocznego w 100%.

IAB

Możliwe opcje współczynnika widocznych wyświetleń według IAB.

Wartości w polu enum
IAB_VIEWED_RATE_UNSPECIFIED Ten wyliczenie jest tylko symbolem zastępczym i nie określa żadnych opcji stawek wyświetleń zgodnych z IAB.
IAB_VIEWED_RATE_80_PERCENT_HIGHER Kieruj na zasoby reklamowe w witrynach i zasoby reklamowe aplikacji, aby zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 80%.
IAB_VIEWED_RATE_75_PERCENT_HIGHER Kieruj na zasoby reklamowe w witrynach i zasoby reklamowe aplikacji, aby zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 75%.
IAB_VIEWED_RATE_70_PERCENT_HIGHER Kieruj na zasoby reklamowe w witrynach i zasoby reklamowe aplikacji, aby zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 70%.
IAB_VIEWED_RATE_65_PERCENT_HIGHER Kieruj na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować współczynnik widoczności IAB (co najmniej 65%).
IAB_VIEWED_RATE_60_PERCENT_HIGHER Kieruj na zasoby reklamowe w witrynach i zasoby reklamowe aplikacji, aby zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 60%.
IAB_VIEWED_RATE_55_PERCENT_HIGHER Kieruj na zasoby reklamowe w witrynach i zasoby reklamowe aplikacji, aby zmaksymalizować współczynnik widoczności IAB (co najmniej 55%).
IAB_VIEWED_RATE_50_PERCENT_HIGHER Kieruj na zasoby reklamowe w witrynach i zasoby reklamowe aplikacji, aby zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 50%.
IAB_VIEWED_RATE_40_PERCENT_HIGHER Kieruj 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 na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 30%.

ViewableDuring

Możliwe opcje czasu wyświetlania.

Wartości w polu enum
AVERAGE_VIEW_DURATION_UNSPECIFIED Ten wyliczeniowy typ danych jest tylko symbolem zastępczym 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 na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować czas trwania wyświetlenia widocznego w 100% przez co najmniej 10 sekund.
AVERAGE_VIEW_DURATION_15_SEC Kieruj na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować czas trwania wyświetlenia widocznego w 100% (co najmniej 15 sekund).

VideoViewability

Szczegóły ustawień widoczności filmów DoubleVerify.

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

enum (VideoIAB)

Kieruj na spis adresów URL w witrynach, aby zmaksymalizować współczynnik widocznych wyświetleń według IAB.
videoViewableRate

enum (VideoViewableRate)

Kieruj na spis adresów URL, aby zmaksymalizować współczynnik w pełni widocznych wyświetleń.
playerImpressionRate

enum (PlayerImpressionRate)

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

VideoIAB

Możliwe opcje współczynnika widocznych wyświetleń według IAB.

Wartości w polu enum
VIDEO_IAB_UNSPECIFIED Ten typ wyliczeniowy jest tylko symbolem zastępczym i nie określa żadnych opcji współczynnika widoczności wideo IAB.
IAB_VIEWABILITY_80_PERCENT_HIGHER Kieruj na zasoby reklamowe w witrynach i zasoby reklamowe aplikacji, aby zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 80%.
IAB_VIEWABILITY_75_PERCENT_HIGHER Kieruj na zasoby reklamowe w witrynach i zasoby reklamowe aplikacji, aby zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 75%.
IAB_VIEWABILITY_70_PERCENT_HIGHER Kieruj na zasoby reklamowe w witrynach i zasoby reklamowe aplikacji, aby zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 70%.
IAB_VIEWABILITY_65_PERCENT_HIHGER Kieruj na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować współczynnik widoczności IAB (co najmniej 65%).
IAB_VIEWABILITY_60_PERCENT_HIGHER Kieruj na zasoby reklamowe w witrynach i zasoby reklamowe aplikacji, aby zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 60%.
IAB_VIEWABILITY_55_PERCENT_HIHGER Kieruj na zasoby reklamowe w witrynach i zasoby reklamowe aplikacji, aby zmaksymalizować współczynnik widoczności IAB (co najmniej 55%).
IAB_VIEWABILITY_50_PERCENT_HIGHER Kieruj na zasoby reklamowe w witrynach i zasoby reklamowe aplikacji, aby zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 50%.
IAB_VIEWABILITY_40_PERCENT_HIHGER Kieruj 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 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 Ten wyliczeniowy typ danych jest tylko symbolem zastępczym i nie określa żadnych opcji współczynnika wyświetleń filmu.
VIEWED_PERFORMANCE_40_PERCENT_HIGHER Kieruj na zasoby reklamowe w witrynach, aby zmaksymalizować współczynnik w pełni widocznych wyświetleń (co najmniej 40%).
VIEWED_PERFORMANCE_35_PERCENT_HIGHER Kieruj na spis adresów URL, aby zmaksymalizować współczynnik w pełni widocznych wyświetleń (co najmniej 35%).
VIEWED_PERFORMANCE_30_PERCENT_HIGHER Kieruj na spis adresów URL, aby zmaksymalizować współczynnik w pełni widocznych wyświetleń na poziomie co najmniej 30%.
VIEWED_PERFORMANCE_25_PERCENT_HIGHER Kieruj na spis adresów URL, aby zmaksymalizować współczynnik w pełni widocznych wyświetleń (co najmniej 25%).
VIEWED_PERFORMANCE_20_PERCENT_HIGHER Kieruj na zasoby reklamowe w witrynach, aby zmaksymalizować współczynnik w pełni widocznych wyświetleń na poziomie co najmniej 20%.
VIEWED_PERFORMANCE_10_PERCENT_HIGHER Kieruj na spis adresów URL, aby zmaksymalizować współczynnik w pełni widocznych wyświetleń na poziomie co najmniej 10%.

PlayerImpressionRate

Możliwe opcje wyświetleń.

Wartości w polu enum
PLAYER_SIZE_400X300_UNSPECIFIED Ten wyliczenie jest tylko symbolem zastępczym i nie określa żadnych opcji wyświetleń.
PLAYER_SIZE_400X300_95 Witryny, w których przypadku co najmniej 95%wyświetleń pochodzi z reklam.
PLAYER_SIZE_400X300_70 Witryny z co najmniej 70%wyświetleń.
PLAYER_SIZE_400X300_25 Witryny, które generują co najmniej 25%wyświetleń.
PLAYER_SIZE_400X300_5 Witryny z co najmniej 5%wyświetleń.

FraudInvalidTraffic

Ustawienia dotyczące fałszywego i nieprawidłowego ruchu w usłudze DoubleVerify.

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

enum (FraudOption)

Unikaj witryn i aplikacji, w których występuje historyczny fałszywy i nieprawidłowy ruch.
avoidInsufficientOption

boolean

Niewystarczające dane historyczne dotyczące fałszywego i nieprawidłowego ruchu z reklam.

FraudOption

Możliwe opcje historycznego wskaźnika fałszywego i nieprawidłowego ruchu z reklam.

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

IntegralAdScience

Szczegół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
  ],
  "qualitySyncCustomSegmentId": [
    string
  ]
}
Pola
traqScoreOption

enum (TRAQScore)

True Advertising Quality (dotyczy tylko displayowych elementów zamówienia).
excludeUnrateable

boolean

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

enum (Adult)

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

enum (Alcohol)

Bezpieczeństwo marki – alkohol.
excludedIllegalDownloadsRisk

enum (IllegalDownloads)

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

enum (Drugs)

Bezpieczeństwo marki – narkotyki.
excludedHateSpeechRisk

enum (HateSpeech)

Bezpieczeństwo marki – wypowiedzi szerzące nienawiść.
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ść filmu (dotyczy tylko elementów zamówienia wideo).
customSegmentId[]

string (int64 format)

Identyfikator segmentu niestandardowego podany przez Integral Ad Science. Identyfikator musi mieścić się w zakresie od 1000001 do 1999999 lub od 3000001 do 3999999 (włącznie).
qualitySyncCustomSegmentId[]

string (int64 format)

Opcjonalnie: Identyfikator segmentu niestandardowego synchronizacji jakości podany przez Integral Ad Science. Identyfikator musi mieścić się w zakresie od 3000000 do 4999999.

TRAQScore

Możliwe zakresy wyników TRAQ (true advertising quality) firmy Integral Ad Science.

Wartości w polu enum
TRAQ_UNSPECIFIED Ten typ wyliczeniowy jest tylko symbolem zastępczym i nie określa żadnych rzeczywistych wyników jakości reklam.
TRAQ_250 Wynik TRAQ w zakresie 250–1000.
TRAQ_500 Wynik TRAQ 500–1000.
TRAQ_600 Wynik TRAQ w zakresie 600–1000.
TRAQ_700 Wynik TRAQ w zakresie 700–1000.
TRAQ_750 Wynik TRAQ w zakresie 750–1000.
TRAQ_875 Wynik TRAQ w zakresie 875–1000.
TRAQ_1000 Wynik TRAQ 1000.

Dorosły

Możliwe opcje Integral Ad Science dotyczące treści dla dorosłych.

Wartości w polu enum
ADULT_UNSPECIFIED Ten wyliczenie jest tylko symbolem zastępczym 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 Integral Ad Science dotyczące alkoholu.

Wartości w polu enum
ALCOHOL_UNSPECIFIED Ten wyliczeniowy typ danych jest tylko symbolem zastępczym i nie określa żadnych opcji alkoholu.
ALCOHOL_HR Alkohol – wyklucz wysokie ryzyko.
ALCOHOL_HMR Alkohol – wyklucz wysokie i umiarkowane ryzyko.

IllegalDownloads

Możliwe opcje nielegalnych pobrań Integral Ad Science.

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

Narkotyki

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

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

HateSpeech

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

Wartości w polu enum
HATE_SPEECH_UNSPECIFIED Ten typ wyliczeniowy jest tylko obiektem zastępczym i nie określa żadnych opcji dotyczących szerzenia nienawiści.
HATE_SPEECH_HR Szerzenie nienawiści – wyklucz wysokie ryzyko.
HATE_SPEECH_HMR Szerzenie nienawiści – wyklucz wysokie i umiarkowane ryzyko.

OffensiveLanguage

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

Wartości w polu enum
OFFENSIVE_LANGUAGE_UNSPECIFIED Ten wyliczeniowy typ danych 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 przemocy w Integral Ad Science.

Wartości w polu enum
VIOLENCE_UNSPECIFIED Ten typ wyliczeniowy jest tylko symbolem zastępczym i nie określa żadnych opcji dotyczących przemocy.
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 Ten wyliczeniowy typ danych jest tylko symbolem zastępczym i nie określa żadnych opcji hazardowych.
GAMBLING_HR Hazard – wyklucz wysokie ryzyko.
GAMBLING_HMR Hazard – wyklucz wysokie i umiarkowane ryzyko.

AdFraudPrevention

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

Wartości w polu enum
SUSPICIOUS_ACTIVITY_UNSPECIFIED Ten wyliczenie to tylko obiekt zastępczy i nie określa żadnych opcji zapobiegania oszustwom związanym z reklamami.
SUSPICIOUS_ACTIVITY_HR Oszustwa reklamowe – wyklucz wysokie ryzyko.
SUSPICIOUS_ACTIVITY_HMR Oszustwa reklamowe – wyklucz wysokie i umiarkowane ryzyko.
SUSPICIOUS_ACTIVITY_FD Oszustwo reklamowe – wykluczanie urządzeń, które mogą być używane do oszustw.

DisplayViewability

Dostępne opcje widoczności reklam displayowych Integral Ad Science.

Wartości w polu enum
PERFORMANCE_VIEWABILITY_UNSPECIFIED Ten wyliczenie to tylko symbol zastępczy i nie określa żadnych opcji widoczności reklam displayowych.
PERFORMANCE_VIEWABILITY_40 Dąż do osiągnięcia wskaźnika widoczności na poziomie co najmniej 40%.
PERFORMANCE_VIEWABILITY_50 Dąż do osiągnięcia widoczności na poziomie co najmniej 50%.
PERFORMANCE_VIEWABILITY_60 Dąż do osiągnięcia widoczności na poziomie co najmniej 60%.
PERFORMANCE_VIEWABILITY_70 Dąż do osiągnięcia wskaźnika widoczności na poziomie co najmniej 70%.

VideoViewability

Możliwe opcje widoczności filmu Integral Ad Science.

Wartości w polu enum
VIDEO_VIEWABILITY_UNSPECIFIED Ten wyliczenie jest tylko symbolem zastępczym i nie określa żadnych opcji widoczności filmu.
VIDEO_VIEWABILITY_40 40%+ widoczności (standard widoczności reklam wideo IAB).
VIDEO_VIEWABILITY_50 50%lub więcej widocznych pikseli (standard widoczności reklam wideo IAB).
VIDEO_VIEWABILITY_60 60%+ widoczności (standard widoczności reklam wideo IAB).
VIDEO_VIEWABILITY_70 co najmniej 70%widoczności (standard IAB dotyczący widoczności reklam wideo);

PoiAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania na wybrane punkty POI. To pole zostanie wypełnione w polu szczegółów obiektu AssignedTargetingOption, gdy wartość targetingType to TARGETING_TYPE_POI.

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

string

Tylko dane wyjściowe. Nazwa wyświetlana punktu POI, np. „Times Square”, „Space Needle”, a następnie pełny adres, jeśli jest dostępny.
targetingOptionId

string

Wymagane. targetingOptionId TargetingOption typu TARGETING_TYPE_POI.

Akceptowane identyfikatory opcji kierowania na ważne miejsca można pobrać za pomocą targetingTypes.targetingOptions.search.

Jeśli kierujesz reklamy na konkretne współrzędne geograficzne usunięte z adresu lub nazwy ważnego miejsca, możesz wygenerować potrzebny identyfikator opcji kierowania, zaokrąglając wybrane wartości współrzędnych do 6 miejsca po przecinku, usuwając miejsca po przecinku i łącząc wartości ciągu znaków rozdzielone średnikiem. Możesz na przykład kierować reklamy na parę współrzędnych geograficznych 40.7414691, -74.003387, używając identyfikatora opcji kierowania „40741469;-74003387”. Po utworzeniu tego pola jego wartość zostanie zaktualizowana przez dodanie średnika i wartości skrótu alfanumerycznego, jeśli podano tylko współrzędne geograficzne.
latitude

number

Tylko dane wyjściowe. Szerokość geograficzna ważnego miejsca zaokrąglona do 6 miejsc po przecinku.
longitude

number

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

number

Wymagane. Promień obszaru wokół punktu POI, na który będą kierowane reklamy. Jednostki promienia są określone przez proximityRadiusUnit. Wartość musi mieścić się w przedziale od 1 do 800, jeśli jednostką jest DISTANCE_UNIT_KILOMETERS, i od 1 do 500, jeśli jednostką jest DISTANCE_UNIT_MILES.
proximityRadiusUnit

enum (DistanceUnit)

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

DistanceUnit

Możliwe opcje jednostek odległości.

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

BusinessChainAssignedTargetingOptionDetails

Szczegóły opcji kierowania na przypisaną sieć placówek firmy. To pole zostanie wypełnione w polu szczegółów obiektu AssignedTargetingOption, gdy wartość targetingType to TARGETING_TYPE_BUSINESS_CHAIN.

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

string

Tylko dane wyjściowe. Wyświetlana nazwa sieci placówek firmy, np. „KFC”, „Chase Bank”.
targetingOptionId

string

Wymagane. targetingOptionId TargetingOption typu TARGETING_TYPE_BUSINESS_CHAIN.

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

number

Wymagane. Promień obszaru wokół sieci placówek firmy, który będzie objęty kierowaniem. Jednostki promienia są określone przez proximityRadiusUnit. Wartość musi mieścić się w przedziale od 1 do 800, jeśli jednostką jest DISTANCE_UNIT_KILOMETERS, i 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 zostanie zaokrąglone do 15,6.
proximityRadiusUnit

enum (DistanceUnit)

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

ContentDurationAssignedTargetingOptionDetails

Szczegóły opcji kierowania przypisanej do czasu trwania treści. To pole zostanie wypełnione w polu contentDurationDetails, gdy wartość targetingType będzie równa TARGETING_TYPE_CONTENT_DURATION. Kierowanie na wszystkie opcje nie jest obsługiwane. Aby to osiągnąć, 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. To pole zostanie wypełnione w polu contentStreamTypeDetails, gdy wartość targetingType będzie równa TARGETING_TYPE_CONTENT_STREAM_TYPE. Kierowanie na wszystkie opcje nie jest obsługiwane. Aby to osiągnąć, 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 do pozycji treści natywnych. To pole zostanie wypełnione w polu nativeContentPositionDetails, gdy wartość targetingType będzie równa TARGETING_TYPE_NATIVE_CONTENT_POSITION. Kierowanie na wszystkie opcje nie jest obsługiwane. Aby to osiągnąć, usuń wszystkie opcje kierowania na pozycje treści natywnych.

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

enum (NativeContentPosition)

Wymagane. Pozycja treści.

OmidAssignedTargetingOptionDetails

Reprezentuje typ zasobów reklamowych z włączonym Open Measurement, który można kierować. To pole zostanie wypełnione w polu szczegółów obiektu AssignedTargetingOption, gdy wartość targetingType to TARGETING_TYPE_OMID.

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

enum (Omid)

Wymagane. Typ zasobów reklamowych z włączonym otwartym pomiarem.

AudioContentTypeAssignedTargetingOptionDetails

Szczegóły opcji kierowania przypisanej do typu treści audio. To pole zostanie wypełnione w polu audioContentTypeDetails, gdy wartość targetingType będzie równa TARGETING_TYPE_AUDIO_CONTENT_TYPE. Kierowanie na wszystkie opcje nie jest obsługiwane. Aby to osiągnąć, 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 przypisanej do gatunku treści. To pole zostanie wypełnione w polu contentGenreDetails, gdy wartość targetingType będzie równa TARGETING_TYPE_CONTENT_GENRE. 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 objęta kierowaniem negatywnym.

YoutubeVideoAssignedTargetingOptionDetails

Szczegóły opcji kierowania przypisanej do filmu na YouTube. To pole zostanie wypełnione w polu youtubeVideoDetails, gdy wartość targetingType będzie równa TARGETING_TYPE_YOUTUBE_VIDEO.

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

string

Identyfikator filmu na YouTube wyświetlany na stronie odtwarzania filmu w YouTube.
negative

boolean

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

YoutubeChannelAssignedTargetingOptionDetails

Szczegóły opcji kierowania przypisanej do kanału w YouTube. To pole zostanie wypełnione w polu youtubeChannelDetails, gdy wartość targetingType będzie równa TARGETING_TYPE_YOUTUBE_CHANNEL.

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

string

Identyfikator kanału w YouTube, na który przesyłane są filmy, 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 w sesji. To pole zostanie wypełnione w polu sessionPositionDetails, gdy wartość targetingType będzie równa TARGETING_TYPE_SESSION_POSITION.

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

enum (SessionPosition)

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

SessionPosition

Możliwe pozycje w sesji.

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

YoutubeChannelPackAssignedTargetingOptionDetails

Szczegóły opcji kierowania przypisanej do pakietu kanałów w YouTube. To pole zostanie wypełnione w polu youtubeChannelPackDetails, gdy wartość targetingType będzie równa TARGETING_TYPE_YOUTUBE_CHANNEL_PACK.

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

string (int64 format)

Wymagane. Identyfikator pakietu kanałów w YouTube.
negative

boolean

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

Dziedziczenie

Wskazuje, czy przypisana opcja kierowania jest dziedziczona z podmiotu wyższego poziomu, np. partnera lub reklamodawcy. Odziedziczone przypisane opcje kierowania mają pierwszeństwo, są zawsze stosowane podczas wyświetlania reklam zamiast kierowania przypisanego na bieżącym poziomie i nie można ich modyfikować za pomocą bieżącej usługi dotyczącej elementu. Muszą być modyfikowane za pomocą usługi elementu, z której są dziedziczone. Dziedziczenie dotyczy tylko kanałów objętych kierowaniem negatywnym, wykluczeń kategorii o charakterze kontrowersyjnym i wykluczeń etykiet treści cyfrowych, jeśli są 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 podmiotu 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.

Metody

create

 Przypisuje opcję kierowania do grupy reklam.

delete

 Usuwa przypisaną opcję kierowania z grupy reklam.

get

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

list

 Zawiera listę opcji kierowania przypisanych do grupy reklam.