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),

  // Union field details can be only one of the following:
  "channelDetails": {
    object (ChannelAssignedTargetingOptionDetails)
  },
  "appCategoryDetails": {
    object (AppCategoryAssignedTargetingOptionDetails)
  },
  "appDetails": {
    object (AppAssignedTargetingOptionDetails)
  },
  "urlDetails": {
    object (UrlAssignedTargetingOptionDetails)
  },
  "dayAndTimeDetails": {
    object (DayAndTimeAssignedTargetingOptionDetails)
  },
  "ageRangeDetails": {
    object (AgeRangeAssignedTargetingOptionDetails)
  },
  "regionalLocationListDetails": {
    object (RegionalLocationListAssignedTargetingOptionDetails)
  },
  "proximityLocationListDetails": {
    object (ProximityLocationListAssignedTargetingOptionDetails)
  },
  "genderDetails": {
    object (GenderAssignedTargetingOptionDetails)
  },
  "videoPlayerSizeDetails": {
    object (VideoPlayerSizeAssignedTargetingOptionDetails)
  },
  "userRewardedContentDetails": {
    object (UserRewardedContentAssignedTargetingOptionDetails)
  },
  "parentalStatusDetails": {
    object (ParentalStatusAssignedTargetingOptionDetails)
  },
  "contentInstreamPositionDetails": {
    object (ContentInstreamPositionAssignedTargetingOptionDetails)
  },
  "contentOutstreamPositionDetails": {
    object (ContentOutstreamPositionAssignedTargetingOptionDetails)
  },
  "deviceTypeDetails": {
    object (DeviceTypeAssignedTargetingOptionDetails)
  },
  "audienceGroupDetails": {
    object (AudienceGroupAssignedTargetingOptionDetails)
  },
  "browserDetails": {
    object (BrowserAssignedTargetingOptionDetails)
  },
  "householdIncomeDetails": {
    object (HouseholdIncomeAssignedTargetingOptionDetails)
  },
  "onScreenPositionDetails": {
    object (OnScreenPositionAssignedTargetingOptionDetails)
  },
  "carrierAndIspDetails": {
    object (CarrierAndIspAssignedTargetingOptionDetails)
  },
  "keywordDetails": {
    object (KeywordAssignedTargetingOptionDetails)
  },
  "negativeKeywordListDetails": {
    object (NegativeKeywordListAssignedTargetingOptionDetails)
  },
  "operatingSystemDetails": {
    object (OperatingSystemAssignedTargetingOptionDetails)
  },
  "deviceMakeModelDetails": {
    object (DeviceMakeModelAssignedTargetingOptionDetails)
  },
  "environmentDetails": {
    object (EnvironmentAssignedTargetingOptionDetails)
  },
  "inventorySourceDetails": {
    object (InventorySourceAssignedTargetingOptionDetails)
  },
  "categoryDetails": {
    object (CategoryAssignedTargetingOptionDetails)
  },
  "viewabilityDetails": {
    object (ViewabilityAssignedTargetingOptionDetails)
  },
  "authorizedSellerStatusDetails": {
    object (AuthorizedSellerStatusAssignedTargetingOptionDetails)
  },
  "languageDetails": {
    object (LanguageAssignedTargetingOptionDetails)
  },
  "geoRegionDetails": {
    object (GeoRegionAssignedTargetingOptionDetails)
  },
  "inventorySourceGroupDetails": {
    object (InventorySourceGroupAssignedTargetingOptionDetails)
  },
  "digitalContentLabelExclusionDetails": {
    object (DigitalContentLabelAssignedTargetingOptionDetails)
  },
  "sensitiveCategoryExclusionDetails": {
    object (SensitiveCategoryAssignedTargetingOptionDetails)
  },
  "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)
  }
  // End of list of possible types for union field details.
}
Pola
name

string

Tylko dane wyjściowe. Nazwa zasobu 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 wykorzystany 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 dotychczasowego kierowania.

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

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

