REST Resource: advertisers.campaigns.targetingTypes.assignedTargetingOptions

Zasób: AssignedTargetOption

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

Zapis JSON
{
  "name": string,
  "assignedTargetingOptionId": 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)
  }
  // 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 obrębie danego zasobu i typu kierowania. Można go użyć w innych kontekstach.

targetingType

enum (TargetingType)

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

inheritance

enum (Inheritance)

Tylko dane wyjściowe. Stan dziedziczenia przypisanej opcji kierowania.

Pole sumy details. Szczegółowe informacje o przypisywanej opcji kierowania. Możesz wypełnić tylko jedno pole w szczegółach, które musi odpowiadać parametrowi targeting_type. details może mieć tylko jedno z tych pól:
channelDetails

object (ChannelAssignedTargetingOptionDetails)

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

appCategoryDetails

object (AppCategoryAssignedTargetingOptionDetails)

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

appDetails

object (AppAssignedTargetingOptionDetails)

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

urlDetails

object (UrlAssignedTargetingOptionDetails)

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

dayAndTimeDetails

object (DayAndTimeAssignedTargetingOptionDetails)

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

ageRangeDetails

object (AgeRangeAssignedTargetingOptionDetails)

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

regionalLocationListDetails

object (RegionalLocationListAssignedTargetingOptionDetails)

Szczegóły regionalnej listy lokalizacji. To pole zostanie wypełnione, gdy targetingType będzie mieć wartość TARGETING_TYPE_REGIONAL_LOCATION_LIST.

proximityLocationListDetails

object (ProximityLocationListAssignedTargetingOptionDetails)

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

genderDetails

object (GenderAssignedTargetingOptionDetails)

Informacje o płci. To pole zostanie wypełnione, gdy targetingType będzie mieć wartość TARGETING_TYPE_GENDER.

videoPlayerSizeDetails

object (VideoPlayerSizeAssignedTargetingOptionDetails)

Informacje o rozmiarze odtwarzacza wideo. To pole zostanie wypełnione, gdy targetingType będzie mieć wartość TARGETING_TYPE_VIDEO_PLAYER_SIZE.

userRewardedContentDetails

object (UserRewardedContentAssignedTargetingOptionDetails)

Szczegółowe informacje o treściach z nagrodą dla użytkowników. To pole zostanie wypełnione, gdy targetingType będzie mieć wartość TARGETING_TYPE_USER_REWARDED_CONTENT.

parentalStatusDetails

object (ParentalStatusAssignedTargetingOptionDetails)

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

contentInstreamPositionDetails

object (ContentInstreamPositionAssignedTargetingOptionDetails)

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

contentOutstreamPositionDetails

object (ContentOutstreamPositionAssignedTargetingOptionDetails)

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

deviceTypeDetails

object (DeviceTypeAssignedTargetingOptionDetails)

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

audienceGroupDetails

object (AudienceGroupAssignedTargetingOptionDetails)

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

browserDetails

object (BrowserAssignedTargetingOptionDetails)

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

householdIncomeDetails

object (HouseholdIncomeAssignedTargetingOptionDetails)

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

onScreenPositionDetails

object (OnScreenPositionAssignedTargetingOptionDetails)

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

carrierAndIspDetails

object (CarrierAndIspAssignedTargetingOptionDetails)

Szczegółowe informacje o operatorze i dostawcy internetu. To pole zostanie wypełnione, gdy targetingType będzie mieć wartość TARGETING_TYPE_CARRIER_AND_ISP.

keywordDetails

object (KeywordAssignedTargetingOptionDetails)

Szczegóły dotyczące słów kluczowych. To pole zostanie wypełnione, gdy targetingType będzie mieć wartość TARGETING_TYPE_KEYWORD.

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

negativeKeywordListDetails

object (NegativeKeywordListAssignedTargetingOptionDetails)

Szczegóły dotyczące słów kluczowych. To pole zostanie wypełnione, gdy targetingType będzie mieć wartość TARGETING_TYPE_NEGATIVE_KEYWORD_LIST.

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

operatingSystemDetails

object (OperatingSystemAssignedTargetingOptionDetails)

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

deviceMakeModelDetails

object (DeviceMakeModelAssignedTargetingOptionDetails)

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

environmentDetails

object (EnvironmentAssignedTargetingOptionDetails)

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

inventorySourceDetails

object (InventorySourceAssignedTargetingOptionDetails)

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

categoryDetails

object (CategoryAssignedTargetingOptionDetails)

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

Kierowanie na kategorię działa też w jej podkategoriach. Jeśli kategoria jest wykluczona z kierowania i uwzględniona jest podkategoria, wykluczenie ma pierwszeństwo.

viewabilityDetails

object (ViewabilityAssignedTargetingOptionDetails)

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

Możesz kierować reklamy tylko na 1 opcję widoczności na zasób.

authorizedSellerStatusDetails

object (AuthorizedSellerStatusAssignedTargetingOptionDetails)

Szczegółowe informacje o stanie autoryzowanego sprzedawcy. To pole zostanie wypełnione, gdy targetingType będzie mieć wartość TARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

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

Jeśli zasób nie ma ustawionej opcji stanu autoryzowanego sprzedawcy, domyślnie reklamy są kierowane na wszystkich autoryzowanych sprzedawców oznaczonych w pliku ads.txt jako DIRECT lub RESELLER.

languageDetails

object (LanguageAssignedTargetingOptionDetails)

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

geoRegionDetails

object (GeoRegionAssignedTargetingOptionDetails)

Szczegóły dotyczące regionu geograficznego. To pole zostanie wypełnione, gdy targetingType będzie mieć wartość TARGETING_TYPE_GEO_REGION.

inventorySourceGroupDetails

object (InventorySourceGroupAssignedTargetingOptionDetails)

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

digitalContentLabelExclusionDetails

object (DigitalContentLabelAssignedTargetingOptionDetails)

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

Etykiety treści cyfrowych służą do kierowania na wykluczenia. Jeśli wykluczenia etykiet treści cyfrowych na poziomie reklamodawcy są ustawione, są zawsze stosowane podczas wyświetlania reklam (nawet wtedy, gdy nie są widoczne w ustawieniach zasobów). Ustawienia zasobów oprócz wykluczeń reklamodawców mogą wykluczać etykiety treści, 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 kategorii reklam o charakterze kontrowersyjnym. To pole zostanie wypełnione, gdy targetingType będzie mieć wartość TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION.

Kategorie o charakterze kontrowersyjnym to wykluczenia kierowania. Wykluczenia kategorii reklam o charakterze kontrowersyjnym na poziomie reklamodawcy, jeśli są ustawione, są zawsze stosowane podczas wyświetlania reklam (nawet wtedy, gdy nie są widoczne w ustawieniach zasobów). Ustawienia zasobów mogą oprócz wykluczeń reklamodawców wykluczać kategorie o charakterze kontrowersyjnym, ale nie mogą ich zastąpić.

exchangeDetails

object (ExchangeAssignedTargetingOptionDetails)

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

subExchangeDetails

object (SubExchangeAssignedTargetingOptionDetails)

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

thirdPartyVerifierDetails

object (ThirdPartyVerifierAssignedTargetingOptionDetails)

Szczegóły weryfikacji zewnętrznej. To pole zostanie wypeł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 targetingType będzie mieć wartość TARGETING_TYPE_POI.

businessChainDetails

object (BusinessChainAssignedTargetingOptionDetails)

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

contentDurationDetails

object (ContentDurationAssignedTargetingOptionDetails)

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

contentStreamTypeDetails

object (ContentStreamTypeAssignedTargetingOptionDetails)

Szczegóły czasu trwania treści. To pole zostanie wypełnione, gdy parametr TargetingType będzie miał wartość TARGETING_TYPE_CONTENT_STREAM_TYPE.

nativeContentPositionDetails

object (NativeContentPositionAssignedTargetingOptionDetails)

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

omidDetails

object (OmidAssignedTargetingOptionDetails)

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

audioContentTypeDetails

object (AudioContentTypeAssignedTargetingOptionDetails)

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

contentGenreDetails

object (ContentGenreAssignedTargetingOptionDetails)

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

Dziedziczenie

