Transparente Einblicke in den Gebotsprozess mit dem SupplyChain-Objekt

Mit dem SupplyChain-Objekt können Käufer und Mittler alle Parteien sehen, die Anzeigeninventar verkaufen oder weiterverkaufen. In Kombination mit ads.txt/ads.txt und ads.txt sorgt das Objekt für Transparenz im Werbesystem.

1. Der Publisher sendet eine Gebotsanfrage.
2. Der Käufer erhält die Gebotsanfrage und die zugehörigen Daten über das SupplyChain-Objekt.
3. Der Käufer prüft die Identitäten aller Mittler, die Inventar weiterverkaufen.
4. Der Käufer crawlt und prüft die Anbieter, die für das Verkaufen von Inventar autorisiert sind.

Die Objekte werden von Google automatisch in einer OpenRTB-Anfrage oder, sofern relevant, über das RTB-Protokoll von Google erstellt.

Funktionsweise des SupplyChain-Objekts

Das SupplyChain-Objekt, das auch als schain bezeichnet wird, ist Teil einer OpenRTB-Gebotsanfrage und besteht aus sogenannten „Knoten“. Jeder Knoten des schain-Objekts steht für eine bestimmte Partei, die an der Gebotsanfrage beteiligt ist. Dazu gehören alle Parteien, die in den direkten Zahlungsfluss für das Inventar involviert sind.

// Example object
"schain": {
    "complete": 1,
    "nodes": [{
         "asi":"google.com",
         "sid":"pub-1234567891234567", // Die gleiche Verkäufer-ID wie für den Publisher in sellers.json
         "hp":1
    }],
    "ver":"1.0"
}

Weitere Informationen finden Sie in der Entwicklerdokumentation zu OpenRTB und in der IAB-Dokumentation (beide in englischer Sprache).

Je nach Art Ihrer Zusammenarbeit mit Käufern ist das SupplyChain-Objekt unterschiedlich aufgebaut.

Publisher, die direkt über Google verkaufen

Bei Publishern, die Inventar direkt über Ad Manager, AdMob oder AdSense verkaufen, enthält das schain-Objekt nur einen Knoten für google.com mit der seller_id aus der Datei „sellers.json“.

Publisher, die Open Bidding verwenden

Bei Publishern, die über Open Bidding mit Drittanbieter-Anzeigenplattformen zusammenarbeiten, enthält das schain-Objekt zwei Knoten: einen für google.com mit der seller_id aus der Datei „sellers.json“ und einen für den Ertragspartner der Anzeigenplattform.

So wie Google den Knoten für google.com erstellt, bevor die Gebotsanfrage gesendet wird, ist die Drittanbieter-Anzeigenplattform dafür verantwortlich, ihren Knoten hinzuzufügen, bevor die Anfrage weitergegeben wird.

Alle Mittler, die nicht am Zahlungsprozess beteiligt sind

Mittler, die keine Zahlungen bearbeiten, sind nicht im SupplyChain-Objekt enthalten. Dazu gehören Mittler, die am clientseitigen Header Bidding, dem Header Bidding ohne Zahlung, der Inventarfreigabe und sonstigen Formen der Vermittlung beteiligt sind.

Publisher, die Zahlungsvermittler vor der Anfrage verwenden ^(Beta) 

Diese Funktion befindet sich in der Betaphase
Funktionen in der Betaphase sind in Ihrem Netzwerk möglicherweise nicht verfügbar. In den Versionshinweisen erfahren Sie, wann diese Funktion für alle Nutzer verfügbar wird.

Publisher, die vor der Anfrage an Google Ad Manager Zahlungsvermittler nutzen, müssen gemäß den IAB-Richtlinien das SupplyChain-Objekt übergeben. Das SupplyChain-Objekt sollte nur Vermittler enthalten, die direkt am Zahlungsfluss für das Inventar beteiligt sind. Zu diesen Vermittlern kann auch die Ad-Server-Technologie eines Drittanbieters gehören, die vom Publisher verwendet wird. Das SupplyChain-Objekt kann in der Anzeigenanfrage mit dem Parameter schain gesendet werden.

