Podstawowe pojęcia

Na tej stronie znajdziesz omówienie architektury interfejsu API Google Ad Manager oraz ogólne zagadnienia i terminy związane z Ad Managerem.

Architektura interfejsów API

Oto uproszczony schemat głównych klas w interfejsie API Ad Managera i ich wzajemnych powiązań:

Zamów

Obiekt Order zawiera ogólne informacje o zamówieniu, takie jak waluta czy sprzedawca, i zawiera co najmniej 1 wystąpienie LineItem. Każdy element LineItem zawiera w kodzie identyfikator elementu zawierającego Order, a nie Order, który zawiera listę obiektów LineItem.

LineItem

Obiekt LineItem opisuje zestaw wymagań dotyczących wyświetlania reklam, w tym sposób i czas wyświetlania reklam, rozmiary kreacji, kolejność wyświetlania kreacji (kolejność, ważenie lub według ich skuteczności), priorytet reklam oraz wiele właściwości opisujących strukturę kosztów. Zasób LineItem ma 1 obiekt InventoryTargeting, który opisuje, do których obiektów AdUnit i Placement może być kierowany, oraz opcjonalnie dodatkowe obiekty podklasy Targeting reprezentujące kryteria geograficzne, niestandardowe lub inne.

LineItemCreativeAssociation

Element LineItemCreativeAssociation (często nazywany LICA) łączy jeden element LineItem z jednym Creative. Elementy zamówienia można połączyć z więcej niż jedną kreacją, a w zależności od typu konta – z więcej niż jednym elementem zamówienia. Gdy tworzysz element LineItemCreativeAssociation, Ad Manager najpierw sprawdza, czy zarówno kreacja, jak i element zamówienia są zgodne. Jeśli rozmiary się różnią, podczas próby utworzenia lub zaktualizowania powiązania pojawi się błąd. Ten obiekt umożliwia również zastąpienie niektórych wartości w powiązanym elemencie LineItem, np. daty rozpoczęcia i zakończenia lub rozmiaru (jeśli masz kreację, która nie pasuje do rozmiaru określonego w elemencie zamówienia, ale chcesz pozwolić Ad Managerowi na dostosowywanie rozmiaru kreacji na bieżąco tak, aby pasowała do jednostki reklamowej). Identyfikatory te nie są wyświetlane w interfejsie Ad Managera. To konwencja interfejsu API.

Kreacja

Creative reprezentuje rzeczywistą reklamę. Jeśli reklama jest hostowana przez Ad Managera, ten obiekt zawiera rzeczywiste bajty obrazu, pliki Flash lub niestandardowe tagi HTML zapisane na serwerach Ad Managera. Jeśli kreacja jest hostowana w witrynie innej firmy, kreacja to URL lub fragment kodu HTML, który wysyła żądanie z serwera zewnętrznego.

Podklasy kierowania na zasoby reklamowe i kierowanie reklam

Obiekt InventoryTargeting zawiera listę jednostek reklamowych powiązanych z określonym LineItem. Możesz określić dodatkowe, opcjonalne kryteria kierowania, używając dodatkowych wystąpień odpowiedniej podklasy Targeting.

Miejsce docelowe

Obiekt Placement to zbiór zawierający co najmniej 1 obiekt AdUnit.

AdUnit

Element AdUnit oznacza lokalizację reklamy na co najmniej jednej stronie. Element AdUnit może być celem obiektu InventoryTargeting LineItem lub obiektu Placement. Obiekt AdUnit ma rozmiar, identyfikator i unikalną nazwę. Identyfikator służy do identyfikowania innych obiektów AdUnit w interfejsie API. Jest używany jako unikalny identyfikator w tagach HTML do identyfikowania konkretnego obiektu AdUnit i jest wysyłany z powrotem do Ad Managera w ramach żądania strony.