L'objet SupplyChain permet aux acheteurs et aux intermédiaires d'identifier toutes les parties qui vendent ou revendent un inventaire publicitaire. Cet objet fonctionne en conjonction avec les fichiers ads.txt/app-ads.txt et sellers.json afin d'apporter de la transparence à l'écosystème publicitaire.
- L'éditeur envoie une demande d'enchère.
- L'acheteur reçoit la demande d'enchère et les données associées depuis l'objet SupplyChain.
- L'acheteur examine les identités de tous les intermédiaires qui revendent l'inventaire.
- L'acheteur explore et valide les vendeurs autorisés à vendre l'inventaire.
Google créera automatiquement les objets dans une requête OpenRTB ou via le protocole Google RTB, le cas échéant.
Fonctionnement de l'objet SupplyChain
L'objet SupplyChain, également appelé schainschain représente une entité spécifique participant à la demande d'enchère, qui inclut toutes les entités impliquées dans le flux de paiement direct pour l'inventaire.
// Exemple d'objet
"schain": {
"complete": 1,
"nodes": [{
"asi":"google.com",
"sid":"pub-1234567891234567", // seller_id identique pour l'éditeur dans sellers.json
"hp":1
}],
"ver":"1.0"
}
Pour en savoir plus, consultez la documentation d'OpenRTB destinée aux développeurs et la documentation de l'IAB.
L'objet SupplyChain prend différentes formes selon la manière dont vous travaillez avec les acheteurs.
Éditeurs qui vendent directement avec Google
Pour les éditeurs qui vendent leur inventaire directement via Ad Manager, AdMob ou AdSense, l'objet schain ne contient qu'un nœud pour "google.com" avec le seller_id figurant dans le fichier sellers.json.
Éditeurs qui utilisent Open Bidding
Pour les éditeurs qui utilisent Open Bidding pour travailler avec des places de marché tierces, l'objet schain compte deux nœuds : un premier pour google.com avec le seller_id figurant dans le fichier sellers.json, et un deuxième pour le partenaire de rendement.
De la même manière que Google crée le nœud pour google.com avant d'envoyer la demande d'enchère, la place de marché tierce doit ajouter son nœud avant de transmettre la demande.
Tous les intermédiaires hors paiement
Les intermédiaires qui ne gèrent pas le paiement, y compris les enchères d'en-tête ("header bidding") côté client, les enchères d'en-tête hors paiement, le partage d'inventaire et autre médiation, ne sont pas inclus dans l'objet SupplyChain.
Les éditeurs qui utilisent des intermédiaires de paiement avant la demande (Bêta)
Les fonctionnalités en version bêta risquent de ne pas être disponibles sur votre réseau. Consultez les notes de version pour découvrir à quelle date cette fonctionnalité sera accessible à tous.
Les éditeurs qui utilisent des intermédiaires de paiement en amont de la demande envoyée à Google Ad Manager doivent transmettre l'objet SupplyChain, conformément aux consignes de l'IAB. L'objet SupplyChain ne doit contenir que les intermédiaires directement impliqués dans le flux de paiement de l'inventaire. Ces intermédiaires peuvent inclure la technologie d'ad server tiers utilisée par l'éditeur. L'objet SupplyChain peut être envoyé dans la demande d'annonce à l'aide du paramètre schain.
Description
Le paramètre de chaîne d'approvisionnement (schain) accepte une valeur variable qui doit être un objet SupplyChain sérialisé. Lorsque ce paramètre est utilisé, Google ajoute un nœud à tous les objets schain reçus avant de les envoyer aux acheteurs.
Consultez la documentation complète de l'IAB pour en savoir plus sur la communication des informations sur l'objet SupplyChain au moyen d'un tag (plutôt qu'avec OpenRTB).
Voir les exigences pour une analyse correcte deschain
Conformément à la documentation de l'IAB, le code suivant définit la sérialisation de l'objet SupplyChain :
- Les propriétés
{SupplyChainObject}!{SupplyChainNode array}. SupplyChainObjectetSupplyChainNodesont séparées par des virgules afin que les champs facultatifs puissent être omis et que ces séparateurs puissent éventuellement être exclus. - Chaque élément
SupplyChainNodeest séparé par un signe!. - Si la valeur d'une propriété contient des caractères nécessitant un encodage sous forme d'URL (
,ou!, par exemple), elle doit être encodée sous forme d'URL avant la sérialisation.
Ordre de sérialisation
Les propriétés SupplyChainObject sont sérialisées dans cet ordre :
ver,complete
Les propriétés SupplyChainNode sont sérialisées dans cet ordre :
asi,sid,hp,rid,name,domain,ext
ext est propre à la place de marché. Google Ad Manager n'analyse pas cette propriété.Exemples de sérialisation de l'objet SupplyChain
Voici deux exemples de sérialisation de l'objet SupplyChain ci-dessus :
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
Exemples d'utilisation
schain=1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1,,,,
Si la propriété asi avait la valeur exchange,1, la sérialisation avec des caractères d'échappement se présenterait comme suit :
1.0,1!exchange%2C1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1
Exigences et recommandations
Ce paramètre n'est pas obligatoire pour diffuser des annonces, quel que soit le type d'implémentation ou de transaction visé, mais il est obligatoire lorsque les éditeurs utilisent des intermédiaires de paiement en amont de la demande envoyée à Google Ad Manager. Cela inclut les éditeurs qui utilisent la technologie d'ad server tiers.
SupplyChain doit également être représenté dans le fichier ads.txt/app-ads.txt d'un éditeur, faute de quoi les acheteurs pourraient considérer que le trafic n'est pas autorisé.Éditeurs Multiple Customer Management
Multiple Customer Management (MCM) permet aux éditeurs parents de monétiser l'inventaire des éditeurs enfants soit individuellement avec le type de délégation "Gérer le compte", soit à grande échelle avec le type de délégation "Gérer l'inventaire".
Pour les éditeurs parents et enfants qui utilisent Gérer l'inventaire, un objet SupplyChain est désormais créé avec un nœud pour l'ID de vendeur de l'éditeur parent, un nœud pour l'éditeur enfant, et l'objet schain est marqué comme complet.
Pour les éditeurs parents et enfants qui utilisent Gérer le compte, l'objet schain comportera un nœud avec l'ID de vendeur de l'éditeur enfant, et la chaîne sera marquée comme complète. Pour les éditeurs qui utilisent "Gérer le compte", la monétisation a lieu dans le compte de l'éditeur enfant. L'éditeur enfant est considéré comme l'éditeur final. Les informations sur l'éditeur parent ne sont pas incluses dans l'objet schain.
