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

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

Wymagany. Wyświetlana nazwa elementu zamówienia.

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

enum (LineItemType)

Wymagany. Niezmienna. Typ elementu zamówienia.
entityStatus

enum (EntityStatus)

Wymagany. Określa, czy element zamówienia może wydawać 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 zaktualizuj jego stan na ENTITY_STATUS_ACTIVE.
  • Elementu zamówienia nie można zmienić z stanu ENTITY_STATUS_DRAFT na inny stan.
  • Jeśli nadrzędne zamówienie reklamowe elementu zamówienia nie jest aktywne, element zamówienia nie może wydawać budżetu, nawet jeśli jego własny stan to ENTITY_STATUS_ACTIVE.
updateTime

string (Timestamp format)

Tylko dane wyjściowe. Sygnatura czasowa określająca, kiedy element zamówienia został ostatnio zaktualizowany. Przypisany przez system.

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. 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 sposobie lineItems.create nie ma wartości lub jest ona pusta, nowo utworzony element zamówienia odziedziczy koszty partnera z nadrzędnego zamówienia reklamowego.
flight

object (LineItemFlight)

Wymagany. Godzina rozpoczęcia i zakończenia wyświetlania elementu zamówienia.
budget

object (LineItemBudget)

Wymagany. Ustawienie alokacji budżetu elementu zamówienia.
pacing

object (Pacing)

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

object (FrequencyCap)

Wymagany. Ustawienia limitu częstotliwości wyświetleń elementu zamówienia.

Jeśli przypisujesz ograniczoną liczbę wyświetleń, musisz użyć pola maxImpressions w tym obiekcie ustawień.
partnerRevenueModel

object (PartnerRevenueModel)

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

Wymagany. 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 jest dostępna tylko w przypadku elementów zamówienia w kampaniach w sieci reklamowej oraz w kampaniach wideo i 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 mogą uniemożliwić jego wyświetlanie.
mobileApp

object (MobileApp)

Aplikacja mobilna promowana przez element zamówienia.

Dotyczy to tylko sytuacji, gdy element 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ć automatycznie wykluczane z kierowania elementu zamówienia. Domyślnie to pole ma wartość false.
youtubeAndPartnersSettings

object (YoutubeAndPartnersSettings)

Tylko dane wyjściowe. Ustawienia specyficzne dla elementów zamówienia typu YouTube i sieć partnerów wideo Google.

LineItemType

Możliwe typy elementów 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 została 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 i multimedialne.
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL wyświetlać reklamy, które zwiększają liczbę instalacji aplikacji;
LINE_ITEM_TYPE_VIDEO_DEFAULT Reklamy wideo sprzedawane zgodnie z modelem CPM w różnych środowiskach.
LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL Reklamy wideo promujące instalacje 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 w modelu RTB sprzedawane w różnych środowiskach.
LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP Reklamy Over-The-Top występują w zamówieniach reklamowych OTT. Ten typ dotyczy tylko elementów zamówienia z zamówieniem reklamowym insertionOrderType OVER_THE_TOP.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION

Reklamy wideo w YouTube promujące 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 w 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 w YouTube, które prezentują historię w określonej kolejności, wykorzystując różne formaty.

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 w YouTube, które optymalizują dotarcie do większej liczby unikalnych użytkowników przy niższych kosztach; Mogą to być bumpery reklamowe, reklamy In-Stream możliwe do pominięcia lub kombinacja tych rodzajó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 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_NON_SKIPPABLE_OVER_THE_TOP

Reklamy wideo w 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 w YouTube na urządzenia CTV, które optymalizują dotarcie do większej liczby unikalnych użytkowników przy niższych kosztach; Mogą to być bumpery reklamowe, reklamy In-Stream możliwe do pominięcia lub kombinacja tych rodzajó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 w YouTube na urządzeniach CTV, Uwzględnij tylko format reklam 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 w YouTube tej samej osobie w określonym czasie określoną liczbę razy.

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 w YouTube, których celem jest zwiększenie liczby obejrzeń za pomocą różnych formatów 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

wyświetlanie reklam displayowych 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.

LineItemFlight

Ustawienia określające czas trwania aktywnego elementu zamówienia.

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

