REST Resource: advertisers.lineItems

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

string

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

Wymagane. Stały. Unikalny identyfikator zamówienia reklamowego, do którego należy element zamówienia.

string (int64 format)

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

string

Wymagane. Wyświetlana nazwa elementu zamówienia.

Musi być zakodowany w standardzie UTF-8 i maksymalnym rozmiarze 240 bajtów.

enum (LineItemType)

Wymagane. Stały. Typ elementu zamówienia.

enum (EntityStatus)

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

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

string (Timestamp format)

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

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

object (PartnerCost)

Koszty partnera powiązane z elementem zamówienia.

Jeśli nie ma podanej wartości lub jest pusta w metodzie lineItems.create, nowo utworzony element zamówienia odziedziczy koszty partnera z nadrzędnego zamówienia reklamowego.

object (LineItemFlight)

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

object (LineItemBudget)

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

object (Pacing)

Wymagane. Ustawienie szybkości wydawania budżetu przez element zamówienia.

object (FrequencyCap)

Wymagane. Ustawienia limitu wyświetleń na użytkownika w elemencie zamówienia.

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

object (PartnerRevenueModel)

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

object (ConversionCountingConfig)

Ustawienie śledzenia konwersji elementu zamówienia.

string (int64 format)

Identyfikatory kreacji powiązanych z elementem zamówienia.

object (BiddingStrategy)

Wymagane. Strategia ustalania stawek elementu zamówienia.

object (IntegrationDetails)

Szczegóły integracji elementu zamówienia.

object (TargetingExpansionConfig)

Ustawienia kierowania zoptymalizowanego elementu zamówienia.

Ta konfiguracja ma zastosowanie tylko w przypadku elementów zamówienia typu displayowego, wideo lub audio, które korzystają z automatycznego określania stawek i kierują reklamy na odpowiednie listy odbiorców.

enum (LineItemWarningMessage)

Tylko dane wyjściowe. Komunikaty ostrzegawcze generowane przez element zamówienia. Te ostrzeżenia nie blokują zapisywania elementu zamówienia, ale niektóre z nich mogą zablokować jego realizowanie.

object (MobileApp)

Aplikacja mobilna promowana przez element zamówienia.

Ma to zastosowanie tylko wtedy, gdy lineItemType to LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL lub LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL.

enum (ReservationType)

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

boolean

Określa, czy wykluczyć nowe giełdy z automatycznego kierowania elementu zamówienia. Domyślnie to pole ma wartość false (fałsz).

object (YoutubeAndPartnersSettings)

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

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

enum (LineItemFlightDateType)

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

object (DateRange)

Daty rozpoczęcia i zakończenia wyświetlania elementu zamówienia. Są one ustalane według strefy czasowej reklamodawcy nadrzędnego.

• Wymagany, gdy flightDateType to LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM. W przeciwnym wypadku dane wyjściowe będą inne.
• Gdy tworzysz nowy okres wyświetlania, zarówno startDate, jak i endDate muszą być w przyszłości.
• Istniejący lot z startDate w przeszłości ma zmienny element endDate, ale stały startDate.
• endDate musi być datą startDate lub późniejszą, zarówno przed rokiem 2037, jak i nowszy.

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

enum (LineItemBudgetAllocationType)

Wymagane. Typ przydziału budżetu.

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

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.

string (int64 format)

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

Gdy budgetAllocationType to:

• LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC, tego pola nie można zmienić i jest ustawiane przez system.
• LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED, jeśli budgetUnit to:
  • BUDGET_UNIT_CURRENCY, to pole przedstawia maksymalną kwotę budżetu do wydania w mikro waluty reklamodawcy. Na przykład 1500000 oznacza 1, 5 standardowej jednostki waluty.
  • BUDGET_UNIT_IMPRESSIONS, to pole zawiera maksymalną liczbę wyświetleń.
• LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED, to pole nie ma zastosowania i będzie ignorowane przez system.

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

enum (PartnerRevenueModelMarkupType)

Wymagane. Rodzaj marży w modelu rozliczeniowym partnera.

string (int64 format)

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

• Jeśli pole markupType ma wartość PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM, to pole przedstawia marżę CPM w mikrosekundach waluty reklamodawcy. Na przykład 1500000 oznacza 1, 5 standardowej jednostki waluty.
• Jeśli pole markupType ma wartość PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP, to pole przedstawia marżę procentową kosztu mediów w milisekundach. Na przykład 100 oznacza 0,1% (0,001 wartości dziesiętnej).
• Jeśli pole markupType ma wartość PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP, to pole przedstawia procent marży całkowitego kosztu mediów (ms). Na przykład 100 oznacza 0,1% (0,001 wartości dziesiętnej).

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

string (int64 format)

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

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.

{
  "floodlightActivityId": string,
  "postClickLookbackWindowDays": integer,
  "postViewLookbackWindowDays": integer
}

string (int64 format)

Wymagane. Identyfikator aktywności Floodlight.

integer

Wymagane. Liczba dni po kliknięciu reklamy, w których może zostać zliczona konwersja. Musi mieścić się w zakresie od 0 do 90 włącznie.

integer

Wymagane. Liczba dni od wyświetlenia reklamy, w których może zostać policzona konwersja. Musi mieścić się w zakresie od 0 do 90 włącznie.

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

string

Wymagane. Identyfikator aplikacji dostarczony przez sklep na platformie.

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

Aplikacje na iOS są identyfikowane na podstawie 9-cyfrowego identyfikatora aplikacji używanego przez sklep Apple App Store, np. 422689480.

