REST Resource: advertisers.lineItems

Zasób: LineItem

pojedynczy element zamówienia;

Zapis JSON 
{
  "name": string,
  "advertiserId": string,
  "campaignId": string,
  "insertionOrderId": string,
  "lineItemId": string,
  "displayName": string,
  "lineItemType": enum (LineItemType),
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "partnerCosts": [
    {
      object (PartnerCost)
    }
  ],
  "flight": {
    object (LineItemFlight)
  },
  "budget": {
    object (LineItemBudget)
  },
  "pacing": {
    object (Pacing)
  },
  "frequencyCap": {
    object (FrequencyCap)
  },
  "partnerRevenueModel": {
    object (PartnerRevenueModel)
  },
  "conversionCounting": {
    object (ConversionCountingConfig)
  },
  "creativeIds": [
    string
  ],
  "bidStrategy": {
    object (BiddingStrategy)
  },
  "integrationDetails": {
    object (IntegrationDetails)
  },
  "targetingExpansion": {
    object (TargetingExpansionConfig)
  },
  "warningMessages": [
    enum (LineItemWarningMessage)
  ],
  "mobileApp": {
    object (MobileApp)
  },
  "reservationType": enum (ReservationType),
  "excludeNewExchanges": boolean,
  "youtubeAndPartnersSettings": {
    object (YoutubeAndPartnersSettings)
  },
  "demandGenSettings": {
    object (DemandGenSettings)
  },
  "containsEuPoliticalAds": enum (EuPoliticalAdvertisingStatus),
  "optimizeFixedBidding": boolean
}
Pola
name

string

Tylko dane wyjściowe. Nazwa zasobu elementu zamówienia.
advertiserId

string (int64 format)

Tylko dane wyjściowe. Unikalny identyfikator reklamodawcy, do którego należy element zamówienia.
campaignId

string (int64 format)

Tylko dane wyjściowe. Unikalny identyfikator kampanii, do której należy element zamówienia.
insertionOrderId

string (int64 format)

Wymagane. Wartość niezmienna. Unikalny identyfikator zamówienia reklamowego, do którego należy element zamówienia.
lineItemId

string (int64 format)

Tylko dane wyjściowe. Unikalny identyfikator elementu zamówienia. Przypisany przez system.
displayName

string

Wymagane. Wyświetlana nazwa elementu zamówienia.

Musi być zakodowany w formacie UTF-8 i mieć maksymalny rozmiar 240 bajtów.
lineItemType

enum (LineItemType)

Wymagane. Wartość niezmienna. Typ elementu zamówienia.
entityStatus

enum (EntityStatus)

Wymagane. Określa, czy element zamówienia może wykorzystywać budżet i ustalać stawki za zasoby reklamowe.

  • W przypadku metody lineItems.create dozwolona jest tylko wartość ENTITY_STATUS_DRAFT. Aby aktywować element zamówienia, użyj metody lineItems.patch i po utworzeniu zmień stan na ENTITY_STATUS_ACTIVE.
  • Nie można zmienić stanu elementu zamówienia z dowolnego innego stanu na ENTITY_STATUS_DRAFT.
  • Jeśli zamówienie reklamowe nadrzędne wobec elementu zamówienia jest nieaktywne, element zamówienia nie może wydawać środków z budżetu, nawet jeśli jego stan to ENTITY_STATUS_ACTIVE.
updateTime

string (Timestamp format)

Tylko dane wyjściowe. Sygnatura czasowa ostatniej aktualizacji elementu zamówienia. Przypisany przez system.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
partnerCosts[]

object (PartnerCost)

Koszty partnera powiązane z elementem zamówienia.

Jeśli w metodzie lineItems.create nie ma tej wartości lub jest ona pusta, nowo utworzony element zamówienia odziedziczy koszty partnera po nadrzędnym zamówieniu reklamowym.
flight

object (LineItemFlight)

Wymagane. Czas rozpoczęcia i zakończenia okresu wyświetlania elementu zamówienia.
budget

object (LineItemBudget)

Wymagane. Ustawienie przydzielania budżetu elementu zamówienia.
pacing

object (Pacing)

Wymagane. Ustawienie szybkości wydawania budżetu elementu zamówienia.
frequencyCap

object (FrequencyCap)

Opcjonalnie: Wymagane, jeśli typ elementu zamówienia to nie LINE_ITEM_TYPE_DEMAND_GEN. Ustawienia limitu wyświetleń na użytkownika w ramach elementu zamówienia.

Jeśli przypisujesz limit, musisz użyć pola maxImpressions w tym obiekcie ustawień.
partnerRevenueModel

object (PartnerRevenueModel)

Wymagane. Ustawienie modelu rozliczeniowego partnera w elemencie zamówienia.
conversionCounting

object (ConversionCountingConfig)

Ustawienie śledzenia konwersji elementu zamówienia.
creativeIds[]

string (int64 format)

Identyfikatory kreacji powiązanych z elementem zamówienia.
bidStrategy

object (BiddingStrategy)

Wymagane. Strategia ustalania stawek elementu zamówienia.
integrationDetails

object (IntegrationDetails)

