Met het object SupplyChain kunnen kopers en tussenpersonen alle partijen bekijken die advertentievoorraad verkopen of wederverkopen. Het object werkt samen met ads.txt/app-ads.txt en sellers.json om transparantie te bieden in het advertentie-ecosysteem.
- De uitgever stuurt een biedingsverzoek.
- De koper ontvangt een biedingsverzoek en gegevens van het object SupplyChain.
- De koper zoekt de identiteit op van alle tussenpersonen die voorraad wederverkopen.
- De koper crawlt en verifieert leveranciers die zijn geautoriseerd om voorraad te verkopen.
Google maakt de objecten automatisch binnen een OpenRTB-verzoek of Google RTB-protocol, indien van toepassing.
Hoe werkt het object SupplyChain?
Het object SupplyChain, ook wel bekend als schainschain staat voor een specifieke entiteit in het biedingsverzoek. Het biedingsverzoek omvat alle entiteiten die zijn betrokken bij de rechtstreekse betalingsflow voor de advertentievoorraad.
sid) van hun subuitgevers delen via Ad Manager of de API zodat Google een volledig object SupplyChain kan maken.
// Voorbeeldobject
"schain": {
"complete": 1,
"nodes": [{
"asi":"google.com",
"sid":"pub-1234567891234567", // Dezelfde seller_id als voor de uitgever in sellers.json
"hp":1
}],
"ver":"1.0"
}
Lees de OpenRTB-documentatie voor ontwikkelaars en de IAB-documentatie voor meer informatie.
Het object SupplyChain kan er anders uitzien, afhankelijk van de manier waarop u met kopers werkt.
Uitgevers die rechtstreeks verkopen met Google
Voor uitgevers die voorraad rechtstreeks verkopen via Ad Manager, AdMob of AdSense, bevat het object schain 1 node voor 'google.com' met de seller_id die wordt vermeld in sellers.json.
Uitgevers die gebruikmaken van Open bieden
Uitgevers die gebruikmaken van Open bieden om samen te werken met externe exchanges, hebben 2 knooppunten in het object schain: 1 knooppunt voor google.com met de seller_id die wordt vermeld in sellers.json en 1 knooppunt voor de rendementspartner van de exchange.
Net zoals Google het knooppunt maakt voor google.com voordat het biedingsverzoek wordt gestuurd, moet de externe exchange het toepasselijke knooppunt toevoegen voordat het verzoek wordt doorgestuurd.
Alle tussenpersonen zonder betalingen
Tussenpersonen die geen betalingen verwerken, zijn niet opgenomen in het object SupplyChain. Dit omvat bieden via koptekst aan de clientzijde, bieden via koptekst zonder betalingen, voorraad delen en andere bemiddeling.
Uitgevers die betalingstussenpersonen gebruiken vóór het verzoek (Bèta)
Functies in de bètafase zijn misschien niet beschikbaar in uw netwerk. Houd de release-opmerkingen in de gaten voor informatie over wanneer deze functie algemeen beschikbaar komt.
Uitgevers die upstream van het verzoek aan Google Ad Manager betalingstussenpersonen gebruiken, moeten het object SupplyChain doorgeven volgens de IAB-richtlijnen. Het object SupplyChain mag alleen tussenpersonen bevatten die rechtstreeks betrokken zijn bij het betalingsproces voor de voorraad. Zulke tussenpersonen kunnen advertentieservertechnologie van derden omvatten die door de uitgever wordt gebruikt. Het object SupplyChain kan in het advertentieverzoek worden verstuurd met de schain-parameter.
Beschrijving
De parameter voor de toeleveringsketen (schain) accepteert een variabele waarde die een geserialiseerd SupplyChain-object moet zijn. Als deze parameter is opgenomen, voegt Google een node toe aan alle ontvangen schain-objecten voordat deze naar kopers worden gestuurd.
Bekijk de volledige IAB-documentatie voor de communicatie van SupplyChain-informatie via een tag (in plaats van OpenRTB).
Bekijk de vereisten voor correcte parsering vanschain
Op basis van de IAB-documentatie definieert het volgende de serialisatie voor het SupplyChain-object:
{SupplyChainObject}!{SupplyChainNode array}. SupplyChainObjectenSupplyChainNodeworden van elkaar gescheiden door komma's, zodat optionele velden kunnen worden weggelaten en komma's als scheidingstekens optioneel kunnen worden uitgesloten.- Elk
SupplyChainNode-element wordt gescheiden door een!. - Als de waarde van een property tekens bevat waarvoor URL-codering is vereist (bijvoorbeeld
,of!), moet de waarde vóór de serialisatie worden gecodeerd met een URL.
Volgorde van serialisatie
SupplyChainObject-property's worden in deze volgorde geserialiseerd:
ver,complete
SupplyChainNode-property's worden in deze volgorde geserialiseerd:
asi,sid,hp,rid,name,domain,ext
ext is exchange-specifiek. Google Ad Manager parseert deze property niet.Voorbeelden van hoe u het SupplyChain-object serialiseert
Hieronder vindt u 2 voorbeelden van manieren om het bovenstaande SupplyChain-object te serialiseren:
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
Gebruiksvoorbeelden
schain=1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1,,,,
Als de waarde voor asi exchange,1 was, ziet de serialisatie met escape-tekens er zo uit:
1.0,1!exchange%2C1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1
Vereisten en aanbevelingen
Hoewel deze parameter niet vereist is om advertenties weer te geven voor een specifieke implementatie of een specifiek transactietype, is deze vereist voor uitgevers die upstream van het verzoek aan Google Ad Manager betalingstussenpersonen gebruiken. Dit geldt ook voor uitgevers die advertentieservertechnologie van derden gebruiken.
SupplyChain zijn toegevoegd, moeten ook worden opgenomen in het ads.txt-/app-ads.txt-bestand van een uitgever, anders kunnen kopers het verkeer als niet geautoriseerd beschouwen.Uitgevers voor Beheer van meerdere klanten (Multiple Customer Management, MCM)
Met Beheer van meerdere klanten (Multiple Customer Management, MCM) kunnen uitgevers de AdMob-accounts van hun klanten beheren met dezelfde zichtbaarheid en controle als de uitgevers zelf.
Voor bovenliggende uitgevers en subuitgevers die gebruikmaken van AdMob MCM, bevat het object schain één node met de verkoper-ID van de subuitgever, één node voor de bovenliggende uitgever en is de keten gemarkeerd als volledig. In AdMob MCM worden inkomsten gegenereerd in het account van de subuitgever. De subuitgever wordt gezien als de einduitgever.