enum (LineItemFlightDateType)

Wymagany. 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 w zależności od strefy czasowej reklamodawcy nadrzędnego.

  • Wymagane, gdy flightDateType ma wartość LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM. W przeciwnym razie ma wartość Dane wyjściowe.
  • Podczas tworzenia nowego lotu zarówno startDate, jak i endDate muszą być w przyszłości.
  • Istniejący lot z wartością startDate w przeszłości ma zmienną endDate, ale niezmienną startDate.
  • Wartość endDate musi być równa startDate lub większa, ale nie może być większa niż 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 została określona lub jest nieznana w tej wersji.
LINE_ITEM_FLIGHT_DATE_TYPE_INHERITED Okresy 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 określające sposób przydzielania budżetu.

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

enum (LineItemBudgetAllocationType)

Wymagany. Typ przydziału budżetu.

LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC jest dostępna tylko wtedy, gdy w zamówieniu reklamowym nadrzędnym jest włączone automatyczne przydzielanie budżetu.
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 na wstawione reklamy.
maxAmount

string (int64 format)

Maksymalna kwota budżetu, jaką wykorzysta 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_CURRENCYTo pole reprezentuje maksymalną kwotę budżetu do wydania w mikrowalutach waluty reklamodawcy. Na przykład 1500000 reprezentuje 1, 5 standardowej jednostki waluty.
    • BUDGET_UNIT_IMPRESSIONS: to pole określa maksymalną liczbę wyświetleń.
  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED, to pole nie ma zastosowania i zostanie zignorowane przez system.

LineItemBudgetAllocationType

Możliwe typy alokacji budżetu.

Wartości w polu enum
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNSPECIFIED Wartość typu nie została określona lub jest nieznana w tej wersji.
LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC Automatyczne przydzielanie budżetu jest włączone dla elementu zamówienia.
LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED Na element 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 określające sposób obliczania przychodów partnera.

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

enum (PartnerRevenueModelMarkupType)

Wymagany. Typ marży w modelu rozliczeniowym partnera.
markupAmount

string (int64 format)

Wymagany. Kwota marży w modelu rozliczeniowym partnera. Musi być większa od lub równa 0.

  • Gdy wartość parametru markupType wynosi PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM, to pole reprezentuje marżę CPM w mikronach waluty reklamodawcy. Na przykład 1500000 reprezentuje 1, 5 standardowej jednostki waluty.
  • Gdy wartość markupType jest ustawiona na PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP, to pole reprezentuje procentową marżę od kosztu mediów w milisekundach. Na przykład wartość 100 oznacza 0,1% (dziesiętne 0,001).
  • Gdy parametr markupType ma wartość PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP, to pole reprezentuje procent marży od całkowitego kosztu mediów w milisekundach. Na przykład wartość 100 oznacza 0,1% (dziesiętne 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 została 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 łącznego kosztu mediów, który obejmuje wszystkie koszty partnera i danych.

ConversionCountingConfig

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

Wszystkie konwersje po kliknięciu będą zliczane. W przypadku zliczania konwersji po obejrzeniu można ustawić wartość procentową.

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

string (int64 format)

Odsetek konwersji po obejrzeniu, który ma być uwzględniony w raportach, w milisekundach (1/1000 % wartości). Musi mieścić się w zakresie od 0 do 100 000 włącznie.

Jeśli np. chcesz ś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 podane w tym polu.

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)

Wymagany. Identyfikator aktywności Floodlight.
postClickLookbackWindowDays

integer

Wymagany. Liczba dni po kliknięciu reklamy, w których może zostać zliczana konwersja. Musi mieścić się w zakresie od 0 do 90.
postViewLookbackWindowDays

integer

Wymagany. Liczba dni po obejrzeniu reklamy, w których może zostać zliczana konwersja. Musi mieścić się w zakresie od 0 do 90.

LineItemWarningMessage

komunikaty ostrzegawcze wygenerowane przez element zamówienia. Tego typu ostrzeżenia nie blokują zapisywania elementu zamówienia, ale mogą uniemożliwić jego wyświetlanie.