To pole jest też obsługiwane w przypadku 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.
Pole zbiorcze details. Szczegółowe informacje o przypisywanej opcji kierowania. Można wypełnić tylko jedno pole w szczegółach, które musi odpowiadać wartości targeting_type. Wartość details może być tylko jedną z tych opcji:
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 dotyczące 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 regionalnej listy lokalizacji. 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 reklamy wideo typu instream. To pole zostanie wypełnione, gdy wartość targetingType będzie równa TARGETING_TYPE_CONTENT_INSTREAM_POSITION.
contentOutstreamPositionDetails

object (ContentOutstreamPositionAssignedTargetingOptionDetails)

Szczegóły dotyczące 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)

Informacje o przeglądarce. 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)

Informacje o operatorze 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łów kluczowych. 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łów kluczowych. 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 statusu 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 kierowanie jest ustawione 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ą skonfigurowane, 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 wszystkie etykiety treści cyfrowych są wykluczone, 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 są wykluczeniami z kierowania. Wykluczenia kategorii o charakterze kontrowersyjnym na poziomie reklamodawcy, jeśli są ustawione, są zawsze stosowane podczas wyświetlania reklam (nawet jeśli nie są widoczne w ustawieniach zasobu). Ustawienia zasobów mogą wykluczać kategorie o charakterze kontrowersyjnym oprócz wykluczeń reklamodawców, 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ń reklamodawców.
exchangeDetails

object (ExchangeAssignedTargetingOptionDetails)

Szczegóły wymiany. 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 zewnętrznego dostawcę. 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 dotyczące 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 dotyczące 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 obsługą standardu 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 w 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.

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 w wyświetlaniu 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, na które kierowane są reklamy negatywnie, 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.

ChannelAssignedTargetingOptionDetails