Weitere Informationen zum Parameter „schain“

Beschreibung

Für den Lieferkettenparameter (schain) kann ein Wert vom Typ Variable verwendet werden, der ein serialisiertes SupplyChain-Objekt sein sollte. Wenn dieser Parameter enthalten ist, hängt Google an alle empfangenen schain-Objekte vor dem Senden an Käufer einen Knoten an.

In der vollständigen IAB-Dokumentation erfahren Sie, wie Sie SupplyChain-Informationen über ein Tag (anstelle von OpenRTB) senden.

Anforderungen für das korrekte Parsing von schain

Basierend auf der IAB-Dokumentation wird die Serialisierung für das SupplyChain-Objekt so definiert:

• {SupplyChainObject}!{SupplyChainNode array}. SupplyChainObject und SupplyChainNode-Properties sind kommagetrennt, sodass optionale Felder weggelassen und Kommatrennzeichen dafür optional ausgeschlossen werden können.
• Die einzelnen SupplyChainNode-Elemente werden durch ein "!" getrennt.
• Wenn der Wert einer Property Zeichen enthält, die eine URL-Codierung erfordern (z. B. "," oder "!"), muss der Wert vor der Serialisierung URL-codiert werden.

Serialisierungsreihenfolge

Die SupplyChainObject-Properties werden in dieser Reihenfolge serialisiert:

ver,complete

Die SupplyChainNode-Properties werden in dieser Reihenfolge serialisiert:

asi,sid,hp,rid,name,domain,ext

Hinweis: Der Inhalt von ext ist für die Anzeigenplattform spezifisch. Diese Property wird in Google Ad Manager nicht geparst.

Beispiele für die Serialisierung des SupplyChain-Objekts

Im Folgenden finden Sie zwei Beispiele für die Serialisierung des oben genannten SupplyChain-Objekts:

Leere optionale Felder mit Kommas serialisieren

1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1,,,,

Leere optionale Felder ohne Kommas serialisieren

1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1

Weitere Informationen zum SupplyChain-Objekt

Verwendungsbeispiele

schain=1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1,,,,

Wenn asi den Wert exchange,1 hätte, würde die Serialisierung mit Escape-Zeichen so aussehen:

1.0,1!exchange%2C1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1

Anforderungen und Empfehlungen

Dieser Parameter ist zwar nicht erforderlich, um Anzeigen für eine bestimmte Implementierung oder einen bestimmten Transaktionstyp auszuliefern, aber für Publisher, die vor der Anfrage an Google Ad Manager Zahlungsvermittler nutzen. Dies gilt auch für Publisher, die Ad-Server-Technologien eines Drittanbieters verwenden.

 

Hinweis: Alle zusätzlichen Knoten, die dem SupplyChain-Objekt angehängt werden, müssen auch in der ads.txt-/app-ads.txt-Datei eines Publishers enthalten sein. Andernfalls betrachten Käufer den Traffic möglicherweise als nicht autorisiert.

Publisher, die das Publisher-Verwaltungstool verwenden

Mit dem Publisher-Verwaltungstool können Publisher die AdMob-Konten ihrer Kunden mit derselben Transparenz und denselben Funktionen verwalten, die sie selbst nutzen.

Bei über- und untergeordneten Publishern, die das Publisher-Verwaltungstool von AdMob verwenden, enthält das schain-Objekt einen Knoten mit der Verkäufer-ID des untergeordneten Publishers sowie einen Knoten für den übergeordneten Publisher und ist als vollständig markiert. Die Monetarisierung erfolgt beim Publisher-Verwaltungstool von AdMob im Konto des untergeordneten Publishers. Der untergeordnete Publisher wird als End-Publisher behandelt.