REST Resource: advertisers.campaigns.targetingTypes.assignedTargetingOptions

{
  "channelId": string,
  "negative": boolean
}

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.

boolean

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

{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}

string

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

string

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

boolean

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

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

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.

string

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

boolean

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

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ą.

{
  "url": string,
  "negative": boolean
}

string

Wymagane. Adres URL, np. example.com.

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

boolean

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

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

enum (DayOfWeek)

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

integer

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

integer

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

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ę.

{
  "ageRange": enum (AgeRange)
}

enum (AgeRange)

Wymagane. Przedział wiekowy odbiorców. Obsługujemy tylko kierowanie na ciągły przedział wiekowy odbiorców. 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.

{
  "regionalLocationListId": string,
  "negative": boolean
}

string (int64 format)

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

boolean

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

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

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.

number

Wymagane. Promień wyrażony w jednostkach odległości określonych w parametry proximityRadiusUnit. Określa wielkość obszaru wokół wybranej lokalizacji, na który będą kierowane reklamy. Promień powinien wynosić od 1 do 500 mil lub 800 kilometrów.

enum (ProximityRadiusUnit)

Wymagane. Jednostki odległości promienia.

{
  "gender": enum (Gender)
}

enum (Gender)

Wymagane. Płeć odbiorców.

{
  "videoPlayerSize": enum (VideoPlayerSize)
}

enum (VideoPlayerSize)

Wymagane. Rozmiar odtwarzacza wideo.

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

string

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

enum (UserRewardedContent)

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

{
  "parentalStatus": enum (ParentalStatus)
}

enum (ParentalStatus)

Wymagane. Status rodzicielski odbiorców.

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

enum (ContentInstreamPosition)

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

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.

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

enum (ContentOutstreamPosition)

Wymagane. Pozycja treści out-stream.

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 dziedziczone przez nowy element zamówienia, gdy ustawienie lineItemType ma wartość LINE_ITEM_TYPE_VIDEO_DEFAULT.

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

enum (DeviceType)

Wymagane. Wyświetlana nazwa typu urządzenia.

number

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

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

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

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

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.

object (GoogleAudienceGroup)

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

object (CustomListGroup)

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

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.

object (FirstAndThirdPartyAudienceGroup)

Identyfikatory i rekomendacje własnych i innych firm w wykluczonej grupie odbiorców z własnych i innych firm. Służy do kierowania wykluczającego. Do kierowania na odbiorców pozytywnych służy komplement zbioru tej grupy i innych wykluczonych grup odbiorców. Wszystkie elementy są logicznie połączone operatorem „LUB”.

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”.

{
  "settings": [
    {
      object (FirstAndThirdPartyAudienceTargetingSetting)
    }
  ]
}

object (FirstAndThirdPartyAudienceTargetingSetting)

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

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

string (int64 format)

Wymagane. Identyfikator listy odbiorców własnej i dostarczonej przez firmę zewnętrzną w przypadku ustawień kierowania na własną listę odbiorców i listę odbiorców dostarczoną przez firmę zewnętrzną. Identyfikator to firstAndThirdPartyAudienceId.

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 ignorowana. Więcej informacji znajdziesz na stronie https://support.google.com/displayvideo/answer/2949947#recency. Jeśli nie określisz limitu, nie zostanie on zastosowany.

{
  "settings": [
    {
      object (GoogleAudienceTargetingSetting)
    }
  ]
}

object (GoogleAudienceTargetingSetting)

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

{
  "googleAudienceId": string
}

string (int64 format)

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

{
  "settings": [
    {
      object (CustomListTargetingSetting)
    }
  ]
}

object (CustomListTargetingSetting)

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

{
  "customListId": string
}

string (int64 format)

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

{
  "settings": [
    {
      object (CombinedAudienceTargetingSetting)
    }
  ]
}

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.

{
  "combinedAudienceId": string
}

string (int64 format)

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

{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}

string

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

string

Wymagane. targetingOptionId elementu TargetingOption typu TARGETING_TYPE_BROWSER.

boolean

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

{
  "householdIncome": enum (HouseholdIncome)
}

enum (HouseholdIncome)

Wymagane. Dochód gospodarstwa domowego odbiorców.

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

string

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

enum (OnScreenPosition)

Tylko dane wyjściowe. Pozycja na ekranie.

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 dziedziczone przez nowy element zamówienia, gdy ustawienie lineItemType ma wartość LINE_ITEM_TYPE_VIDEO_DEFAULT.

{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}

string

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

string

Wymagane. targetingOptionId elementu TargetingOption typu TARGETING_TYPE_CARRIER_AND_ISP.

boolean

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

{
  "keyword": string,
  "negative": boolean
}

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 formacie UTF-8 i mieć maksymalny rozmiar 255 bajtów. Maksymalna liczba znaków to 80. Maksymalna liczba słów to 10.

boolean

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

{
  "negativeKeywordListId": string
}

string (int64 format)

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

{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}

string

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

string

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

boolean

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

{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}

string

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

string

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

boolean

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

{
  "environment": enum (Environment)
}

enum (Environment)

Wymagane. Środowisko wyświetlania.

{
  "inventorySourceId": string
}

string (int64 format)

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

{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}

string

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

string

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

boolean

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

{
  "viewability": enum (Viewability)
}

enum (Viewability)

Wymagane. Prognozowany odsetek widoczności.

{
  "authorizedSellerStatus": enum (AuthorizedSellerStatus),
  "targetingOptionId": string
}

enum (AuthorizedSellerStatus)

