Podstawowe pojęcia
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
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.
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-08-21 UTC.
[null,null,["Ostatnia aktualizacja: 2025-08-21 UTC."],[[["\u003cp\u003eThe Google Ad Manager API uses objects like Orders, Line Items, and Creatives to structure and manage ad campaigns.\u003c/p\u003e\n"],["\u003cp\u003eLine Items define ad requirements, targeting criteria, and cost structures, and are linked to Creatives via LineItemCreativeAssociations.\u003c/p\u003e\n"],["\u003cp\u003eCreatives represent the actual ads, which can be hosted by Ad Manager or a third-party server.\u003c/p\u003e\n"],["\u003cp\u003eAd Units represent ad locations on web pages and are targeted by Line Items or Placements, which are collections of Ad Units.\u003c/p\u003e\n"],["\u003cp\u003eInventory Targeting specifies which Ad Units are associated with a Line Item, while Targeting subclasses allow for additional criteria like geography or custom attributes.\u003c/p\u003e\n"]]],["The Google Ad Manager API's core components include `Order`, `LineItem`, `LineItemCreativeAssociation` (LICA), `Creative`, `InventoryTargeting`, `Placement`, and `AdUnit`. An `Order` contains `LineItem` instances, which define ad display requirements. A LICA links a `LineItem` to a `Creative`. `InventoryTargeting` links ad units to `LineItem`. `Placement` is a collection of `AdUnit`, representing ad locations. `Creative` is the actual ad content. AdUnits can be used to identify other adUnits.\n"],null,["# Basic Concepts\n\nThis page provides an overview\nof the architecture of the Google Ad Manager API and describes general concepts and terms in Ad Manager.\n\nAPI Architecture\n----------------\n\nHere is a simplified diagram of the main classes in the Ad Manager API, and how they relate to each other:\n\nOrder\n-----\n\n: An [Order](/ad-manager/api/reference/latest/OrderService.Order) object holds general information about the order such as the currency or salesperson, and contains one or more `LineItem` instances. In code, each `LineItem` holds the ID of its containing `Order`, rather than the `Order` holding a list of `LineItem` objects.\n\nLineItem\n--------\n\n: A [LineItem](/ad-manager/api/reference/latest/LineItemService.LineItem) object describes a set of requirements for an ad to show, including how\n and when the ads should be shown, the sizes of the creatives it should show and\n the order in which to show them (in order, weighted, or according to their performance),\n the priority of these ads, and many properties describing the cost structure. A\n `LineItem` has one `InventoryTargeting` object that describes which `AdUnit` and `Placement` objects it can target, and optional additional `Targeting` subclass objects that represent geographical, custom, or other criteria.\n\nLineItemCreativeAssociation\n---------------------------\n\n: A [LineItemCreativeAssociation](/ad-manager/api/reference/latest/LineItemCreativeAssociationService.LineItemCreativeAssociation) (often called a LICA) links one `LineItem` to\n one `Creative`. Line items can be linked to more than one creative, and depending on your account type, you might be able to link a creative to more than one line item. When you create a `LineItemCreativeAssociation`,\n Ad Manager first checks whether both the creative and the line item are compatible;\n if the sizes differ, for instance, you'll get an error when you try to create\n or update the association. This object also lets you override some values in the associated `LineItem`,\n such as start/end dates, or size (if you have a creative that doesn't\n quite fit the size specified by the line item, but you are willing to let Ad Manager\n adjust the size of the creative to fit the ad unit on the fly). LICAs are not exposed in the Ad Manager user interface; they are an API convention.\n\nCreative\n--------\n\n: A [Creative](/ad-manager/api/reference/latest/CreativeService.Creative) represents the actual ad. If the ad is hosted by Ad Manager,\n this object holds the actual image bytes, flash files, or custom HTML tags stored\n on Ad Manager's servers; if the creative is hosted on a\n third-party site, the creative is a URL or HTML snippet that makes the\n request from the third-party server.\n\nInventoryTargeting and Targeting subclasses\n-------------------------------------------\n\n: The [InventoryTargeting](/ad-manager/api/reference/latest/LineItemService.InventoryTargeting) object lists which ad units are associated with a specific `LineItem`. You can specify additional, optional targeting criteria using additional instances of an appropriate subclass of [`Targeting`](/ad-manager/api/reference/latest/LineItemService.Targeting).\n\nPlacement\n---------\n\n: A [Placement](/ad-manager/api/reference/latest/PlacementService.Placement) object is a collection of one or more `AdUnit` objects.\n\nAdUnit\n------\n\n: An [AdUnit](/ad-manager/api/reference/latest/InventoryService.AdUnit) represents an ad location on one or more pages. An `AdUnit` can be a target of either a `LineItem`'s `InventoryTargeting` object or a `Placement` object. An `AdUnit` object includes a size, an ID, and a unique name. The ID is used to identify other `AdUnit` objects within the API; the name is used as a unique identifier in the HTML tags to identify a specific `AdUnit` object, and is sent back to Ad Manager as part of the page request."]]
