Grundlegende Konzepte

Auf dieser Seite erhalten Sie einen Überblick über die Architektur der Google Ad Manager API. Außerdem werden allgemeine Konzepte und Begriffe in Ad Manager beschrieben.

Architektur von APIs

Hier sehen Sie ein vereinfachtes Diagramm der Hauptklassen in der Ad Manager API und ihre Beziehung zueinander:

Auftrag

Ein Order-Objekt enthält allgemeine Informationen zum Auftrag wie die Währung oder den Verkäufer und enthält mindestens eine LineItem-Instanz. Im Code enthält jede LineItem die ID der zugehörigen Order und nicht die Order mit einer Liste von LineItem-Objekten.

LineItem

Ein LineItem-Objekt beschreibt eine Reihe von Anforderungen an die Auslieferung einer Anzeige. Dazu gehören unter anderem, wie und wann die Anzeigen ausgeliefert werden sollen, welche Größe und in welcher Reihenfolge (in der Reihenfolge, in der Gewichtung oder gemäß ihrer Leistung), die Priorität der Anzeigen und viele Eigenschaften die Kostenstruktur beschreiben. Eine LineItem hat ein InventoryTargeting-Objekt, das beschreibt, auf welche AdUnit- und Placement-Objekte sie ausgerichtet werden kann, und optionale zusätzliche Targeting-Unterklasse-Objekte, die geografische, benutzerdefinierte oder andere Kriterien darstellen.

LineItemCreativeAssociation

Eine LineItemCreativeAssociation (häufig auch als LICA bezeichnet) verknüpft eine LineItem mit einer Creative. Werbebuchungen können mit mehreren Creatives verknüpft werden. Je nach Kontotyp können Sie ein Creative auch mit mehreren Werbebuchungen verknüpfen. Wenn Sie eine LineItemCreativeAssociation erstellen, wird in Ad Manager zuerst geprüft, ob sowohl das Creative als auch die Werbebuchung kompatibel sind. Wenn sich die Größen beispielsweise unterscheiden, wird beim Versuch, die Verknüpfung zu erstellen oder zu aktualisieren, ein Fehler ausgegeben. Mit diesem Objekt können Sie auch einige Werte in der zugehörigen LineItem überschreiben, z. B. das Start- und Enddatum oder die Größe. Dies gilt, wenn Sie ein Creative haben, das nicht ganz der in der Werbebuchung angegebenen Größe entspricht, Sie die Größe aber in Ad Manager anpassen lassen möchten, damit es in den Anzeigenblock passt. LICAs werden nicht auf der Ad Manager-Benutzeroberfläche angezeigt. Sie sind eine API-Konvention.

Creative

Ein Creative steht für die eigentliche Anzeige. Wenn die Anzeige von Ad Manager gehostet wird, enthält dieses Objekt die tatsächlichen Bildbyte, Flash-Dateien oder benutzerdefinierten HTML-Tags, die auf den Ad Manager-Servern gespeichert sind. Wird das Creative auf einer Drittanbieterwebsite gehostet, ist das Creative eine URL oder ein HTML-Snippet, über das die Anfrage vom Drittanbieterserver gesendet wird.

Unterklassen für Inventar-Targeting und Targeting

Über das InventoryTargeting-Objekt werden die Anzeigenblöcke aufgelistet, die einem bestimmten LineItem zugeordnet sind. Sie können zusätzliche, optionale Targeting-Kriterien mithilfe zusätzlicher Instanzen einer geeigneten Unterklasse von Targeting festlegen.

Placement

Ein Placement-Objekt ist eine Sammlung aus einem oder mehreren AdUnit-Objekten.

AdUnit

Ein AdUnit steht für eine Anzeigenplatzierung auf einer oder mehreren Seiten. Ein AdUnit kann ein Ziel des InventoryTargeting-Objekts einer LineItem oder eines Placement-Objekts sein. Ein AdUnit-Objekt enthält eine Größe, eine ID und einen eindeutigen Namen. Die ID wird verwendet, um andere AdUnit-Objekte innerhalb der API zu identifizieren. Der Name wird in den HTML-Tags als eindeutige Kennung zur Identifizierung eines bestimmten AdUnit-Objekts genutzt und als Teil der Seitenanfrage an Ad Manager zurückgesendet.