Wskazuje, czy przypisana opcja kierowania jest dziedziczona z elementu wyższego poziomu, takiego jak partner czy reklamodawca. Dziedziczone przypisane opcje kierowania mają pierwszeństwo, są zawsze stosowane w wyświetlaniu zamiast kierowania przypisanego na bieżącym poziomie i nie można ich zmienić w bieżącej usłudze encji. Należy je modyfikować za pomocą usługi encji, z której są dziedziczone. Dziedziczenie ma zastosowanie tylko do wykluczonych kanałów, wykluczeń kategorii o charakterze kontrowersyjnym i wykluczeń etykiet treści cyfrowych, jeśli zostały one skonfigurowane na poziomie nadrzędnym.

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

ChannelAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania na kanał. Gdy targetingType ma wartość TARGETING_TYPE_CHANNEL, zostanie ono wypełnione w polu szczegółów właściwości AssignedTargetOption.

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

string (int64 format)

To pole jest wymagane. Identyfikator kanału. Powinny 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 celem kierowania wykluczającego. 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 ono wypełnione w polu appCategoryDetails właściwości AssignedTargetOption.

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

string

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

targetingOptionId

string

To pole jest wymagane. Pole targetingOptionId, gdy targetingType ma wartość TARGETING_TYPE_APP_CATEGORY.

negative

boolean

Wskazuje, czy ta opcja jest celem kierowania wykluczającego.

AppAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania na aplikację. Gdy targetingType ma wartość TARGETING_TYPE_APP, zostanie ono wypełnione w polu szczegółów właściwości AssignedTargetOption.

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

string

To pole jest wymagane. Identyfikator aplikacji.

Aplikacja Sklep Play na Androida używa identyfikatora pakietu, np. com.google.android.gm. Identyfikator aplikacji Apple App Store zawiera 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 celem kierowania wykluczającego.

appPlatform

enum (AppPlatform)

Wskazuje platformę aplikacji docelowej. Jeśli nie określisz wartości pola, przyjmuje się, że platforma aplikacji jest przeznaczona na urządzenia mobilne (tzn. Android lub iOS) i wybierzemy odpowiednią platformę mobilną z 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. Ta wyliczenie jest symbolem zastępczym 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 FireTV.
APP_PLATFORM_PLAYSTATION Platforma aplikacji to Playstation.
APP_PLATFORM_APPLE_TV Platforma aplikacji to Apple TV.
APP_PLATFORM_XBOX Platforma aplikacji to Xbox.
APP_PLATFORM_SAMSUNG_TV 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 nigdzie indziej.

UrlAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania na adres URL. Gdy targetingType ma wartość TARGETING_TYPE_URL, zostanie ono wypełnione w polu szczegółów właściwości AssignedTargetOption.

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

string

To pole jest 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 subdomenę, np. five.four.three.two.one.example.com.

negative

boolean

Wskazuje, czy ta opcja jest celem kierowania wykluczającego.

DayAndTimeAssignedTargetingOptionDetails

Przedstawienie segmentu czasu określonego w konkretnym dniu tygodnia oraz czasu rozpoczęcia i zakończenia. Czas podany przez startHour musi przypadać przed czasem w endHour.

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

enum (DayOfWeek)

To pole jest wymagane. Dzień tygodnia powiązany z tym ustawieniem kierowania na dzień i godzinę.

startHour

integer

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

endHour

integer

To pole jest wymagane. Godzina końcowa kierowania na dzień i godzinę. Musi mieścić się w przedziale od 1 (1 godzina od początku dnia) do 24 (koniec dnia).

timeZoneResolution

enum (TimeZoneResolution)

To pole jest wymagane. Mechanizm służący do określania strefy czasowej, która ma być używana w przypadku danego ustawienia kierowania na datę i godzinę.

DayOfWeek

Reprezentuje dzień tygodnia.

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

TimeZoneResolution

Możliwe sposoby rozpoznania strefy czasowej.

Wartości w polu enum
TIME_ZONE_RESOLUTION_UNSPECIFIED Rozdzielczość strefy czasowej jest nieokreślona lub nieznana.
TIME_ZONE_RESOLUTION_END_USER Czas jest ustawiany według strefy czasowej użytkownika, który widział reklamę.
TIME_ZONE_RESOLUTION_ADVERTISER Czas jest ustawiany według strefy czasowej reklamodawcy, który wyświetlił reklamę.

AgeRangeAssignedTargetingOptionDetails

Reprezentuje przedział wiekowy, na który można kierować reklamy. Gdy targetingType ma wartość TARGETING_TYPE_AGE_RANGE, zostanie ono wypełnione w polu szczegółów właściwości AssignedTargetOption.

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

enum (AgeRange)

Przedział wiekowy odbiorców. Obsługujemy tylko kierowanie na stały przedział wiekowy odbiorców. Dlatego przedział wiekowy podany w tym polu może być 1) kierowany wyłącznie lub 2) częściowo z szerszego przedziału wiekowego. Zasięg stałego kierowania na przedział wiekowy można zwiększyć, kierując reklamy również na odbiorców w nieznanym wieku.

Dane wyjściowe tylko w wersji 1. Wymagane w wersji 2.

targetingOptionId

string

To pole jest wymagane. Wartość targetingOptionId elementu TargetingOption typu TARGETING_TYPE_AGE_RANGE.

RegionalLocationListAssignedTargetingOptionDetails

Szczegóły kierowania na listę lokalizacji regionalnych. Gdy targetingType ma wartość TARGETING_TYPE_REGIONAL_LOCATION_LIST, zostanie ono wypełnione w polu szczegółów właściwości AssignedTargetOption.

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

string (int64 format)

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

negative

boolean

Wskazuje, czy ta opcja jest celem kierowania wykluczającego.

ProximityLocationListAssignedTargetingOptionDetails

Szczegóły kierowania na listę pobliskich lokalizacji. Gdy targetingType ma wartość TARGETING_TYPE_PROXIMITY_LOCATION_LIST, zostanie ono wypełnione w polu szczegółów właściwości AssignedTargetOption.

Zapis JSON
{
  "proximityLocationListId": string,
  "proximityRadiusRange": enum (ProximityRadiusRange)
}
Pola
proximityLocationListId

string (int64 format)

To pole jest wymagane. Identyfikator listy lokalizacji w pobliżu. Powinna się odnosić do pola locationListId zasobu LocationList, którego typ to TARGETING_LOCATION_TYPE_PROXIMITY.

proximityRadiusRange

enum (ProximityRadiusRange)

To pole jest wymagane. Zakres promienia listy lokalizacji w pobliżu. Jest to wielkość obszaru wokół wybranej lokalizacji, na którą będą kierowane reklamy.

Kierowanie na zbliżony obszar (All) w ramach 1 zasobu musi mieć tę samą wartość zakresu zasięgu. Ustaw tę wartość tak, aby pasowała do istniejącego kierowania. Po aktualizacji to pole zmieni zasięg promienia we wszystkich kierowaniu na zbliżony obszar w ramach zasobu.

ProximityRadiusRange

Typ zakresu promienia przypisanego do kierowania geograficznego. Zakres promienia zależy od gęstości populacji. Na przykład PROXIMITY_RADIUS_RANGE_SMALL na obszarze wiejskim będzie się różnił od PROXIMITY_RADIUS_RANGE_SMALL w gęsto zaludnionym mieście.

Wartości w polu enum
PROXIMITY_RADIUS_RANGE_UNSPECIFIED Zakres docelowego obszaru nie został określony lub jest nieznany. Wartość domyślna, gdy zakres promienia nie jest określony w tej wersji. Ta wyliczenie jest tylko symbolem zastępczym wartości domyślnej i nie reprezentuje opcji zakresu rzeczywistego.
PROXIMITY_RADIUS_RANGE_SMALL Zakres kierowania jest niewielki.
PROXIMITY_RADIUS_RANGE_MEDIUM Docelowy zasięg jest średni.
PROXIMITY_RADIUS_RANGE_LARGE Zakres kierowania jest duży.

GenderAssignedTargetingOptionDetails

Szczegóły dotyczące przypisanej opcji kierowania na płeć. Gdy targetingType ma wartość TARGETING_TYPE_GENDER, zostanie ono wypełnione w polu szczegółów właściwości AssignedTargetOption.

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

enum (Gender)

Płeć odbiorców.

Dane wyjściowe tylko w wersji 1. Wymagane w wersji 2.

targetingOptionId

string

To pole jest wymagane. Wartość targetingOptionId elementu TargetingOption typu TARGETING_TYPE_GENDER.

