REST Resource: advertisers.adGroups.targetingTypes.assignedTargetingOptions

Zasób: AssignedTargetingOption

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

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

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

string

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

string

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

string

Tylko dane wyjściowe. Alias dla grupy assignedTargetingOptionId. Ta wartość może być używana zamiast assignedTargetingOptionId podczas pobierania lub usuwania dotychczasowego kierowania.

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

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

To pole jest też obsługiwane w przypadku opcji kierowania przypisanych do elementu zamówienia, które należą do tych typów kierowania:

  • TARGETING_TYPE_CONTENT_INSTREAM_POSITION
  • TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
targetingType

enum (TargetingType)

Tylko dane wyjściowe. Identyfikuje typ przypisanej opcji kierowania.
inheritance

enum (Inheritance)

Tylko dane wyjściowe. Stan dziedziczenia przypisanej opcji kierowania.
Pole unii details. szczegółowe informacje o przypisanym elemencie kierowania; W szczegółach można wypełnić tylko jedno pole, 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 to TARGETING_TYPE_CHANNEL.
appCategoryDetails

object (AppCategoryAssignedTargetingOptionDetails)

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

object (AppAssignedTargetingOptionDetails)

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

object (UrlAssignedTargetingOptionDetails)

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

object (DayAndTimeAssignedTargetingOptionDetails)

szczegóły dotyczące dnia i godziny; To pole zostanie wypełnione, gdy wartość targetingType to TARGETING_TYPE_DAY_AND_TIME.
ageRangeDetails

object (AgeRangeAssignedTargetingOptionDetails)

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

object (RegionalLocationListAssignedTargetingOptionDetails)

Szczegóły listy lokalizacji regionalnych. To pole zostanie wypełnione, gdy wartość targetingType to TARGETING_TYPE_REGIONAL_LOCATION_LIST.
proximityLocationListDetails

object (ProximityLocationListAssignedTargetingOptionDetails)

Szczegóły listy lokalizacji z uwzględnieniem odległości. To pole zostanie zapełnione, gdy targetingType będzie mieć wartość TARGETING_TYPE_PROXIMITY_LOCATION_LIST.
genderDetails

object (GenderAssignedTargetingOptionDetails)

Szczegółowe informacje o płci. To pole zostanie wypełnione, gdy wartość targetingType to TARGETING_TYPE_GENDER.
videoPlayerSizeDetails

object (VideoPlayerSizeAssignedTargetingOptionDetails)

Szczegóły rozmiaru odtwarzacza. To pole zostanie zapełnione, gdy targetingType będzie mieć wartość TARGETING_TYPE_VIDEO_PLAYER_SIZE.
userRewardedContentDetails

object (UserRewardedContentAssignedTargetingOptionDetails)

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

object (ParentalStatusAssignedTargetingOptionDetails)

Informacje o stanie rodzicielskim. To pole zostanie zapełnione, gdy targetingType będzie mieć wartość TARGETING_TYPE_PARENTAL_STATUS.
contentInstreamPositionDetails

object (ContentInstreamPositionAssignedTargetingOptionDetails)

Szczegóły pozycji treści w instreamie. To pole zostanie zapełnione, gdy targetingType będzie mieć wartość TARGETING_TYPE_CONTENT_INSTREAM_POSITION.
contentOutstreamPositionDetails

object (ContentOutstreamPositionAssignedTargetingOptionDetails)

Szczegóły pozycji treści w outstreme. To pole zostanie wypełnione, gdy wartość targetingType to TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION.
deviceTypeDetails

object (DeviceTypeAssignedTargetingOptionDetails)

Szczegóły typu urządzenia. To pole zostanie wypełnione, gdy wartość targetingType to TARGETING_TYPE_DEVICE_TYPE.
audienceGroupDetails

object (AudienceGroupAssignedTargetingOptionDetails)

Szczegóły kierowania na odbiorców. To pole zostanie wypełnione, gdy wartość targetingType to TARGETING_TYPE_AUDIENCE_GROUP. Możesz kierować reklamy tylko na 1 opcję grupy odbiorców na zasób.
browserDetails

object (BrowserAssignedTargetingOptionDetails)

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

object (HouseholdIncomeAssignedTargetingOptionDetails)

Szczegóły dochodu gospodarstwa domowego. To pole zostanie wypełnione, gdy wartość targetingType to TARGETING_TYPE_HOUSEHOLD_INCOME.
onScreenPositionDetails

object (OnScreenPositionAssignedTargetingOptionDetails)

Szczegóły pozycji na ekranie. To pole zostanie wypełnione, gdy wartość targetingType to TARGETING_TYPE_ON_SCREEN_POSITION.
carrierAndIspDetails

object (CarrierAndIspAssignedTargetingOptionDetails)

Szczegóły operatora sieci komórkowej i dostawcy internetu. To pole zostanie wypełnione, gdy wartość targetingType to TARGETING_TYPE_CARRIER_AND_ISP.
keywordDetails

object (KeywordAssignedTargetingOptionDetails)

Szczegóły słowa kluczowego. To pole zostanie wypełnione, gdy wartość targetingType to TARGETING_TYPE_KEYWORD.

Do zasobu można przypisać maksymalnie 5000 bezpośrednich wykluczających słów kluczowych. Brak limitu liczby pozytywnych słów kluczowych, które można przypisać.
negativeKeywordListDetails

object (NegativeKeywordListAssignedTargetingOptionDetails)

Szczegóły słów kluczowych. To pole zostanie wypełnione, gdy wartość targetingType to TARGETING_TYPE_NEGATIVE_KEYWORD_LIST.

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

object (OperatingSystemAssignedTargetingOptionDetails)

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

object (DeviceMakeModelAssignedTargetingOptionDetails)

Marka i model urządzenia. To pole zostanie zapełnione, gdy targetingType będzie mieć wartość TARGETING_TYPE_DEVICE_MAKE_MODEL.
environmentDetails

object (EnvironmentAssignedTargetingOptionDetails)

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

object (InventorySourceAssignedTargetingOptionDetails)

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

object (CategoryAssignedTargetingOptionDetails)

Szczegóły kategorii. To pole zostanie wypełnione, gdy wartość targetingType to TARGETING_TYPE_CATEGORY.

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

object (ViewabilityAssignedTargetingOptionDetails)

Szczegóły dotyczące widoczności. To pole zostanie wypełnione, gdy wartość targetingType to TARGETING_TYPE_VIEWABILITY.

Możesz ustawić tylko jedną opcję widoczności na zasób.
authorizedSellerStatusDetails

object (AuthorizedSellerStatusAssignedTargetingOptionDetails)

Informacje o stanie autoryzowanego sprzedawcy. To pole zostanie wypełnione, gdy wartość targetingType to TARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

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

Jeśli zasób nie ma opcji statusu autoryzowanego sprzedawcy, domyślnie docelowymi są wszyscy autoryzowani sprzedawcy wskazani w pliku ads.txt jako DIRECT lub RESELLER.
languageDetails

object (LanguageAssignedTargetingOptionDetails)

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

object (GeoRegionAssignedTargetingOptionDetails)

Szczegóły regionu geograficznego. To pole zostanie wypełnione, gdy wartość targetingType to TARGETING_TYPE_GEO_REGION.
inventorySourceGroupDetails

object (InventorySourceGroupAssignedTargetingOptionDetails)

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

object (DigitalContentLabelAssignedTargetingOptionDetails)

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

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

object (SensitiveCategoryAssignedTargetingOptionDetails)

Szczegóły dotyczące kategorii kontrowersyjnej. To pole zostanie zapełnione, gdy targetingType będzie mieć wartość TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION.