Szczegóły opcji kierowania na przypisany kanał. To pole zostanie wypełnione w polu szczegółów obiektu AssignedTargetingOption, gdy wartość targetingType będzie równa 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ść pola 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 przypisanej opcji kierowania na aplikację. To pole zostanie wypełnione w polu szczegółów obiektu AssignedTargetingOption, gdy wartość targetingType będzie równa 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 9-cyfrowy ciąg znaków, 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 zostanie określone, przyjmuje się, że platformą aplikacji jest platforma mobilna (czyli 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 wyliczenie to obiekt zastępczy 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 Platformą aplikacji jest Amazon Fire TV.
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 Platforma aplikacji to LG TV.
APP_PLATFORM_VIZIO_TV Platformą aplikacji jest VIZIO TV.

UrlAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania na adres URL. To pole zostanie wypełnione w polu szczegółów obiektu AssignedTargetingOption, gdy wartość targetingType będzie równa 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 godziną rozpoczęcia i zakończenia. Czas reprezentowany przez startHour musi przypadać przed czasem reprezentowanym przez endHour.

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

enum (DayOfWeek)

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

integer

Wymagane. Godzina rozpoczęcia kierowania na datę 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 datę 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ę.

DzieńTygodnia

Reprezentuje dzień tygodnia.

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

TimeZoneResolution

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

Wartości w polu enum
TIME_ZONE_RESOLUTION_UNSPECIFIED Rozdzielczość strefy czasowej jest nieokreślona lub nieznana.
TIME_ZONE_RESOLUTION_END_USER Czas jest podawany w strefie czasowej użytkownika, który 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 będzie równa 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 będzie równa TARGETING_TYPE_REGIONAL_LOCATION_LIST.

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

string (int64 format)

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

boolean

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

ProximityLocationListAssignedTargetingOptionDetails

Szczegóły kierowania na listę lokalizacji zbliżonych obszarów. To pole zostanie wypełnione w polu szczegółów obiektu AssignedTargetingOption, gdy wartość targetingType będzie równa 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 kolumnie 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 odległości 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 obiektem zastępczym wartości domyślnej i nie reprezentuje rzeczywistej jednostki odległości.
PROXIMITY_RADIUS_UNIT_MILES Jednostka odległości promienia w milach.
PROXIMITY_RADIUS_UNIT_KILOMETERS Jednostka odległości promienia w kilometrach

GenderAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania na płeć. To pole zostanie wypełnione w polu szczegółów obiektu AssignedTargetingOption, gdy wartość targetingType będzie równa 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 w polu targetingType będzie wartość TARGETING_TYPE_VIDEO_PLAYER_SIZE. Kierowanie na wszystkie opcje nie jest obsługiwane. Aby uzyskać ten efekt, usuń wszystkie opcje kierowania na rozmiar odtwarzacza wideo.

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

enum (VideoPlayerSize)

Wymagane. Rozmiar odtwarzacza wideo.

UserRewardedContentAssignedTargetingOptionDetails

Szczegóły opcji kierowania na treści z nagrodą dla użytkowników. To pole zostanie wypełnione w polu userRewardedContentDetails, gdy w polu targetingType będzie wartość 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 będzie równa TARGETING_TYPE_PARENTAL_STATUS.

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

enum (ParentalStatus)

Wymagane. Status rodzicielski odbiorców.

ContentInstreamPositionAssignedTargetingOptionDetails

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

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

enum (ContentInstreamPosition)

Wymagane. Pozycja reklamy wideo lub audio w strumieniu treści.
adType

enum (AdType)

Tylko dane wyjściowe. Typ reklamy, na który chcesz kierować reklamy. Dotyczy tylko kierowania na zamówienia reklamowe, 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

Reprezentuje 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 odtwarzane podczas strumieniowego przesyłania treści w odtwarzaczach wideo.
AD_TYPE_AUDIO Kreacje audio, np. reklamy audio odtwarzane w treściach audio.

ContentOutstreamPositionAssignedTargetingOptionDetails

Szczegóły opcji kierowania na pozycję w treści przypisanej do reklamy typu out-stream. To pole zostanie wypełnione w polu contentOutstreamPositionDetails, gdy w polu targetingType będzie wartość 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óry chcesz kierować reklamy. Dotyczy tylko kierowania na zamówienia reklamowe, 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 będzie równa 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 stawek pozwala zmieniać częstotliwość wyświetlania reklam w zależności od typu urządzenia. Zastosuje mnożnik do pierwotnej ceny stawki. Gdy to pole ma wartość 0, oznacza to, że nie ma zastosowania, zamiast mnożyć 0 przez pierwotną cenę oferty.

Jeśli np. cena stawki bez mnożnika wynosi 10,00 PLN, a mnożnik dla tabletów to 1,5, wynikowa 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 opcji kierowania na przypisaną grupę odbiorców. To pole zostanie wypełnione w polu szczegółów obiektu AssignedTargetingOption, gdy wartość targetingType będzie równa TARGETING_TYPE_AUDIENCE_GROUP. Relacja między poszczególnymi grupami to UNION, z wyjątkiem grup excludedFirstAndThirdPartyAudienceGroup i excludedGoogleAudienceGroup, w przypadku których jako INTERSECTION z innymi grupami używana jest relacja COMPLEMENT.

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

object (FirstAndThirdPartyAudienceGroup)

Opcjonalnie. Identyfikatory własnych list odbiorców i list odbiorców dostarczonych przez firmę zewnętrzną oraz okresy ważności uwzględnionych grup własnych list odbiorców i list odbiorców dostarczonych przez firmę zewnętrzną. Każda grupa odbiorców własnych i odbiorców firm zewnętrznych zawiera tylko identyfikatory odbiorców własnych i odbiorców firm zewnętrznych. Relacja między każdą własną i dostarczoną przez firmę zewnętrzną grupą odbiorców to INTERSECTION, a wynik jest łączony z innymi grupami odbiorców za pomocą operatora UNION. Powtarzające się grupy z tymi samymi ustawieniami zostaną zignorowane.
includedGoogleAudienceGroup

object (GoogleAudienceGroup)

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

object (FirstAndThirdPartyAudienceGroup)

Opcjonalnie. Identyfikatory własnych list odbiorców i list odbiorców dostarczonych przez firmę zewnętrzną oraz okresy, w których te listy były aktualne, w przypadku wykluczonej grupy własnych list odbiorców i list odbiorców dostarczonych przez firmę zewnętrzną. Używane do kierowania wykluczającego. DOPEŁNIENIE SUMY tej grupy i innych wykluczonych grup odbiorców jest używane jako ILOCZYN w przypadku każdego kierowania na odbiorców o wartości dodatniej. Wszystkie elementy są połączone logicznym operatorem „LUB”.
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 w przypadku każdego kierowania na odbiorców o wartości dodatniej. Zawiera tylko odbiorców Google o podobnych zainteresowaniach, odbiorców na rynku i odbiorców korzystających z zainstalowanych aplikacji. Wszystkie elementy są połączone logicznym operatorem „LUB”.

FirstAndThirdPartyAudienceGroup

Szczegóły własnej grupy odbiorców i grupy odbiorców firmy zewnętrznej. Wszystkie ustawienia kierowania na własne listy odbiorców i listy odbiorców dostarczone przez firmę zewnętrzną są połączone ze sobą za pomocą operatora logicznego „LUB”.

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

object (FirstAndThirdPartyAudienceTargetingSetting)

Wymagane. Wszystkie ustawienia kierowania na odbiorców własnych i odbiorców firm zewnętrznych w grupie odbiorców własnych i odbiorców firm zewnętrznych. Powtarzające się ustawienia o tym samym identyfikatorze są niedozwolone.

FirstAndThirdPartyAudienceTargetingSetting

Szczegóły ustawienia kierowania na własne listy odbiorców i listy odbiorców dostarczone przez firmę zewnętrzną.

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

string (int64 format)

Wymagane. Identyfikator własnej listy odbiorców i listy odbiorców dostarczonej przez firmę zewnętrzną w ustawieniu kierowania na własne listy odbiorców i listy odbiorców dostarczone przez firmę zewnętrzną. Ten identyfikator to firstAndThirdPartyAudienceId.
recency

enum (Recency)

Opcjonalnie. Aktualność ustawienia kierowania na własne listy odbiorców i listy odbiorców dostarczone przez firmę zewnętrzną. 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 aktualności własnych list odbiorców i list odbiorców dostarczonych przez firmę zewnętrzną.

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

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ą połączone ze sobą za pomocą operatora logicznego „LUB”.

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

object (CustomListTargetingSetting)

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

CustomListTargetingSetting

Szczegóły ustawienia kierowania na listy niestandardowe.

Zapis JSON 
{
  "customListId": string
}
Pola
customListId

string (int64 format)

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

CombinedAudienceGroup

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

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

object (CombinedAudienceTargetingSetting)

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

CombinedAudienceTargetingSetting

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

Zapis JSON 
{
  "combinedAudienceId": string
}
Pola
combinedAudienceId

string (int64 format)

Wymagane. Identyfikator połączonej grupy odbiorców w ustawieniu kierowania na połączoną grupę odbiorców. Ten identyfikator to combinedAudienceId.

BrowserAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania na przeglądarki. To pole zostanie wypełnione w polu szczegółów obiektu AssignedTargetingOption, gdy wartość targetingType będzie równa 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 elementu 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 będzie równa TARGETING_TYPE_HOUSEHOLD_INCOME.

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

enum (HouseholdIncome)

Wymagane. Dochód gospodarstwa domowego odbiorców.

OnScreenPositionAssignedTargetingOptionDetails

Szczegóły opcji kierowania na pozycję na ekranie. To pole zostanie wypełnione w polu onScreenPositionDetails, gdy w polu targetingType będzie wartość 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óry chcesz kierować reklamy. Dotyczy tylko kierowania na zamówienia reklamowe, 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 operatorów sieci komórkowych i dostawców usług internetowych. To pole zostanie wypełnione w polu szczegółów obiektu AssignedTargetingOption, gdy wartość targetingType będzie równa 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 elementu 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 będzie równa TARGETING_TYPE_KEYWORD.

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

string

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

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.

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 będzie równa 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 w polu targetingType będzie wartość TARGETING_TYPE_OPERATING_SYSTEM.

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

string

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

string

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 przypisanej opcji kierowania na markę i model urządzenia. To pole zostanie wypełnione w polu deviceMakeModelDetails, gdy w polu targetingType będzie wartość TARGETING_TYPE_DEVICE_MAKE_MODEL.

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

string

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

string

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

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

string

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

string

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ść pola targetingType to TARGETING_TYPE_VIEWABILITY.

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

enum (Viewability)

Wymagane. Prognozowany procent widoczności.

AuthorizedSellerStatusAssignedTargetingOptionDetails

Reprezentuje przypisany stan autoryzowanego sprzedawcy. To pole zostanie wypełnione w polu szczegółów obiektu AssignedTargetingOption, gdy wartość targetingType będzie równa 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 elementu 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 będzie równa 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 elementu 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ść tego pola.

GeoRegionAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania na region geograficzny. To pole zostanie wypełnione w polu szczegółów obiektu AssignedTargetingOption, gdy wartość targetingType będzie równa 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 elementu TargetingOption typu TARGETING_TYPE_GEO_REGION.
geoRegionType

enum (GeoRegionType)

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

boolean

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

InventorySourceGroupAssignedTargetingOptionDetails

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

Zapis JSON 
{
  "inventorySourceGroupId": string
}
Pola
inventorySourceGroupId

string (int64 format)

Wymagane. Identyfikator grupy źródła 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 będzie równa 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.

SensitiveCategoryAssignedTargetingOptionDetails

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

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

enum (SensitiveCategory)

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

ContentThemeAssignedTargetingOptionDetails

Szczegóły kierowania na temat treści. To pole zostanie wypełnione w polu szczegółów obiektu AssignedTargetingOption, gdy wartość targetingType będzie równa 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 tematyki treści DV360.
excludedContentTheme

enum (ContentTheme)

Wymagane. Wartość wyliczeniowa tematyki treści w 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 będzie równa TARGETING_TYPE_EXCHANGE.

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

enum (Exchange)

Wymagane. Wartość wyliczeniowa giełdy.

SubExchangeAssignedTargetingOptionDetails

Szczegółowe informacje o przypisanej opcji kierowania na giełdę podrzędną. To pole zostanie wypełnione w polu szczegółów obiektu AssignedTargetingOption, gdy wartość targetingType będzie równa TARGETING_TYPE_SUB_EXCHANGE.

Zapis JSON 
{
  "targetingOptionId": string
}
Pola
targetingOptionId

string

Wymagane. targetingOptionId elementu 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 będzie równa TARGETING_TYPE_THIRD_PARTY_VERIFIER.

Zapis JSON 
{

  // Union field verifier can be only one of the following:
  "adloox": {
    object (Adloox)
  },
  "doubleVerify": {
    object (DoubleVerify)
  },
  "integralAdScience": {
    object (IntegralAdScience)
  }
  // End of list of possible types for union field verifier.
}
Pola
Pole zbiorcze verifier. Może kierować reklamy na jednego z weryfikatorów zewnętrznych, aby egzekwować progi bezpieczeństwa marki w przypadku wyświetleń. verifier może mieć tylko jedną z tych wartości:
adloox

object (Adloox)

Weryfikator marki zewnętrznej – Scope3 (wcześniej Adloox).
doubleVerify

object (DoubleVerify)

Zewnętrzny weryfikator marki – DoubleVerify.
integralAdScience

object (IntegralAdScience)

Zewnętrzny weryfikator marki – Integral Ad Science.

Adloox

Szczegóły ustawień 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 Scope3 dotyczące fałszywego i nieprawidłowego ruchu, które mają zostać wykluczone.
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, które należy wykluczyć z zakresu ryzyka.
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 dotyczące treści związanych z narkotykami i alkoholem, które chcesz wykluczyć.
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ć.
spamHarmfulContent

enum (GarmRiskExclusion)

Opcjonalnie. Zakresy ryzyka GARM, które należy wykluczyć w przypadku spamu lub szkodliwych treści.
terrorismContent

enum (GarmRiskExclusion)

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

enum (GarmRiskExclusion)

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

enum (DisplayIabViewability)

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

enum (VideoIabViewability)

Opcjonalnie. Próg widoczności reklam wideo według IAB.

AdlooxCategory

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

Wartości w polu enum
ADLOOX_UNSPECIFIED Wartość domyślna, gdy w tej wersji kategoria Scope3 nie jest określona lub jest 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 oszustw, nieprawidłowego ruchu i wieloczynnikowego uwierzytelniania 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 lub MFA albo jest ona nieznana.
FRAUD_IVT_MFA FRAUD, IVT, MFA.

GarmRiskExclusion

Dostępne opcje wykluczania poziomów ryzyka GARM.

Wartości w polu enum
GARM_RISK_EXCLUSION_UNSPECIFIED Ten wyliczenie jest tylko symbolem zastępczym i nie określa żadnej opcji wykluczenia 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 w Scope3 (wcześniej Adloox).

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

VideoIabViewability

Dostępne progi widoczności reklam wideo według IAB w przypadku Scope3 (dawniej Adloox).

Wartości w polu enum
VIDEO_IAB_VIEWABILITY_UNSPECIFIED Wartość domyślna, gdy nie jest określona lub jest nieznana w tej wersji.
VIDEO_IAB_VIEWABILITY_10 Co najmniej 10% – widoczność (standard widoczności reklam wideo IAB).
VIDEO_IAB_VIEWABILITY_20 co najmniej 20% – widoczność (standard widoczności reklam wideo IAB);
VIDEO_IAB_VIEWABILITY_35 co najmniej 35% – widoczność (standard widoczności reklam wideo IAB);
VIDEO_IAB_VIEWABILITY_50 co najmniej 50%w widoku (standard widoczności reklam wideo IAB);
VIDEO_IAB_VIEWABILITY_75 co najmniej 75%w widoku (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 tej 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óre mają historyczny wskaźnik fałszywego i nieprawidłowego ruchu z reklam.
customSegmentId

string (int64 format)

Niestandardowy identyfikator segmentu 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 dotyczące kontroli 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 typ wyliczeniowy jest tylko obiektem 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/broń.
HATE_PROFANITY szerzenie nienawiści 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/natłok reklam.

MediumSeverityCategory

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

Wartości w polu enum
MEDIUM_SEVERITY_UNSPECIFIED Ten typ wyliczeniowy jest tylko obiektem 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 Katastrofy: lotnictwo.
DISASTER_MAN_MADE Katastrofy: spowodowane przez człowieka.
DISASTER_NATURAL Katastrofy: naturalne.
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 ocen wiekowych.

Wartości w polu enum
AGE_RATING_UNSPECIFIED Ten typ wyliczeniowy jest tylko elementem zastępczym i nie określa żadnych opcji oceny wiekowej.
APP_AGE_RATE_UNKNOWN Aplikacje o nieznanej kategorii wiekowej.
APP_AGE_RATE_4_PLUS Aplikacje z oceną Dla wszystkich (od 4 lat).
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 tylko dla dorosłych (od 18 lat).

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 tej 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 wyliczeniowy typ danych jest tylko elementem zastępczym i nie określa żadnych opcji oceny aplikacji w formie gwiazdek.
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świetlania 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 współczynnika wyświetleń IAB.
IAB_VIEWED_RATE_80_PERCENT_HIGHER Kieruj na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 80%.
IAB_VIEWED_RATE_75_PERCENT_HIGHER Kieruj na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 75%.
IAB_VIEWED_RATE_70_PERCENT_HIGHER Kieruj na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 70%.
IAB_VIEWED_RATE_65_PERCENT_HIGHER Kieruj na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 65%.
IAB_VIEWED_RATE_60_PERCENT_HIGHER Kieruj na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 60%.
IAB_VIEWED_RATE_55_PERCENT_HIGHER Kieruj na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 55%.
IAB_VIEWED_RATE_50_PERCENT_HIGHER Kieruj na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 50%.
IAB_VIEWED_RATE_40_PERCENT_HIGHER Kieruj 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 oglądania.

Wartości w polu enum
AVERAGE_VIEW_DURATION_UNSPECIFIED Ten typ wyliczeniowy jest tylko obiektem 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% przez 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% (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 w DoubleVerify.

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

enum (VideoIAB)

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

enum (VideoViewableRate)

Kieruj na zasoby reklamowe w witrynach, 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 widoczności według IAB.

Wartości w polu enum
VIDEO_IAB_UNSPECIFIED Ten wyliczenie jest tylko symbolem zastępczym i nie określa żadnych opcji współczynnika widoczności reklam wideo według IAB.
IAB_VIEWABILITY_80_PERCENT_HIGHER Kieruj na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 80%.
IAB_VIEWABILITY_75_PERCENT_HIGHER Kieruj na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 75%.
IAB_VIEWABILITY_70_PERCENT_HIGHER Kieruj na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 70%.
IAB_VIEWABILITY_65_PERCENT_HIHGER Kieruj na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 65%.
IAB_VIEWABILITY_60_PERCENT_HIGHER Kieruj na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 60%.
IAB_VIEWABILITY_55_PERCENT_HIHGER Kieruj na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 55%.
IAB_VIEWABILITY_50_PERCENT_HIGHER Kieruj na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 50%.
IAB_VIEWABILITY_40_PERCENT_HIHGER Kieruj 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 typ wyliczeniowy jest tylko obiektem zastępczym i nie określa żadnych opcji współczynnika widoczności filmu.
VIEWED_PERFORMANCE_40_PERCENT_HIGHER Kieruj na zasoby reklamowe w witrynach, aby zmaksymalizować współczynnik w pełni widocznych wyświetleń na poziomie co najmniej 40%.
VIEWED_PERFORMANCE_35_PERCENT_HIGHER Kieruj na zasoby reklamowe w witrynach, aby zmaksymalizować współczynnik w pełni widocznych wyświetleń (co najmniej 35%).
VIEWED_PERFORMANCE_30_PERCENT_HIGHER Kieruj na zasoby reklamowe w witrynach, aby zmaksymalizować współczynnik w pełni widocznych wyświetleń na poziomie co najmniej 30%.
VIEWED_PERFORMANCE_25_PERCENT_HIGHER Kieruj na zasoby reklamowe w witrynach, 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ń (co najmniej 20%).
VIEWED_PERFORMANCE_10_PERCENT_HIGHER Kieruj na zasoby reklamowe w witrynach, aby zmaksymalizować współczynnik w pełni widocznych wyświetleń (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 wyświetla się ponad 95%wyświetleń.
PLAYER_SIZE_400X300_70 Strony, na których wyświetla się ponad 70%wyświetleń.
PLAYER_SIZE_400X300_25 Strony, na których wyświetla się ponad 25%reklam.
PLAYER_SIZE_400X300_5 Strony z co najmniej 5%wyświetleń.

FraudInvalidTraffic

Ustawienia dotyczące oszustw 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 historyczne statystyki na temat fałszywego i nieprawidłowego ruchu z reklam.

FraudOption

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

Wartości w polu enum
FRAUD_UNSPECIFIED Ten wyliczeniowy typ danych 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.
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 dostarczony przez Integral Ad Science. Identyfikator musi mieścić się w zakresie od 3000000 do 4999999 (włącznie).

TRAQScore

Możliwe zakresy wyników TRAQ (True Advertising Quality) Integral Ad Science.

Wartości w polu enum
TRAQ_UNSPECIFIED Ten wyliczeniowy typ danych jest tylko obiektem 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 Adult.

Wartości w polu enum
ADULT_UNSPECIFIED Ten typ wyliczeniowy 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

Dostępne opcje Integral Ad Science dotyczące alkoholu.

Wartości w polu enum
ALCOHOL_UNSPECIFIED Ten wyliczenie 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ń w 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 w przypadku leków Integral Ad Science.

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 dotyczące mowy nienawiści w usłudze Integral Ad Science.

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

OffensiveLanguage

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

Wartości w polu enum
OFFENSIVE_LANGUAGE_UNSPECIFIED 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 wyliczenie jest tylko symbolem zastępczym i nie określa żadnych opcji związanych z przemocą.
VIOLENCE_HR Przemoc – wyklucz wysokie ryzyko.
VIOLENCE_HMR Przemoc – wyklucz wysokie i umiarkowane ryzyko.

Hazard

Możliwe opcje hazardu w Integral Ad Science.

Wartości w polu enum
GAMBLING_UNSPECIFIED Ten wyliczenie 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 typ wyliczeniowy jest tylko symbolem zastępczym i nie określa żadnych opcji zapobiegania oszustwom reklamowym.
SUSPICIOUS_ACTIVITY_HR Oszustwa reklamowe – wyklucz wysokie ryzyko.
SUSPICIOUS_ACTIVITY_HMR Oszustwa reklamowe – wyklucz wysokie i umiarkowane ryzyko.

DisplayViewability

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

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

VideoViewability

Możliwe opcje widoczności w przypadku usługi wideo Integral Ad Science.

Wartości w polu enum
VIDEO_VIEWABILITY_UNSPECIFIED Ten typ wyliczeniowy jest tylko elementem zastępczym i nie określa żadnych opcji widoczności filmu.
VIDEO_VIEWABILITY_40 co najmniej 40%w widoku (standard widoczności reklam wideo IAB);
VIDEO_VIEWABILITY_50 co najmniej 50%w widoku (standard widoczności reklam wideo IAB);
VIDEO_VIEWABILITY_60 Co najmniej 60%wyświetleń (standard widoczności reklam wideo IAB).
VIDEO_VIEWABILITY_70 co najmniej 70% – widoczność (standard widoczności reklam wideo IAB);

PoiAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania na punkty POI. To pole zostanie wypełnione w polu szczegółów obiektu AssignedTargetingOption, gdy wartość targetingType będzie równa 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. Wyświetlana nazwa punktu POI, np. „Times Square”, „Space Needle”, a jeśli jest dostępny, także pełny adres.
targetingOptionId

string

Wymagane. targetingOptionId elementu TargetingOption typu TARGETING_TYPE_POI.

Identyfikatory akceptowanych 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ągów znaków rozdzielone średnikiem. Możesz na przykład określić kierowanie na parę współrzędnych geograficznych 40.7414691, -74.003387, używając identyfikatora opcji kierowania „40741469;-74003387”. Po utworzeniu wartość tego pola 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 miejsc po przecinku.
proximityRadiusAmount

number

Wymagane. Promień obszaru wokół wybranego punktu, na który będą kierowane reklamy. Jednostki promienia są określone przez proximityRadiusUnit. Musi to być liczba z zakresu 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 przypisanej opcji kierowania na sieć placówek. To pole zostanie wypełnione w polu szczegółów obiektu AssignedTargetingOption, gdy wartość targetingType będzie równa 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 firm, np. „KFC”, „Chase Bank”.
targetingOptionId

string

Wymagane. targetingOptionId elementu TargetingOption typu TARGETING_TYPE_BUSINESS_CHAIN.

Identyfikatory akceptowanych opcji kierowania na sieci placówek można pobrać za pomocą metody SearchTargetingOptions.
proximityRadiusAmount

number

Wymagane. Promień obszaru wokół sieci placówek firmy, na który będą kierowane reklamy. Jednostki promienia są określone przez proximityRadiusUnit. Musi to być liczba z zakresu 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 wpisana wartość będzie zbyt szczegółowa, zostanie zaokrąglona 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 w polu targetingType będzie wartość 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 w polu targetingType będzie wartość 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 pozycji treści natywnych. To pole zostanie wypełnione w polu nativeContentPositionDetails, gdy w polu targetingType będzie wartość TARGETING_TYPE_NATIVE_CONTENT_POSITION. Kierowanie na wszystkie opcje nie jest obsługiwane. Aby to osiągnąć, usuń wszystkie opcje kierowania na pozycję treści natywnych.

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

enum (NativeContentPosition)

Wymagane. Pozycja treści.

OmidAssignedTargetingOptionDetails

Reprezentuje typ zasobów reklamowych z obsługą standardu Open Measurement, na który można kierować reklamy. To pole zostanie wypełnione w polu szczegółów obiektu AssignedTargetingOption, gdy wartość targetingType będzie równa TARGETING_TYPE_OMID.

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

enum (Omid)

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

AudioContentTypeAssignedTargetingOptionDetails

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

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

string

Identyfikator filmu w YouTube, który pojawia się 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 w polu targetingType będzie wartość TARGETING_TYPE_YOUTUBE_CHANNEL.

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

string

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

boolean

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

SessionPositionAssignedTargetingOptionDetails

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

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

enum (SessionPosition)

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

SessionPosition

Możliwe pozycje w sesji.

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

Metody

get

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

list

 Zawiera listę opcji kierowania przypisanych do grupy reklam.