Dans les accords de programmatique garanti, vous négociez avec les vendeurs le nombre d'impressions que vous achetez à un prix fixe. Lorsque vous acceptez une proposition d'accord de programmatique garanti, vous vous engagez à acheter l'inventaire du vendeur en fonction des conditions négociées. Pour en savoir plus sur vos engagements et les outils permettant de surveiller votre conformité, consultez l'article du centre d'aide décrivant le framework pour le contrat de niveau de service de programmatique garanti.
Créer
Les accords de programmatique garanti sont créés lorsque les négociations commencent par un appel d'offres. Vous pouvez lancer des négociations en envoyant un appel d'offres à un vendeur via buyers.proposals.sendRfp.
L'appel d'offres doit contenir programmaticGuaranteedTerms pour que la proposition résultante corresponde à un accord de programmatique garanti. Les vendeurs peuvent également vous envoyer un appel d'offres, qui apparaîtra sous la forme d'une proposition dans l'API Marketplace. Une fois créée, vous pouvez trouver la proposition d'accord avec buyers.proposals.list, et la négociation entre vous et le vendeur peut commencer.
Négocier
Une fois qu'une proposition est créée pour un accord de programmatique garanti, vous pouvez la négocier avec le vendeur en ajustant la proposition et l'accord correspondant jusqu'à ce que les deux parties soient satisfaites ou que la proposition soit annulée. Lors d'une négociation réussie, vous pouvez effectuer l'une des opérations suivantes:
- Interrogez les modifications apportées à la proposition ou à l'accord: chaque fois qu'une modification est apportée à une proposition ou à l'accord correspondant, la
proposalRevisionest incrémentée. Vous pouvez l'utiliser pour détecter à quel moment le vendeur a accepté votre proposition ou a répondu par une contre-offre. - Corriger la proposition ou l'accord : modifiez votre proposition ou envoyez une contre-offre au vendeur. Cette action incrémente la
proposalRevision. - Communication avec le vendeur: les propositions contiennent des remarques visibles par les acheteurs et les vendeurs. Par exemple, vous pouvez ajouter une note pour fournir du contexte sur une modification que vous avez apportée à une proposition ou à son accord.
Finaliser et préparer la diffusion
Si vous êtes satisfait d'une proposition et que son state est BUYER_ACCEPTANCE_REQUESTED, vous pouvez l'accepter.
Cette action permet de finaliser l'accord, qui commence à être diffusé à flightStartTime.
Pour vous assurer que la diffusion de l'accord ne commence que lorsque vous avez préparé vos créations, nous vous recommandons de contacter votre responsable de compte technique afin qu'il désactive ce comportement par défaut pour vos accords de programmatique garanti. Vous pourrez ainsi signaler manuellement qu'ils sont prêts à être diffusés. Voici un exemple de workflow dans lequel vous indiquez manuellement quand vos accords de programmatique garanti sont prêts à être diffusés:
- Négociez la proposition avec le vendeur.
- Utilisez l'API Real-time Bidding pour envoyer des créations pour examen: les créations que vous souhaitez diffuser doivent être examinées et approuvées pour être utilisées dans des accords.
- Acceptez la proposition: une fois la proposition acceptée, les accords acceptés sont reflétés dans les accords finalisés.
- Utilisez l'API Real-time Bidding pour récupérer les créations envoyées précédemment et vérifier qu'elles sont approuvées pour être utilisées dans les enchères sur les accords dans le système d'enchères en temps réel: consultez le
dealsPolicyCompliancepour vérifier que les créations sont approuvées et peuvent être placées en réponse aux demandes d'enchères entrantes.- Si la création n'a pas été approuvée, consultez les thèmes pour déterminer le motif du refus. Ajustez la création si nécessaire et corrigez-la pour relancer l'examen jusqu'à ce que tous les problèmes soient résolus.
- Ajoutez toutes les créations qui seront utilisées dans l'accord finalisé: nous vous recommandons d'ajouter des créations à l'accord avec lequel vous souhaitez les utiliser avant de lancer la diffusion de l'accord.
- Signaler manuellement que l'accord est prêt pour la diffusion : une fois que l'accord est prêt pour la diffusion, vous commencez à recevoir des demandes d'enchères pour l'accord au
flightStartTimeconfiguré, et ce jusqu'à ce que les valeursflightEndTimeouimpressionCapsoient atteintes.
Renégocier
Une fois un accord finalisé, vous ou le vendeur pouvez lancer une renégociation en modifiant la proposition ou ses accords. Lors de la renégociation, la ressource finalizedDeals reflète l'accord précédent et continue d'être diffusée en conséquence, si possible. À la place, la ressource deals reflète l'état actuel de la renégociation, qui se déroule de la même manière que la négociation initiale.
Si vous et le vendeur acceptez l'accord renégocié, il remplacera l'accord finalisé d'origine et sera diffusé en fonction du nouveau contrat. Dans le cas contraire, s'il est annulé, l'accord retrouvera l'état dans lequel il se trouvait avant le début de la renégociation.
Enchérir sur des impressions pour les accords de programmatique garanti
Lorsqu'un accord de programmatique garanti commence à être diffusé, l'intégration des enchères en temps réel reçoit des demandes d'enchères pour cet accord et doit définir des enchères en fonction des conditions de l'accord (par exemple, à un prix spécifique pour un nombre défini d'impressions sur une période donnée).
Une demande d'enchère donnée peut inclure plusieurs accords de programmatique garanti. Dans ce cas, vous devez répondre pour chaque ID d'accord envoyé dans la demande. Voici les champs directement pertinents pour les accords de programmatique garanti:
| Protocole Google | Protocole OpenRTB | Description |
|---|---|---|
BidRequest.adslot.matching_ad_data.direct_deal.direct_deal_id
|
BidRequest.imp.pmp.deals.id
|
Identifiant unique de l'accord. Il correspond à l'ID de ressource de l'accord renvoyé par l'API Marketplace. |
BidRequest.adslot.matching_ad_data.direct_deal.deal_type
|
BidRequest.imp.pmp.deals.ext.deal_type
|
Type d'enchère, qui sera défini sur PROGRAMMATIC_GUARANTEED ou sur "3" pour le code JSON OpenRTB.
|
BidRequest.adslot.matching_ad_data.direct_deal.fixed_cpm_micros
|
BidRequest.imp.pmp.deals.bidfloor
|
Équivaut au CPM de l'accord convenu entre l'acheteur et le vendeur. Il s'affiche sous la forme fixedPrice dans l'API Marketplace. Pour les accords de programmatique garanti, cette valeur remplace toute valeur spécifiée dans la réponse à l'enchère.
|
BidRequest.adslot.matching_ad_data.direct_deal.publisher_blocks_overridden
|
BidRequest.imp.pmp.deals.ext.publisher_blocks_overridden
|
toujours true pour les accords de programmatique garanti. Les catégories exclues sont donc autorisées.
|
BidRequest.adslot.matching_ad_data.direct_deal.must_bid
|
BidRequest.imp.pmp.deals.ext.must_bid
|
Indique si les acheteurs doivent enchérir sur l'accord. Par exemple, si l'accord est en avance sur le calendrier, la valeur est définie sur "False" et les enchères sont facultatives. Sinon, les enchères sont requises. Par conséquent, ne pas définir d'enchères peut avoir un impact négatif sur la diffusion de l'accord et la disponibilité de l'inventaire. |
Mettre en veille et réactiver la diffusion
Si vous ne pouvez temporairement pas enchérir dessus, vous devez utiliser la méthode buyers.finalizedDeals.pause pour mettre en veille un accord de programmatique garanti finalisé. Vous pouvez choisir cette option si votre création a été initialement approuvée, mais a été refusée et doit donc être renvoyée. Notez que même si vous ne recevrez plus de demandes d'enchères pour l'accord, vous devrez tout de même respecter les obligations qui ont été négociées en tant que conditions de l'accord.
Pour réactiver la diffusion de l'accord finalisé, vous pouvez utiliser buyers.finalizedDeals.resume.