Met het object SupplyChain kunnen kopers en tussenpersonen alle partijen bekijken die advertentievoorraad verkopen of wederverkopen. Het object werkt samen met ads.txt
/ads.txt
en ads.txt
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
, is onderdeel van een OpenRTB-biedingsverzoek en bestaat uit nodes. Elke node in het object schain
schain
staat voor een specifieke entiteit in het biedingsverzoek. Het biedingsverzoek omvat alle entiteiten die zijn betrokken bij de rechtstreekse betalingsflow voor de advertentievoorraad.
// 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"
}
Raadpleeg de OpenRTB-documentatie voor ontwikkelaars en de IAB-documentatie voor meer informatie.
Het object SupplyChain ziet er anders uit, 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, beschikken over 2 nodes in het object schain
: 1 node voor google.com met de seller_id
die wordt vermeld in sellers.json en 1 node voor de rendementspartner van de exchange.
Net als Google de node maakt voor google.com voordat het biedingsverzoek wordt gestuurd, is de exchange verantwoordelijk voor het toevoegen van de toepasselijke node 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. Dergelijke 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.
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 die Beheer van meerdere klanten (Multiple Customer Management, MCM) gebruiken
Met Beheer van meerdere klanten (Multiple Customer Management, MCM) kunnen bovenliggende uitgevers inkomsten genereren met voorraad van subuitgevers via het machtigingstype Account beheren (individueel) of het machtigingstype Voorraad beheren (op schaal).
Voor partners die Account beheren gebruiken
Voor bovenliggende uitgevers en subuitgevers die gebruikmaken van Account beheren, bevat het object schain
1 node met de verkoper-ID van de subuitgever en is de keten gemarkeerd als volledig. Voor uitgevers die gebruikmaken van Account beheren, worden inkomsten gegenereerd via het account van de subuitgever. De subuitgever wordt gezien als de einduitgever. De gegevens van de bovenliggende uitgever worden niet opgenomen in het object schain
.
Voor partners die Voorraad beheren gebruiken
Het object SupplyChain is nu gemarkeerd als voltooid voor MCM-uitgevers die Voorraad beheren gebruiken. Er is 1 node voor MCM-subuitgevers, 1 node voor bovenliggende MCM-uitgevers en de keten is gemarkeerd als voltooid.
Deze update vereist dat bovenliggende MCM-uitgevers die Voorraad beheren gebruiken, de verkoper-ID (SID) van hun subuitgevers delen via de Ad Manager-frontend of -API.
Voorbeeld van het voltooide object SupplyChain
"schain" : {
"ver": "1.0",
"complete" : 1,
"nodes" : [
// Node voor MCM-subuitgever
{
"asi":"mcm-parent-example.com", // Dit is een voorbeeld. Voer het werkelijke domein van de bovenliggende uitgever in.
"sid":"52e41fac28963d1e058a106f", // Verkoper-ID van subuitgever in seller.json van bovenliggende uitgever
"hp":1,
},
// Node voor bovenliggende uitgever die Voorraad beheren van MCM gebruikt
{
"asi":"google.com",
"sid":"pub-1234567891234567", // Uitgever-ID van bovenliggende MCM-uitgever in seller.json van Google
"hp":1,
}
]
}
Veelgestelde vragen
Waarom moeten bovenliggende MCM-uitgevers een sellers.json-bestand maken?
Informatie van partners openbaar beschikbaar maken door toe te staan dat hun gegevens worden vermeld in het sellers.json-bestand, is een belangrijke stap om kopers te helpen hun voorraad te verifiëren.
Meer informatie over de IAB sellers.json-specificatie.
Moeten al mijn subuitgevers een geldig ads.txt-bestand hebben?
Als het ads.txt-bestand van de subuitgever geen regel bevat waarin de bovenliggende MCM-uitgever als DIRECT wordt vermeld (bijvoorbeeld MCM-parent-example.com, Seller-ID for the MCM child, DIRECT), maar op de Google-regel de uitgever-ID van de bovenliggende uitgever wordt vermeld (bijvoorbeeld google.com, PUB ID for the MCM parent, RESELLER, f08c47fec0942fa0), heeft dit dan een negatieve invloed op de opbrengst? Is de toeleveringsketen volledig?