Reklamy o charakterze kontrowersyjnym obejmują wykluczenia 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ąpić.
exchangeDetails

object (ExchangeAssignedTargetingOptionDetails)

Szczegóły giełdy. To pole zostanie wypełnione, gdy wartość targetingType to TARGETING_TYPE_EXCHANGE.
subExchangeDetails

object (SubExchangeAssignedTargetingOptionDetails)

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

object (ThirdPartyVerifierAssignedTargetingOptionDetails)

Szczegóły weryfikacji przez usługę zewnętrzną. To pole zostanie zapełnione, gdy targetingType będzie mieć wartość TARGETING_TYPE_THIRD_PARTY_VERIFIER.
poiDetails

object (PoiAssignedTargetingOptionDetails)

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

object (BusinessChainAssignedTargetingOptionDetails)

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

object (ContentDurationAssignedTargetingOptionDetails)

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

object (ContentStreamTypeAssignedTargetingOptionDetails)

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

object (NativeContentPositionAssignedTargetingOptionDetails)

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

object (OmidAssignedTargetingOptionDetails)

Informacje o zasobach reklamowych z włączoną funkcją Open Measurement. To pole zostanie wypełnione, gdy wartość targetingType to TARGETING_TYPE_OMID.
audioContentTypeDetails

object (AudioContentTypeAssignedTargetingOptionDetails)

Szczegóły typu treści audio. To pole zostanie wypełnione, gdy wartość targetingType to TARGETING_TYPE_AUDIO_CONTENT_TYPE.
contentGenreDetails

object (ContentGenreAssignedTargetingOptionDetails)

Szczegóły gatunku treści. To pole zostanie wypełnione, gdy wartość targetingType to TARGETING_TYPE_CONTENT_GENRE.
youtubeVideoDetails

object (YoutubeVideoAssignedTargetingOptionDetails)

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

object (YoutubeChannelAssignedTargetingOptionDetails)

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

object (SessionPositionAssignedTargetingOptionDetails)

Szczegóły pozycji sesji. To pole zostanie wypełnione, gdy wartość targetingType to TARGETING_TYPE_SESSION_POSITION.

Dziedziczenie

Wskazuje, czy przypisana opcja kierowania jest dziedziczona z elementu wyższego poziomu, np. partnera lub reklamodawcy. Opcje kierowania odziedziczone mają pierwszeństwo, są zawsze stosowane w wyświetlaniu z uwzględnieniem kierowania przypisanego na bieżącym poziomie i nie można ich modyfikować za pomocą bieżącej usługi elementu. Należy je zmodyfikować w usłudze elementu, z której są dziedziczone. Dziedziczenie dotyczy tylko kierowania na kanały z wykluczeniem, wykluczeń kategorii o charakterze kontrowersyjnym i wykluczeń etykiet treści cyfrowych, jeśli są skonfigurowane na poziomie konta nadrzędnego.

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

ChannelAssignedTargetingOptionDetails

Szczegóły dotyczące przypisanej opcji kierowania na kanał. Gdy wartość targetingType wynosi TARGETING_TYPE_CHANNEL, to pole zostanie wypełnione w polu szczegółów AssignedTargetingOption.

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

string (int64 format)

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

boolean

Wskazuje, czy ta opcja jest objęta kierowaniem negatywnym. W przypadku opcji kierowania przypisanej na poziomie reklamodawcy to pole musi mieć wartość „PRAWDA”.

AppCategoryAssignedTargetingOptionDetails

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

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

string

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

string

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

boolean

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

AppAssignedTargetingOptionDetails

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

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

string

Wymagane. Identyfikator aplikacji.

Aplikacja Sklep Play na Androida używa identyfikatora pakietu, np. com.google.android.gm. Identyfikator aplikacji w 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 platforma aplikacji jest mobilna (czyli Androida lub iOS), a my na podstawie identyfikatora aplikacji określimy odpowiednią platformę mobilną.

AppPlatform

Możliwe opcje kierowania na platformę aplikacji

Wartości w polu enum
APP_PLATFORM_UNSPECIFIED Wartość domyślna, gdy w tej wersji nie jest określona platforma aplikacji. Ta wartość zastępcza jest miejscem zarezerwowanym dla wartości domyślnej i nie reprezentuje rzeczywistej opcji platformy.
APP_PLATFORM_IOS Platforma aplikacji to iOS.
APP_PLATFORM_ANDROID Platforma aplikacji to Android.
APP_PLATFORM_ROKU Platforma aplikacji to Roku.
APP_PLATFORM_AMAZON_FIRETV Platforma aplikacji to Amazon Fire TV.
APP_PLATFORM_PLAYSTATION Platforma aplikacji to PlayStation.
APP_PLATFORM_APPLE_TV Platforma aplikacji to Apple TV.
APP_PLATFORM_XBOX Platforma aplikacji to Xbox.
APP_PLATFORM_SAMSUNG_TV Platforma aplikacji to Samsung TV.
APP_PLATFORM_ANDROID_TV Platforma aplikacji to Android TV.
APP_PLATFORM_GENERIC_CTV Platforma aplikacji to platforma CTV, która nie jest wymieniona w innym miejscu.
APP_PLATFORM_LG_TV Platforma aplikacji to LG TV.
APP_PLATFORM_VIZIO_TV Platforma aplikacji to VIZIO TV.

UrlAssignedTargetingOptionDetails

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

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 kierowana negatywnie.

DayAndTimeAssignedTargetingOptionDetails

Reprezentacja segmentu czasu zdefiniowanego na określony dzień tygodnia z czasem rozpoczęcia i zakończenia. Czas podany w polu startHour musi przypadać przed czasem przedstawionym przez endHour.

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

enum (DayOfWeek)

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

integer

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

integer

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

enum (TimeZoneResolution)

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

AgeRangeAssignedTargetingOptionDetails

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

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

enum (AgeRange)

Wymagane. Przedział wiekowy odbiorców. Obsługujemy tylko kierowanie na odbiorców o stałym przedziale wiekowym. W związku z tym przedział wiekowy podany w tym polu może być 1) docelowy lub 2) częścią większego ciągłego przedziału wiekowego. Zasięg kierowania na ciągły przedział wiekowy można zwiększyć, kierując reklamy również na odbiorców w nieznanym wieku.

RegionalLocationListAssignedTargetingOptionDetails

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

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

string (int64 format)

Wymagane. Identyfikator listy regionalnej lokalizacji. Powinna odnosić 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. Gdy wartość targetingType wynosi TARGETING_TYPE_PROXIMITY_LOCATION_LIST, to pole zostanie wypełnione w polu szczegółów AssignedTargetingOption.

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

string (int64 format)

Wymagane. Identyfikator listy lokalizacji zbliżeniowych. Powinien odwoływać się do pola locationListId zasobu LocationList, którego typ to TARGETING_LOCATION_TYPE_PROXIMITY.
proximityRadius

number

Wymagane. Promień wyrażony w jednostkach odległości określonych w parametry proximityRadiusUnit. Określa rozmiar obszaru wokół wybranej lokalizacji, który będzie objęty kierowaniem reklam. Promień powinien się mieścić w przedziale od 1 do 500 mil lub 800 kilometrów.
proximityRadiusUnit

enum (ProximityRadiusUnit)

Wymagane. Jednostki odległości promienia.

ProximityRadiusUnit

Wyliczenie jednostek odległości dla ProximityRadius.