Szczegóły integracji elementu zamówienia.
targetingExpansion

object (TargetingExpansionConfig)

Ustawienia kierowania zoptymalizowanego elementu zamówienia.

Ta konfiguracja dotyczy tylko elementów zamówienia typu displayowego, wideo lub audio, które korzystają z automatycznego określania stawek i są kierowane na odpowiednie listy odbiorców.
warningMessages[]

enum (LineItemWarningMessage)

Tylko dane wyjściowe. Komunikaty ostrzegawcze wygenerowane przez element zamówienia. Te ostrzeżenia nie uniemożliwiają zapisania elementu zamówienia, ale niektóre z nich mogą uniemożliwić jego wyświetlanie.
mobileApp

object (MobileApp)

Reklama aplikacji promowana przez element zamówienia.

Ma to zastosowanie tylko wtedy, gdy lineItemType ma wartość LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL lub LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL.
reservationType

enum (ReservationType)

Tylko dane wyjściowe. Typ rezerwacji elementu zamówienia.
excludeNewExchanges

boolean

Określa, czy nowe giełdy mają być wykluczone z automatycznego kierowania przez element zamówienia. Domyślnie to pole ma wartość false.
youtubeAndPartnersSettings

object (YoutubeAndPartnersSettings)

Opcjonalnie: Ustawienia dotyczące elementów zamówienia typu YouTube i sieć partnerów wideo Google.
demandGenSettings

object (DemandGenSettings)

Opcjonalnie: Ustawienia dotyczące elementów zamówienia generujących popyt.

Dotyczy tylko elementów zamówienia generujących popyt.
containsEuPoliticalAds

enum (EuPoliticalAdvertisingStatus)

Czy ten element zamówienia będzie wyświetlać reklamy polityczne w Unii Europejskiej.

Jeśli w przypadku reklamodawcy nadrzędnego pole containsEuPoliticalAds ma wartość DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING, to pole będzie miało wartość DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING, chyba że określono inaczej. To pole można następnie zaktualizować za pomocą interfejsu, interfejsu API lub plików uporządkowanych danych.

To pole musi zostać przypisane podczas tworzenia nowego elementu zamówienia. W przeciwnym razie żądanie advertisers.lineItems.create nie powiedzie się.
optimizeFixedBidding

boolean

Opcjonalnie: Określa, czy włączyć optymalizację stawek DV360 w przypadku elementów zamówienia ze stałymi stawkami.

Domyślnie DV360 optymalizuje Określanie stawek stałych, automatycznie obniżając stawki za wyświetlenia, które mają mniejsze szanse na uzyskanie dobrych wyników. Ta optymalizacja jest domyślnie włączona (wartość to „true”).

Gdy to pole ma wartość false, optymalizacja jest wyłączona, a stawka nie zostanie obniżona z żadnego powodu.

To ustawienie dotyczy tylko elementów zamówienia z biddingStrategy typu FIXED_BID.

LineItemType

Możliwe typy elementu zamówienia.

Typ elementu zamówienia określa, które ustawienia i opcje są dostępne, np. format reklam lub opcje kierowania.

Wartości w polu enum
LINE_ITEM_TYPE_UNSPECIFIED

Wartość typu nie jest określona lub jest nieznana w tej wersji.

Elementów zamówienia tego typu i ich kierowania nie można tworzyć ani aktualizować za pomocą interfejsu API.
LINE_ITEM_TYPE_DISPLAY_DEFAULT reklamy graficzne, HTML5, natywne lub multimedialne;
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL Reklamy displayowe, które zwiększają liczbę instalacji aplikacji.
LINE_ITEM_TYPE_VIDEO_DEFAULT Reklamy wideo sprzedawane w modelu CPM w różnych środowiskach.
LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL Reklamy wideo, które zachęcają do instalacji aplikacji.
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INVENTORY

Reklamy displayowe wyświetlane w zasobach reklamowych aplikacji mobilnych.

Elementów zamówienia tego typu i ich kierowania nie można tworzyć ani aktualizować za pomocą interfejsu API.
LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INVENTORY

Reklamy wideo wyświetlane w zasobach reklamowych aplikacji mobilnych.

Elementów zamówienia tego typu i ich kierowania nie można tworzyć ani aktualizować za pomocą interfejsu API.
LINE_ITEM_TYPE_AUDIO_DEFAULT Reklamy audio RTB sprzedawane w różnych środowiskach.
LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP Reklamy over-the-top w zamówieniach reklamowych OTT. Ten typ ma zastosowanie tylko do elementów zamówienia z zamówieniem reklamowym insertionOrderType OVER_THE_TOP.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION

Reklamy wideo na YouTube, które promują konwersje.

Elementów zamówienia tego typu i ich kierowania nie można tworzyć ani aktualizować za pomocą interfejsu API.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE

Reklamy wideo na YouTube (do 15 sekund), których nie można pominąć.

Elementów zamówienia tego typu i ich kierowania nie można tworzyć ani aktualizować za pomocą interfejsu API.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE

Reklamy wideo na YouTube, które opowiadają historię w określonej kolejności, korzystając z różnych formatów.

