- Zasób: LineItem
- LineItemType
- LineItemFlight
- LineItemFlightDateType
- LineItemBudget
- LineItemBudgetAllocationType
- PartnerRevenueModel,
- PartnerRevenueModelMarkupType
- ConversionCountingConfig
- TrackingFloodlightActivityConfig
- LineItemWarningMessage
- MobileApp
- Platform
- YoutubeAndPartnersSettings
- ThirdPartyMeasurementConfigs
- ThirdPartyVendorConfig (Konfiguracja firmy zewnętrznej)
- ThirdPartyVendor
- YoutubeAndPartnersInventorySourceConfig
- YoutubeAndPartnersContentCategory
- TargetFrequency
- VideoAdSequenceSettings
- VideoAdSequenceMinimumDuration
- VideoAdSequenceStep
- InteractionType
- Metody
Zasób: LineItem
Jeden element zamówienia.
Zapis JSON |
---|
{ "name": string, "advertiserId": string, "campaignId": string, "insertionOrderId": string, "lineItemId": string, "displayName": string, "lineItemType": enum ( |
Pola | |
---|---|
name |
Tylko dane wyjściowe. Nazwa zasobu elementu zamówienia. |
advertiserId |
Tylko dane wyjściowe. Unikalny identyfikator reklamodawcy, do którego należy element zamówienia. |
campaignId |
Tylko dane wyjściowe. Unikalny identyfikator kampanii, do której należy element zamówienia. |
insertionOrderId |
To pole jest wymagane. Stałe. Unikalny identyfikator zamówienia reklamowego, do którego należy element zamówienia. |
lineItemId |
Tylko dane wyjściowe. Unikalny identyfikator elementu zamówienia. Przypisana przez system. |
displayName |
To pole jest wymagane. Wyświetlana nazwa elementu zamówienia. Musi być zakodowany w formacie UTF-8 o maksymalnym rozmiarze 240 bajtów. |
lineItemType |
To pole jest wymagane. Stałe. Typ elementu zamówienia. |
entityStatus |
To pole jest wymagane. Określa, czy element zamówienia może wydawać budżet i ustalać stawki za zasoby reklamowe.
|
updateTime |
Tylko dane wyjściowe. Sygnatura czasowa ostatniej aktualizacji elementu zamówienia. Przypisana przez system. Sygnatura czasowa w formacie „Zulu” RFC3339 UTC z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: |
partnerCosts[] |
Koszty partnera powiązane z elementem zamówienia. Jeśli w metodzie |
flight |
To pole jest wymagane. Godzina rozpoczęcia i zakończenia okresu wyświetlania elementu zamówienia. |
budget |
To pole jest wymagane. Ustawienie alokacji budżetu elementu zamówienia. |
pacing |
To pole jest wymagane. Ustawienie szybkości wykorzystywania środków przez budżet elementu zamówienia. |
frequencyCap |
To pole jest wymagane. Ustawienia limitu wyświetleń na użytkownika ustawionego w elemencie zamówienia. Aby przypisać ograniczony limit, należy użyć pola |
partnerRevenueModel |
To pole jest wymagane. Ustawienie modelu rozliczeniowego partnera powiązanego z elementem zamówienia. |
conversionCounting |
Ustawienie śledzenia konwersji elementu zamówienia. |
creativeIds[] |
Identyfikatory kreacji powiązanych z elementem zamówienia. |
bidStrategy |
To pole jest wymagane. Strategia ustalania stawek powiązana z elementem zamówienia. |
integrationDetails |
Szczegóły integracji elementu zamówienia. |
targetingExpansion |
Ustawienia kierowania zoptymalizowanego elementu zamówienia. Ta konfiguracja dotyczy tylko displayowych elementów zamówienia oraz elementów zamówienia wideo i audio, które korzystają z automatycznego określania stawek i kierują reklamy na odpowiednie listy odbiorców. |
warningMessages[] |
Tylko dane wyjściowe. Komunikaty ostrzegawcze wygenerowane przez element zamówienia. Ostrzeżenia te nie blokują zapisywania elementu zamówienia, ale niektóre z nich mogą zablokować jego realizację. |
mobileApp |
Aplikacja mobilna promowana w elemencie zamówienia. Ma to zastosowanie tylko wtedy, gdy |
reservationType |
Tylko dane wyjściowe. Typ rezerwacji elementu zamówienia. |
excludeNewExchanges |
Określa, czy nowe giełdy mają być wykluczone z automatycznego kierowania elementu zamówienia. To pole domyślnie ma wartość Fałsz. |
youtubeAndPartnersSettings |
Tylko dane wyjściowe. Ustawienia specyficzne dla elementów zamówienia typu YouTube i sieć partnerów wideo Google. |
LineItemType
Możliwe typy elementu zamówienia.
Typ elementu zamówienia określa, które ustawienia i opcje, takie jak format reklam czy opcje kierowania, są odpowiednie.
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 ustawień kierowania nie można tworzyć ani aktualizować za pomocą interfejsu API. |
LINE_ITEM_TYPE_DISPLAY_DEFAULT |
Reklamy graficzne, HTML5, natywne lub rich media. |
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL |
Reklamy displayowe, które zachęcają do 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, które zachęcają do instalacji aplikacji. |
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INVENTORY |
Reklamy displayowe wyświetlane w zasobach reklamowych w aplikacjach mobilnych. Elementów zamówienia tego typu i ich ustawień 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 w aplikacjach mobilnych. Elementów zamówienia tego typu i ich ustawień kierowania nie można tworzyć ani aktualizować za pomocą interfejsu API. |
LINE_ITEM_TYPE_AUDIO_DEFAULT |
Reklamy audio RTB sprzedawane do różnych środowisk. |
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 ustawień 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 ustawień kierowania nie można tworzyć ani aktualizować za pomocą interfejsu API. |
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE |
Reklamy wideo w YouTube prezentujące sekwencje w określonej kolejności za pomocą różnych formatów. Elementów zamówienia tego typu i ich ustawień 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 ustawień 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ą 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 kombinację różnych typów. Elementów zamówienia tego typu i ich ustawień 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 ustawień 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ądzenia CTV (do 15 sekund), których nie można pominąć. Elementów zamówienia tego typu i ich ustawień 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ą 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 kombinację różnych typów. Elementów zamówienia tego typu i ich ustawień 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ądzenia CTV. Uwzględnij tylko reklamy w formacie In-Stream. Elementów zamówienia tego typu i ich ustawień 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 tej samej osobie docelowej liczby reklam w YouTube w określonym przedziale czasu. Elementów zamówienia tego typu i ich ustawień kierowania nie można tworzyć ani aktualizować za pomocą interfejsu API. |
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW |
reklamy wideo w YouTube, które mają na celu zwiększenie liczby obejrzeń za pomocą różnych formatów reklam; Elementów zamówienia tego typu i ich ustawień 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 ustawień 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 ustawień kierowania nie można tworzyć ani aktualizować za pomocą interfejsu API. |
LineItemFlight
Ustawienia, które kontrolują aktywny czas trwania elementu zamówienia.
Zapis JSON |
---|
{ "flightDateType": enum ( |
Pola | |
---|---|
flightDateType |
To pole jest wymagane. Typ dat wyświetlania elementu zamówienia. |
dateRange |
Daty rozpoczęcia i zakończenia wyświetlania reklam z elementu zamówienia. Rozwiązuje się je w zależności od strefy czasowej reklamodawcy nadrzędnego.
|
LineItemFlightDateType
Możliwe typy dat wyświetlania reklam 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 reklam z elementu zamówienia są dziedziczone z jego 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 ( |
Pola | |
---|---|
budgetAllocationType |
To pole jest wymagane. Typ przydziału budżetu. Typ |
budgetUnit |
Tylko dane wyjściowe. Jednostka budżetu określa, czy budżet zależy od waluty, czy od wyświetleń. Ta wartość jest dziedziczona z nadrzędnego zamówienia reklamowego. |
maxAmount |
Maksymalna kwota budżetu, jaką wydaje element zamówienia. Musi być większy niż 0. Gdy
|
LineItemBudgetAllocationType
Możliwe typy przydziału 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 elemencie zamówienia włączono automatyczne przydzielanie budżetu. |
LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED |
Do elementu zamówienia jest przydzielana 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 ( |
Pola | |
---|---|
markupType |
To pole jest wymagane. Typ marży w modelu rozliczeniowym partnera. |
markupAmount |
To pole jest wymagane. Kwota marży według modelu rozliczeniowego partnera. Wartość nie może być mniejsza niż 0.
|
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 dopłaty z kosztu mediów. |
PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP |
Oblicz przychody partnera na podstawie dopłaty procentowej od całkowitego kosztu mediów, która obejmuje wszystkie koszty partnera i koszty danych. |
ConversionCountingConfig
Ustawienia określające sposób zliczania konwersji.
Zliczane będą wszystkie konwersje po kliknięciu. W przypadku zliczania konwersji po obejrzeniu można ustawić wartość procentową.
Zapis JSON |
---|
{
"postViewCountPercentageMillis": string,
"floodlightActivityConfigs": [
{
object ( |
Pola | |
---|---|
postViewCountPercentageMillis |
Procent konwersji po obejrzeniu do zliczenia w milisekundach (1/1000 procenta). Musi mieścić się w zakresie od 0 do 100 000 włącznie. Aby np. śledzić 50% konwersji po kliknięciu, ustaw wartość 50 000. |
floodlightActivityConfigs[] |
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. |
TrackingFloodlightActivityConfig
Ustawienia, które kontrolują zachowanie pojedynczej konfiguracji aktywności Floodlight.
Zapis JSON |
---|
{ "floodlightActivityId": string, "postClickLookbackWindowDays": integer, "postViewLookbackWindowDays": integer } |
Pola | |
---|---|
floodlightActivityId |
To pole jest wymagane. Identyfikator aktywności Floodlight. |
postClickLookbackWindowDays |
To pole jest wymagane. Liczba dni po kliknięciu reklamy, w których może zostać zaliczona konwersja. Wartość musi mieścić się w przedziale od 0 do 90 włącznie. |
postViewLookbackWindowDays |
To pole jest wymagane. Liczba dni po wyświetleniu reklamy, w których może zostać zaliczona konwersja. Wartość musi mieścić się w przedziale od 0 do 90 włącznie. |
LineItemWarningMessage
Komunikaty ostrzegawcze wygenerowane przez element zamówienia. Ostrzeżenia tego typu nie blokują zapisywania elementu zamówienia, ale mogą zablokować jego realizację.
Wartości w polu enum | |
---|---|
LINE_ITEM_WARNING_MESSAGE_UNSPECIFIED |
Nie określono lub jest nieznany. |
INVALID_FLIGHT_DATES |
Ten element zamówienia ma nieprawidłowe daty wyświetlania reklam. Element zamówienia nie będzie wyświetlany. |
EXPIRED |
Data zakończenia tego elementu zamówienia już minęła. |
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 wyświetlany. |
INVALID_INVENTORY_SOURCE |
Nie masz ustawionego kierowania na żadne aktywne źródło zasobów reklamowych. Element zamówienia nie będzie wyświetlany. |
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 wyświetlany. |
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 obejmującą użytkowników urządzeń mobilnych. Element zamówienia nie będzie wyświetlany. |
NO_VALID_CREATIVE |
Ten element zamówienia nie zawiera żadnej prawidłowej kreacji. Element zamówienia nie będzie wyświetlany. |
PARENT_INSERTION_ORDER_PAUSED |
Zamówienie reklamowe tego elementu zamówienia jest wstrzymane. Element zamówienia nie będzie wyświetlany. |
PARENT_INSERTION_ORDER_EXPIRED |
Zamówienie reklamowe powiązane z tym elementem zamówienia ma datę zakończenia w przeszłości. Element zamówienia nie będzie wyświetlany. |
MobileApp
Aplikacja mobilna promowana przez element zamówienia promujący instalacje aplikacji mobilnej.
Zapis JSON |
---|
{
"appId": string,
"platform": enum ( |
Pola | |
---|---|
appId |
To pole jest wymagane. Identyfikator aplikacji udostępniany przez sklep na platformie. Aplikacje na Androida są rozpoznawane na podstawie identyfikatora pakietu używanego w Sklepie Play na Androida (np. Aplikacje na iOS są identyfikowane na podstawie dziewięciocyfrowego identyfikatora używanego przez sklep Apple App Store, np. |
platform |
Tylko dane wyjściowe. Platforma aplikacji. |
displayName |
Tylko dane wyjściowe. Nazwa aplikacji. |
publisher |
Tylko dane wyjściowe. Wydawca aplikacji. |
Platforma
Możliwe platformy aplikacji mobilnych.
Wartości w polu enum | |
---|---|
PLATFORM_UNSPECIFIED |
Nie określono platformy. |
IOS |
platformie iOS. |
ANDROID |
Android. |
YoutubeAndPartnersSettings
Ustawienia elementów zamówienia typu YouTube i sieć partnerów wideo Google.
Zapis JSON |
---|
{ "viewFrequencyCap": { object ( |
Pola | |
---|---|
viewFrequencyCap |
Ustawienia limitu wyświetleń na użytkownika przypisanego do elementu zamówienia. Aby przypisać ograniczony limit, należy użyć pola |
thirdPartyMeasurementConfigs |
Opcjonalnie. Zewnętrzne konfiguracje pomiarowe elementu zamówienia. |
inventorySourceSettings |
Ustawienia określające, na jakie zasoby reklamowe YouTube i sieć partnerów wideo Google będzie kierowany element zamówienia. |
contentCategory |
Rodzaj treści, w których będą wyświetlane reklamy YouTube i sieci partnerów wideo Google. |
effectiveContentCategory |
Tylko dane wyjściowe. Kategoria treści obowiązująca podczas wyświetlania elementu zamówienia. Jeśli ustawisz kategorię treści zarówno na poziomie elementu zamówienia, jak i reklamodawcy, podczas wyświetlania elementu zamówienia zostanie zastosowana bardziej rygorystyczna kategoria. |
targetFrequency |
Średnia liczba wyświetleń reklam z tego elementu zamówienia tej samej osobie w określonym czasie. |
linkedMerchantId |
Identyfikator sprzedawcy połączonego z elementem zamówienia w pliku danych o produktach. |
relatedVideoIds[] |
Identyfikatory filmów są widoczne pod główną reklamą wideo, która jest odtwarzana w aplikacji YouTube na urządzeniach mobilnych. |
leadFormId |
Identyfikator formularza służącego do pozyskiwania potencjalnych klientów. |
videoAdSequenceSettings |
Ustawienia związane z VideoAdSequence. |
ThirdPartyMeasurementConfigs
Ustawienia określające, jakie dane dostawców zewnętrznych mierzą określone dane elementu zamówienia.
Zapis JSON |
---|
{ "viewabilityVendorConfigs": [ { object ( |
Pola | |
---|---|
viewabilityVendorConfigs[] |
Opcjonalnie. Dostawcy zewnętrzni do pomiaru widoczności. Usługa obejmuje tych dostawców zewnętrznych:
|
brandSafetyVendorConfigs[] |
Opcjonalnie. Dostawcy zewnętrzni do pomiaru bezpieczeństwa marki. Usługa obejmuje tych dostawców zewnętrznych:
|
reachVendorConfigs[] |
Opcjonalnie. Zewnętrzni dostawcy narzędzi do pomiaru zasięgu. Usługa obejmuje tych dostawców zewnętrznych:
|
brandLiftVendorConfigs[] |
Opcjonalnie. Dostawcy zewnętrzni do pomiaru wyników marki. Usługa obejmuje tych dostawców zewnętrznych:
|
ThirdPartyVendorConfig
Ustawienia określające sposób konfigurowania zewnętrznych dostawców usług pomiarowych.
Zapis JSON |
---|
{
"vendor": enum ( |
Pola | |
---|---|
vendor |
Zewnętrzny dostawca usług pomiarowych. |
placementId |
Identyfikator używany przez platformę dostawcy zewnętrznego do identyfikowania elementu zamówienia. |
ThirdPartyVendor
Dostawcy, którzy oferują zewnętrzne usługi pomiarowe.
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 |
Dane telemetryczne. |
THIRD_PARTY_VENDOR_MEETRICS |
Meetrics |
THIRD_PARTY_VENDOR_ZEFR |
ZEFR. |
THIRD_PARTY_VENDOR_NIELSEN |
firmy Nielsen. |
THIRD_PARTY_VENDOR_KANTAR |
Kantar |
THIRD_PARTY_VENDOR_DYNATA |
Dynata. |
YoutubeAndPartnersInventorySourceConfig
Ustawienia, które określają, na jakie zasoby reklamowe YouTube i jakie zasoby reklamowe w YouTube będą kierowane element zamówienia typu YouTube i sieć partnerów wideo Google.
Zapis JSON |
---|
{ "includeYoutube": boolean, "includeGoogleTv": boolean, "includeYoutubeVideoPartners": boolean } |
Pola | |
---|---|
includeYoutube |
Opcjonalnie. Określa, czy reklamy mają być kierowane na zasoby reklamowe w YouTube. Dotyczy to zarówno wyników wyszukiwania, jak i kanałów oraz filmów. |
includeGoogleTv |
Opcjonalnie. Określa, czy ustawić kierowanie na zasoby reklamowe w aplikacjach wideo dostępnych w Google TV. |
includeYoutubeVideoPartners |
Określa, czy ustawić kierowanie na zasoby reklamowe w kolekcji witryn i aplikacji partnerów, które przestrzegają tych samych standardów bezpieczeństwa marki co YouTube. |
YoutubeAndPartnersContentCategory
Kategorie bezpieczeństwa marki w treściach dostępnych 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ść opiera się na 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óra spełnia 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 niestosownego języka i podtekstów seksualnych. |
TargetFrequency
Ustawienie, które określa średnią liczbę wyświetleń reklamy tej samej osobie w określonym czasie.
Zapis JSON |
---|
{
"targetCount": string,
"timeUnit": enum ( |
Pola | |
---|---|
targetCount |
Docelowa liczba wyświetleń reklam tej samej osobie w okresie określonym przez |
timeUnit |
Jednostka czasu, w której zostanie zastosowana docelowa częstotliwość. Obowiązuje ta jednostka czasu:
|
timeUnitCount |
Ostatnia wartość w kolumnie W zależności od wartości atrybutu
|
VideoAdSequenceSettings
Ustawienia związane z VideoAdSequence.
Zapis JSON |
---|
{ "minimumDuration": enum ( |
Pola | |
---|---|
minimumDuration |
Minimalny odstęp czasu, po którego upływie ten sam użytkownik zobaczy tę sekwencję ponownie. |
steps[] |
Kroki, z których składa się sekwencja. |
VideoAdSequenceMinimumDuration
Wyliczenie możliwego minimalnego czasu interwału, zanim ten sam użytkownik zobaczy ponownie VideoAdSequence.
Wartości w polu enum | |
---|---|
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_UNSPECIFIED |
Nieokreślone lub nieznane. |
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_WEEK |
7 dni. |
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_MONTH |
30 dni. |
VideoAdSequenceStep
Szczegół pojedynczego kroku w elemencie VideoAdSequence.
Zapis JSON |
---|
{
"stepId": string,
"adGroupId": string,
"previousStepId": string,
"interactionType": enum ( |
Pola | |
---|---|
stepId |
Identyfikator kroku. |
adGroupId |
Identyfikator odpowiedniej grupy reklam odpowiadającej danemu krokowi. |
previousStepId |
Identyfikator poprzedniego kroku. Pierwszy krok nie zawiera poprzedniego kroku. |
interactionType |
Interakcja z poprzedniego kroku, która doprowadzi widza do tego kroku. Pierwszy krok nie ma przypisanego typu interakcyjności. |
InteractionType
Typy interakcji na etapie.
Wartości w polu enum | |
---|---|
INTERACTION_TYPE_UNSPECIFIED |
Nieokreślone lub nieznane |
INTERACTION_TYPE_PAID_VIEW |
Płatne wyświetlenie. |
INTERACTION_TYPE_SKIP |
Pominięte przez widza. |
INTERACTION_TYPE_IMPRESSION |
Obejrzenie reklamy. |
INTERACTION_TYPE_ENGAGED_IMPRESSION |
Wyświetlenie reklamy, które nie zostało od razu pominięte przez użytkownika, ale nie nastąpiło też w związku ze zdarzeniem podlegającym rozliczeniu. |
Metody |
|
---|---|
|
Zbiorcze edytowanie opcji kierowania w wielu elementach zamówienia. |
|
Wyświetla listę opcji kierowania przypisanych do wielu elementów zamówienia w różnych typach kierowania. |
|
Aktualizuje wiele elementów zamówienia. |
|
Tworzy nowy element zamówienia. |
|
Usuwa element zamówienia. |
|
Powiela element zamówienia. |
|
Tworzy nowy element zamówienia z ustawieniami (w tym kierowaniem) odziedziczonymi z zamówienia reklamowego i entity_status (ENTITY_STATUS_DRAFT ). |
|
Pobiera element zamówienia. |
|
Wyświetla listę elementów zamówienia we właściwościach reklamodawcy. |
|
Aktualizuje istniejący element zamówienia. |