- Zasób: LineItem
 - LineItemType
 - LineItemFlight
 - LineItemFlightDateType
 - LineItemBudget
 - LineItemBudgetAllocationType
 - PartnerRevenueModel
 - PartnerRevenueModelMarkupType
 - ConversionCountingConfig
 - TrackingFloodlightActivityConfig
 - TargetingExpansionConfig
 - TargetingExpansionLevel
 - LineItemWarningMessage
 - MobileApp
 - Platform
 - 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 | 
                
                   
 Wymagane. Stały. 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 | 
                
                   
 Wymagane. Wyświetlana nazwa elementu zamówienia. Musi być zakodowany w standardzie UTF-8 i maksymalnym rozmiarze 240 bajtów.  | 
              
lineItemType | 
                
                   
 Wymagane. Stały. Typ elementu zamówienia.  | 
              
entityStatus | 
                
                   
 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 RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady:   | 
              
partnerCosts[] | 
                
                   
 Koszty partnera powiązane z elementem zamówienia. Jeśli nie ma podanej wartości lub jest pusta w metodzie   | 
              
flight | 
                
                   
 Wymagane. Czas rozpoczęcia i zakończenia okresu wyświetlania elementu zamówienia.  | 
              
budget | 
                
                   
 Wymagane. Ustawienie przydzielania budżetu elementu zamówienia.  | 
              
pacing | 
                
                   
 Wymagane. Ustawienie szybkości wydawania budżetu przez element zamówienia.  | 
              
frequencyCap | 
                
                   
 Wymagane. Ustawienia limitu wyświetleń na użytkownika w elemencie zamówienia. Jeśli przypisujesz ograniczony limit, musisz używać pola   | 
              
partnerRevenueModel | 
                
                   
 Wymagane. Ustawienie modelu rozliczeniowego partnera w elemencie zamówienia.  | 
              
conversionCounting | 
                
                   
 Ustawienie śledzenia konwersji elementu zamówienia.  | 
              
creativeIds[] | 
                
                   
 Identyfikatory kreacji powiązanych z elementem zamówienia.  | 
              
bidStrategy | 
                
                   
 Wymagane. Strategia ustalania stawek elementu zamówienia.  | 
              
integrationDetails | 
                
                   
 Szczegóły integracji elementu zamówienia.  | 
              
inventorySourceIds[] | 
                
                   
 Identyfikatory źródeł prywatnych zasobów reklamowych przypisanych do elementu zamówienia.  | 
              
targetingExpansion | 
                
                   
 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.  | 
              
warningMessages[] | 
                
                   
 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.  | 
              
mobileApp | 
                
                   
 Aplikacja mobilna promowana przez element zamówienia. Ma to zastosowanie tylko wtedy, gdy   | 
              
reservationType | 
                
                   
 Tylko dane wyjściowe. Typ rezerwacji elementu zamówienia.  | 
              
excludeNewExchanges | 
                
                   
 Określa, czy wykluczyć nowe giełdy z automatycznego kierowania elementu zamówienia. Domyślnie to pole ma wartość false (fałsz).  | 
              
