Assistance pour les agences partenaires

Cet article explique comment les plates-formes côté demande (DSP) peuvent aider les agences en s'intégrant à la plate-forme de celles-ci. Elles peuvent ainsi fournir des rapports globaux et améliorer l'efficacité des workflows pour les agences et les éditeurs.

Les agences peuvent négocier et conclure des accords programmatiques non garantis directement avec les éditeurs. Ces accords au niveau de l'agence seront négociés entre le compte de l'agence et l'éditeur. Ils pourront ensuite faire l'objet de transactions sur toutes les DSP configurées dans le compte de l'agence. Lorsqu'un accord avec une agence est créé, un ID d'accord universel est généré et utilisé par toutes les DSP participantes. Cela permet de réduire le nombre d'ID d'accords en double (un par compte de DSP) pour une même campagne.

Exigences d'intégration pour effectuer des transactions à l'aide d'un compte d'agence

Les agences fournissent à Google la liste des ID de compte de chaque DSP dans l'espace de noms de la DSP, que Google mappera avec leur compte d'agence. Les DSP devront renvoyer l'ID de compte de DSP dans leur réponse aux enchères afin que les dépenses puissent être correctement associées à l'agence.

• Spécification OpenRTB (JSON ou Protobuf) : renseignez le champ seat dans seatbid. Pour les partenaires qui remplissent déjà ce champ, aucune action immédiate n'est requise.
• Renseignez le champ "advertiser_domain" dans les réponses aux enchères en plus de l'ID de compte de DSP de l'agence.

Pour les enchérisseurs intégrés à notre API Marketplace, Google renverra les accords conclus par les agences dans la ressource d'accord finalisée au niveau de l'enchérisseur. Étant donné que ces accords n'appartiennent pas à l'enchérisseur, les accords avec une agence renvoyés dans cette ressource seront en lecture seule et n'auront pas de proposition correspondante.

Flux d'accords et exigences liées aux API pour les accords non garantis

Les accords sont négociés directement entre les agences et les éditeurs via les interfaces utilisateur Google.

• Un éditeur peut créer une proposition pour l'agence A dans l'interface utilisateur Google Ad Manager. 
• L'agence A se connecte à l'interface utilisateur de son compte d'agence pour accepter la proposition ou négocier des modifications. 
• Lorsqu'un accord est finalisé et actif, il devient visible pour les DSP sélectionnées par l'agence. Ces accords d'agence (contrairement aux accords traditionnels) sont en lecture seule du point de vue de la DSP, mais elles ne sont pas immuables (les agences peuvent renégocier les conditions via les interfaces utilisateur Google).

Pour accéder aux accords conclus par les agences, les DSP doivent s'intégrer à l'API Marketplace Authorized Buyers.

Points d'intégration clés pour les enchérisseurs/DSP :

• Obtenez les accords finalisés grâce à l'API Finalized Deals au niveau de l'enchérisseur : les accords d'agence appartiennent au compte de l'agence, et non à un compte géré par une DSP. Par conséquent, les points de terminaison buyers.finalizedDeals et buyers.proposals ne renverront pas ces accords. Les enchérisseurs peuvent également utiliser l'API Finalized Deals au niveau de l'enchérisseur pour obtenir la liste complète de leurs accords finalisés.
• Packages d'enchères : de même, les enchérisseurs peuvent récupérer des packages d'enchères en appelant le point de terminaison bidders.auctionPackages.list.

Modifications au niveau des objets d'API : l'objet d'API Deals existant sera étendu pour inclure des informations supplémentaires sur les comptes d'agence. Les modifications suivantes (indiquées en gras) détaillent les ajouts apportés à la documentation publique.

Exemple

Représentation JSON d'un accord

{

  // ...

 

  // ... Lorsque le champ media_planner

  // est renseigné, ce champ est vide et l'acheteur facturé est

  // déterminé en fonction de la réponse à l'enchère.

  // Format : `buyers/{buyerAccountId}`

  "billedBuyer" : chaîne

 

   // Le champ d'union negotiating_buyer ne peut être que l'un des éléments suivants:

  "buyer": chaîne,

  "client": chaîne,

 // Ce champ représente un média-planner (par exemple, une agence ou 

 // un annonceur majeur).

 "mediaPlanner" : {

    object (MediaPlanner)

}

  // Fin de la liste des types possibles pour le champ d'union "negotiating_buyer".

 

 // Si défini, ce champ contient la liste des ID de compte spécifiques au DSP qui 

  // est éligible pour effectuer des transactions pour cet accord.

  "eligibleSeatId": [

   chaîne

 ],

 

  // ...

}

Remarque : Voici les principaux changements :

• Nouveau champ mediaPlanner permettant d'identifier les offres spécifiques aux agences.
• Le champ billedBuyer sera vide pour les accords propres aux agences.
• Le nouveau champ eligibleSeatIds contient l'ensemble des comptes dans l'espace de noms propre à la DSP qui peuvent définir une enchère sur l'accord. Les réponses aux enchères pour l'accord sans ID de compte spécifié ou dont l'ID de compte ne figure pas dans cette liste seront filtrées par Google.

Flux d'accords et exigences concernant les API pour les accords programmatiques garantis (PG)

Pour que les DSP puissent acheter des accords PG créés depuis un compte d'agence, quelques exigences supplémentaires s'appliquent au flux afin de permettre la prise en charge des accords garantis.

1. Comme pour les accords non garantis, les accords PG deviennent visibles pour la DSP sélectionnée par l'agence une fois qu'ils sont finalisés. Toutefois, les transactions reposant sur des accords ne commencent qu'après la configuration appropriée. 
2. Une fois l'accord finalisé, les agences doivent configurer les créations et les dépenses associées dans le système de la DSP. Une fois cette étape de configuration terminée, la DSP peut en informer Google en appelant l'API Marketplace Authorized Buyers. Plus précisément, l'API des accords finalisés au niveau de l'enchérisseur dispose d'un nouveau point de terminaison appelé SetReadyToServe.
3. Lorsque SetReadyToServe est appelé sur un accord, celui-ci devient actif et Google commence à envoyer des demandes d'enchères à la DSP sélectionnée après l'heure de début spécifiée de l'accord. À ce stade, suivez les consignes relatives aux enchères pour les accords PG.
   Remarque  : Le signal must_bid doit être respecté pour rester dans les conditions du contrat de niveau de service des enchères PG.