Elementów zamówienia tego typu i ich kierowania nie można tworzyć ani aktualizować za pomocą interfejsu API.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO

reklamy audio w YouTube.

Elementów zamówienia tego typu i ich kierowania nie można tworzyć ani aktualizować za pomocą interfejsu API.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH

Reklamy wideo na YouTube, które optymalizują docieranie do większej liczby unikalnych użytkowników przy niższych kosztach. Może obejmować bumpery reklamowe, reklamy In-Stream możliwe do pominięcia lub połączenie obu typów reklam.

Elementów zamówienia tego typu i ich kierowania nie można tworzyć ani aktualizować za pomocą interfejsu API.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE

Domyślne reklamy wideo na YouTube.

Elementów zamówienia tego typu i ich kierowania nie można tworzyć ani aktualizować za pomocą interfejsu API.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP

Reklamy wideo na YouTube na urządzeniach CTV (do 15 sekund), których nie można pominąć.

Elementów zamówienia tego typu i ich kierowania nie można tworzyć ani aktualizować za pomocą interfejsu API.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP

Reklamy wideo na YouTube na urządzeniach CTV, które optymalizują docieranie do większej liczby unikalnych użytkowników przy niższych kosztach. Może obejmować bumpery reklamowe, reklamy In-Stream możliwe do pominięcia lub połączenie obu typów reklam.

Elementów zamówienia tego typu i ich kierowania nie można tworzyć ani aktualizować za pomocą interfejsu API.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP

Domyślne reklamy wideo na YouTube na urządzeniach CTV. Uwzględniaj tylko format reklamy In-Stream.

Elementów zamówienia tego typu i ich kierowania nie można tworzyć ani aktualizować za pomocą interfejsu API.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCY

Celem tego typu elementu zamówienia jest wyświetlanie reklam na YouTube docelową liczbę razy tej samej osobie w określonym czasie.

Elementów zamówienia tego typu i ich kierowania nie można tworzyć ani aktualizować za pomocą interfejsu API.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW

Reklamy wideo na YouTube, które mają na celu zwiększenie liczby wyświetleń dzięki różnym formatom reklam.

Elementów zamówienia tego typu i ich kierowania nie można tworzyć ani aktualizować za pomocą interfejsu API.
LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME

Reklamy displayowe wyświetlane w cyfrowych zewnętrznych zasobach reklamowych.

Elementów zamówienia tego typu i ich kierowania nie można tworzyć ani aktualizować za pomocą interfejsu API.
LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME

Reklamy wideo wyświetlane w cyfrowych zewnętrznych zasobach reklamowych.

Elementów zamówienia tego typu i ich kierowania nie można tworzyć ani aktualizować za pomocą interfejsu API.
LINE_ITEM_TYPE_DEMAND_GEN reklamy generujące popyt.

LineItemFlight

Ustawienia, które określają czas aktywności elementu zamówienia.

Zapis JSON 
{
  "flightDateType": enum (LineItemFlightDateType),
  "dateRange": {
    object (DateRange)
  }
}
Pola
flightDateType

enum (LineItemFlightDateType)

Wymagane. Typ dat wyświetlania elementu zamówienia.
dateRange

object (DateRange)

Daty rozpoczęcia i zakończenia okresu wyświetlania elementu zamówienia. Są one rozwiązywane względem strefy czasowej reklamodawcy nadrzędnego.

  • Wymagane, gdy flightDateType to LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM. W przeciwnym razie tylko dane wyjściowe.
  • Podczas tworzenia nowego okresu wyświetlania zarówno startDate, jak i endDate muszą przypadać w przyszłości.
  • Istniejący lot z startDate w przeszłości ma zmienny endDate, ale niezmienny startDate.
  • endDate musi być startDate lub późniejsza, obie przed rokiem 2037.

LineItemFlightDateType

Możliwe typy dat wyświetlania elementu zamówienia.

Wartości w polu enum
LINE_ITEM_FLIGHT_DATE_TYPE_UNSPECIFIED Wartość typu nie jest określona lub jest nieznana w tej wersji.
LINE_ITEM_FLIGHT_DATE_TYPE_INHERITED Daty wyświetlania elementu zamówienia są dziedziczone z nadrzędnego zamówienia reklamowego.
LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM Element zamówienia używa własnych niestandardowych dat wyświetlania reklam.

LineItemBudget

Ustawienia, które określają sposób przydzielania budżetu.

Zapis JSON 
{
  "budgetAllocationType": enum (LineItemBudgetAllocationType),
  "budgetUnit": enum (BudgetUnit),
  "maxAmount": string
}
Pola
budgetAllocationType

enum (LineItemBudgetAllocationType)

Wymagane. Typ przydziału budżetu.

LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC ma zastosowanie tylko wtedy, gdy w nadrzędnym zamówieniu reklamowym jest włączone automatyczne przydzielanie budżetu.

W przypadku elementów zamówienia generujących popyt to pole musi mieć wartość LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED.
budgetUnit

enum (BudgetUnit)

Tylko dane wyjściowe. Jednostka budżetu określa, czy budżet jest oparty na walucie czy na wyświetleniach. Ta wartość jest dziedziczona z nadrzędnego zamówienia reklamowego.
maxAmount