LineItemType
Możliwe typy elementu zamówienia.
Typ elementu zamówienia określa, które ustawienia i opcje mają zastosowanie (np. format reklam czy 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 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 mają zachęcać do instalowania 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 instalowania 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 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 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 o wartości OVER_THE_TOP insertionOrderType. | 
              
LineItemFlight
Ustawienia, które określają czas trwania aktywności elementu zamówienia.
| Zapis JSON | 
|---|
{ "flightDateType": enum (  | 
              
| Pola | |
|---|---|
flightDateType | 
                
                   
 Wymagane. Typ dat wyświetlania elementu zamówienia.  | 
              
dateRange | 
                
                   
 Daty rozpoczęcia i zakończenia wyświetlania elementu zamówienia. Są one ustalane według strefy czasowej reklamodawcy nadrzędnego. 
  | 
              
triggerId | 
                
                   
 Identyfikator reguły ręcznej powiązanej z elementem zamówienia. 
 Ostrzeżenie: elementy zamówienia korzystające z reguł ręcznych nie wyświetlają już reklam w sieci reklamowej Film 360. To pole zostanie wycofane 1 sierpnia 2023 r. Aby dowiedzieć się więcej, przeczytaj ogłoszenie o wycofaniu funkcji.  | 
              
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 reklam elementu zamówienia są dziedziczone z nadrzędnego zamówienia reklamowego. | 
LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM | 
                Element zamówienia ma własne niestandardowe daty wyświetlania reklam. | 
LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER | 
                Element zamówienia używa reguły. Ostrzeżenie: elementy zamówienia korzystające z reguł ręcznych nie wyświetlają już reklam w sieci reklamowej Film 360. Ta wartość zostanie wycofana 1 sierpnia 2023 r. Aby dowiedzieć się więcej, przeczytaj ogłoszenie o wycofaniu funkcji.  | 
              
LineItemBudget
Ustawienia określające sposób przydzielania budżetu.
| Zapis JSON | 
|---|
{ "budgetAllocationType": enum (  | 
              
| Pola | |
|---|---|
budgetAllocationType | 
                
                   
 Wymagane. Typ przydziału budżetu. Kolumna   | 
              
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 | 
                
                   
 Maksymalna kwota budżetu, jaką będzie wydać 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 | 
                Automatyczne przydzielanie budżetu jest włączone w elemencie zamówienia. | 
LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED | 
                Do elementu zamówienia jest przydzielona stała maksymalna kwota budżetu. | 
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED | 
                Do elementu zamówienia nie ma zastosowania żaden limit budżetu. | 
PartnerRevenueModel
Ustawienia, które określają sposób obliczania przychodów partnera.
| Zapis JSON | 
|---|
{
  "markupType": enum ( | 
              
| Pola | |
|---|---|
markupType | 
                
                   
 Wymagane. Rodzaj marży w modelu rozliczeniowym partnera.  | 
              
markupAmount | 
                
                   
 Wymagane. Kwota marży w modelu rozliczeniowym 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 dopłaty procentowej od jego kosztu mediów.  | 
              
PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP | 
                Oblicz przychody partnera jako dopłatę procentową od jego całkowitego kosztu mediów, w tym wszystkie koszty partnera i dane. | 
ConversionCountingConfig
Ustawienia, które kontrolują sposób liczenia konwersji.
Zostaną zliczone wszystkie konwersje po kliknięciu. W przypadku zliczania konwersji po obejrzeniu można ustawić wartość procentową.
| Zapis JSON | 
|---|
{
  "postViewCountPercentageMillis": string,
  "floodlightActivityConfigs": [
    {
      object ( | 
              
| Pola | |
|---|---|
postViewCountPercentageMillis | 
                
                   
 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.  | 
              
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 | 
                
                   
 Wymagane. Identyfikator aktywności Floodlight.  | 
              
postClickLookbackWindowDays | 
                
                   
 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.  | 
              
postViewLookbackWindowDays | 
                
                   
 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.  | 
              
TargetingExpansionConfig
Ustawienia, które pozwalają zarządzać ustawieniami kierowania zoptymalizowanego elementu zamówienia.
| Zapis JSON | 
|---|
{
  "targetingExpansionLevel": enum ( | 
              
| Pola | |
|---|---|
targetingExpansionLevel | 
                
                   
 Wymagane. Określa, czy kierowanie zoptymalizowane jest włączone. To pole obsługuje następujące wartości: 
 Jeśli to pole ma inną wartość, zostanie automatycznie ustawione na  
  | 
              
excludeFirstPartyAudience | 
                
                   
 Określa, czy chcesz wykluczyć z rozszerzania zasięgu kierowania własne listy odbiorców. To pole zostało wycofane po uruchomieniu kierowania zoptymalizowanego. To pole zostanie ustawione na   | 
              
TargetingExpansionLevel
Ustawienie Kierowanie zoptymalizowane.
| Wartości w polu enum | |
|---|---|
TARGETING_EXPANSION_LEVEL_UNSPECIFIED | 
                Ustawienie kierowania zoptymalizowanego nie zostało określone lub jest nieznane w tej wersji. | 
NO_EXPANSION | 
                Kierowanie zoptymalizowane jest wyłączone. | 
LEAST_EXPANSION | 
                Kierowanie zoptymalizowane jest włączone. | 
SOME_EXPANSION | 
                Jeśli jest używana, zostanie automatycznie ustawiona na   | 
              
BALANCED_EXPANSION | 
                Jeśli jest używana, zostanie automatycznie ustawiona na   | 
              
MORE_EXPANSION | 
                Jeśli jest używana, zostanie automatycznie ustawiona na   | 
              
MOST_EXPANSION | 
                Jeśli jest używana, zostanie automatycznie ustawiona na   | 
              
LineItemWarningMessage
Komunikaty ostrzegawcze generowane przez element zamówienia. Te typy ostrzeżeń nie blokują zapisywania elementu zamówienia, ale mogą zablokować jego realizowanie.
| 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 realizowany. | 
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 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 | 
                Aplikacje i aplikacje tego elementu zamówienia Kierowanie na 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, którzy korzystają 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 | 
                Zamówienie reklamowe tego elementu zamówienia ma datę zakończenia przypadającą w przeszłości. Element zamówienia nie będzie realizowany. | 
NO_POSITIVE_AUDIENCE_LIST_TARGETED | 
                Ten element zamówienia nie jest kierowany na żadne listy odbiorców, przez co może za szybko wykorzystać budżet. | 
APP_INSTALL_NO_CONVERSION_PIXEL | 
                Dla tego elementu zamówienia instalacji w aplikacji nie skonfigurowano jeszcze piksela konwersji. | 
TARGETING_REVOKED_OR_CLOSED_USER_LIST | 
                Ten element zamówienia jest kierowany na co najmniej jedną listę użytkowników, która nie jest już dostępna. W przyszłości uniemożliwi to wyświetlanie reklam z tego elementu zamówienia, dlatego zastanów się nad usunięciem tych list z kierowania. | 
APP_INSTALL_NO_OPTIMAL_BIDDING_STRATEGY | 
                Ten element zamówienia instalacji w aplikacji nie ma optymalnej strategii określania stawek. | 
CREATIVE_SIZE_NOT_IN_USE_FOR_TARGETED_DEALS | 
                Umowy, na które jest kierowany ten element zamówienia, akceptują rozmiary kreacji, które nie są używane. Może to ograniczyć wyświetlanie lub skuteczność elementu zamówienia. | 
NO_CREATIVE_FOR_TARGETED_DEALS | 
                Ten element zamówienia nie zawiera żadnej kreacji w ramach umów objętych kierowaniem. | 
TARGETING_DEPRECATED_GEO_TARGET | 
                Ten element zamówienia jest kierowany na wycofaną lokalizację geograficzną. | 
DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION | 
                Ten element zamówienia korzysta z ustawienia  Przed 25 marca 2023 r. zaktualizuj integrację interfejsu API, aby bezpośrednio wykluczać własne listy odbiorców za pomocą kierowania na odbiorców, aby uwzględnić wycofanie pola   | 
              
MobileApp
Aplikacja mobilna promowana przez element zamówienia promujący instalację aplikacji mobilnej.
| Zapis JSON | 
|---|
{
  "appId": string,
  "platform": enum ( | 
              
| Pola | |
|---|---|
appId | 
                
                   
 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.  Aplikacje na iOS są identyfikowane na podstawie 9-cyfrowego identyfikatora aplikacji 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 | 
                Platforma iOS. | 
ANDROID | 
                Platforma Androida. | 
Metody | 
            |
|---|---|
                
 | 
              Umożliwia zbiorcze edytowanie opcji kierowania w ramach jednego elementu zamówienia. | 
                
 | 
              Zawiera listę przypisanych opcji kierowania elementu zamówienia z różnymi typami kierowania. | 
                
 | 
              Tworzy nowy element zamówienia. | 
                
 | 
              Usuwa element zamówienia. | 
                
 | 
              
                Tworzy nowy element zamówienia z ustawieniami (w tym kierowaniem) odziedziczonymi z zamówienia reklamowego i elementu entity_status (ENTITY_STATUS_DRAFT). | 
            
                
 | 
              Pobiera element zamówienia. | 
                
 | 
              Wyświetla listę elementów zamówienia reklamodawcy. | 
                
 | 
              Aktualizuje istniejący element zamówienia. |