Wartości w polu enum
PROXIMITY_RADIUS_UNIT_UNSPECIFIED Wartość domyślna, gdy w tej wersji nie są określone jednostki miary odległości. Ten typ jest miejscem zastępczym dla wartości domyślnej i nie reprezentuje rzeczywistej jednostki miary odległości.
PROXIMITY_RADIUS_UNIT_MILES Jednostka odległości promienia w milach.
PROXIMITY_RADIUS_UNIT_KILOMETERS Jednostka miary promienia w kilometrach

GenderAssignedTargetingOptionDetails

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

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

enum (Gender)

Wymagane. Płeć odbiorców.

VideoPlayerSizeAssignedTargetingOptionDetails

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

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

enum (VideoPlayerSize)

Wymagane. Rozmiar odtwarzacza wideo.

UserRewardedContentAssignedTargetingOptionDetails

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

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

string

Wymagane. Pole targetingOptionId, gdy targetingType ma wartość TARGETING_TYPE_USER_REWARDED_CONTENT.
userRewardedContent

enum (UserRewardedContent)

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

ParentalStatusAssignedTargetingOptionDetails

Szczegóły opcji kierowania na przypisany status rodzicielski. Gdy wartość targetingType wynosi TARGETING_TYPE_PARENTAL_STATUS, to pole zostanie wypełnione w polu szczegółów AssignedTargetingOption.

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

enum (ParentalStatus)

Wymagane. Status rodzicielski odbiorców.

ContentInstreamPositionAssignedTargetingOptionDetails

Szczegóły opcji kierowania na pozycję w in-stream przypisanej treści. Gdy wartość targetingType to TARGETING_TYPE_CONTENT_INSTREAM_POSITION, pole contentInstreamPositionDetails zostanie wypełnione.

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

enum (ContentInstreamPosition)

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

enum (AdType)

Tylko dane wyjściowe. Typ reklamy docelowej. Domyślnie tę opcję kierowania odziedziczą tylko zamówienia reklamowe i nowe elementy zamówienia obsługujące określony typ reklamy. Możliwe wartości to:

  • AD_TYPE_VIDEO, to ustawienie zostanie dziedziczone przez nowy element zamówienia, gdy ustawienie lineItemType ma wartość LINE_ITEM_TYPE_VIDEO_DEFAULT.
  • AD_TYPE_AUDIO, to ustawienie zostanie dziedziczone przez nowy element zamówienia, gdy ustawienie lineItemType ma wartość LINE_ITEM_TYPE_AUDIO_DEFAULT.

AdType

Reprezentuje typ kreacji powiązanej z reklamami.

Wartości w polu enum
AD_TYPE_UNSPECIFIED W tej wersji nie podano lub nie określono typu reklamy.
AD_TYPE_DISPLAY Kreacje displayowe, np. obrazki i HTML5.
AD_TYPE_VIDEO Kreacje wideo, np. reklamy wideo odtwarzane podczas strumieniowego przesyłania treści w odtwarzaczach wideo.
AD_TYPE_AUDIO Kreacje audio, np. reklamy audio odtwarzane w treściach audio.

ContentOutstreamPositionAssignedTargetingOptionDetails

Szczegóły opcji kierowania na pozycję out-of-stream przypisanej treści. Gdy wartość targetingType to TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION, pole contentOutstreamPositionDetails zostanie wypełnione.

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

enum (ContentOutstreamPosition)

Wymagane. Pozycja treści out-stream.
adType

enum (AdType)

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

  • AD_TYPE_DISPLAY, to ustawienie zostanie dziedziczone przez nowy element zamówienia, gdy ustawienie lineItemType ma wartość LINE_ITEM_TYPE_DISPLAY_DEFAULT.
  • AD_TYPE_VIDEO, to ustawienie zostanie dziedziczone przez nowy element zamówienia, gdy ustawienie lineItemType ma wartość LINE_ITEM_TYPE_VIDEO_DEFAULT.

DeviceTypeAssignedTargetingOptionDetails

Szczegóły kierowania na typ urządzenia. Gdy targetingType ma wartość TARGETING_TYPE_DEVICE_TYPE, ta wartość zostanie wypełniona w polu szczegółów obiektu AssignedKierowanieOption.

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

enum (DeviceType)

Wymagane. Wyświetlana nazwa typu urządzenia.
youtubeAndPartnersBidMultiplier

number

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

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

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

AudienceGroupAssignedTargetingOptionDetails

Szczegóły opcji kierowania na grupę odbiorców. Gdy wartość targetingType wynosi TARGETING_TYPE_AUDIENCE_GROUP, to pole zostanie wypełnione w polu szczegółów AssignedTargetingOption. Relacja między poszczególnymi grupami to złączenie wykluczające, z wyjątkiem grup ExcludedFirstAndThirdPartyAudienceGroup i ExcludedGoogleAudienceGroup, w przypadku których relacja komplementarna jest używana jako przecina z innymi grupami.

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

object (FirstAndThirdPartyAudienceGroup)

Identyfikatory własnych i zewnętrznych list odbiorców oraz ich odstępy w przypadku uwzględnionych własnych i zewnętrznych grup odbiorców. Każda grupa własnych i zewnętrznych list odbiorców zawiera tylko identyfikatory własnych i zewnętrznych list odbiorców. Relacja między każdą własną i zewnętrzną grupą odbiorców to PRZEKROJENIE, a wynik jest złączany z innymi grupami odbiorców. Powtarzające się grupy z tymi samymi ustawieniami zostaną zignorowane.
includedGoogleAudienceGroup

object (GoogleAudienceGroup)

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

object (CustomListGroup)

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

object (CombinedAudienceGroup)

Identyfikatory połączonych grup odbiorców uwzględnionej grupy odbiorców z połączonych list. Zawiera tylko identyfikatory połączonych grup odbiorców.
excludedFirstAndThirdPartyAudienceGroup

object (FirstAndThirdPartyAudienceGroup)

Identyfikatory i odbiorcy własne dla wykluczonej grupy odbiorców (własnej lub dostarczonej przez firmę zewnętrzną) oraz odbiorców dostarczonych przez firmę zewnętrzną. Służy do kierowania wykluczającego. Do kierowania na odbiorców pozytywnych jest używany zbiór komplementarny zbioru tej grupy i innych wykluczonych grup odbiorców. Wszystkie elementy są logicznie połączone operatorem „LUB”.
excludedGoogleAudienceGroup

object (GoogleAudienceGroup)

Identyfikatory odbiorców Google wykluczonej grupy odbiorców Google. Służy do kierowania wykluczającego. Do kierowania na odbiorców pozytywnych jest używany zbiór komplementarny zbioru tej grupy i innych wykluczonych grup odbiorców. Zawiera tylko listy odbiorców Google typu „Odbiorcy o podobnych zainteresowaniach”, „Odbiorcy na rynku” i „Odbiorcy z zainstalowanymi aplikacjami”. Wszystkie elementy są logicznie połączone operatorem „LUB”.

FirstAndThirdPartyAudienceGroup

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

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

object (FirstAndThirdPartyAudienceTargetingSetting)

Wymagane. Wszystkie ustawienia kierowania na odbiorców własnych i na listy odbiorców dostarczone przez inną firmę w grupie odbiorców własnych i na listy odbiorców dostarczone przez inną firmę. Powtarzające się ustawienia z tym samym identyfikatorem są niedozwolone.

FirstAndThirdPartyAudienceTargetingSetting

Szczegóły ustawień kierowania na własne i obce listy odbiorców

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

string (int64 format)

Wymagane. Identyfikatory odbiorców własnych i innych firm dla ustawienia kierowania na odbiorców własnych i dostarczonych przez inną firmę. Identyfikator to firstAndThirdPartyAudienceId.
recency