Wartości w polu enum
LINE_ITEM_WARNING_MESSAGE_UNSPECIFIED Nieokreślony lub nieznany.
INVALID_FLIGHT_DATES Ten element zamówienia ma nieprawidłowe daty wyświetlania reklam. Element zamówienia nie będzie się wyświetlać.
EXPIRED Data zakończenia tego elementu zamówienia przypada w przeszłości.
PENDING_FLIGHT Realizacja tego elementu zamówienia rozpocznie się 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 się wyświetlać.
INVALID_INVENTORY_SOURCE Nie masz ustawionego kierowania na żadne aktywne źródło zasobów reklamowych. Element zamówienia nie będzie się wyświetlać.
APP_INVENTORY_INVALID_SITE_TARGETING Ustawienia kierowania na aplikacje i adresy URL tego elementu zamówienia nie obejmują żadnych aplikacji mobilnych. Ten typ elementu zamówienia wymaga uwzględnienia aplikacji mobilnych w ustawieniach kierowania na kanał, listę witryn lub aplikacje. Element zamówienia nie będzie się wyświetlać.
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 ustawienia kierowania na listę użytkowników urządzeń mobilnych. Element zamówienia nie będzie się wyświetlać.
NO_VALID_CREATIVE Ten element zamówienia nie zawiera żadnych prawidłowych kreacji. Element zamówienia nie będzie się wyświetlać.
PARENT_INSERTION_ORDER_PAUSED Zamówienie reklamowe tego elementu zamówienia jest wstrzymane. Element zamówienia nie będzie się wyświetlać.
PARENT_INSERTION_ORDER_EXPIRED Zamówienie reklamowe tego elementu zamówienia ma datę zakończenia w przeszłości. Element zamówienia nie będzie się wyświetlać.

MobileApp

Aplikacja mobilna promowana za pomocą elementu zamówienia promującego instalację aplikacji mobilnej.

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

string

Wymagany. Identyfikator aplikacji dostarczony przez sklep na platformie.

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

Aplikacje na iOS są identyfikowane za pomocą 9-cyfrowego identyfikatora używanego przez Apple App Store, 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 Nie określono platformy.
IOS platformy iOS;
ANDROID platforma Androida,

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,
  "relatedVideoIds": [
    string
  ],
  "leadFormId": string,
  "videoAdSequenceSettings": {
    object (VideoAdSequenceSettings)
  }
}
Pola
viewFrequencyCap

object (FrequencyCap)

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

Jeśli przypisujesz ograniczoną liczbę wyświetleń, 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 określające, na jakie zasoby reklamowe YouTube i partnerów będzie kierowany element zamówienia.
contentCategory

enum (YoutubeAndPartnersContentCategory)

Rodzaj treści, w których będą wyświetlane reklamy YouTube i partnerów.
effectiveContentCategory

enum (YoutubeAndPartnersContentCategory)

Tylko dane wyjściowe. Kategoria treści, która ma zastosowanie 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 restrykcyjna kategoria.
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 sprzedawcy powiązany z elementem zamówienia w pliku danych o produktach.
relatedVideoIds[]

string

Opcjonalnie: Identyfikatory filmów wyświetlają się pod główną reklamą wideo, która jest odtwarzana w aplikacji YouTube na urządzeniach mobilnych.
leadFormId

string (int64 format)

Opcjonalnie: Identyfikator formularza służącego do zdobywania potencjalnych klientów.
videoAdSequenceSettings

object (VideoAdSequenceSettings)

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

ThirdPartyMeasurementConfigs

Ustawienia określające, jakie dane o elementach zamówienia są mierzone przez dostawców zewnętrznych.

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

object (ThirdPartyVendorConfig)

Opcjonalnie: Dostawcy zewnętrzni, którzy mierzą widoczność.

Dotyczy to 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: Dostawcy zewnętrzni, którzy mierzą bezpieczeństwo marki.

Dotyczy to tych zewnętrznych dostawców:

  • THIRD_PARTY_VENDOR_ZERF
  • THIRD_PARTY_VENDOR_DOUBLE_VERIFY
  • THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE
reachVendorConfigs[]

object (ThirdPartyVendorConfig)

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

Dotyczy to tych zewnętrznych dostawców:

  • THIRD_PARTY_VENDOR_NIELSEN
  • THIRD_PARTY_VENDOR_COMSCORE
  • THIRD_PARTY_VENDOR_KANTAR
