- 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 |
To pole jest wymagane. Niezmienne. 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. Niezmienne. Typ elementu zamówienia. |
entityStatus |
To pole jest wymagane. Określa, czy element zamówienia może wydawać budżet i ustalać stawki na zasoby reklamowe.
|
updateTime |
Tylko dane wyjściowe. Sygnatura czasowa ostatniej aktualizacji elementu zamówienia. Przypisana przez system. Sygnatura czasowa w formacie RFC3339 UTC „Zulu”, z rozdzielczością nanosekundy 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 wydawania budżetu elementu zamówienia. |
frequencyCap |
To pole jest wymagane. Ustawienia limitu wyświetleń na użytkownika przypisane do elementu zamówienia. Aby przypisać ograniczone ograniczenie, 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. |
inventorySourceIds[] |
Identyfikatory źródeł prywatnych zasobów reklamowych przypisanych do 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. Te ostrzeżenia nie blokują zapisania elementu zamówienia, ale niektóre z nich mogą uniemożliwić jego realizację. |
mobileApp |
Aplikacja mobilna promowana przez element zamówienia. Ma zastosowanie tylko wtedy, gdy |
reservationType |
Tylko dane wyjściowe. Typ rezerwacji elementu zamówienia. |
excludeNewExchanges |
Określa, czy nowe giełdy mają nie być automatycznie kierowane przez element zamówienia. Domyślnie to pole ma wartość fałsz. |
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, mają zastosowanie.
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 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 mają zachęcać do instalowania 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 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 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 obecne w zamówieniach reklamowych OTT. Ten typ dotyczy tylko elementów zamówienia z zamówieniem reklamowym o wartości insertionOrderType OVER_THE_TOP . |
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 elementu zamówienia. Są one ustalane względem 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ą się już w Display & Video 360. To pole zostanie wycofane 1 sierpnia 2023 r. Więcej informacji znajdziesz w naszym ogłoszeniu 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 jego nadrzędnego zamówienia reklamowego. |
LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM |
Element zamówienia używa własnych niestandardowych dat 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ą się już w Display & Video 360. Ta wartość zostanie wycofana 1 sierpnia 2023 r. Więcej informacji znajdziesz w naszym ogłoszeniu o wycofaniu funkcji. |
LineItemBudget
Ustawienia kontrolujące sposób przydzielania budżetu.
Zapis JSON |
---|
{ "budgetAllocationType": enum ( |
Pola | |
---|---|
budgetAllocationType |
To pole jest wymagane. Typ przydziału budżetu. Ustawienie |
budgetUnit |
Tylko dane wyjściowe. Jednostka budżetowa 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 wydana przez 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 |
Element zamówienia nie ma określonego limitu budżetu. |
PartnerRevenueModel
Ustawienia określające sposób obliczania przychodów partnera.
Zapis JSON |
---|
{
"markupType": enum ( |
Pola | |
---|---|
markupType |
To pole jest wymagane. Typ narzutu modelu rozliczeniowego partnera. |
markupAmount |
To pole jest wymagane. Kwota marży modelu rozliczeniowego partnera. Nie może być mniejsza niż 0.
|
PartnerRevenueModelMarkupType
Możliwe typy narzutów 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 od 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 |
Odsetek zliczonych konwersji po obejrzeniu (w milisekundach (1/1000 z procent). Wymagana wartość z zakresu od 0 do 100 000 włącznie. Aby na przykład śledzić 50% konwersji po kliknięciu, ustaw wartość 50 000. |
floodlightActivityConfigs[] |
Konfiguracje aktywności Floodlight służące 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ą działanie 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. Wymagana wartość z zakresu 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. Wymagana wartość z zakresu od 0 do 90 włącznie. |
TargetingExpansionConfig
Ustawienia, które kontrolują ustawienia kierowania zoptymalizowanego elementu zamówienia.
Zapis JSON |
---|
{
"targetingExpansionLevel": enum ( |
Pola | |
---|---|
targetingExpansionLevel |
To pole jest wymagane. Określa, czy kierowanie zoptymalizowane jest włączone. To pole obsługuje następujące wartości:
Jeśli w tym polu ustawiono jakąkolwiek inną wartość, zostanie ona automatycznie ustawiona na Domyślną wartością pola jest |
excludeFirstPartyAudience |
Określa, czy własne listy odbiorców mają być używane do rozszerzania zasięgu kierowania. To pole zostało wycofane wraz z wprowadzeniem kierowania zoptymalizowanego. To pole zostanie ustawione na |
TargetingExpansionLevel
Ustawienie Kierowanie zoptymalizowane.
Wartości w polu enum | |
---|---|
TARGETING_EXPANSION_LEVEL_UNSPECIFIED |
Ustawienie kierowania zoptymalizowanego nie jest określone lub jest w tej wersji nieznane. |
NO_EXPANSION |
Kierowanie zoptymalizowane jest wyłączone. |
LEAST_EXPANSION |
Kierowanie zoptymalizowane jest włączone. |
SOME_EXPANSION |
Jeśli jest używana, automatycznie zmieni się na |
BALANCED_EXPANSION |
Jeśli jest używana, automatycznie zmieni się na |
MORE_EXPANSION |
Jeśli jest używana, automatycznie zmieni się na |
MOST_EXPANSION |
Jeśli jest używana, automatycznie zmieni się na |
LineItemWarningMessage
Komunikaty ostrzegawcze wygenerowane przez element zamówienia. Ostrzeżenia tego typu nie blokują zapisywania elementu zamówienia, ale mogą uniemożliwić jego realizację.
Wartości w polu enum | |
---|---|
LINE_ITEM_WARNING_MESSAGE_UNSPECIFIED |
Nie określono lub jest nieznana. |
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 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 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 kierowaniu 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 do ż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 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. |
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 1 listę użytkowników, która nie jest już dostępna. W przyszłości uniemożliwi to wyświetlanie elementu zamówienia, dlatego rozważ usunięcie 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 kierowany jest ten element zamówienia, akceptują rozmiary kreacji, które nie są używane. Może to ograniczyć realizację 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 wycofane lokalizacje geograficzne. |
DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION |
Ten element zamówienia korzysta z ustawienia Zaktualizuj integrację interfejsu API przed 25 marca 2023 r., 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 |
To pole jest wymagane. Identyfikator aplikacji podany przez sklep na platformie. Aplikacje na Androida są identyfikowane na podstawie identyfikatora pakietu używanego w Sklepie Play na Androida (np. Aplikacje na iOS są rozpoznawane 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 |
Platforma iOS. |
ANDROID |
platformę Androida. |
Metody |
|
---|---|
|
Zbiorcze edytowanie opcji kierowania w jednym elemencie zamówienia. |
|
Wyświetla listę opcji kierowania przypisanych do elementu zamówienia różnych typów 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 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. |