enum (Platform)

Tylko dane wyjściowe. Platforma aplikacji.

string

Tylko dane wyjściowe. Nazwa aplikacji.

string

Tylko dane wyjściowe. Wydawca aplikacji.

{
  "biddingStrategy": {
    object (YoutubeAndPartnersBiddingStrategy)
  },
  "viewFrequencyCap": {
    object (FrequencyCap)
  },
  "thirdPartyMeasurementSettings": {
    object (YoutubeAndPartnersThirdPartyMeasurementSettings)
  },
  "inventorySourceSettings": {
    object (YoutubeAndPartnersInventorySourceConfig)
  },
  "contentCategory": enum (YoutubeAndPartnersContentCategory),
  "effectiveContentCategory": enum (YoutubeAndPartnersContentCategory),
  "targetFrequency": {
    object (TargetFrequency)
  },
  "linkedMerchantId": string,
  "relatedVideoIds": [
    string
  ],
  "leadFormId": string,
  "videoAdSequenceSettings": {
    object (VideoAdSequenceSettings)
  }
}

object (YoutubeAndPartnersBiddingStrategy)

Wymagane. Strategia ustalania stawek elementu zamówienia typu YouTube i sieć partnerów wideo Google.

object (FrequencyCap)

Wyświetl ustawienia limitu wyświetleń na użytkownika w przypadku elementu zamówienia.

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

object (YoutubeAndPartnersThirdPartyMeasurementSettings)

Opcjonalnie: Ustawienia zewnętrznych usług pomiaru elementu zamówienia.

object (YoutubeAndPartnersInventorySourceConfig)

Ustawienia określające, na jakie zasoby reklamowe YouTube i sieć partnerów wideo Google będzie kierowany element zamówienia.

enum (YoutubeAndPartnersContentCategory)

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

enum (YoutubeAndPartnersContentCategory)

Tylko dane wyjściowe. Kategoria treści, która ma zastosowanie podczas realizacji elementu zamówienia. Jeśli ustawisz kategorię treści zarówno w elemencie zamówienia, jak i u reklamodawcy, przy realizacji elementu zamówienia będzie stosowana ta bardziej rygorystyczna.

object (TargetFrequency)

Średnia liczba wyświetleń reklam z tego elementu zamówienia tej samej osobie w określonym przedziale czasu.

string (int64 format)

Identyfikator sprzedawcy powiązany z elementem zamówienia w pliku danych o produktach.

string

Identyfikatory filmów są wyświetlane pod główną reklamą wideo, gdy reklama jest odtwarzana w aplikacji YouTube na urządzeniach mobilnych.

string (int64 format)

Identyfikator formularza służącego do pozyskiwania potencjalnych klientów.

object (VideoAdSequenceSettings)

Ustawienia związane z VideoAdSequence.

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

object (ThirdPartyVendorConfig)

Dostawcy zewnętrzni mierzą widoczność.

Korzystasz z tych dostawców zewnętrznych:

• 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

object (ThirdPartyVendorConfig)

Dostawcy zewnętrzni mierzą bezpieczeństwo marki.

Korzystasz z tych dostawców zewnętrznych:

• THIRD_PARTY_VENDOR_ZERF
• THIRD_PARTY_VENDOR_DOUBLE_VERIFY
• THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE

object (ThirdPartyVendorConfig)

Dostawcy zewnętrzni mierzący zasięg.

Korzystasz z tych dostawców zewnętrznych:

• THIRD_PARTY_VENDOR_NIELSEN
• THIRD_PARTY_VENDOR_COMSCORE
• THIRD_PARTY_VENDOR_KANTAR

object (ThirdPartyVendorConfig)

Dostawcy zewnętrzni mierzący wyniki marki.

Korzystasz z tych dostawców zewnętrznych:

• THIRD_PARTY_VENDOR_DYNATA
• THIRD_PARTY_VENDOR_KANTAR

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

enum (ThirdPartyVendor)

Zewnętrzny dostawca usług pomiarowych.

string

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

{
  "includeYoutubeSearch": boolean,
  "includeYoutubeVideos": boolean,
  "includeGoogleTv": boolean,
  "includeYoutubeVideoPartners": boolean
}

boolean

Określa, czy kierować reklamy na zasoby reklamowe na stronie wyników wyszukiwania w YouTube.

boolean

Określa, czy kierować reklamy na zasoby reklamowe na kanałach i filmach w YouTube oraz na filmy z YouTube umieszczone w innych witrynach.

boolean

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

boolean

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

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

string (int64 format)

Średnia docelowa liczba wyświetleń reklam tej samej osobie w przedziale czasu określonym przez zasady timeUnit i timeUnitCount.

enum (TimeUnit)

Jednostka czasu, w której zostanie zastosowana docelowa częstotliwość.

Obowiązuje ta jednostka czasu:

• TIME_UNIT_WEEKS

integer

Liczba wartości w kolumnie timeUnit, która będzie utrzymywać docelową częstotliwość.

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

• TIME_UNIT_WEEKS – musi wynosić 1

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

enum (VideoAdSequenceMinimumDuration)

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

object (VideoAdSequenceStep)

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

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

string (int64 format)

Identyfikator kroku.

string (int64 format)

Identyfikator odpowiedniej grupy reklam w danym kroku.

string (int64 format)

Identyfikator poprzedniego kroku. Pierwszy krok nie ma poprzedniego kroku.

enum (InteractionType)

Interakcja na poprzednim etapie, która doprowadzi widza do tego etapu. Pierwszy krok nie ma obiektu InteropType.