VideoPlayerSizeAssignedTargetingOptionDetails

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

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

string

To pole jest wymagane. Pole targetingOptionId, gdy targetingType ma wartość TARGETING_TYPE_VIDEO_PLAYER_SIZE.

videoPlayerSize

enum (VideoPlayerSize)

Rozmiar odtwarzacza.

Dane wyjściowe tylko w wersji 1. Wymagane w wersji 2.

UserRewardedContentAssignedTargetingOptionDetails

Szczegóły opcji kierowania na treści z nagrodą dla użytkowników. Gdy targetingType będzie mieć wartość TARGETING_TYPE_USER_REWARDED_CONTENT, zostanie ono wypełnione w polu userRewardedContentDetails.

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

string

To pole jest 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 przypisanej opcji kierowania na status rodzicielski. Gdy targetingType ma wartość TARGETING_TYPE_PARENTAL_STATUS, zostanie ono wypełnione w polu szczegółów właściwości AssignedTargetOption.

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

enum (ParentalStatus)

Status rodzicielski odbiorców.

Dane wyjściowe tylko w wersji 1. Wymagane w wersji 2.

targetingOptionId

string

To pole jest wymagane. Wartość targetingOptionId elementu TargetingOption typu TARGETING_TYPE_PARENTAL_STATUS.

ContentInstreamPositionAssignedTargetingOptionDetails

Szczegóły opcji kierowania na pozycję przypisanej treści w reklamie In-Stream. Gdy targetingType będzie mieć wartość TARGETING_TYPE_CONTENT_INSTREAM_POSITION, zostanie ono wypełnione w polu contentInstreamPositionDetails.

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

string

To pole jest wymagane. Pole targetingOptionId, gdy targetingType ma wartość TARGETING_TYPE_CONTENT_INSTREAM_POSITION.

contentInstreamPosition

enum (ContentInstreamPosition)

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

Dane wyjściowe tylko w wersji 1. Wymagane w wersji 2.

adType

enum (AdType)

Tylko dane wyjściowe. Typ reklamy, na którą chcesz kierować reklamy. Ta opcja będzie domyślnie dziedziczona tylko w przypadku kierowania zamówień reklamowych i nowych elementów zamówienia obsługujących określony typ reklamy. Możliwe wartości to:

  • AD_TYPE_VIDEO, ustawienie zostanie odziedziczone przez nowy element zamówienia, gdy wartość w kolumnie lineItemType wynosi LINE_ITEM_TYPE_VIDEO_DEFAULT.
  • AD_TYPE_AUDIO, ustawienie zostanie odziedziczone przez nowy element zamówienia, gdy wartość w kolumnie lineItemType wynosi LINE_ITEM_TYPE_AUDIO_DEFAULT.

AdType

Reprezentuje typ kreacji powiązany z reklamami.

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

ContentOutstreamPositionAssignedTargetingOptionDetails

Szczegóły opcji kierowania na pozycję przypisanej treści Out-Stream. Gdy targetingType będzie mieć wartość TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION, zostanie ono wypełnione w polu contentOutstreamPositionDetails.

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

string

To pole jest wymagane. Pole targetingOptionId, gdy targetingType ma wartość TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION.

contentOutstreamPosition

enum (ContentOutstreamPosition)

Pozycja treści Out-Stream.

Dane wyjściowe tylko w wersji 1. Wymagane w wersji 2.

adType

enum (AdType)

Tylko dane wyjściowe. Typ reklamy, na którą chcesz kierować reklamy. Ta opcja będzie domyślnie dziedziczona tylko w przypadku kierowania zamówień reklamowych i nowych elementów zamówienia obsługujących określony typ reklamy. Możliwe wartości to:

  • AD_TYPE_DISPLAY, ustawienie zostanie odziedziczone przez nowy element zamówienia, gdy wartość w kolumnie lineItemType wynosi LINE_ITEM_TYPE_DISPLAY_DEFAULT.
  • AD_TYPE_VIDEO, ustawienie zostanie odziedziczone przez nowy element zamówienia, gdy wartość w kolumnie lineItemType wynosi LINE_ITEM_TYPE_VIDEO_DEFAULT.

DeviceTypeAssignedTargetingOptionDetails

Szczegóły kierowania według typu urządzenia. Gdy targetingType ma wartość TARGETING_TYPE_DEVICE_TYPE, zostanie ono wypełnione w polu szczegółów właściwości AssignedTargetOption.

Zapis JSON
{
  "targetingOptionId": string,
  "deviceType": enum (DeviceType)
}
Pola
targetingOptionId

string

To pole jest wymagane. Identyfikator typu urządzenia.

deviceType

enum (DeviceType)

Wyświetlana nazwa typu urządzenia.

Dane wyjściowe tylko w wersji 1. Wymagane w wersji 2.

AudienceGroupAssignedTargetingOptionDetails

Szczegóły opcji kierowania przypisanej grupy odbiorców. Gdy targetingType ma wartość TARGETING_TYPE_AUDIENCE_GROUP, zostanie ono wypełnione w polu szczegółów właściwości AssignedTargetOption. Relacja między poszczególnymi grupami to UNION, z wyjątkiem wykluczeń FirstAndOtherPartyAudienceGroup i excludedGoogleAudienceGroup, których COMPLEMENT służy jako EDGE w połączeniu 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 odbiorców (własnych i dostarczonych przez firmę zewnętrzną) oraz częstotliwości uwzględnionych w grupach odbiorców (własnych i dostarczonych przez firmę zewnętrzną). Każda grupa odbiorców własna i dostarczona przez inną firmę zawiera tylko identyfikatory odbiorców własne i dostarczone przez inną firmę. Relacja między Własną grupą odbiorców a grupą odbiorców dostarczoną przez inną firmę to EDGE, a wynik jest łączony z innymi grupami odbiorców. Powtarzające się grupy z takimi samymi ustawieniami będą ignorowane.

includedGoogleAudienceGroup

object (GoogleAudienceGroup)

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

includedCustomListGroup

object (CustomListGroup)

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

includedCombinedAudienceGroup

object (CombinedAudienceGroup)

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

excludedFirstAndThirdPartyAudienceGroup

object (FirstAndThirdPartyAudienceGroup)

Identyfikatory własne i listy odbiorców dostarczone przez inną firmę w przypadku wykluczonej własnej grupy odbiorców i grupy odbiorców dostarczonych przez firmę zewnętrzną. Służy do kierowania wykluczającego. UZUPEŁNIENIE połączenia tej grupy i innych wykluczonych grup odbiorców służy jako PRZESUNIĘCIE DO każdego niewykluczającego kierowania na odbiorców. Wszystkie elementy są logicznie połączone operatorem LUB.

excludedGoogleAudienceGroup

object (GoogleAudienceGroup)

Identyfikatory odbiorców Google w wykluczonej grupie odbiorców Google. Służy do kierowania wykluczającego. UZUPEŁNIENIE połączenia tej grupy i innych wykluczonych grup odbiorców służy jako PRZESUNIĘCIE DO każdego niewykluczającego kierowania na odbiorców. Obejmuje tylko odbiorców Google o podobnych zainteresowaniach, odbiorców na rynku i zainstalowanych aplikacji. Wszystkie elementy są logicznie połączone operatorem LUB.

FirstAndThirdPartyAudienceGroup

Szczegółowe informacje o własnej grupie odbiorców i grupie odbiorców dostarczonej przez inną firmę. Wszystkie ustawienia kierowania na odbiorców własnych i dostarczanych przez inne firmy są logicznie połączone operatorem LUB.

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

object (FirstAndThirdPartyAudienceTargetingSetting)

To pole jest wymagane. Wszystkie ustawienia kierowania na odbiorców (własne i innych firm) w grupie odbiorców (własnej i innej firmy). Powtarzające się ustawienia o tym samym identyfikatorze są niedozwolone.

FirstAndThirdPartyAudienceTargetingSetting

Szczegóły ustawienia kierowania na odbiorców własnych i dostarczanych przez inne firmy.

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

string (int64 format)

To pole jest wymagane. Identyfikator odbiorców z własnej i innej firmy, który jest określony w ustawieniu kierowania na odbiorców (własnej i innej firmy). Ten identyfikator to firstAndThirdPartyAudienceId.

recency

enum (Recency)

