Was ist das schain-(SupplyChain-)Objekt?

Es ist ein IAB-Tech-Lab-Objekt, das in OpenRTB bei source.ext.schain getragen wird und der Reihe nach jedes Advertising-System auflistet, das die Bid-Request zwischen Publisher und Exchange berührt hat, sodass Buyer den Supply-Path verifizieren können.

Was bedeuten asi, sid und hp an jedem Node?

asi ist die kanonische Domain des Advertising-Systems, sid ist die Seller- oder Reseller-Account-id innerhalb dieses Systems (passend zu seiner sellers.json), und hp ist 1, wenn dieser Node am Payment-Flow beteiligt ist. Alle drei sind pro Node erforderlich.

Was ist der Unterschied zwischen dem JSON-Objekt und dem serialisierten String?

Das JSON-Objekt ist die vollständige source.ext.schain-Struktur, die in einem Bid-Request-Body genutzt wird. Der serialisierte String ist eine kompakte URL-kodierte Form — ver,complete!node!node — in der jeder Node asi,sid,hp,rid,name,domain ist, genutzt wo ein Header oder Query-Parameter nötig ist.

Wann sollte complete 0 statt 1 sein?

Setze complete=1 nur, wenn jeder Intermediär vom Publisher an im nodes-Array deklariert ist. Wenn ein Upstream-Hop unbekannt oder ausgelassen ist, setze complete=0, damit Bidder wissen, dass die Kette unvollständig ist.

Ruft dieses Tool meinen Ad-Tag oder meine Bid-Request von einem Server ab?

Nein. Du fügst das schain ein oder baust es, und alles — Serialisierung, Parsing und Validierung — passiert lokal in deinem Browser. Die Seller-ids, Domains und Node-Daten, die du eingibst, werden nie an ArrayKit gesendet.

Kann es ein schain validieren, das ich aus einer Live-Bid-Request kopiert habe?

Ja. Füge es in den Validate-Modus ein, entweder als JSON-Objekt (inklusive eines umschließenden source.ext.schain) oder als serialisierten String, und das Tool prüft die Pflicht-Node-Felder, das complete-Flag, die ver und zeichnet die Hop-Kette.

schain Builder & Validator

Baue und validiere das IAB-SupplyChain-Objekt (schain) für OpenRTB und exportiere sowohl das source.ext.schain-JSON als auch den serialisierten String — alles in deinem Browser.

Der schain Builder & Validator läuft vollständig in deinem Browser. Die Seller-ids, Domains und Supply-Chain-Nodes, die du baust oder einfügst, bleiben auf deinem Gerät und werden nie zu ArrayKit hochgeladen.

OpenRTB Enum Reference öffnen

Über schain Builder

Der schain Builder & Validator setzt das IAB-Tech-Lab-SupplyChain-Objekt zusammen, das in OpenRTB-Bid-Requests bei source.ext.schain mitreist. Füge jeden Intermediär als geordneten Node mit seinem asi, sid und hp-(Payment-)Flag hinzu, setze die complete- und ver-Werte und kopiere dann sowohl das JSON-Objekt als auch den URL-kodierten serialisierten String, den Exchanges erwarten. Wechsle in den Validate-Modus, um ein bestehendes schain einzufügen — als JSON oder als serialisierten String — und sofort fehlende Pflichtfelder, ein schlechtes complete-Flag oder eine unerwartete Version zu sehen, wobei die Hop-Kette Node für Node gezeichnet wird. Ad-Ops-, SSP- und Header-Bidding-Engineers können Supply-Paths hier auditieren und reparieren; die Nodes und Seller-ids, die du einfügst, werden auf deinem Gerät geparst und nie hochgeladen.

Funktionen

Füge geordnete Supply-Chain-Nodes hinzu, ordne und entferne sie (asi, sid, hp, rid, name, domain)
Schalte das complete-Flag um und fixiere ver auf die aktuelle 1.0-Spec
Exportiert das OpenRTB-source.ext.schain-JSON-Objekt, bereit zum Einfügen in eine Bid-Request
Erzeugt den URL-kodierten serialisierten String, den Exchanges akzeptieren (ver,complete!node!node)
Der Validate-Modus akzeptiert entweder ein JSON-schain oder einen serialisierten String
Markiert fehlende asi, sid oder hp, ein ungültiges complete-Flag und eine unerwartete ver
Visualisiert die Hop-Kette, sodass du die Node-Reihenfolge auf einen Blick bestätigst
Läuft vollständig in deinem Browser — Seller-ids und Domains bleiben auf deinem Gerät