enum (Recency)

Aktualność ustawień kierowania na własne listy odbiorców i listy odbiorców firm zewnętrznych. Dotyczy tylko własnych list odbiorców. W innym przypadku jest ignorowany. Więcej informacji znajdziesz na stronie https://support.google.com/displayvideo/answer/2949947#recency. Jeśli nie określisz tego parametru, nie zostanie zastosowany żaden limit.

Czas od poprzedniej wizyty

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

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

GoogleAudienceGroup

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

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

object (GoogleAudienceTargetingSetting)

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

GoogleAudienceTargetingSetting

Szczegóły ustawienia kierowania na odbiorców Google

Zapis JSON 
{
  "googleAudienceId": string
}
Pola
googleAudienceId

string (int64 format)

Wymagane. Identyfikator listy odbiorców Google ustawiony w ustawieniu kierowania na odbiorców zdefiniowanych przez Google. Identyfikator to googleAudienceId.

CustomListGroup

Szczegóły niestandardowej grupy list. Wszystkie ustawienia kierowania na listę niestandardową są logicznie połączone za pomocą operatora „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 listę niestandardową

Zapis JSON 
{
  "customListId": string
}
Pola
customListId

string (int64 format)

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

CombinedAudienceGroup

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

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

object (CombinedAudienceTargetingSetting)

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

CombinedAudienceTargetingSetting

Szczegóły ustawień kierowania na połączone listy odbiorców.

Zapis JSON 
{
  "combinedAudienceId": string
}
Pola
combinedAudienceId

string (int64 format)

Wymagane. Identyfikator połączonej listy odbiorców w ustawieniu kierowania na połączoną listę odbiorców. Identyfikator to combinedAudienceId.

BrowserAssignedTargetingOptionDetails

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

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

string

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

string

Wymagane. Wartość targetingOptionId obiektu TargetingOption typu TARGETING_TYPE_BROWSER.
negative

boolean

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

HouseholdIncomeAssignedTargetingOptionDetails

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

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

enum (HouseholdIncome)

Wymagane. Dochód gospodarstwa domowego odbiorców.

OnScreenPositionAssignedTargetingOptionDetails

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

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

string

Wymagane. Pole targetingOptionId, gdy targetingType ma wartość TARGETING_TYPE_ON_SCREEN_POSITION.
onScreenPosition

enum (OnScreenPosition)

Tylko dane wyjściowe. Pozycja na ekranie.
adType

enum (AdType)

Tylko dane wyjściowe. Typ reklamy docelowej. Domyślnie tę opcję kierowania odziedziczą tylko zamówienia reklamowe i nowe elementy zamówienia obsługujące określony typ reklamy. Możliwe wartości to:

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

CarrierAndIspAssignedTargetingOptionDetails

Szczegóły opcji kierowania na operatora sieci komórkowej i dostawcę usług internetowych. Gdy wartość targetingType wynosi TARGETING_TYPE_CARRIER_AND_ISP, to pole zostanie wypełnione w polu szczegółów AssignedTargetingOption.

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

string

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

string

Wymagane. targetingOptionId w TargetingOption typu TARGETING_TYPE_CARRIER_AND_ISP.
negative

boolean

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

KeywordAssignedTargetingOptionDetails

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

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

string

Wymagane. słowo kluczowe, np. car insurance;

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

boolean

Wskazuje, czy ta opcja jest kierowana negatywnie.

NegativeKeywordListAssignedTargetingOptionDetails

Szczegóły kierowania dla listy wykluczających słów kluczowych. Gdy targetingType ma wartość TARGETING_TYPE_NEGATIVE_KEYWORD_LIST, ta wartość zostanie wypełniona w polu szczegółów obiektu AssignedKierowanieOption.

Zapis JSON 
{
  "negativeKeywordListId": string
}
Pola
negativeKeywordListId

string (int64 format)

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

OperatingSystemAssignedTargetingOptionDetails

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

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

string

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

string

Wymagane. Identyfikator opcji kierowania wypełniony w polu targetingOptionId, gdy wartość targetingType to TARGETING_TYPE_OPERATING_SYSTEM.
negative

boolean

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

DeviceMakeModelAssignedTargetingOptionDetails

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

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

string

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

string

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

boolean

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

EnvironmentAssignedTargetingOptionDetails

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

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

enum (Environment)

Wymagane. Środowisko obsługi.

InventorySourceAssignedTargetingOptionDetails

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

Zapis JSON 
{
  "inventorySourceId": string
}
Pola
inventorySourceId

string (int64 format)

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

CategoryAssignedTargetingOptionDetails

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

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

string

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

string

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

boolean

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

ViewabilityAssignedTargetingOptionDetails

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

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

enum (Viewability)

Wymagane. Prognozowany odsetek widoczności.

AuthorizedSellerStatusAssignedTargetingOptionDetails

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

Jeśli zasób nie ma przypisanej opcji kierowania TARGETING_TYPE_AUTHORIZED_SELLER_STATUS, 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 docelowego.
targetingOptionId

string

Wymagane. targetingOptionId w TargetingOption typu TARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

LanguageAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania na język. Gdy targetingType ma wartość TARGETING_TYPE_LANGUAGE, ta wartość zostanie wypełniona w polu szczegółów obiektu AssignedKierowanieOption.

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

string

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

string

Wymagane. targetingOptionId w TargetingOption typu TARGETING_TYPE_LANGUAGE.
negative

boolean

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

GeoRegionAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania na region geograficzny. Gdy targetingType ma wartość TARGETING_TYPE_GEO_REGION, ta wartość zostanie wypełniona w polu szczegółów obiektu AssignedKierowanieOption.

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

string

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

string

Wymagane. targetingOptionId w 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 dla grupy źródeł zasobów reklamowych. Gdy wartość targetingType wynosi TARGETING_TYPE_INVENTORY_SOURCE_GROUP, to pole zostanie wypełnione w polu szczegółów AssignedTargetingOption.

Zapis JSON 
{
  "inventorySourceGroupId": string
}
Pola
inventorySourceGroupId

string (int64 format)

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

DigitalContentLabelAssignedTargetingOptionDetails

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

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

enum (ContentRatingTier)

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

SensitiveCategoryAssignedTargetingOptionDetails

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

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

enum (SensitiveCategory)

Wymagane. Typ enumeracji dla kategorii treści o charakterze kontrowersyjnym w DV360, które zostały sklasyfikowane jako WYŁĄCZONE.

ExchangeAssignedTargetingOptionDetails

Szczegóły opcji kierowania przypisanej giełdy. Gdy wartość targetingType wynosi TARGETING_TYPE_EXCHANGE, to pole zostanie wypełnione w polu szczegółów AssignedTargetingOption.

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

enum (Exchange)

Wymagane. Wartość typu enum giełdy.

SubExchangeAssignedTargetingOptionDetails

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

Zapis JSON 
{
  "targetingOptionId": string
}
Pola
targetingOptionId

string

Wymagane. Wartość targetingOptionId obiektu TargetingOption typu TARGETING_TYPE_SUB_EXCHANGE.

ThirdPartyVerifierAssignedTargetingOptionDetails

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

Zapis JSON 
{

  // Union field verifier can be only one of the following:
  "adloox": {
    object (Adloox)
  },
  "doubleVerify": {
    object (DoubleVerify)
  },
  "integralAdScience": {
    object (IntegralAdScience)
  }
  // End of list of possible types for union field verifier.
}
Pola
Pole unii verifier. Możesz kierować reklamy na weryfikatora zewnętrznego, aby zapewnić zgodność wyświetleń z wymaganiami w zakresie bezpieczeństwa marki. verifier może być tylko jednym z tych elementów:
adloox