czas od ostatniej aktywności ustawienia kierowania na odbiorców (własna i dostarczonych przez firmę zewnętrzną). Dotyczy tylko własnych list odbiorców. W przeciwnym razie zostaną zignorowane. Więcej informacji znajdziesz na stronie https://support.google.com/displayvideo/answer/2949947#recency. Jeśli nie określono inaczej, limit czasu od poprzedniej wizyty nie jest używany.

Czas od poprzedniej wizyty

Wszystkie obsługiwane wartości czasu od poprzedniej wizyty na liście odbiorców własnej i dostarczonej przez inną firmę.

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

GoogleAudienceGroup

Szczegółowe informacje o grupie 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)

To pole jest wymagane. Wszystkie ustawienia kierowania na odbiorców Google w grupie odbiorców Google. Powtarzające się ustawienia o tym samym identyfikatorze będą ignorowane.

GoogleAudienceTargetingSetting

Szczegółowe informacje o ustawieniach kierowania na odbiorców Google.

Zapis JSON
{
  "googleAudienceId": string
}
Pola
googleAudienceId

string (int64 format)

To pole jest wymagane. Identyfikator odbiorców Google przypisany do ustawienia kierowania na odbiorców Google. Ten identyfikator to googleAudienceId.

CustomListGroup

Szczegóły niestandardowej grupy listy. Wszystkie ustawienia kierowania na listy niestandardowe są logiczne operatorem LUB.

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

object (CustomListTargetingSetting)

To pole jest wymagane. Wszystkie ustawienia kierowania na listy niestandardowe w grupie listy niestandardowej. Powtarzające się ustawienia o tym samym identyfikatorze będą ignorowane.

CustomListTargetingSetting

Szczegóły ustawienia kierowania na listy niestandardowe.

Zapis JSON
{
  "customListId": string
}
Pola
customListId

string (int64 format)

To pole jest wymagane. Niestandardowy identyfikator ustawienia kierowania na listy niestandardowe. Ten identyfikator to customListId.

CombinedAudienceGroup

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

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

object (CombinedAudienceTargetingSetting)

To pole jest wymagane. Wszystkie ustawienia kierowania na odbiorców z połączonych list w grupie odbiorców z połączonych list. Powtarzające się ustawienia o tym samym identyfikatorze będą ignorowane. Liczba ustawień grup odbiorców z połączonych list nie może być większa niż 5. W przeciwnym razie wystąpi błąd.

CombinedAudienceTargetingSetting

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

Zapis JSON
{
  "combinedAudienceId": string
}
Pola
combinedAudienceId

string (int64 format)

To pole jest wymagane. Połączony identyfikator odbiorców na potrzeby ustawienia kierowania na odbiorców z połączonych list. Ten identyfikator to combinedAudienceId.

BrowserAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania na przeglądarkę. Gdy targetingType ma wartość TARGETING_TYPE_BROWSER, zostanie ono wypełnione w polu szczegółów właściwości AssignedTargetOption.

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

string

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

targetingOptionId

string

To pole jest wymagane. Wartość targetingOptionId elementu TargetingOption typu TARGETING_TYPE_BROWSER.

negative

boolean

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

HouseholdIncomeAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania dochodu gospodarstwa domowego. Gdy targetingType ma wartość TARGETING_TYPE_HOUSEHOLD_INCOME, zostanie ono wypełnione w polu szczegółów właściwości AssignedTargetOption.

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

enum (HouseholdIncome)

Dochód gospodarstwa domowego odbiorców.

Dane wyjściowe tylko w wersji 1. Wymagane w wersji 2.

targetingOptionId

string

To pole jest wymagane. Wartość targetingOptionId elementu TargetingOption typu TARGETING_TYPE_HOUSEHOLD_INCOME.

OnScreenPositionAssignedTargetingOptionDetails

Szczegóły opcji kierowania na pozycję na ekranie. Gdy targetingType będzie mieć wartość TARGETING_TYPE_ON_SCREEN_POSITION, zostanie ono wypełnione w polu onScreenPositionDetails.

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

string

To pole jest wymagane. Pole targetingOptionId, gdy targetingType ma wartość TARGETING_TYPE_ON_SCREEN_POSITION.

onScreenPosition

enum (OnScreenPosition)

Tylko dane wyjściowe. Pozycja na ekranie.

adType

enum (AdType)

Tylko dane wyjściowe. Typ reklamy, na którą chcesz kierować reklamy. Ta opcja będzie domyślnie dziedziczona tylko w przypadku kierowania zamówień reklamowych i nowych elementów zamówienia obsługujących określony typ reklamy. Możliwe wartości to:

  • AD_TYPE_DISPLAY, ustawienie zostanie odziedziczone przez nowy element zamówienia, gdy wartość w kolumnie lineItemType wynosi LINE_ITEM_TYPE_DISPLAY_DEFAULT.
  • AD_TYPE_VIDEO, ustawienie zostanie odziedziczone przez nowy element zamówienia, gdy wartość w kolumnie lineItemType wynosi LINE_ITEM_TYPE_VIDEO_DEFAULT.

CarrierAndIspAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania na operatora sieci komórkowej i dostawcę internetu. Gdy targetingType ma wartość TARGETING_TYPE_CARRIER_AND_ISP, zostanie ono wypełnione w polu szczegółów właściwości AssignedTargetOption.

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

string

Tylko dane wyjściowe. Wyświetlana nazwa operatora lub dostawcy internetu.

targetingOptionId

string

To pole jest wymagane. Wartość targetingOptionId elementu TargetingOption typu TARGETING_TYPE_CARRIER_AND_ISP.

negative

boolean

Wskazuje, czy ta opcja jest celem kierowania wykluczającego. Wszystkie opcje kierowania na operatora i dostawcę internetu przypisane do tego samego zasobu muszą mieć taką samą wartość w tym polu.

KeywordAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania na słowa kluczowe. Gdy targetingType ma wartość TARGETING_TYPE_KEYWORD, zostanie ono wypełnione w polu szczegółów właściwości AssignedTargetOption.

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

string

To pole jest wymagane. Słowo kluczowe, np. car insurance.

Niewykluczające słowo kluczowe nie może być obraźliwe. Musi być zakodowany w formacie UTF-8 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 celem kierowania wykluczającego.

NegativeKeywordListAssignedTargetingOptionDetails

Szczegóły kierowania listy wykluczających słów kluczowych. Gdy targetingType ma wartość TARGETING_TYPE_NEGATIVE_KEYWORD_LIST, zostanie ono wypełnione w polu szczegółów właściwości AssignedTargetOption.

Zapis JSON
{
  "negativeKeywordListId": string
}
Pola
negativeKeywordListId

string (int64 format)

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

OperatingSystemAssignedTargetingOptionDetails

Szczegóły opcji kierowania przypisanego systemu operacyjnego. Gdy targetingType będzie mieć wartość TARGETING_TYPE_OPERATING_SYSTEM, zostanie ono wypełnione w polu operatingSystemDetails.

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

string

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

targetingOptionId

string

To pole jest wymagane. Identyfikator opcji kierowania wpisany w polu targetingOptionId, gdy targetingType ma wartość TARGETING_TYPE_OPERATING_SYSTEM.

negative

boolean

Wskazuje, czy ta opcja jest celem kierowania wykluczającego.

DeviceMakeModelAssignedTargetingOptionDetails

Szczegóły opcji kierowania na markę i model urządzenia. Gdy targetingType będzie mieć wartość TARGETING_TYPE_DEVICE_MAKE_MODEL, zostanie ono wypełnione w polu deviceMakeModelDetails.

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

To pole jest wymagane. Pole targetingOptionId, gdy targetingType ma wartość TARGETING_TYPE_DEVICE_MAKE_MODEL.

negative

boolean

Wskazuje, czy ta opcja jest celem kierowania wykluczającego.

EnvironmentAssignedTargetingOptionDetails

Szczegóły opcji kierowania przypisanego środowiska. Gdy targetingType ma wartość TARGETING_TYPE_ENVIRONMENT, zostanie ono wypełnione w polu szczegółów właściwości AssignedTargetOption.

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

enum (Environment)

Środowisko wyświetlania.

Dane wyjściowe tylko w wersji 1. Wymagane w wersji 2.

targetingOptionId

string