So verwendest du schain Builder

Lass den Build-Tab ausgewählt und trage asi, sid und das hp-Flag für jeden Node ein
Füge weitere Nodes hinzu und nutze die Pfeile, um sie in Publisher-zu-Exchange-Reihenfolge zu bringen
Setze das complete-Flag (1, wenn der ganze Pfad deklariert ist) und kopiere das JSON oder den serialisierten String
Wechsle zu Validate und füge ein bestehendes schain ein, um Pflichtfelder und Node-Reihenfolge zu prüfen

Beispiel

Eingabe

asi: exchange1.com
sid: 1234
hp: 1
complete: 1

Ausgabe

1.0,1!exchange1.com,1234,1

Ein Node serialisiert zu ver,complete!asi,sid,hp; das JSON geht in source.ext.schain.

Häufige Fehler & Fehlerbehebung

Validate meldet, dass einem Node asi, sid oder hp fehlt. — Jeder Node braucht alle drei Pflichtfelder: asi ist die kanonische Domain des Advertising-Systems, sid ist die Seller-/Reseller-id aus diesem System, und hp muss 0 oder 1 sein.
Die Exchange lehnt den serialisierten String ab. — Felder müssen URL-kodiert und in der Reihenfolge asi,sid,hp,rid,name,domain sein, mit Kommas zwischen Feldern und ! zwischen Nodes; das Header-Segment ist ver,complete.
complete ist auf 1 gesetzt, aber du hast einen Upstream-Reseller weggelassen. — complete=1 behauptet, dass jeder Intermediär deklariert ist. Wenn ein Hop unbekannt ist, setze complete=0, damit nachgelagerte Bidder wissen, dass der Pfad partiell ist.
sid stimmt nicht mit der Seller-id in sellers.json überein. — Die sid an jedem Node muss der seller_id entsprechen, die das jeweilige System in seiner sellers.json veröffentlicht, sonst behandeln Buyer den Pfad als unverifiziert.

Häufig gestellte Fragen

Was ist das schain-(SupplyChain-)Objekt?: Es ist ein IAB-Tech-Lab-Objekt, das in OpenRTB bei source.ext.schain getragen wird und der Reihe nach jedes Advertising-System auflistet, das die Bid-Request zwischen Publisher und Exchange berührt hat, sodass Buyer den Supply-Path verifizieren können.
Was bedeuten asi, sid und hp an jedem Node?: asi ist die kanonische Domain des Advertising-Systems, sid ist die Seller- oder Reseller-Account-id innerhalb dieses Systems (passend zu seiner sellers.json), und hp ist 1, wenn dieser Node am Payment-Flow beteiligt ist. Alle drei sind pro Node erforderlich.
Was ist der Unterschied zwischen dem JSON-Objekt und dem serialisierten String?: Das JSON-Objekt ist die vollständige source.ext.schain-Struktur, die in einem Bid-Request-Body genutzt wird. Der serialisierte String ist eine kompakte URL-kodierte Form — ver,complete!node!node — in der jeder Node asi,sid,hp,rid,name,domain ist, genutzt wo ein Header oder Query-Parameter nötig ist.
Wann sollte complete 0 statt 1 sein?: Setze complete=1 nur, wenn jeder Intermediär vom Publisher an im nodes-Array deklariert ist. Wenn ein Upstream-Hop unbekannt oder ausgelassen ist, setze complete=0, damit Bidder wissen, dass die Kette unvollständig ist.
Ruft dieses Tool meinen Ad-Tag oder meine Bid-Request von einem Server ab?: Nein. Du fügst das schain ein oder baust es, und alles — Serialisierung, Parsing und Validierung — passiert lokal in deinem Browser. Die Seller-ids, Domains und Node-Daten, die du eingibst, werden nie an ArrayKit gesendet.
Kann es ein schain validieren, das ich aus einer Live-Bid-Request kopiert habe?: Ja. Füge es in den Validate-Modus ein, entweder als JSON-Objekt (inklusive eines umschließenden source.ext.schain) oder als serialisierten String, und das Tool prüft die Pflicht-Node-Felder, das complete-Flag, die ver und zeichnet die Hop-Kette.