Accords de programmatique garanti

Dans le cadre des contrats programmatiques garantis, vous négociez avec les vendeurs le nombre d'impressions que vous achèterez à un prix fixe. Si vous acceptez une proposition de Contrat Programmatique Garanti, vous vous engagez à acheter l'inventaire du vendeur selon les 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 cadre SLA programmatique garanti.

Créer

Les accords programmatiques garantis sont créés lorsque les négociations débutent par un appel d'offres (RFP). Vous pouvez entamer des négociations en envoyant une demande de proposition (RFP) à un vendeur avec buyers.proposals.sendRfp. L'appel d'offres doit contenir programmaticGuaranteedTerms pour que la proposition résultante soit un accord programmatique garanti. Les vendeurs peuvent également vous envoyer un appel d'offres, qui s'affichera sous forme de proposition dans l'API Marketplace. Une fois la proposition créée, vous pouvez la retrouver dans buyers.proposals.list. Vous pouvez alors commencer à négocier avec le vendeur.

Négocier

Une fois qu'une proposition de contrat programmatique garanti est créée, vous pouvez négocier avec le vendeur en ajustant la proposition et le contrat correspondant jusqu'à ce que les deux parties soient satisfaites ou que la proposition soit annulée. Lors d'une négociation réussie, vous pourriez effectuer l'une des actions suivantes :

  • Interroger pour détecter les modifications apportées à la proposition ou à l'accord : chaque fois qu'une modification est apportée à une proposition ou à l'accord correspondant, proposalRevision est incrémenté. Vous pouvez utiliser cette fonction pour détecter si le vendeur a accepté votre proposition ou s'il a répondu par une contre-offre.
  • Corriger la proposition ou l'accord : modifiez votre proposition ou envoyez une contre-offre au vendeur. Cela incrémentera le proposalRevision.
  • Communiquer avec le vendeur : les propositions contiennent des notes 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 pour le service

Lorsque vous êtes satisfait d'une proposition et que son state est BUYER_ACCEPTANCE_REQUESTED, vous pouvez accepter la proposition. Cela finalise l'accord, qui commence à être appliqué à partir du flightStartTime.

Afin de garantir que l'offre ne soit diffusée que lorsque vos créations publicitaires sont prêtes, nous vous recommandons de contacter votre responsable technique de compte pour désactiver ce comportement par défaut pour vos offres programmatiques garanties et de signaler manuellement lorsqu'elles sont prêtes à être diffusées. Voici un exemple de flux de travail dans lequel vous signalez manuellement quand vos offres programmatiques garanties sont prêtes à être diffusées :

  • Négocier la proposition avec le vendeur
  • Utilisez l'API d'enchères en temps réel pour soumettre des créations pour examen : les créations que vous avez l'intention de placer doivent être examinées et approuvées pour être utilisées dans les transactions.
  • Accepter la proposition : Une fois qu’une proposition est acceptée, les accords acceptés sont reflétés dans les accords finalisés.
  • Utilisez l'API d'enchères en temps réel pour récupérer les créations soumises précédemment et confirmer qu'elles sont approuvées pour être utilisées dans les enchères sur les transactions dans les enchères en temps réel : consultez le dealsPolicyCompliance pour 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 topics pour déterminer la raison du refus. Ajustez la création si nécessaire, et patch pour lancer une nouvelle révision jusqu'à ce que tous les problèmes soient résolus.
  • Utilisez l'API Real-time Bidding pour ajouter l'accord à toutes les créations qui seront utilisées dans l'accord. L'ajout d'un accord à une création permet à l'éditeur associé à l'accord d'examiner cette création avant le début de la diffusion.
    • Si un éditeur exige une relecture manuelle des éléments créatifs, les offres comportant des éléments créatifs non approuvés par l'éditeur seront exclues de la vente aux enchères. Google recommande d'ajouter l'offre à tous les supports créatifs que vous comptez utiliser dans le cadre de cette offre avant son lancement.
  • Signalez manuellement que l'offre est prête à être servie : Une fois l'offre prête à être servie, vous commencerez à recevoir des demandes d'enchères pour l'offre au flightStartTime configuré, qui continueront jusqu'à ce que son flightEndTime ou impressionCap soit atteint.

Renégocier

Une fois la transaction finalisée, vous ou le vendeur pouvez initierrenégociation en modifiant la proposition ou ses termes. Pendant la renégociation, la ressource finalizedDeals reflète l'accord précédent et continuera à fonctionner sur la base de celui-ci si possible. La ressource deals reflète plutôt l'état actuel de la renégociation, qui se déroulera de manière similaire à 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 nouvel accord. Autrement, en cas d'annulation, l'accord reviendra à son état antérieur à la renégociation.

Définir des enchères pour les impressions dans les accords de programmatique garanti

Lorsqu'un accord programmatique garanti commence à être diffusé, votre intégration enchères en temps réel recevra des demandes d'enchères pour cet accord et devra enchérir en fonction des termes de l'accord, par exemple, à un prix spécifique pour un nombre défini d'impressions sur une période de temps.

Une demande d'enchère donnée peut inclure plusieurs accords PG. Dans ce cas, vous devrez répondre pour chaque identifiant de transaction soumis dans la requête. Les domaines directement pertinents pour les contrats programmatiques garantis comprennent les suivants :

Protocole Google Protocole OpenRTB Description
BidRequest.adslot.matching_ad_data.direct_deal.direct_deal_id BidRequest.imp.pmp.deals.id Identifiant unique de l'offre. Cela correspondra à l'identifiant de ressource de l'offre tel que renvoyé par l'API Marketplace.
BidRequest.adslot.matching_ad_data.direct_deal.deal_type BidRequest.imp.pmp.deals.ext.deal_type Le type d'enchère, qui sera défini sur PROGRAMMATIC_GUARANTEED, ou "3" pour OpenRTB JSON.
BidRequest.adslot.matching_ad_data.direct_deal.fixed_cpm_micros BidRequest.imp.pmp.deals.bidfloor Il sera équivalent au CPM de l'accord conclu entre l'acheteur et le vendeur. Il s'affichera sous la forme fixedPrice dans l'API Marketplace. Pour les accords programmatiques garantis, cette valeur remplacera 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 offres programmatiques garanties, ce qui signifie que les catégories exclues sont autorisées.
BidRequest.adslot.matching_ad_data.direct_deal.must_bid BidRequest.imp.pmp.deals.ext.must_bid Indique si les acheteurs sont tenus d'enchérir sur l'accord. Par exemple, si la transaction est en avance sur le calendrier prévu, cette option serait désactivée et les enchères deviendraient facultatives. Dans le cas contraire, une offre est requise, ce qui signifie que le fait de ne pas soumettre d'offre peut avoir un impact négatif sur la réalisation de la transaction et la disponibilité des stocks.

Mettez en pause et reprenez le service

Vous devez utiliser la méthode buyers.finalizedDeals.pause pour mettre en veilleuse un accord programmatique garanti finalisé si vous ne pouvez pas enchérir dessus temporairement. Par exemple, vous pourriez procéder ainsi si votre création avait été initialement approuvée, mais ensuite refusée et devait par conséquent être soumise à nouveau. Notez que cela vous empêchera de recevoir des demandes d'enchères pour l'accord, mais que vous devrez toujours respecter les obligations négociées comme conditions de l'accord.

Pour reprendre la diffusion de l'accord finalisé, vous pouvez utiliser buyers.finalizedDeals.resume.