Tylko dane wyjściowe. Stan autoryzowanego sprzedawcy docelowego.

string

Wymagane. targetingOptionId elementu TargetingOption typu TARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}

string

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

string

Wymagane. targetingOptionId elementu TargetingOption typu TARGETING_TYPE_LANGUAGE.

boolean

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

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

string

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

string

Wymagane. targetingOptionId w TargetingOption typu TARGETING_TYPE_GEO_REGION.

enum (GeoRegionType)

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

boolean

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

{
  "inventorySourceGroupId": string
}

string (int64 format)

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

{
  "excludedContentRatingTier": enum (ContentRatingTier)
}

enum (ContentRatingTier)

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

{
  "excludedSensitiveCategory": enum (SensitiveCategory)
}

enum (SensitiveCategory)

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

{
  "exchange": enum (Exchange)
}

enum (Exchange)

Wymagane. Wartość typu enum wymiany.

{
  "targetingOptionId": string
}

string

Wymagane. targetingOptionId elementu TargetingOption typu TARGETING_TYPE_SUB_EXCHANGE.

{

  // 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.
}

object (Adloox)

Weryfikator zewnętrzny marki – Adloox.

object (DoubleVerify)

Zewnętrzny weryfikator marki – DoubleVerify.

object (IntegralAdScience)

Zewnętrzny weryfikator marki – Integral Ad Science.

{
  "excludedAdlooxCategories": [
    enum (AdlooxCategory)
  ]
}

enum (AdlooxCategory)

Ustawienia bezpieczeństwa marki udostępniane przez firmę Adloox.

{
  "brandSafetyCategories": {
    object (BrandSafetyCategories)
  },
  "avoidedAgeRatings": [
    enum (AgeRating)
  ],
  "appStarRating": {
    object (AppStarRating)
  },
  "displayViewability": {
    object (DisplayViewability)
  },
  "videoViewability": {
    object (VideoViewability)
  },
  "fraudInvalidTraffic": {
    object (FraudInvalidTraffic)
  },
  "customSegmentId": string
}

object (BrandSafetyCategories)

Ustawienia bezpieczeństwa marki w DV.

enum (AgeRating)

Unikaj ustalania stawek za aplikacje z ograniczeniem wiekowym.

object (AppStarRating)

Unikaj ustalania stawek za aplikacje z gwiazdkami.

object (DisplayViewability)

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

object (VideoViewability)

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

object (FraudInvalidTraffic)

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

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
• avoidedAgeRatings
• appStarRating
• fraudInvalidTraffic

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

boolean

Nieznany lub niekwalifikujący się do oceny.

enum (HighSeverityCategory)

Kategorie o wysokiej rangi w zakresie unikania zagrożeń dla bezpieczeństwa marki.

enum (MediumSeverityCategory)

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

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

enum (StarRating)

Unikaj ustalania stawek za aplikacje z gwiazdkami.

boolean

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

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

enum (IAB)

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

enum (ViewableDuring)

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

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

enum (VideoIAB)

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

enum (VideoViewableRate)

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

enum (PlayerImpressionRate)

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

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

enum (FraudOption)

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

boolean

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

{
  "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
  ]
}

enum (TRAQScore)

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

boolean

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

enum (Adult)

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

enum (Alcohol)

Bezpieczeństwo marki – alkohol.

enum (IllegalDownloads)

Bezpieczeństwo marki – nielegalne pliki do pobrania.

enum (Drugs)

Bezpieczeństwo marki – leki.

enum (HateSpeech)

Bezpieczeństwo marki – wypowiedzi szerzące nienawiść.

enum (OffensiveLanguage)

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

enum (Violence)

Bezpieczeństwo marki – przemoc.

enum (Gambling)

Bezpieczeństwo marki – hazard.

enum (AdFraudPrevention)

Ustawienia dotyczące oszustw reklamowych.

enum (DisplayViewability)

Wyświetl widoczną sekcję (dotyczy tylko displayowych elementów zamówienia).

enum (VideoViewability)

Sekcja Widoczność reklam wideo (dotyczy tylko elementów zamówienia wideo).

string (int64 format)

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

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

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

string

Wymagane. targetingOptionId elementu 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 .

number

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

number

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

number

Wymagane. Promień obszaru wokół punktu zainteresowania, który będzie docelowy. 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.

enum (DistanceUnit)

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

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

string

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

string

Wymagane. targetingOptionId elementu TargetingOption typu TARGETING_TYPE_BUSINESS_CHAIN.

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

number

Wymagane. Promień obszaru wokół sieci placówek firmy, na który będą kierowane reklamy. 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.

enum (DistanceUnit)

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

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

string

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

enum (ContentDuration)

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

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

string

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

enum (ContentStreamType)

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

{
  "contentPosition": enum (NativeContentPosition)
}

enum (NativeContentPosition)

Wymagane. Pozycja treści.

{
  "omid": enum (Omid)
}

enum (Omid)

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

{
  "audioContentType": enum (AudioContentType)
}

enum (AudioContentType)

Wymagane. Typ treści audio.

{
  "targetingOptionId": string,
  "displayName": string,
  "negative": boolean
}

string

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

string

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

boolean

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

{
  "videoId": string,
  "negative": boolean
}

string

Identyfikator filmu w YouTube, który pojawia się na stronie odtwarzania filmu w YouTube.

boolean

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

{
  "channelId": string,
  "negative": boolean
}

string

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

boolean

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

{
  "sessionPosition": enum (SessionPosition)
}

enum (SessionPosition)

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