object (Adloox)

Weryfikator zewnętrzny marki – Adloox.
doubleVerify

object (DoubleVerify)

Zewnętrzny weryfikator marki – DoubleVerify.
integralAdScience

object (IntegralAdScience)

Zewnętrzny weryfikator marki – Integral Ad Science.

Adloox

Szczegółowe informacje o ustawieniach bezpieczeństwa marki w 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 Adloox, które chcesz wykluczyć.
excludedFraudIvtMfaCategories[]

enum (FraudIvtMfaCategory)

Opcjonalnie: Wykluczone kategorie oszustwa IVT MFA według Adloox.
adultExplicitSexualContent

enum (GarmRiskExclusion)

Opcjonalnie: Treści dla dorosłych i treści o charakterze jednoznacznie seksualnym – zakresy ryzyka GARM do wykluczenia.
crimeHarmfulActsIndividualsSocietyHumanRightsViolationsContent

enum (GarmRiskExclusion)

Opcjonalnie: Zakresy ryzyka GARM związane z treściami dotyczącymi przestępstw i działań szkodliwych, które należy wykluczyć.
armsAmmunitionContent

enum (GarmRiskExclusion)

Opcjonalnie: Zakresy ryzyka broni i amunicji GARM do wykluczenia.
deathInjuryMilitaryConflictContent

enum (GarmRiskExclusion)

Opcjonalnie: Wykluczanie zakresów ryzyka GARM związanych z treściami dotyczącymi śmierci, obrażeń lub konfliktów wojskowych.
debatedSensitiveSocialIssueContent

enum (GarmRiskExclusion)

Opcjonalnie: Wyklucz zakresy ryzyka GARM dotyczące debat dotyczących drażliwych problemów społecznych.
illegalDrugsTobaccoEcigarettesVapingAlcoholContent

enum (GarmRiskExclusion)

Opcjonalnie: Treści związane z narkotykami i alkoholem – zakresy ryzyka według GARM, które należy wykluczyć.
onlinePiracyContent

enum (GarmRiskExclusion)

Opcjonalnie: Zakresy ryzyka związanego z piractwem online według GARM, które należy wykluczyć.
hateSpeechActsAggressionContent

enum (GarmRiskExclusion)

Opcjonalnie: Zakresy ryzyka GARM dotyczące wypowiedzi szerzących nienawiść i aktów agresji, które należy wykluczyć.
obscenityProfanityContent

enum (GarmRiskExclusion)

Opcjonalnie: Treści nieprzyzwoite i wulgaryzmy – zakresy ryzyka GARM do wykluczenia.
spamHarmfulContent

enum (GarmRiskExclusion)

Opcjonalnie: Zakresy ryzyka spamu lub szkodliwych treści GARM do wykluczenia.
terrorismContent

enum (GarmRiskExclusion)

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

enum (GarmRiskExclusion)

Opcjonalnie: Zakresy ryzyka związanego z treściami zawierającymi nieprawdziwe informacje według GARM, które należy wykluczyć.
displayIabViewability

enum (DisplayIabViewability)

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

enum (VideoIabViewability)

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

AdlooxCategory

Dostępne kategorie Adloox

Wartości w polu enum
ADLOOX_UNSPECIFIED Wartość domyślna, gdy kategoria Adloox nie jest określona lub jest nieznana w tej wersji.
ADULT_CONTENT_HARD Treści dla dorosłych (treści o charakterze twardym).
ADULT_CONTENT_SOFT Treści dla dorosłych (miękkie).
ILLEGAL_CONTENT Treści niezgodne z prawem.
BORDERLINE_CONTENT treści bliskie łamania wytycznych.
DISCRIMINATORY_CONTENT Treści dyskryminujące.
VIOLENT_CONTENT_WEAPONS Treści przedstawiające przemoc i bronie.
LOW_VIEWABILITY_DOMAINS domeny o niskiej widoczności,
FRAUD Oszustwo.

FraudIvtMfaCategory

Dostępne kategorie oszustw, IVT i MFA w Adloox

Wartości w polu enum
FRAUD_IVT_MFA_CATEGORY_UNSPECIFIED Wartość domyślna, gdy w tej wersji nie jest określona lub jest nieznana kategoria oszustwa Adloox, IVT lub MFA.
FRAUD_IVT_MFA FRAUD, IVT, MFA.

GarmRiskExclusion

Dostępne opcje wykluczania poziomu ryzyka w GARM.

Wartości w polu enum
GARM_RISK_EXCLUSION_UNSPECIFIED Jest ona tylko zmienną i nie określa żadnej opcji wykluczania ryzyka GARM.
GARM_RISK_EXCLUSION_FLOOR Wyklucz ryzyko związane z poziomem skrajnym.
GARM_RISK_EXCLUSION_HIGH Wyklucz ryzyko wysokie i skrajne.
GARM_RISK_EXCLUSION_MEDIUM Wyklucz średni, wysoki i skrajny poziom ryzyka.
GARM_RISK_EXCLUSION_LOW Wyklucz wszystkie poziomy ryzyka (niskie, średnie, wysokie i minimalne).

DisplayIabViewability

Dostępne progi widoczności reklam displayowych Adloox IAB.

Wartości w polu enum
DISPLAY_IAB_VIEWABILITY_UNSPECIFIED Wartość domyślna, jeśli nie została określona lub jest nieznana w tej wersji.
DISPLAY_IAB_VIEWABILITY_10 Widoczność 10%lub większa (standard widoczności reklam display IAB).
DISPLAY_IAB_VIEWABILITY_20 Ponad 20%widoczne (standard IAB widoczności reklam displayowych).
DISPLAY_IAB_VIEWABILITY_35 Widoczność ≥ 35% (standard widoczności reklam displayowych IAB).
DISPLAY_IAB_VIEWABILITY_50 Widoczność ≥50% (standard widoczności reklam displayowych IAB).
DISPLAY_IAB_VIEWABILITY_75 widoczne w 100% (standard widoczności reklam displayowych IAB).

VideoIabViewability