string (int64 format)

Maksymalna kwota budżetu, którą wyda element zamówienia. Musi być większy niż 0.

Gdy budgetAllocationType:

  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC, to pole jest niezmienne i jest ustawiane przez system.
  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED, jeśli budgetUnit to:
    • BUDGET_UNIT_CURRENCY – to pole reprezentuje maksymalną kwotę budżetu do wydania w mikrowartościach waluty reklamodawcy. Na przykład 1500000 oznacza 1, 5 standardowej jednostki waluty.
    • BUDGET_UNIT_IMPRESSIONS, to pole reprezentuje maksymalną liczbę wyświetleń do zrealizowania.
  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED, to pole nie dotyczy i będzie ignorowane przez system.

LineItemBudgetAllocationType

Możliwe typy przydzielania budżetu.

Wartości w polu enum
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNSPECIFIED Wartość typu nie jest określona lub jest nieznana w tej wersji.
LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC W przypadku elementu zamówienia włączone jest automatyczne przydzielanie budżetu.
LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED Do elementu zamówienia jest przypisana stała maksymalna kwota budżetu.
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED Do elementu zamówienia nie jest stosowany żaden limit budżetu.

PartnerRevenueModel

Ustawienia, które określają sposób obliczania przychodów partnera.

Zapis JSON 
{
  "markupType": enum (PartnerRevenueModelMarkupType),
  "markupAmount": string
}
Pola
markupType

enum (PartnerRevenueModelMarkupType)

Wymagane. Typ marży w modelu rozliczeniowym partnera.

W przypadku elementów zamówienia generujących popyt to pole musi mieć wartość PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP.
markupAmount

string (int64 format)

Wymagane. Kwota marży w modelu rozliczeniowym partnera. Wartość nie może być mniejsza niż 0.

  • Gdy parametr markupType ma wartość PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM, to pole reprezentuje marżę CPM w mikrowalucie reklamodawcy. Na przykład 1500000 oznacza 1, 5 standardowej jednostki waluty.
  • Gdy pole markupType ma wartość PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP, to pole reprezentuje procentową marżę kosztu mediów w milach. Na przykład 100 oznacza 0,1% (dziesiętnie 0,001).
  • Gdy markupType jest ustawione na PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP, to pole reprezentuje łączną marżę procentową całkowitego kosztu mediów w milach. Na przykład 100 oznacza 0,1% (dziesiętnie 0,001).

PartnerRevenueModelMarkupType

Możliwe typy marży w modelu rozliczeniowym partnera.

Wartości w polu enum
PARTNER_REVENUE_MODEL_MARKUP_TYPE_UNSPECIFIED Wartość typu nie jest określona lub jest nieznana w tej wersji.
PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM Oblicz przychody partnera na podstawie stałego CPM.
PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP

Oblicz przychody partnera na podstawie procentowej opłaty dodatkowej od kosztu mediów.
PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP Oblicz przychody partnera na podstawie procentowej opłaty dodatkowej od całkowitego kosztu mediów, który obejmuje wszystkie koszty partnera i danych.

ConversionCountingConfig

Ustawienia określające sposób liczenia konwersji.

Zliczane będą wszystkie konwersje po kliknięciu. Możesz ustawić wartość procentową na potrzeby zliczania konwersji po obejrzeniu.

Zapis JSON 
{
  "postViewCountPercentageMillis": string,
  "floodlightActivityConfigs": [
    {
      object (TrackingFloodlightActivityConfig)
    }
  ],
  "primaryAttributionModelId": string
}
Pola
postViewCountPercentageMillis

string (int64 format)

Odsetek konwersji po obejrzeniu, które mają być zliczane, podany w mili (1/1000 procenta). Musi należeć do zakresu od 0 do 100 000 włącznie.

Aby na przykład śledzić 50% konwersji po kliknięciu, ustaw wartość 50000.
floodlightActivityConfigs[]

object (TrackingFloodlightActivityConfig)

Konfiguracje aktywności Floodlight używane do śledzenia konwersji.

Liczba zliczonych konwersji to suma wszystkich konwersji zliczonych przez wszystkie identyfikatory aktywności Floodlight określone w tym polu.

Tego pola nie można aktualizować, jeśli do elementu zamówienia jest przypisany algorytm ustalania stawek niestandardowych. Jeśli ustawisz to pole i przypiszesz algorytm ustalania stawek niestandardowych w tym samym żądaniu, aktywności Floodlight muszą być zgodne z aktywnościami używanymi przez algorytm ustalania stawek niestandardowych.
primaryAttributionModelId

string (int64 format)

Opcjonalnie: Model atrybucji używany do pomiaru konwersji. Ten model atrybucji określa sposób liczenia konwersji. Model główny możesz ustawić dla konfiguracji lub grupy Floodlight. Więcej informacji znajdziesz tutaj.

Dotyczy tylko elementów zamówienia generujących popyt.

TrackingFloodlightActivityConfig

Ustawienia, które kontrolują działanie pojedynczej konfiguracji aktywności Floodlight.

