Insyn i budgivning med hjälp av SupplyChain-objekt

Med SupplyChain-objekt kan köpare och mellanhänder se alla parter som säljer eller återsäljer annonsutrymme. Objektet fungerar med ads.txt/app-ads.txt och sellers.json och ger insyn i annonseringsekosystemet.

1. Utgivaren skickar en budbegäran.
2. Köparen tar emot en budbegäran och data från SupplyChain-objektet.
3. Köparen letar upp identiteten på alla mellanhänder som återförsäljer annonsutrymme.
4. Köparen genomsöker och verifierar leverantörer som är auktoriserade att sälja annonsutrymme.

Google skapar automatiskt objekt i en OpenRTB-begäran eller ett Google RTB-protokoll där så är tillämpligt.

Så här fungerar SupplyChain-objekt

SupplyChain-objekt kallas även schain-objekt. De är en del av en OpenRTB-budbegäran och består av ”noder”. Varje nod i schain-objektet representerar en specifik enhet som deltar i budbegäran vilket inkluderar alla enheter som är involverade i direktflödet för annonsutrymme.

Tips! För att Google ska kunna skapa ett fullständigt SupplyChain-objekt måste överordnade MCM-konton i Hantera annonsutrymme dela sina underordnade utgivares säljar-id:n (sid) via Ad Manager eller med hjälp av API:et.

 

// Exempel-objekt
"schain": {
    "complete": 1,
    "nodes": [{
         "asi":"google.com",
         "sid":"pub-1234567891234567", // Samma seller_id för utgivaren i sellers.json
         "hp":1
    }],
    "ver":"1.0"
}

Du hittar mer information i OpenRTB:s utvecklardokumentation och IAB:s dokumentation.

SupplyChain-objekt ser olika ut beroende på hur du arbetar med köpare.

Utgivare som säljer direkt via Google

För utgivare som säljer annonsutrymme direkt via Ad Manager, AdMob eller AdSense innehåller schain-objektet endast en nod för google.com med seller_id i sellers.json.

Utgivare som använder Öppen budgivning

Utgivare som använder Öppen budgivning för att arbeta med tredjepartsbörser har två noder i schain-objektet, en nod för google.com med seller_id i sellers.json och en nod för börsens avkastningspartner.

På samma sätt som Google skapar noden för google.com innan en budbegäran skickas ansvarar tredjepartsbörsen för att lägga till sin nod innan de vidarebefordrar begäran.

Mellanhänder som inte hanterar betalningar

Mellanhänder som inte hanterar betalningar ingår inte i SupplyChain-objektet. Detta omfattar header bidding på klientsidan, header bidding utan betalning, annonsutrymmesdelning och annan förmedling.

Utgivare som använder betalningsförmedlare före begäran ^(beta) 

This feature is in Beta
Features in Beta phase might not be available in your network. Watch the release notes for when this feature becomes generally available.

Utgivare som använder betalningsförmedlare uppströms från begäran till Google Ad Manager måste skicka med objektet SupplyChain enligt IAB-riktlinjerna. SupplyChain-objektet ska endast innehålla mellanhänder som är direkt involverade i betalningsflödet för annonsutrymmet. Sådana mellanhänder kan vara teknik hos tredjepartsleverantörer av annonseringstjänster som används av utgivaren. Objektet SupplyChain kan skickas i annonsbegäran med parametern schain.

Läs mer om parametern schain

Beskrivning

The supply chain (schain) parameter accepts a variable value which should be serialized SupplyChain object. When this parameter is included, Google appends a node to any received schain objects prior to sending to buyers.

See the full IAB documentation for communicating SupplyChain information via a tag (rather than OpenRTB).

See requirements for schain to be parsed correctly

Based on the IAB documentation, the following defines the serialization for the SupplyChain object:

• {SupplyChainObject}!{SupplyChainNode array}. SupplyChainObject and SupplyChainNode properties are comma delimited such that optional fields can be omitted and comma separators for which can be optionally excluded.
• Each SupplyChainNode element is separated by a "!".
• If the value of any property contains characters that require URL encoding (for example "," or "!"), the value should be URL encoded before serialization.

Serialization order

SupplyChainObject properties are serialized in this order:

ver,complete

SupplyChainNode properties are serialized in this order:

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

Note: The contents of ext are exchange specific. Google Ad Manager does not parse this property.

Examples of how to serialize the SupplyChain object

Below are two examples of ways to serialize the above SupplyChain object:

Serialize with commas for empty optional fields

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

Serialize without commas for empty optional fields

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

Learn more about the SupplyChain object.

Usage examples

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

If the value for asi were exchange,1, then the serialization with escaped characters would look like:

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

Requirements and recommendations

While this this parameter is not required to serve ads to any specific implementation or transaction type, it is required for publishers leveraging payment intermediaries upstream of the request to Google Ad Manager. This includes publishers who use third-party ad server technology.

 

Obs! Eventuella ytterligare noder som läggs till i objektet SupplyChain ska också finnas med i utgivarens ads.txt-/app-ads.txt-fil. Annars kan köpare betrakta trafiken som obehörig.

Multiple Customer Management-utgivare

Med MCM (Multiple Customer Management) kan utgivare hantera sina kunders AdMob-konton med samma insyn och kontroll som utgivarna själva.

För överordnade och underordnade utgivare som använder AdMob MCM har schain-objektet en nod med den underordnade utgivarens säljar-id och kedjan markeras som fullständig. För AdMob MCM sker intäktsgenerering i det underordnade utgivarkontot. Den underordnade utgivaren behandlas som slutlig utgivare. Den överordnade utgivarens information ingår inte i schain-objektet.