To pole jest wymagane. Wartość targetingOptionId elementu TargetingOption typu TARGETING_TYPE_ENVIRONMENT (np. „508010” – na potrzeby kierowania na opcję ENVIRONMENT_WEB_OPTIMIZED).

InventorySourceAssignedTargetingOptionDetails

Szczegóły kierowania dla źródła zasobów reklamowych. Gdy targetingType ma wartość TARGETING_TYPE_INVENTORY_SOURCE, zostanie ono wypełnione w polu szczegółów właściwości AssignedTargetOption.

Zapis JSON
{
  "inventorySourceId": string
}
Pola
inventorySourceId

string (int64 format)

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

CategoryAssignedTargetingOptionDetails

Szczegóły opcji kierowania przypisanej kategorii. Gdy targetingType będzie mieć wartość TARGETING_TYPE_CATEGORY, zostanie ono wypełnione w polu categoryDetails.

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

string

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

targetingOptionId

string

To pole jest wymagane. Pole targetingOptionId, gdy targetingType ma wartość TARGETING_TYPE_CATEGORY.

negative

boolean

Wskazuje, czy ta opcja jest celem kierowania wykluczającego.

ViewabilityAssignedTargetingOptionDetails

Szczegóły opcji kierowania przypisanej widoczności. Gdy targetingType ma wartość TARGETING_TYPE_VIEWABILITY, zostanie ono wypełnione w polu viewabilityDetails właściwości AssignedTargetOption.

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

enum (Viewability)

Procent przewidywanej widoczności.

Dane wyjściowe tylko w wersji 1. Wymagane w wersji 2.

targetingOptionId

string

To pole jest wymagane. Wartość targetingOptionId elementu TargetingOption typu TARGETING_TYPE_VIEWABILITY (np. „509010” – na potrzeby kierowania w opcji VIEWABILITY_10_PERCENT_OR_MORE).

AuthorizedSellerStatusAssignedTargetingOptionDetails

Reprezentuje przypisany stan autoryzowanego sprzedawcy. Gdy targetingType ma wartość TARGETING_TYPE_AUTHORIZED_SELLER_STATUS, zostanie ono wypełnione w polu szczegółów właściwości AssignedTargetOption.

Jeśli zasób nie ma przypisanej opcji kierowania TARGETING_TYPE_AUTHORIZED_SELLER_STATUS, używa 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 mają być kierowane reklamy.

targetingOptionId

string

To pole jest wymagane. Wartość targetingOptionId elementu TargetingOption typu TARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

LanguageAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania na język. Gdy targetingType ma wartość TARGETING_TYPE_LANGUAGE, zostanie ono wypełnione w polu szczegółów właściwości AssignedTargetOption.

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

string

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

targetingOptionId

string

To pole jest wymagane. Wartość targetingOptionId elementu TargetingOption typu TARGETING_TYPE_LANGUAGE.

negative

boolean

Wskazuje, czy ta opcja jest celem kierowania wykluczającego. Wszystkie opcje kierowania na język przypisane w tym samym zasobie muszą mieć taką samą wartość w tym polu.

GeoRegionAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania na region geograficzny. Gdy targetingType ma wartość TARGETING_TYPE_GEO_REGION, zostanie ono wypełnione w polu szczegółów właściwości AssignedTargetOption.

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

string

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

targetingOptionId

string

To pole jest wymagane. Wartość 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 celem kierowania wykluczającego.

InventorySourceGroupAssignedTargetingOptionDetails

Szczegóły kierowania grupy źródeł zasobów reklamowych. Gdy targetingType ma wartość TARGETING_TYPE_INVENTORY_SOURCE_GROUP, zostanie ono wypełnione w polu szczegółów właściwości AssignedTargetOption.

Zapis JSON
{
  "inventorySourceGroupId": string
}
Pola
inventorySourceGroupId

string (int64 format)

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

DigitalContentLabelAssignedTargetingOptionDetails

Szczegóły kierowania etykiet treści cyfrowych. Gdy targetingType ma wartość TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION, zostanie ono wypełnione w polu szczegółów właściwości AssignedTargetOption.

Zapis JSON
{
  "excludedTargetingOptionId": string,
  "contentRatingTier": enum (ContentRatingTier)
}
Pola
excludedTargetingOptionId

string

To pole jest wymagane. Identyfikator etykiety treści cyfrowych do WYKLUCZENIA.

contentRatingTier

enum (ContentRatingTier)

Tylko dane wyjściowe. Wyświetlana nazwa poziomu oceny treści cyfrowych.

SensitiveCategoryAssignedTargetingOptionDetails

Szczegóły kierowania reklam o charakterze kontrowersyjnym. Gdy targetingType ma wartość TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION, zostanie ono wypełnione w polu szczegółów właściwości AssignedTargetOption.

Zapis JSON
{
  "excludedTargetingOptionId": string,
  "sensitiveCategory": enum (SensitiveCategory)
}
Pola
excludedTargetingOptionId

string

To pole jest wymagane. Identyfikator kategorii reklam o charakterze kontrowersyjnym, która ma zostać WYKLUCZONA.

sensitiveCategory

enum (SensitiveCategory)

Tylko dane wyjściowe. Wyliczenie należące do klasyfikatora treści o charakterze kontrowersyjnym w DV360.

ExchangeAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania na giełdy. Gdy targetingType ma wartość TARGETING_TYPE_EXCHANGE, zostanie ono wypełnione w polu szczegółów właściwości AssignedTargetOption.

Zapis JSON
{
  "targetingOptionId": string
}
Pola
targetingOptionId

string

To pole jest wymagane. Wartość targetingOptionId elementu TargetingOption typu TARGETING_TYPE_EXCHANGE.

SubExchangeAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania na giełdy podrzędne. Gdy targetingType ma wartość TARGETING_TYPE_SUB_EXCHANGE, zostanie ono wypełnione w polu szczegółów właściwości AssignedTargetOption.

Zapis JSON
{
  "targetingOptionId": string
}
Pola
targetingOptionId

string

To pole jest wymagane. Wartość targetingOptionId elementu TargetingOption typu TARGETING_TYPE_SUB_EXCHANGE.

ThirdPartyVerifierAssignedTargetingOptionDetails

Szczegóły opcji kierowania przypisanego weryfikatora zewnętrznego. Gdy targetingType ma wartość TARGETING_TYPE_THIRD_PARTY_VERIFIER, zostanie ono wypełnione w polu szczegółów właściwości AssignedTargetOption.