brandLiftVendorConfigs[]

object (ThirdPartyVendorConfig)

Opcjonalnie: Dostawcy zewnętrzni, którzy mierzą wyniki marki.

Dotyczy to tych zewnętrznych dostawców:

  • THIRD_PARTY_VENDOR_DYNATA
  • THIRD_PARTY_VENDOR_KANTAR

ThirdPartyVendorConfig

Ustawienia określające sposób konfiguracji zewnętrznych dostawców 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ą pomiary zewnętrzne.

Wartości w polu enum
THIRD_PARTY_VENDOR_UNSPECIFIED Nieznany dostawca zewnętrzny.
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 Telemetria.
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.

YoutubeAndPartnersInventorySourceConfig

Ustawienia określające, jakie zasoby reklamowe związane z YouTube będą objęte kierowaniem elementu 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 chcesz kierować reklamy na zasoby reklamowe w YouTube. Dotyczy to wyszukiwarki, kanałów i filmów.
includeGoogleTv

boolean

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

boolean

Określ, czy chcesz kierować reklamy na zasoby reklamowe w zbiorze witryn i aplikacji partnerów, które przestrzegają tych samych norm bezpieczeństwa marki co YouTube.

YoutubeAndPartnersContentCategory

Kategorie bezpieczeństwa marki w przypadku treści w YouTube i od partnerów.

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ą zgodne z wytycznymi 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 w zakresie niewłaściwego języka i podtekstu seksualnego.

TargetFrequency

Ustawienie określające średnią liczbę wyświetleń reklam tej samej osobie w określonym przedziale czasu.

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 wartości timeUnit i timeUnitCount.
timeUnit

enum (TimeUnit)

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

Obowiązuje ta jednostka czasu:

  • TIME_UNIT_WEEKS
timeUnitCount

integer

Liczba timeUnit, przez którą będzie trwała docelowa częstotliwość.

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

  • TIME_UNIT_WEEKS – musi być 1

VideoAdSequenceSettings

Ustawienia związane z elementem VideoAdSequence.

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

enum (VideoAdSequenceMinimumDuration)

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

object (VideoAdSequenceStep)

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

VideoAdSequenceMinimumDuration

Wyliczenie możliwego minimalnego odstępu czasowego przed ponownym wyświetleniem sekwencji VideoAdSequence temu samemu użytkownikowi.

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 etapu 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 odpowiedniej grupy reklam kroku.
previousStepId

string (int64 format)

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

enum (InteractionType)

Interakcja z poprzedniego kroku, która doprowadzi widza do tego kroku. Pierwszy krok nie ma atrybutu interactionType.

InteractionType

Typy interakcji na kroku.

Wartości w polu enum
INTERACTION_TYPE_UNSPECIFIED Nieokreślony lub nieznany
INTERACTION_TYPE_PAID_VIEW Wyświetlenie płatne.
INTERACTION_TYPE_SKIP Pominięcie przez widza.
INTERACTION_TYPE_IMPRESSION Wyświetlenie reklamy (po jej wyświetleniu).
INTERACTION_TYPE_ENGAGED_IMPRESSION Wyświetlenie reklamy, które nie zostało natychmiast pominięte przez widza, ale też nie doprowadziło do zdarzenia naliczalnego.

Metody

bulkEditAssignedTargetingOptions

 Zbiorcze edytowanie opcji kierowania w większej liczbie elementów zamówienia.

bulkListAssignedTargetingOptions

 Wyświetla przypisane opcje kierowania w różnych elementach zamówienia w różnych typach kierowania.

bulkUpdate

 Zaktualizuje wiele elementów zamówienia.

create

 Tworzy nowy element zamówienia.

delete

 Usuwa element zamówienia.

duplicate

 Duplikuje element zamówienia.

generateDefault

 Tworzy nowy element zamówienia z ustawieniami (w tym kierowaniem) dziedziczonymi z zamówienia reklamowego i ENTITY_STATUS_DRAFT entity_status.

get

 Pobiera element zamówienia.

list

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

patch

 Aktualizuje dotychczasowy element zamówienia.