Zapis JSON 
{
  "floodlightActivityId": string,
  "postClickLookbackWindowDays": integer,
  "postViewLookbackWindowDays": integer
}
Pola
floodlightActivityId

string (int64 format)

Wymagane. Identyfikator aktywności Floodlight.
postClickLookbackWindowDays

integer

Wymagane. Liczba dni po kliknięciu reklamy, w których może zostać zarejestrowana konwersja. Musi należeć do przedziału od 0 do 90 włącznie.
postViewLookbackWindowDays

integer

Wymagane. Liczba dni po wyświetleniu reklamy, w ciągu których może zostać zliczona konwersja. Musi należeć do przedziału od 0 do 90 włącznie.

LineItemWarningMessage

Komunikaty ostrzegawcze wygenerowane przez element zamówienia. Tego typu ostrzeżenia nie uniemożliwiają zapisania elementu zamówienia, ale mogą uniemożliwić jego uruchomienie.

Wartości w polu enum
LINE_ITEM_WARNING_MESSAGE_UNSPECIFIED Nie określono lub nieznany.
INVALID_FLIGHT_DATES Ten element zamówienia ma nieprawidłowy okres wyświetlania. Element zamówienia nie będzie realizowany.
EXPIRED Data zakończenia tego elementu zamówienia przypada w przeszłości.
PENDING_FLIGHT Ten element zamówienia zacznie działać w przyszłości.
ALL_PARTNER_ENABLED_EXCHANGES_NEGATIVELY_TARGETED Wszystkie giełdy obsługiwane przez partnerów są wykluczone przez kierowanie. Element zamówienia nie będzie realizowany.
INVALID_INVENTORY_SOURCE Nie masz ustawionego kierowania na żadne aktywne źródło zasobów reklamowych. Element zamówienia nie będzie realizowany.
APP_INVENTORY_INVALID_SITE_TARGETING Kierowanie tego elementu zamówienia na aplikacje i adresy URL nie obejmuje żadnych aplikacji mobilnych. Ten typ elementu zamówienia wymaga uwzględnienia aplikacji mobilnych w kierowaniu na kanał, listę witryn lub aplikacje. Element zamówienia nie będzie realizowany.
APP_INVENTORY_INVALID_AUDIENCE_LISTS Ten element zamówienia nie jest kierowany na żadnych użytkowników urządzeń mobilnych. Ten typ elementu zamówienia wymaga kierowania na listę użytkowników korzystających z urządzeń mobilnych. Element zamówienia nie będzie realizowany.
NO_VALID_CREATIVE Ten element zamówienia nie zawiera żadnej prawidłowej kreacji. Element zamówienia nie będzie realizowany.
PARENT_INSERTION_ORDER_PAUSED Zamówienie reklamowe tego elementu zamówienia jest wstrzymane. Element zamówienia nie będzie realizowany.
PARENT_INSERTION_ORDER_EXPIRED Data zakończenia zamówienia reklamowego tego elementu zamówienia przypada w przeszłości. Element zamówienia nie będzie realizowany.

MobileApp

Aplikacja mobilna promowana przez element zamówienia promujący instalację aplikacji mobilnej.

Zapis JSON 
{
  "appId": string,
  "platform": enum (Platform),
  "displayName": string,
  "publisher": string
}
Pola
appId

string

Wymagane. Identyfikator aplikacji podany przez sklep na platformie.

Aplikacje na Androida są identyfikowane za pomocą identyfikatora pakietu używanego przez Sklep Play na Androidzie, np. com.google.android.gm.

Aplikacje na iOS są identyfikowane za pomocą 9-cyfrowego identyfikatora aplikacji używanego przez sklep z aplikacjami Apple, np. 422689480.
platform

enum (Platform)

Tylko dane wyjściowe. Platforma aplikacji.
displayName

string

Tylko dane wyjściowe. Nazwa aplikacji.
publisher

string

Tylko dane wyjściowe. Wydawca aplikacji.

Platforma

Możliwe platformy aplikacji mobilnych.

Wartości w polu enum
PLATFORM_UNSPECIFIED Platforma nie została określona.
IOS Platforma iOS.
ANDROID Platforma Android.

YoutubeAndPartnersSettings

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

Zapis JSON 
{
  "viewFrequencyCap": {
    object (FrequencyCap)
  },
  "thirdPartyMeasurementConfigs": {
    object (ThirdPartyMeasurementConfigs)
  },
  "inventorySourceSettings": {
    object (YoutubeAndPartnersInventorySourceConfig)
  },
  "contentCategory": enum (YoutubeAndPartnersContentCategory),
  "effectiveContentCategory": enum (YoutubeAndPartnersContentCategory),
  "targetFrequency": {
    object (TargetFrequency)
  },
  "linkedMerchantId": string,
  "relatedVideos": [
    {
      object (RelatedVideo)
    }
  ],
  "leadFormId": string,
  "videoAdSequenceSettings": {
    object (VideoAdSequenceSettings)
  },
  "videoAdInventoryControl": {
    object (VideoAdInventoryControl)
  }
}
Pola
viewFrequencyCap

object (FrequencyCap)