Zapis JSON
{

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

object (Adloox)

Zewnętrzny weryfikator marki – Adloox.

doubleVerify

object (DoubleVerify)

Zewnętrzny weryfikator marki – DoubleVerify.

integralAdScience

object (IntegralAdScience)

Weryfikator marki zewnętrzny – Integral Ad Science.

Adloox

Szczegóły ustawień Adloox.

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

enum (AdlooxCategory)

Ustawienia bezpieczeństwa marki Adloox.

AdlooxCategory

Możliwe opcje Adloox.

Wartości w polu enum
ADLOOX_UNSPECIFIED Ta wyliczenie jest tylko wartością zastępczą i nie określa żadnych opcji Adloox.
ADULT_CONTENT_HARD Treści dla dorosłych (twarde).
ADULT_CONTENT_SOFT Treści dla dorosłych (miękkie).
ILLEGAL_CONTENT Treści niezgodne z prawem.
BORDERLINE_CONTENT Treści bliskie łamania wytycznych
DISCRIMINATORY_CONTENT Treści dyskryminujące.
VIOLENT_CONTENT_WEAPONS Treści związane z przemocą i bronią.
LOW_VIEWABILITY_DOMAINS Domeny o niskiej widoczności.
FRAUD Oszustwo.

DoubleVerify

Szczegółowe informacje o ustawieniach 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 w DVD.

avoidedAgeRatings[]

enum (AgeRating)

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

appStarRating

object (AppStarRating)

Unikaj licytacji dotyczących aplikacji z oceną w postaci gwiazdek.

displayViewability

object (DisplayViewability)

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

videoViewability

object (VideoViewability)

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

fraudInvalidTraffic

object (FraudInvalidTraffic)

Unikaj witryn i aplikacji o historycznym wskaźniku oszustw 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. Niestandardowy identyfikator segmentu nie może być określony w żadnym z tych pól:

BrandSafetyCategories

Ustawienia kontroli bezpieczeństwa marki.

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

boolean

Brak informacji lub brak oceny.

avoidedHighSeverityCategories[]

enum (HighSeverityCategory)

Kategorie, do których unikamy reklam o dużej wadze w związku z bezpieczeństwem marki.

avoidedMediumSeverityCategories[]

enum (MediumSeverityCategory)

Kategorie unikania o średnim poziomie ważności w przypadku bezpieczeństwa marki.

HighSeverityCategory

Możliwe opcje dotyczące kategorii o dużej wadze.

Wartości w polu enum
HIGHER_SEVERITY_UNSPECIFIED Ta wyliczenie jest tylko wartością zastępczą i nie określa żadnych kategorii o dużej wadze.
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/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: umiejętności przestępcze.
NUISANCE_INCENTIVIZED_MALWARE_CLUTTER Stosowanie zachęt/złośliwe oprogramowanie/natłok.

MediumSeverityCategory

Możliwe opcje w przypadku kategorii o średniej wadze.

Wartości w polu enum
MEDIUM_SEVERITY_UNSPECIFIED Ta wyliczenie jest tylko wartością zastępczą i nie określa żadnych kategorii o średniej wadze.
AD_SERVERS Serwery reklam.
ADULT_CONTENT_SWIMSUIT Treści dla dorosłych: stroje kąpielowe.
ALTERNATIVE_LIFESTYLES Kontrowersyjne tematy: alternatywne style życia.
CELEBRITY_GOSSIP Kontrowersyjne tematy: plotki o celebrytach.
GAMBLING Kontrowersyjne tematy: hazard.
OCCULT Kontrowersyjne tematy: okultyzm.
SEX_EDUCATION Kontrowersyjne tematy: edukacja seksualna.
DISASTER_AVIATION Katastrofa: lotnictwo.
DISASTER_MAN_MADE Katastrofa: stworzona przez człowieka.
DISASTER_NATURAL Katastrofa: naturalne.
DISASTER_TERRORIST_EVENTS Katastrofa: zdarzenia 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 użytkowników: fora, zdjęcia i filmy.
INFLAMMATORY_POLITICS_AND_NEWS Kontrowersyjne tematy: wiadomości i treści polityczne mające na celu podburzanie.
NEGATIVE_NEWS_PHARMACEUTICAL Negatywne wiadomości: farmaceutyczne.

AgeRating

Możliwe opcje klasyfikacji wiekowej.

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

AppStarRating

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

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

enum (StarRating)

Unikaj licytacji dotyczących aplikacji z oceną w postaci gwiazdek.

avoidInsufficientStarRating

boolean

Unikaj ustalania stawek w przypadku aplikacji, które mają niewystarczającą liczbę gwiazdek.

StarRating

Możliwe opcje oceny w gwiazdkach.

Wartości w polu enum
APP_STAR_RATE_UNSPECIFIED Ta wyliczenie jest tylko wartością zastępczą i nie określa żadnych opcji oceny aplikacji w gwiazdkach.
APP_STAR_RATE_1_POINT_5_LESS Oficjalne aplikacje z oceną 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ółowe informacje o ustawieniach widoczności reklam displayowych DoubleVerify.

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

enum (IAB)

Kieruj na zasoby reklamowe na stronach internetowych i w aplikacjach, by zmaksymalizować współczynnik widoczności według IAB.

viewableDuring

enum (ViewableDuring)

Ustaw kierowanie na zasoby reklamowe w witrynach i aplikacjach, by zmaksymalizować czas trwania wyświetlenia widocznego w 100%.

IAB

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

Wartości w polu enum
IAB_VIEWED_RATE_UNSPECIFIED Ta wyliczenie jest tylko wartością zastępczą i nie określa żadnych opcji IAB związanych ze współczynnikiem obejrzeń.
IAB_VIEWED_RATE_80_PERCENT_HIGHER Kieruj na zasoby reklamowe na stronach internetowych i w aplikacjach, by zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 80%.
IAB_VIEWED_RATE_75_PERCENT_HIGHER Kieruj na zasoby reklamowe na stronach internetowych i w aplikacjach, by zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 75%.
IAB_VIEWED_RATE_70_PERCENT_HIGHER Kieruj na zasoby reklamowe na stronach internetowych i w aplikacjach, by zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 70%.
IAB_VIEWED_RATE_65_PERCENT_HIGHER Kieruj na zasoby reklamowe na stronach internetowych i w aplikacjach, by zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 65%.
IAB_VIEWED_RATE_60_PERCENT_HIGHER Kieruj na zasoby reklamowe na stronach internetowych i w aplikacjach, by zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 60%.
IAB_VIEWED_RATE_55_PERCENT_HIGHER Kieruj na zasoby reklamowe na stronach internetowych i w aplikacjach, by zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 55%.
IAB_VIEWED_RATE_50_PERCENT_HIGHER Kieruj na zasoby reklamowe na stronach internetowych i w aplikacjach, by zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 50%.
IAB_VIEWED_RATE_40_PERCENT_HIGHER Kieruj na zasoby reklamowe na stronach internetowych i w aplikacjach, by zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 40%.
IAB_VIEWED_RATE_30_PERCENT_HIGHER Kieruj na zasoby reklamowe na stronach internetowych i w aplikacjach, by zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 30%.

ViewableDuring

Możliwe opcje czasu wyświetlania.

Wartości w polu enum
AVERAGE_VIEW_DURATION_UNSPECIFIED Ta wyliczenie jest tylko wartością zastępczą i nie określa żadnych opcji średniego czasu oglądania.
AVERAGE_VIEW_DURATION_5_SEC Kieruj na zasoby reklamowe w witrynach i aplikacjach, by 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, by zmaksymalizować czas trwania wyświetlenia widocznego w 100% przez co najmniej 10 sekund.
AVERAGE_VIEW_DURATION_15_SEC Kieruj na zasoby reklamowe w witrynach i aplikacjach, by zmaksymalizować czas trwania wyświetlenia widocznego w 100% przez co najmniej 15 sekund.

VideoViewability

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

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

enum (VideoIAB)

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

videoViewableRate

enum (VideoViewableRate)

Kieruj na zasoby reklamowe w internecie, aby zmaksymalizować współczynnik w pełni widocznych reklam.

playerImpressionRate

enum (PlayerImpressionRate)

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

VideoIAB

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

Wartości w polu enum
VIDEO_IAB_UNSPECIFIED Ta wyliczenie jest tylko wartością zastępczą i nie określa żadnych opcji współczynnika widoczności według IAB.
IAB_VIEWABILITY_80_PERCENT_HIGHER Kieruj na zasoby reklamowe na stronach internetowych i w aplikacjach, by zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 80%.
IAB_VIEWABILITY_75_PERCENT_HIGHER Kieruj na zasoby reklamowe na stronach internetowych i w aplikacjach, by zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 75%.
IAB_VIEWABILITY_70_PERCENT_HIGHER Kieruj na zasoby reklamowe na stronach internetowych i w aplikacjach, by zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 70%.
IAB_VIEWABILITY_65_PERCENT_HIHGER Kieruj na zasoby reklamowe na stronach internetowych i w aplikacjach, by zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 65%.
IAB_VIEWABILITY_60_PERCENT_HIGHER Kieruj na zasoby reklamowe na stronach internetowych i w aplikacjach, by zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 60%.
IAB_VIEWABILITY_55_PERCENT_HIHGER Kieruj na zasoby reklamowe na stronach internetowych i w aplikacjach, by zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 55%.
IAB_VIEWABILITY_50_PERCENT_HIGHER Kieruj na zasoby reklamowe na stronach internetowych i w aplikacjach, by zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 50%.
IAB_VIEWABILITY_40_PERCENT_HIHGER Kieruj na zasoby reklamowe na stronach internetowych i w aplikacjach, by zmaksymalizować współczynnik widoczności IAB na poziomie co najmniej 40%.
IAB_VIEWABILITY_30_PERCENT_HIHGER Kieruj na zasoby reklamowe na stronach internetowych i w aplikacjach, by 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 Ta wyliczenie jest tylko wartością zastępczą i nie określa żadnych opcji współczynnika widoczności filmu.
VIEWED_PERFORMANCE_40_PERCENT_HIGHER Kieruj na zasoby reklamowe w internecie, aby zmaksymalizować współczynnik w pełni widocznych reklam na poziomie co najmniej 40%.
VIEWED_PERFORMANCE_35_PERCENT_HIGHER Kieruj na zasoby reklamowe w internecie, aby zmaksymalizować współczynnik w pełni widocznych reklam na poziomie co najmniej 35%.
VIEWED_PERFORMANCE_30_PERCENT_HIGHER Kieruj na zasoby reklamowe w internecie, aby zmaksymalizować współczynnik w pełni widocznych reklam na poziomie co najmniej 30%.
VIEWED_PERFORMANCE_25_PERCENT_HIGHER Kieruj na zasoby reklamowe w internecie, aby zmaksymalizować współczynnik w pełni widocznych reklam na poziomie co najmniej 25%.
VIEWED_PERFORMANCE_20_PERCENT_HIGHER Kieruj na zasoby reklamowe w internecie, aby zmaksymalizować współczynnik w pełni widocznych reklam na poziomie co najmniej 20%.
VIEWED_PERFORMANCE_10_PERCENT_HIGHER Kieruj na zasoby reklamowe w internecie, aby zmaksymalizować współczynnik w pełni widocznych reklam na poziomie co najmniej 10%.

PlayerImpressionRate

Możliwe opcje wyświetleń.

Wartości w polu enum
PLAYER_SIZE_400X300_UNSPECIFIED Ta wyliczenie jest tylko wartością zastępczą i nie określa żadnych opcji wyświetleń.
PLAYER_SIZE_400X300_95 Strony generujące co najmniej 95%wyświetleń.
PLAYER_SIZE_400X300_70 Strony generujące co najmniej 70%wyświetleń.
PLAYER_SIZE_400X300_25 Strony generujące co najmniej 25%wyświetleń.
PLAYER_SIZE_400X300_5 Witryny generujące co najmniej 5%wyświetleń.

FraudInvalidTraffic

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

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

enum (FraudOption)

Unikaj witryn i aplikacji z historycznymi oszustwami i nieprawidłowym ruchem.

avoidInsufficientOption

boolean

Niewystarczające statystyki dotyczące oszustw i nieprawidłowego ruchu w przeszłości.

FraudOption

Możliwe opcje dotyczące historycznego współczynnika oszustw i nieprawidłowego ruchu z reklam.

Wartości w polu enum
FRAUD_UNSPECIFIED Ta wyliczenie jest tylko wartością zastępczą i nie określa żadnych opcji dotyczących oszustw 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ółowe informacje o ustawieniach Integral Ad Science.

Zapis JSON
{
  "traqScoreOption": enum (TRAQScore),
  "excludeUnrateable": boolean,
  "excludedAdultRisk": enum (Adult),
  "excludedAlcoholRisk": enum (Alcohol),
  "excludedIllegalDownloadsRisk": enum (IllegalDownloads),
  "excludedDrugsRisk": enum (Drugs),
  "excludedHateSpeechRisk": enum (HateSpeech),
  "excludedOffensiveLanguageRisk": enum (OffensiveLanguage),
  "excludedViolenceRisk": enum (Violence),
  "excludedGamblingRisk": enum (Gambling),
  "excludedAdFraudRisk": enum (AdFraudPrevention),
  "displayViewability": enum (DisplayViewability),
  "videoViewability": enum (VideoViewability),
  "customSegmentId": [
    string
  ]
}
Pola
traqScoreOption

enum (TRAQScore)

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

excludeUnrateable

boolean

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

excludedAdultRisk

enum (Adult)

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

excludedAlcoholRisk

enum (Alcohol)

Bezpieczeństwo marki – alkohol.

excludedIllegalDownloadsRisk

enum (IllegalDownloads)

Bezpieczeństwo marki – nielegalne pobieranie plików.

excludedDrugsRisk

enum (Drugs)

Bezpieczeństwo marki – narkotyki.

excludedHateSpeechRisk

enum (HateSpeech)

Bezpieczeństwo marki – szerzenie nienawiści.

excludedOffensiveLanguageRisk

enum (OffensiveLanguage)

Bezpieczeństwo marki – obraźliwy język.

excludedViolenceRisk

enum (Violence)

Bezpieczeństwo marki – przemoc.

excludedGamblingRisk

enum (Gambling)

Bezpieczeństwo marki – hazard.

excludedAdFraudRisk

enum (AdFraudPrevention)

Ustawienia dotyczące oszustw reklamowych.

displayViewability

enum (DisplayViewability)

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

videoViewability

enum (VideoViewability)

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

customSegmentId[]

string (int64 format)

Niestandardowy identyfikator segmentu dostarczony przez Integral Ad Science. Identyfikator musi mieścić się w zakresie od 1000001 do 1999999 włącznie.

TRAQScore

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

Wartości w polu enum
TRAQ_UNSPECIFIED Ta wyliczenie jest tylko wartością zastępczą i nie określa żadnych prawdziwych wyników jakości reklam.
TRAQ_250 Wskaźnik TRAQ: 250-1000.
TRAQ_500 Wskaźnik TRAQ: 500-1000.
TRAQ_600 Wskaźnik TRAQ: 600-1000.
TRAQ_700 Wskaźnik TRAQ: 700-1000.
TRAQ_750 Wskaźnik TRAQ: 750-1000.
TRAQ_875 Wskaźnik TRAQ: 875-1000.
TRAQ_1000 Wynik TRAQ: 1000.

Dorosły

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

Wartości w polu enum
ADULT_UNSPECIFIED Ta wyliczenie jest tylko wartością zastępczą i nie określa żadnych opcji dla dorosłych.
ADULT_HR Dla dorosłych – wyklucz wysokie ryzyko.
ADULT_HMR Dla dorosłych – wyklucz wysokie i umiarkowane ryzyko.

alkohol.

Możliwe opcje reklamowania alkoholu w Integral Ad Science.

Wartości w polu enum
ALCOHOL_UNSPECIFIED Ta wyliczenie jest tylko wartością zastępczą 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 nielegalnego pobierania z usługi Integral Ad Science.

Wartości w polu enum
ILLEGAL_DOWNLOADS_UNSPECIFIED Ta wyliczenie jest tylko wartością zastępczą i nie określa żadnych niedozwolonych opcji pobierania.
ILLEGAL_DOWNLOADS_HR Niedozwolone pobieranie plików – wyklucz wysokie ryzyko.
ILLEGAL_DOWNLOADS_HMR Niedozwolone pobieranie plików – wyklucz wysokie i średnie ryzyko.

Leki

Możliwe opcje leków Integral Ad Science.

Wartości w polu enum
DRUGS_UNSPECIFIED Ta wyliczenie jest tylko wartością zastępczą i nie określa żadnych opcji leków.
DRUGS_HR Leki – wyklucz wysokie ryzyko.
DRUGS_HMR Leki – wyklucz wysokie i umiarkowane ryzyko.

HateSpeech

Możliwe opcje szerzenia nienawiści w usłudze Integral Ad Science.

Wartości w polu enum
HATE_SPEECH_UNSPECIFIED Ta wyliczenie jest tylko wartością zastępczą i nie określa żadnych opcji dotyczących szerzenia nienawiści.
HATE_SPEECH_HR Szerzenie nienawiści – wyklucz wysokie ryzyko.
HATE_SPEECH_HMR Szerzenie nienawiści – wyklucz wysokie i średnie ryzyko.

OffensiveLanguage

Możliwe opcje języka Integral Ad Science Offensive.

Wartości w polu enum
OFFENSIVE_LANGUAGE_UNSPECIFIED Ta wyliczenie jest tylko zmienną 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 średnie ryzyko.

Przemoc

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

Wartości w polu enum
VIOLENCE_UNSPECIFIED Ta wyliczenie jest tylko obiektem zastępczym i nie określa żadnych opcji przemocy.
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 Ta wyliczenie jest tylko wartością zastępczą i nie określa żadnych opcji hazardu.
GAMBLING_HR Hazard – wyklucz wysokie ryzyko.
GAMBLING_HMR Hazard – wyklucz wysokie i umiarkowane ryzyko.

AdFraudPrevention

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

Wartości w polu enum
SUSPICIOUS_ACTIVITY_UNSPECIFIED Ta wyliczenie jest tylko wartością zastępczą i nie określa żadnych opcji zapobiegania oszustwom reklamowym.
SUSPICIOUS_ACTIVITY_HR Oszustwo reklamowe – wyklucz wysokie ryzyko.
SUSPICIOUS_ACTIVITY_HMR Oszustwo reklamowe – wyklucz wysokie i umiarkowane ryzyko.

DisplayViewability

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

Wartości w polu enum
PERFORMANCE_VIEWABILITY_UNSPECIFIED Ta wyliczenie jest tylko wartością zastępczą i nie określa żadnych opcji widoczności reklam displayowych.
PERFORMANCE_VIEWABILITY_40 Docelowa widoczność na poziomie co najmniej 40%
PERFORMANCE_VIEWABILITY_50 Docelowa widoczność na poziomie co najmniej 50%
PERFORMANCE_VIEWABILITY_60 Docelowa widoczność na poziomie co najmniej 60%
PERFORMANCE_VIEWABILITY_70 Docelowa widoczność na poziomie co najmniej 70%

VideoViewability

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

Wartości w polu enum
VIDEO_VIEWABILITY_UNSPECIFIED Ta wyliczenie jest tylko wartością zastępczą i nie określa żadnych opcji widoczności reklam wideo.
VIDEO_VIEWABILITY_40 Ponad 40%widoczne (standard IAB widoczności reklam wideo).
VIDEO_VIEWABILITY_50 Ponad 50%widoczne (standard IAB widoczności reklam wideo).
VIDEO_VIEWABILITY_60 Ponad 60%widoczne (standard IAB widoczności reklam wideo).
VIDEO_VIEWABILITY_70 Ponad 70%widoczne (standard IAB widoczności reklam wideo).

PoiAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania na ciekawe miejsca. Gdy targetingType ma wartość TARGETING_TYPE_POI, zostanie ono wypełnione w polu szczegółów właściwości AssignedTargetOption.

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 ważnego miejsca, np. „Times Square”, „Space Needle”, a następnie jego pełny adres, jeśli jest dostępny.

targetingOptionId

string

To pole jest wymagane. Wartość targetingOptionId elementu TargetingOption typu TARGETING_TYPE_POI.

Akceptowane identyfikatory opcji kierowania na ważne miejsca można pobrać przy użyciu: SearchTargetingOptions.

Jeśli z adresu lub nazwy ciekawego miejsca chcesz usunąć określoną współrzędną szerokości i długości geograficznej, możesz wygenerować identyfikator opcji kierowania, zaokrąglając odpowiednie wartości współrzędnych do 6 miejsca po przecinku, usuwając ułamki i łącząc wartości w ciągu znaków rozdzielone średnikami. Możesz np. kierować reklamy na parę szerokości i długości geograficznej 40,7414691, -74,003387, korzystając z identyfikatora opcji kierowania „40741469;-74003387”.

latitude

number

Tylko dane wyjściowe. Szerokość ciekawego miejsca w zaokrągleniu do 6 miejsca po przecinku.

longitude

number

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

proximityRadiusAmount

number

To pole jest wymagane. Promień obszaru wokół ważnego miejsca, na który będą kierowane reklamy. Jednostki promienia są określane przez proximityRadiusUnit. Należy podać wartość z zakresu od 1 do 800, jeśli jednostka to DISTANCE_UNIT_KILOMETERS, lub od 1 do 500, jeśli jednostka ma wartość DISTANCE_UNIT_MILES.

proximityRadiusUnit

enum (DistanceUnit)

To pole jest 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 Mile.
DISTANCE_UNIT_KILOMETERS Kilometry.

BusinessChainAssignedTargetingOptionDetails

Szczegóły przypisanej opcji kierowania na sieć placówek. Gdy targetingType ma wartość TARGETING_TYPE_BUSINESS_CHAIN, zostanie ono wypełnione w polu szczegółów właściwości AssignedTargetOption.

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

To pole jest wymagane. Wartość targetingOptionId elementu TargetingOption typu TARGETING_TYPE_BUSINESS_CHAIN.

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

proximityRadiusAmount

number

To pole jest wymagane. Promień obszaru wokół sieci placówek firmy, na który będzie kierowana kampania. Jednostki promienia są określane przez proximityRadiusUnit. Należy podać wartość z zakresu od 1 do 800, jeśli jednostka to DISTANCE_UNIT_KILOMETERS, lub od 1 do 500, jeśli jednostka ma wartość DISTANCE_UNIT_MILES. Minimalny przyrost w obu przypadkach to 0,1. Dane wejściowe zostaną zaokrąglone do najbliższej dopuszczalnej wartości, jeśli będą zbyt szczegółowe, np. 15,57 zmieni się na 15,6.

proximityRadiusUnit

enum (DistanceUnit)

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

ContentDurationAssignedTargetingOptionDetails

Szczegóły opcji kierowania przypisanej do czasu trwania treści. Gdy targetingType będzie mieć wartość TARGETING_TYPE_CONTENT_DURATION, zostanie ono wypełnione w polu contentDurationDetails. Jednoznaczne kierowanie na wszystkie opcje nie jest obsługiwane. Aby osiągnąć ten efekt, usuń wszystkie opcje kierowania na czas trwania treści.

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

string

To pole jest 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 będzie mieć wartość TARGETING_TYPE_CONTENT_STREAM_TYPE, zostanie ono wypełnione w polu contentStreamTypeDetails. Jednoznaczne kierowanie na wszystkie opcje nie jest obsługiwane. Aby osiągnąć ten efekt, usuń wszystkie opcje kierowania na typ strumienia treści.

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

string

To pole jest wymagane. Pole targetingOptionId, gdy targetingType ma wartość TARGETING_TYPE_CONTENT_STREAM_TYPE.

contentStreamType

enum (ContentStreamType)

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

NativeContentPositionAssignedTargetingOptionDetails

Szczegóły opcji kierowania przypisanej do pozycji treści natywnej. Gdy targetingType będzie mieć wartość TARGETING_TYPE_NATIVE_CONTENT_POSITION, zostanie ono wypełnione w polu nativeContentPositionDetails. Jednoznaczne kierowanie na wszystkie opcje nie jest obsługiwane. Aby osiągnąć ten efekt, usuń wszystkie natywne opcje kierowania na pozycję treści.

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

string

To pole jest wymagane. Pole targetingOptionId, gdy targetingType ma wartość TARGETING_TYPE_NATIVE_CONTENT_POSITION.

contentPosition

enum (NativeContentPosition)

Pozycja treści.

Dane wyjściowe tylko w wersji 1. Wymagane w wersji 2.

OmidAssignedTargetingOptionDetails

Reprezentuje typ zasobów reklamowych z obsługą Open Measurement, na który można kierować reklamy. Gdy targetingType ma wartość TARGETING_TYPE_OMID, zostanie ono wypełnione w polu szczegółów właściwości AssignedTargetOption.

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

enum (Omid)

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

Dane wyjściowe tylko w wersji 1. Wymagane w wersji 2.

targetingOptionId

string

To pole jest wymagane. Wartość targetingOptionId elementu TargetingOption typu TARGETING_TYPE_OMID.

AudioContentTypeAssignedTargetingOptionDetails

Szczegóły opcji kierowania przypisanej do typu treści audio. Gdy targetingType będzie mieć wartość TARGETING_TYPE_AUDIO_CONTENT_TYPE, zostanie ono wypełnione w polu audioContentTypeDetails. Jednoznaczne kierowanie na wszystkie opcje nie jest obsługiwane. Aby osiągnąć ten efekt, usuń wszystkie opcje kierowania na typ treści audio.

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

string

To pole jest wymagane. Pole targetingOptionId, gdy targetingType ma wartość TARGETING_TYPE_AUDIO_CONTENT_TYPE.

audioContentType

enum (AudioContentType)

Typ treści audio.

Dane wyjściowe tylko w wersji 1. Wymagane w wersji 2.

ContentGenreAssignedTargetingOptionDetails

Szczegóły opcji kierowania przypisanej do gatunku treści. Gdy targetingType będzie mieć wartość TARGETING_TYPE_CONTENT_GENRE, zostanie ono wypełnione w polu contentGenreDetails. Jednoznaczne kierowanie na wszystkie opcje nie jest obsługiwane. Aby osiągnąć ten efekt, usuń wszystkie opcje kierowania na gatunek treści.

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

string

To pole jest 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 celem kierowania wykluczającego.

Metody

get

Pobiera jedną opcję kierowania przypisaną do kampanii.

list

Zawiera listę opcji kierowania przypisanych do kampanii dla określonego typu kierowania.