Dostępne progi widoczności reklam wideo IAB w 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 Widoczne na ekranie na poziomie co najmniej 10% (standard widoczności reklam wideo IAB).
VIDEO_IAB_VIEWABILITY_20 Ponad 20%widoczne (standard IAB widoczności reklam wideo).
VIDEO_IAB_VIEWABILITY_35 Ponad 35%widoczne (standard IAB widoczności reklam wideo).
VIDEO_IAB_VIEWABILITY_50 Widoczność ≥ 50% (standard widoczności reklam wideo IAB).
VIDEO_IAB_VIEWABILITY_75 widoczność na ekranie przez co najmniej 75% czasu (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 licytacji dotyczących aplikacji z kategorią wiekową.
appStarRating

object (AppStarRating)

Unikaj ustalania stawek za aplikacje z gwiazdkami.
displayViewability

object (DisplayViewability)

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

object (VideoViewability)

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

object (FraudInvalidTraffic)

Unikaj witryn i aplikacji, które mają historyczne wskaźniki fałszywego i nieprawidłowego ruchu.
customSegmentId

string (int64 format)

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

BrandSafetyCategories

Ustawienia kontroli bezpieczeństwa marki.

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

boolean

Nieznane lub niesklasyfikowane.
avoidedHighSeverityCategories[]

enum (HighSeverityCategory)

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

enum (MediumSeverityCategory)

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

HighSeverityCategory

Możliwe opcje w przypadku kategorii o wysokiej wagi.

Wartości w polu enum
HIGHER_SEVERITY_UNSPECIFIED Ten typ danych jest tylko miejscem zastępczym i nie określa żadnych kategorii o wysokiej wagi.
ADULT_CONTENT_PORNOGRAPHY Treści dla dorosłych: pornografia, tematy dla dorosłych i nagość.
COPYRIGHT_INFRINGEMENT Naruszenie praw autorskich.
SUBSTANCE_ABUSE Narkotyki/alkohol/substancje kontrolowane: nadużywanie środków odurzających.
GRAPHIC_VIOLENCE_WEAPONS Drastyczne sceny/skrajna przemoc/broń.
HATE_PROFANITY Nienawiść/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 w przypadku kategorii o średnim stopniu ważności.

Wartości w polu enum
MEDIUM_SEVERITY_UNSPECIFIED Ten typ danych jest tylko miejscem zastępczym i nie określa kategorii o średniej wagi.
AD_SERVERS Serwery reklam.
ADULT_CONTENT_SWIMSUIT Treści dla dorosłych: kostiumy kąpielowe.
ALTERNATIVE_LIFESTYLES Kontrowersyjne tematy: alternatywne style życia.
CELEBRITY_GOSSIP Kontrowersyjne tematy: plotki o celebrytach.
GAMBLING Kontrowersyjne tematy: hazard.
OCCULT Kontrowersyjne tematy: okultyzm.
SEX_EDUCATION Kontrowersyjne tematy: edukacja seksualna.
DISASTER_AVIATION Katastrofa: lotnictwo.
DISASTER_MAN_MADE Katastrofa: wywołana przez człowieka.
DISASTER_NATURAL Katastrofa: naturalna.
DISASTER_TERRORIST_EVENTS Katastrofa: ataki terrorystyczne.
DISASTER_VEHICLE Katastrofa: pojazd.
ALCOHOL Narkotyki/alkohol/substancje kontrolowane: alkohol.
SMOKING Narkotyki, alkohol, substancje kontrolowane: palenie.
NEGATIVE_NEWS_FINANCIAL Negatywne wiadomości: finansowe.
NON_ENGLISH Niestandardowe treści: w języku innym niż angielski.
PARKING_PAGE Niestandardowe treści: zaparkowanie.
UNMODERATED_UGC Niemoderowane treści generowane przez użytkowników: fora, obrazy i filmy.
INFLAMMATORY_POLITICS_AND_NEWS Kontrowersyjne tematy: wiadomości i treści polityczne mające na celu podburzanie.
NEGATIVE_NEWS_PHARMACEUTICAL Negatywne wiadomości: farmaceutyczne.

AgeRating

Możliwe opcje klasyfikacji wiekowej.

Wartości w polu enum
AGE_RATING_UNSPECIFIED Jest ona tylko wartością zastępczą i nie określa żadnych opcji kategorii wiekowej.
APP_AGE_RATE_UNKNOWN Aplikacje o nieznanej klasyfikacji wiekowej.
APP_AGE_RATE_4_PLUS Aplikacje z oceną Dla wszystkich (4+).
APP_AGE_RATE_9_PLUS Aplikacje z kategorią Dla wszystkich (9+).
APP_AGE_RATE_12_PLUS Aplikacje dla nastolatków (12+).
APP_AGE_RATE_17_PLUS Aplikacje z kategorią Dla dorosłych (od 17 roku życia).
APP_AGE_RATE_18_PLUS Aplikacje z kategorią 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 ustalania stawek za aplikacje z gwiazdkami.
avoidInsufficientStarRating

boolean

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

StarRating

Możliwe opcje dotyczące gwiazdek.

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

Wyświetlalność w sieci reklamowej

Szczegóły ustawień widoczności wyświetlania w DoubleVerify

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

enum (IAB)

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

enum (ViewableDuring)

Kieruj 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ń IAB

Wartości w polu enum
IAB_VIEWED_RATE_UNSPECIFIED Ta enumeracja jest tylko miejscem zastępczym i nie określa żadnych opcji stawek wyświetlanych przez IAB.
IAB_VIEWED_RATE_80_PERCENT_HIGHER Kieruj reklamy na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować współczynnik widoczności IAB do poziomu co najmniej 80%.
IAB_VIEWED_RATE_75_PERCENT_HIGHER Kieruj reklamy na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 75%.
IAB_VIEWED_RATE_70_PERCENT_HIGHER Kieruj reklamy na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 70%.
IAB_VIEWED_RATE_65_PERCENT_HIGHER Kieruj reklamy na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 65%.
IAB_VIEWED_RATE_60_PERCENT_HIGHER Kieruj reklamy na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 60%.
IAB_VIEWED_RATE_55_PERCENT_HIGHER Kieruj reklamy na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 55%.
IAB_VIEWED_RATE_50_PERCENT_HIGHER Kieruj reklamy na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 50%.
IAB_VIEWED_RATE_40_PERCENT_HIGHER Kieruj reklamy na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 40%.
IAB_VIEWED_RATE_30_PERCENT_HIGHER Kieruj reklamy na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 30%.

ViewableDuring

Możliwe opcje dotyczące czasu wyświetlania.

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

VideoViewability

Szczegóły ustawień widoczności filmu w DoubleVerify

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

enum (VideoIAB)

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

enum (VideoViewableRate)

Kieruj reklamy na zasoby reklamowe w internecie, aby zmaksymalizować współczynnik widoczności w 100%.
playerImpressionRate

enum (PlayerImpressionRate)

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

VideoIAB

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

Wartości w polu enum
VIDEO_IAB_UNSPECIFIED Ten typ enum jest tylko miejscem zastępczym i nie określa żadnych opcji współczynnika widoczności reklam wideo według IAB.
IAB_VIEWABILITY_80_PERCENT_HIGHER Kieruj reklamy na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować współczynnik widoczności IAB do poziomu co najmniej 80%.
IAB_VIEWABILITY_75_PERCENT_HIGHER Kieruj reklamy na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 75%.
IAB_VIEWABILITY_70_PERCENT_HIGHER Kieruj reklamy na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 70%.
IAB_VIEWABILITY_65_PERCENT_HIHGER Kieruj reklamy na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 65%.
IAB_VIEWABILITY_60_PERCENT_HIGHER Kieruj reklamy na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 60%.
IAB_VIEWABILITY_55_PERCENT_HIHGER Kieruj reklamy na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 55%.
IAB_VIEWABILITY_50_PERCENT_HIGHER Kieruj reklamy na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 50%.
IAB_VIEWABILITY_40_PERCENT_HIHGER Kieruj reklamy na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 40%.
IAB_VIEWABILITY_30_PERCENT_HIHGER Kieruj reklamy na zasoby reklamowe w witrynach i aplikacjach, aby zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 30%.

VideoViewableRate

Możliwe opcje współczynnika widoczności

Wartości w polu enum
VIDEO_VIEWABLE_RATE_UNSPECIFIED Ten typ danych jest tylko miejscem substytucyjnym i nie określa żadnych opcji oglądalności filmu.
VIEWED_PERFORMANCE_40_PERCENT_HIGHER Kieruj na zasoby reklamowe w witrynach, aby zmaksymalizować współczynnik widoczności na poziomie co najmniej 40%.
VIEWED_PERFORMANCE_35_PERCENT_HIGHER Kieruj na zasoby reklamowe w witrynach, aby zmaksymalizować współczynnik widoczności w 100% do poziomu co najmniej 35%.
VIEWED_PERFORMANCE_30_PERCENT_HIGHER Kieruj na internetowe zasoby reklamowe, aby zmaksymalizować współczynnik pełnej widoczności na poziomie co najmniej 30%.
VIEWED_PERFORMANCE_25_PERCENT_HIGHER Kieruj na zasoby reklamowe w internecie, aby zmaksymalizować współczynnik widoczności w 100% do poziomu co najmniej 25%.
VIEWED_PERFORMANCE_20_PERCENT_HIGHER Kieruj na zasoby reklamowe w internecie, aby zmaksymalizować współczynnik widoczności w 100% do poziomu co najmniej 20%.
VIEWED_PERFORMANCE_10_PERCENT_HIGHER Kieruj na zasoby reklamowe w internecie, aby zmaksymalizować współczynnik widoczności w 100% lub wyższy.

PlayerImpressionRate

Możliwe opcje wyświetleń.

Wartości w polu enum
PLAYER_SIZE_400X300_UNSPECIFIED Jest ona tylko symbolem zastępczym i nie określa żadnych opcji wyświetleń.
PLAYER_SIZE_400X300_95 Strony z ponad 95% wyświetleń.
PLAYER_SIZE_400X300_70 Strony z ponad 70% wyświetleń.
PLAYER_SIZE_400X300_25 Strony z 25% lub większą liczbą wyświetleń.
PLAYER_SIZE_400X300_5 Strony, które generują co najmniej 5%wyświetleń.

FraudInvalidTraffic

Ustawienia dotyczące oszustwa i nieprawidłowego ruchu w DoubleVerify.

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

enum (FraudOption)

Unikaj witryn i aplikacji, które mają historyczne statystyki na temat fałszywego i nieprawidłowego ruchu.
avoidInsufficientOption

boolean

Niewystarczające historyczne statystyki na temat fałszywego i nieprawidłowego ruchu.

FraudOption

Możliwe opcje historycznego współczynnika fałszywego i nieprawidłowego ruchu.

Wartości w polu enum
FRAUD_UNSPECIFIED Ta enumeracja jest tylko miejscem zastępczym i nie określa żadnych opcji dotyczących oszustwa ani nieprawidłowego ruchu.
AD_IMPRESSION_FRAUD_100 100% fałszywego i nieprawidłowego ruchu z reklam.
AD_IMPRESSION_FRAUD_50 Co najmniej 50% fałszywego i nieprawidłowego ruchu z reklam.
AD_IMPRESSION_FRAUD_25 Co najmniej 25% 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
  ]
}
Pola
traqScoreOption