Ustawienia limitu wyświetleń na użytkownika elementu zamówienia.

Jeśli przypisujesz limit, musisz użyć pola maxViews w tym obiekcie ustawień.
thirdPartyMeasurementConfigs

object (ThirdPartyMeasurementConfigs)

Opcjonalnie: Konfiguracje zewnętrznych usług pomiarowych elementu zamówienia.
inventorySourceSettings

object (YoutubeAndPartnersInventorySourceConfig)

Ustawienia, które określają, na jakie zasoby reklamowe YouTube i sieci partnerów wideo Google będzie kierowany element zamówienia.
contentCategory

enum (YoutubeAndPartnersContentCategory)

Tylko dane wyjściowe. Rodzaj treści, w których będą się wyświetlać reklamy w YouTube i sieci partnerów wideo Google.
effectiveContentCategory

enum (YoutubeAndPartnersContentCategory)

Tylko dane wyjściowe. Kategoria treści, która obowiązuje podczas wyświetlania elementu zamówienia. Jeśli kategoria treści jest ustawiona zarówno w elemencie zamówienia, jak i u reklamodawcy, podczas wyświetlania elementu zamówienia będzie obowiązywać bardziej rygorystyczne ustawienie.

Nowe elementy zamówienia będą dziedziczyć tylko ustawienie na poziomie reklamodawcy.
targetFrequency

object (TargetFrequency)

Opcjonalnie: Średnia liczba wyświetleń reklam z tego elementu zamówienia tej samej osobie w określonym czasie.
linkedMerchantId

string (int64 format)

Opcjonalnie: Identyfikator konta Merchant Center używanego do dostarczania pliku danych o produktach.

To konto Merchant Center musi być już połączone z reklamodawcą.
relatedVideos[]

object (RelatedVideo)

Opcjonalnie: Podobne filmy dla elementu zamówienia. Te filmy będą się wyświetlać pod główną reklamą wideo, która jest odtwarzana w aplikacji YouTube na urządzeniach mobilnych.
leadFormId

string (int64 format)

Opcjonalnie: Identyfikator formularza do generowania potencjalnych klientów.
videoAdSequenceSettings

object (VideoAdSequenceSettings)

Opcjonalnie: Ustawienia związane z sekwencją reklam wideo.
videoAdInventoryControl

object (VideoAdInventoryControl)

Opcjonalnie: Ustawienia określające, które zasoby reklamowe są dozwolone w przypadku tego elementu zamówienia.

ThirdPartyMeasurementConfigs

Ustawienia, które określają, którzy zewnętrzni dostawcy mierzą określone dane elementu zamówienia.

Zapis JSON 
{
  "viewabilityVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "brandSafetyVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "reachVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "brandLiftVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ]
}
Pola
viewabilityVendorConfigs[]

object (ThirdPartyVendorConfig)

Opcjonalnie: Zewnętrzni dostawcy usług pomiaru widoczności.

Możesz korzystać z usług tych zewnętrznych dostawców:

  • THIRD_PARTY_VENDOR_MOAT
  • THIRD_PARTY_VENDOR_DOUBLE_VERIFY
  • THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE
  • THIRD_PARTY_VENDOR_COMSCORE
  • THIRD_PARTY_VENDOR_TELEMETRY
  • THIRD_PARTY_VENDOR_MEETRICS
brandSafetyVendorConfigs[]

object (ThirdPartyVendorConfig)

Opcjonalnie: Zewnętrzni dostawcy usług pomiaru bezpieczeństwa marki.

Możesz korzystać z usług tych zewnętrznych dostawców:

  • THIRD_PARTY_VENDOR_ZEFR
  • THIRD_PARTY_VENDOR_DOUBLE_VERIFY
  • THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE
reachVendorConfigs[]

object (ThirdPartyVendorConfig)

Opcjonalnie: Zewnętrzni dostawcy usług pomiaru zasięgu.

Możesz korzystać z usług tych zewnętrznych dostawców:

  • THIRD_PARTY_VENDOR_NIELSEN
  • THIRD_PARTY_VENDOR_COMSCORE
  • THIRD_PARTY_VENDOR_KANTAR
  • THIRD_PARTY_VENDOR_VIDEO_RESEARCH
  • THIRD_PARTY_VENDOR_MEDIA_SCOPE
  • THIRD_PARTY_VENDOR_AUDIENCE_PROJECT
  • THIRD_PARTY_VENDOR_VIDEO_AMP
  • THIRD_PARTY_VENDOR_ISPOT_TV
  • THIRD_PARTY_VENDOR_GEMIUS
brandLiftVendorConfigs[]

object (ThirdPartyVendorConfig)

Opcjonalnie: Zewnętrzni dostawcy usług pomiaru wyników marki.

Możesz korzystać z usług tych zewnętrznych dostawców:

  • THIRD_PARTY_VENDOR_DYNATA
  • THIRD_PARTY_VENDOR_KANTAR
  • THIRD_PARTY_VENDOR_INTAGE
  • THIRD_PARTY_VENDOR_MACROMILL

ThirdPartyVendorConfig

Ustawienia, które określają sposób konfigurowania dostawców zewnętrznych usług pomiarowych.

