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 Saceschain-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}. SupplyChainObjectandSupplyChainNodeproperties are comma delimited such that optional fields can be omitted and comma separators for which can be optionally excluded.- Each
SupplyChainNodeelement 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-udgivere
Værktøjet Multiple Customer Management (MCM) giver udgivere mulighed for at administrere deres kunders AdMob-konti med samme grad af synlighed og kontrol som på deres egne konti.
For overordnede og underordnede udgivere, der bruger MCM i AdMob, får schain-objektet én node med den underordnede udgivers sælger-id, og kæden markeres som fuldstændig. Når der bruges MCM i AdMob, finder indtægtsgenereringen sted på den underordnede udgivers konto. Den underordnede udgiver behandles som slutudgiveren. Den overordnede udgivers oplysninger er ikke inkluderet i schain-objektet.