enum (TRAQScore)

True Advertising Quality (CPM) (dotyczy tylko elementów zamówienia w sieci reklamowej).
excludeUnrateable

boolean

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

enum (Adult)

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

enum (Alcohol)

Bezpieczeństwo marki – alkohol.
excludedIllegalDownloadsRisk

enum (IllegalDownloads)

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

enum (Drugs)

Bezpieczeństwo marki – leki.
excludedHateSpeechRisk

enum (HateSpeech)

Bezpieczeństwo marki – 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 dotyczące oszustw reklamowych.
displayViewability

enum (DisplayViewability)

Sekcja Wyświetlanie widoczności (dotyczy tylko displayowych elementów zamówienia).
videoViewability

enum (VideoViewability)

Sekcja Widoczność reklam wideo (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 (włącznie).

TRAQScore

Możliwe zakresy wyników Integral Ad Science TRAQ (rzeczywista jakość reklam).

Wartości w polu enum
TRAQ_UNSPECIFIED Ten typ danych jest tylko miejscem zastępczym i nie określa żadnych rzeczywistych wyników jakości reklamy.
TRAQ_250 Wynik TRAQ: 250–1000.
TRAQ_500 Wynik TRAQ: 500–1000.
TRAQ_600 Wynik TRAQ: 600–1000.
TRAQ_700 Wynik TRAQ: 700–1000.
TRAQ_750 Wynik TRAQ to 750–1000.
TRAQ_875 Wynik TRAQ: 875–1000.
TRAQ_1000 TRAQ ma wartość 1000.

Dorosły

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

Wartości w polu enum
ADULT_UNSPECIFIED Ta enumeracja jest tylko miejscem zastępczym i nie określa żadnych opcji dla dorosłych.
ADULT_HR Treści dla dorosłych – wyklucz wysoki poziom ryzyka.
ADULT_HMR Dla dorosłych – wyklucz wysokie i umiarkowane ryzyko.

Alkohol

Możliwe opcje dotyczące alkoholu w Integral Ad Science

Wartości w polu enum
ALCOHOL_UNSPECIFIED Ta enumeracja jest tylko miejscem zastępczym i nie określa żadnych opcji alkoholowych.
ALCOHOL_HR Alkohol – wyklucz obszary wysokiego ryzyka.
ALCOHOL_HMR Alkohol – wyklucz ryzyko wysokie i umiarkowane.

IllegalDownloads

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

Wartości w polu enum
ILLEGAL_DOWNLOADS_UNSPECIFIED Ta enumeracja jest tylko miejscem zastępczym i nie określa żadnych opcji nielegalnych pobrań.
ILLEGAL_DOWNLOADS_HR Nielegalne pliki do pobrania – wyklucz pliki wysokiego ryzyka.
ILLEGAL_DOWNLOADS_HMR Nielegalne pliki do pobrania – wyklucz ryzyko wysokie i umiarkowane.

Narkotyki

Możliwe opcje Integral Ad Science Drugs.

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

HateSpeech

Możliwe opcje dotyczące mowy nienawiści w usłudze Integral Ad Science

Wartości w polu enum
HATE_SPEECH_UNSPECIFIED Ta enumeracja jest tylko miejscem zastępczym i nie określa żadnych opcji dotyczących mowy nienawiści.
HATE_SPEECH_HR Szerzenie nienawiści – wyklucz obszary wysokiego ryzyka.
HATE_SPEECH_HMR Mowa nienawiści – wyklucz wysoki i umiarkowany poziom ryzyka.

OffensiveLanguage

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

Wartości w polu enum
OFFENSIVE_LANGUAGE_UNSPECIFIED Ten typ enum jest tylko miejscem 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 wysoki i umiarkowany poziom ryzyka.

Przemoc

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

Wartości w polu enum
VIOLENCE_UNSPECIFIED Ten typ jest tylko miejscem zastępczym i nie określa żadnych opcji przemocy.
VIOLENCE_HR Przemoc – wyklucz wysoki poziom ryzyka.
VIOLENCE_HMR Przemoc – wyklucz wysoki i umiarkowany poziom ryzyka.

Hazard

Możliwe opcje hazardu w usłudze Integral Ad Science

Wartości w polu enum
GAMBLING_UNSPECIFIED Ten typ jest tylko miejscem zastępczym i nie określa żadnych opcji hazardu.
GAMBLING_HR Hazard – wyklucz wysoki poziom ryzyka.
GAMBLING_HMR Hazard – wyklucz wysoki i średni poziom ryzyka.

AdFraudPrevention

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

Wartości w polu enum
SUSPICIOUS_ACTIVITY_UNSPECIFIED Ta enumeracja jest tylko miejscem zastępczym i nie określa żadnych opcji zapobiegania oszustwom reklamowym.
SUSPICIOUS_ACTIVITY_HR Oszustwa reklamowe – wyklucz wysoki poziom ryzyka.
SUSPICIOUS_ACTIVITY_HMR Oszustwa reklamowe – wyklucz ryzyko wysokie i umiarkowane.

DisplayViewability

Możliwe opcje widoczności reklamy displayowej w usłudze Integral Ad Science.

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

VideoViewability

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

Wartości w polu enum
VIDEO_VIEWABILITY_UNSPECIFIED Ten typ danych jest tylko miejscem zastępczym i nie określa żadnych opcji widoczności filmu.
VIDEO_VIEWABILITY_40 Widoczność powyżej 40% (standard widoczności reklam wideo IAB).
VIDEO_VIEWABILITY_50 Widoczność ≥ 50% (standard widoczności reklam wideo IAB).
VIDEO_VIEWABILITY_60 Widoczność powyżej 60% (standard widoczności reklam wideo IAB).
VIDEO_VIEWABILITY_70 Widoczność na ekranie: co najmniej 70% (standard widoczności reklam wideo IAB).

PoiAssignedTargetingOptionDetails

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

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

string

Tylko dane wyjściowe. Wyświetlana nazwa punktu zainteresowania, np. „Times Square”, „Space Needle”, a za nią pełny adres (jeśli jest dostępny).
targetingOptionId

string

Wymagane. Wartość targetingOptionId obiektu TargetingOption typu TARGETING_TYPE_POI.

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

Jeśli kierujesz reklamy na współrzędne geograficzne, które zostały usunięte z adresu lub nazwy punktu zainteresowania, możesz wygenerować niezbędny identyfikator opcji kierowania, zaokrąglając wartości współrzędnych do 6 znaków po przecinku, usuwając wartości dziesiętne i łącząc ciągi znaków rozdzielone średnikami. Możesz na przykład kierować reklamy na parę współrzędnych 40,7414691, -74,003387, używając identyfikatora opcji kierowania „40741469;-74003387”. Po utworzeniu to pole zostanie zaktualizowane, aby dodać przecinek i wartość zaszyfrowaną alfanumerycznie, jeśli podano tylko współrzędne szerokości i długości geograficznej .
latitude

number

Tylko dane wyjściowe. Szerokość geograficzną punktu POI zaokrągla do 6 miejsc po przecinku.
longitude

number

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

number

Wymagane. Promień obszaru wokół ważnego miejsca, na który będzie kierowana reklama. Jednostki promienia są określone przez proximityRadiusUnit. Musi wynosić od 1 do 800, jeśli jednostką jest DISTANCE_UNIT_KILOMETERS, oraz od 1 do 500, jeśli jednostką jest DISTANCE_UNIT_MILES.
proximityRadiusUnit

enum (DistanceUnit)

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

DistanceUnit

Możliwe opcje jednostek odległości.

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

BusinessChainAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania na sieć placówek Gdy wartość targetingType wynosi TARGETING_TYPE_BUSINESS_CHAIN, to pole zostanie wypełnione w polu szczegółów AssignedTargetingOption.

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

string

Tylko dane wyjściowe. Wyświetlana nazwa sieci firmowej, np. „KFC”, „Chase Bank”.
targetingOptionId

string

Wymagane. targetingOptionId w TargetingOption typu TARGETING_TYPE_BUSINESS_CHAIN.

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

number

Wymagane. Promień obszaru wokół sieci firmowej, na który będzie kierowana reklama. Jednostki promienia są określone przez proximityRadiusUnit. Musi wynosić od 1 do 800, jeśli jednostką jest DISTANCE_UNIT_KILOMETERS, oraz od 1 do 500, jeśli jednostką jest DISTANCE_UNIT_MILES. Minimalny przyrost w obu przypadkach wynosi 0,1. Jeśli dane wejściowe są zbyt szczegółowe, zostaną zaokrąglone do najbliższej dopuszczalnej wartości, np. 15,57 stanie się 15,6.
proximityRadiusUnit

enum (DistanceUnit)

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

ContentDurationAssignedTargetingOptionDetails

Szczegóły opcji kierowania przypisanej do czasu trwania treści. Gdy wartość targetingType to TARGETING_TYPE_CONTENT_DURATION, pole contentDurationDetails zostanie wypełnione. Kierowanie na wszystkie opcje nie jest obsługiwane. Aby osiągnąć ten efekt, usuń wszystkie opcje kierowania na czas trwania treści.

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

string

Wymagane. Pole targetingOptionId, gdy targetingType ma wartość TARGETING_TYPE_CONTENT_DURATION.
contentDuration

enum (ContentDuration)

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

ContentStreamTypeAssignedTargetingOptionDetails

Szczegóły opcji kierowania przypisanej do typu strumienia treści. Gdy targetingType ma wartość TARGETING_TYPE_CONTENT_STREAM_TYPE, pole contentStreamTypeDetails zostanie wypełnione. Kierowanie na wszystkie opcje nie jest obsługiwane. Aby to zrobić, usuń wszystkie opcje kierowania na typ strumienia treści.

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

string

Wymagane. Pole targetingOptionId, gdy targetingType ma wartość TARGETING_TYPE_CONTENT_STREAM_TYPE.
contentStreamType

enum (ContentStreamType)

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

NativeContentPositionAssignedTargetingOptionDetails

Szczegóły opcji kierowania na pozycję w treści natywnej. Gdy wartość targetingType to TARGETING_TYPE_NATIVE_CONTENT_POSITION, pole nativeContentPositionDetails zostanie wypełnione. Kierowanie na wszystkie opcje nie jest obsługiwane. Aby osiągnąć ten efekt, usuń wszystkie opcje kierowania na pozycje natywne pod kątem pozycji treści.

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

enum (NativeContentPosition)

Wymagane. Pozycja treści.

OmidAssignedTargetingOptionDetails

Reprezentuje typ zasobów reklamowych z obsługą standardu Open Measurement, na który można kierować reklamy. Gdy wartość targetingType wynosi TARGETING_TYPE_OMID, to pole zostanie wypełnione w polu szczegółów AssignedTargetingOption.

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

enum (Omid)

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

AudioContentTypeAssignedTargetingOptionDetails

Szczegóły dotyczące typu treści audio przypisanego do opcji kierowania. Gdy targetingType ma wartość TARGETING_TYPE_AUDIO_CONTENT_TYPE, pole audioContentTypeDetails zostanie wypełnione. Kierowanie na wszystkie opcje nie jest obsługiwane. Aby to zrobić, usuń wszystkie opcje kierowania na typ treści audio.

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

enum (AudioContentType)

Wymagane. Typ treści audio.

ContentGenreAssignedTargetingOptionDetails

Szczegóły opcji kierowania na gatunek treści. Gdy wartość targetingType to TARGETING_TYPE_CONTENT_GENRE, pole contentGenreDetails zostanie wypełnione. Kierowanie na wszystkie opcje nie jest obsługiwane. Aby to zrobić, usuń wszystkie opcje kierowania na gatunek treści.

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

string

Wymagane. Pole targetingOptionId, gdy targetingType ma wartość TARGETING_TYPE_CONTENT_GENRE.
displayName

string

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

boolean

Wskazuje, czy ta opcja jest kierowana negatywnie.

YoutubeVideoAssignedTargetingOptionDetails

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

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

string

Identyfikator filmu w YouTube, 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 przypisanego do kanału w YouTube. Gdy targetingType ma wartość TARGETING_TYPE_YOUTUBE_CHANNEL, pole youtubeChannelDetails zostanie wypełnione.

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

string

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

boolean

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

SessionPositionAssignedTargetingOptionDetails

Szczegóły opcji kierowania na pozycję sesji. Gdy wartość targetingType to TARGETING_TYPE_SESSION_POSITION, pole sessionPositionDetails zostanie wypełnione.

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

enum (SessionPosition)

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

SessionPosition

Możliwe pozycje w sesji.

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

Metody

get

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

list

 Zawiera listę opcji kierowania przypisanych do grupy reklam.