Zapis JSON 
{
  "vendor": enum (ThirdPartyVendor),
  "placementId": string
}
Pola
vendor

enum (ThirdPartyVendor)

Dostawca zewnętrznych usług pomiarowych.
placementId

string

Identyfikator używany przez platformę zewnętrznego dostawcy do identyfikowania elementu zamówienia.

ThirdPartyVendor

Dostawcy, którzy wykonują zewnętrzne usługi pomiarowe.

Wartości w polu enum
THIRD_PARTY_VENDOR_UNSPECIFIED Nieznany zewnętrzny dostawca.
THIRD_PARTY_VENDOR_MOAT Moat.
THIRD_PARTY_VENDOR_DOUBLE_VERIFY DoubleVerify.
THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE Integral Ad Science.
THIRD_PARTY_VENDOR_COMSCORE Comscore.
THIRD_PARTY_VENDOR_TELEMETRY Dane telemetryczne.
THIRD_PARTY_VENDOR_MEETRICS Meetrics.
THIRD_PARTY_VENDOR_ZEFR ZEFR.
THIRD_PARTY_VENDOR_NIELSEN Nielsen.
THIRD_PARTY_VENDOR_KANTAR Kantar.
THIRD_PARTY_VENDOR_DYNATA Dynata.
THIRD_PARTY_VENDOR_TRANSUNION Transunion.
THIRD_PARTY_VENDOR_ORIGIN pochodzenia.
THIRD_PARTY_VENDOR_GEMIUS Gemius.
THIRD_PARTY_VENDOR_MEDIA_SCOPE MediaScope.
THIRD_PARTY_VENDOR_AUDIENCE_PROJECT Audience Project.
THIRD_PARTY_VENDOR_VIDEO_AMP Video Amp.
THIRD_PARTY_VENDOR_ISPOT_TV iSpot.tv.
THIRD_PARTY_VENDOR_INTAGE Intage.
THIRD_PARTY_VENDOR_MACROMILL Macromill.
THIRD_PARTY_VENDOR_VIDEO_RESEARCH Video Research.
THIRD_PARTY_VENDOR_AQUILA Aquila.

YoutubeAndPartnersInventorySourceConfig

Ustawienia, które określają, na jakie zasoby reklamowe związane z YouTube będzie kierowany element zamówienia typu YouTube i sieć partnerów wideo Google.

Zapis JSON 
{
  "includeYoutube": boolean,
  "includeGoogleTv": boolean,
  "includeYoutubeVideoPartners": boolean
}
Pola
includeYoutube

boolean

Opcjonalnie: Określa, czy kierować reklamy na zasoby reklamowe w YouTube. Obejmuje to wyszukiwanie, kanały i filmy.
includeGoogleTv

boolean

Opcjonalnie: Określa, czy kierować reklamy na zasoby reklamowe w aplikacjach wideo dostępnych w Google TV.
includeYoutubeVideoPartners

boolean

Określa, czy kierować reklamy na zasoby reklamowe w zbiorze partnerskich witryn i aplikacji przestrzegających tych samych norm bezpieczeństwa marki co YouTube.

YoutubeAndPartnersContentCategory

Kategorie bezpieczeństwa marki w przypadku treści w YouTube i sieci partnerów wideo Google.

Wartości w polu enum
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_UNSPECIFIED Kategoria treści nie jest określona lub jest nieznana w tej wersji.
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_STANDARD Kategoria obejmująca szeroki zakres treści odpowiednich dla większości marek. Treści są wybierane na podstawie wytycznych YouTube na temat tworzenia filmów odpowiednich do wyświetlania reklam.
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_EXPANDED Kategoria obejmująca wszystkie treści w YouTube i sieci partnerów wideo, które spełniają standardy generowania przychodu.
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_LIMITED Kategoria obejmująca ograniczony zakres treści, które spełniają podwyższone wymagania, zwłaszcza pod względem niestosownego języka i treści z podtekstem seksualnym.

TargetFrequency

Ustawienie, które kontroluje średnią liczbę wyświetleń reklam tej samej osobie w określonym czasie.

Zapis JSON 
{
  "targetCount": string,
  "timeUnit": enum (TimeUnit),
  "timeUnitCount": integer
}
Pola
targetCount

string (int64 format)

Docelowa średnia liczba wyświetleń reklam tej samej osobie w okresie określonym przez parametry timeUnit i timeUnitCount.
timeUnit

enum (TimeUnit)

Jednostka czasu, w której będzie stosowana docelowa częstotliwość.

Możesz użyć tych jednostek czasu:

  • TIME_UNIT_WEEKS
  • TIME_UNIT_MONTHS
timeUnitCount

integer

Liczba (timeUnit), przez którą będzie obowiązywać docelowa częstotliwość.

W zależności od wartości timeUnit obowiązują te ograniczenia:

  • TIME_UNIT_WEEKS – musi wynosić 1
  • TIME_UNIT_MONTHS – musi wynosić 1

RelatedVideo

Reprezentuje wpis dotyczący podobnego filmu.

Zapis JSON 
{
  "videoId": string,
  "videoAssetId": string
}
Pola
videoId

