SupplyChain Object giver købere og formidlere mulighed for at se alle parter, der sælger eller videresælger annoncebeholdning. Dette objekt er sammen med ads.txt
/app-ads.txt
og sellers.json
med til at sikre gennemsigtighed i økosystemet for annoncer.
- Udgiveren sender en budanmodning.
- Køberen modtager budanmodningen og data fra SupplyChain Object.
- Køberen tjekker id for samtlige mellemled, der forhandler den aktuelle beholdning.
- Køberen foretager crawling og verificering af leverandører med tilladelse til at sælge den aktuelle beholdning.
Google opretter automatisk objekterne i en OpenRTB-anmodning eller Google RTB-protokol, hvis det er relevant.
Sådan fungerer SupplyChain Object
SupplyChain Object, som også kaldes
, er en del af en OpenRTB-budanmodning og består af såkaldte "noder". Hver node i Sace
schain
-objektet repræsenterer en bestemt enhed, der deltager i budanmodningen, som omfatter alle enheder, der er involveret i processen til direkte betaling for beholdning.
sid
) for deres underordnede udgivere via Ad Manager eller ved hjælp af API'en.
// Example object
"schain": {
"complete": 1,
"nodes": [{
"asi":"google.com",
"sid":"pub-1234567891234567", // Same seller_id for the publisher in sellers.json
"hp":1
}],
"ver":"1.0"
}
Læs udviklerdokumentationen til OpenRTB og dokumentationen til IAB for at få flere oplysninger.
SupplyChain Object ser forskelligt ud, alt efter hvordan du arbejder med købere.
Udgivere, der sælger direkte via Google
For udgivere, der sælger beholdning direkte via Ad Manager, AdMob eller AdSense, indeholder schain
-objektet kun én node for "google.dk" med seller_id
i sellers.json.
Udgivere, der bruger Åben budgivning
Udgivere, som samarbejder med tredjepartsbørser via Åben budgivning, har to noder i schain
-objektet: Én node for google.com med det seller_id
, der er registreret i sellers.json, og én node for børsafkastpartneren.
Google er ansvarlig for at oprette noden for google.com, før budanmodningen sendes, og tredjepartsbørspartneren er ansvarlig for at tilføje sin node, før anmodningen sendes.
Alle mellemled, der ikke håndterer betalinger
Mellemled, der ikke håndterer betalinger, er ikke inkluderet i SupplyChain Object. Dette omfatter header-budgivning på klientsiden, header-budgivning uden betalingshåndtering, deling af beholdning og andre former for formidling.
Udgivere, der bruger betalingsformidlere inden anmodningen (beta)
Features in Beta phase might not be available in your network. Watch the release notes for when this feature becomes generally available.
Udgivere, der anvender betalingsformidlere upstream af anmodningen til Google Ad Manager, skal overføre SupplyChain
Object i henhold til IAB-retningslinjerne. SupplyChain
Object må kun indeholde mellemled, der er direkte involveret i betalingsprocessen for beholdningen. Disse mellemled kan omfatte tredjepartsannonceserverteknologi, der bruges af udgiveren. SupplyChain
Object kan sendes i annonceanmodningen ved hjælp af parameteren schain
.
Beskrivelse
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 forschain
to be parsed correctly
Based on the IAB documentation, the following defines the serialization for the SupplyChain
object:
{SupplyChainObject}!{SupplyChainNode array}. SupplyChainObject
andSupplyChainNode
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
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:
1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1,,,,
1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1
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.
SupplyChain
Object, skal også repræsenteres i en udgivers ads.txt-/app-ads.txt-fil, da købere ellers kan betragte trafikken som uautoriseret.Multiple Customer Management publishers
Multiple Customer Management (MCM) enables parent publishers to monetize child publishers’ inventory either individually with the Manage Account delegation type, or at scale with the Manage Inventory delegation type .
For parent and child publishers using Manage Inventory, there is now one SupplyChain Object created with one node for the parent publisher’s seller ID, one node for the child publisher, and the schain
object is marked complete.
For parent and child publishers using Manage Account, the schain
object will have one node with the child publisher’s seller ID and the chain will be marked as complete. For Manage Account publishers, monetization occurs in the child publisher’s account. The child publisher is treated as the end publisher. The parent publisher’s information is not included in the schain
object.