string

Tylko dane wyjściowe. Identyfikator filmu na YouTube powiązanego z podobnym filmem.
videoAssetId

string (int64 format)

Wymagane. adAssetId zasobu AdAsset filmu na YouTube.

VideoAdSequenceSettings

Ustawienia związane z sekwencją reklam wideo.

Zapis JSON 
{
  "minimumDuration": enum (VideoAdSequenceMinimumDuration),
  "steps": [
    {
      object (VideoAdSequenceStep)
    }
  ]
}
Pola
minimumDuration

enum (VideoAdSequenceMinimumDuration)

Minimalny odstęp czasu, po którym ten sam użytkownik ponownie zobaczy tę sekwencję.
steps[]

object (VideoAdSequenceStep)

Kroki, z których składa się sekwencja.

VideoAdSequenceMinimumDuration

Typ wyliczeniowy możliwych minimalnych odstępów czasu, po których ten sam użytkownik może ponownie zobaczyć sekwencję reklam wideo.

Wartości w polu enum
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_UNSPECIFIED Nieokreślony lub nieznany.
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_WEEK 7 dni.
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_MONTH 30 dni.

VideoAdSequenceStep

Szczegóły pojedynczego kroku w sekwencji reklam wideo.

Zapis JSON 
{
  "stepId": string,
  "adGroupId": string,
  "previousStepId": string,
  "interactionType": enum (InteractionType)
}
Pola
stepId

string (int64 format)

Identyfikator kroku.
adGroupId

string (int64 format)

Identyfikator grupy reklam odpowiadającej danemu krokowi.
previousStepId

string (int64 format)

Identyfikator poprzedniego kroku. Pierwszy krok nie ma poprzedniego kroku.
interactionType

enum (InteractionType)

Interakcja w poprzednim kroku, która doprowadzi widza do tego kroku. Pierwszy krok nie ma parametru interactionType.

InteractionType

Typy interakcji na danym etapie.

Wartości w polu enum
INTERACTION_TYPE_UNSPECIFIED Nieokreślony lub nieznany
INTERACTION_TYPE_PAID_VIEW Wyświetlenie płatne.
INTERACTION_TYPE_SKIP pominięte przez widza,
INTERACTION_TYPE_IMPRESSION (obejrzenie) wyświetlenia reklamy,
INTERACTION_TYPE_ENGAGED_IMPRESSION Wyświetlenie reklamy, które nie zostało natychmiast pominięte przez widza, ale nie osiągnęło zdarzenia naliczanego do rachunku.

VideoAdInventoryControl

Kontrola zasobów reklamowych wideo używana w niektórych typach elementów zamówienia w YouTube.

Zapis JSON 
{
  "allowInStream": boolean,
  "allowInFeed": boolean,
  "allowShorts": boolean,
  "allowNonSkippableInStream": boolean
}
Pola
allowInStream

boolean

Opcjonalnie: Określa, czy reklamy mogą się wyświetlać w formacie In-Stream.
allowInFeed

boolean

Opcjonalnie: Czy reklamy mogą się wyświetlać w formacie In-Feed.
allowShorts

boolean

Opcjonalnie: Określa, czy reklamy mogą się wyświetlać w formacie Shorts.
allowNonSkippableInStream

boolean

Opcjonalnie: Wskazuje, czy reklamy mogą się wyświetlać w formacie In-Stream niemożliwym do pominięcia.

DemandGenSettings

Ustawienia elementów zamówienia generujących popyt.

Zapis JSON 
{
  "thirdPartyMeasurementConfigs": {
    object (ThirdPartyMeasurementConfigs)
  },
  "linkedMerchantId": string,
  "geoLanguageTargetingEnabled": boolean
}
Pola
thirdPartyMeasurementConfigs

object (ThirdPartyMeasurementConfigs)

Opcjonalnie: Ustawienia zewnętrznych usług pomiarowych dotyczące elementu zamówienia generującego popyt.
linkedMerchantId

string (int64 format)

Opcjonalnie: Identyfikator konta Merchant Center używanego do dostarczania pliku danych o produktach.

To konto Merchant Center musi być już połączone z reklamodawcą.
geoLanguageTargetingEnabled

boolean

Opcjonalnie: Wartość niezmienna. Czy kierowanie na lokalizację i język można ustawić na poziomie elementu zamówienia. W przeciwnym razie odpowiednie typy kierowania muszą być przypisane bezpośrednio do grup reklam.

Metody

bulkEditAssignedTargetingOptions

 Zbiorcze edytowanie opcji kierowania w wielu elementach zamówienia.

bulkListAssignedTargetingOptions

 Wyświetla listę opcji kierowania przypisanych do wielu elementów zamówienia w różnych typach kierowania.

bulkUpdate

 Aktualizuje wiele elementów zamówienia.

create

 Tworzy nowy element zamówienia.

delete

 Usuwa element zamówienia.

duplicate

 Duplikuje element zamówienia.

get

 Pobiera element zamówienia.

list

 Wyświetla listę elementów zamówienia reklamodawcy.

patch

 Aktualizuje istniejący element zamówienia.