Un élément Deal représente un segment d'inventaire, des termes, des détails de ciblage et d'autres informations permettant de diffuser des annonces. Vous pouvez inclure un ou plusieurs accords dans une Proposal pour négocier avec les éditeurs.
Types d'accords
Vous pouvez utiliser trois types d'accords dans le cadre de négociations:
- Accords d'enchères privées (initiés par l'éditeur)
- Accords préférés
- Accords de programmatique garanti
Cycle de vie
Cette section décrit les différentes étapes du cycle de vie d'un accord.
Créer des propositions
Les acheteurs peuvent entamer des négociations en envoyant un appel d'offres, où le type d'accord est spécifié dans le corps de la demande par preferredDealTerms ou programmaticGuaranteedTerms. Ces types d'accords nécessitent les champs flightStartTime et flightEndTime.
Pour envoyer une proposition, vous devez faire référence à un éditeur via son PublisherProfile.
Négocier avec les éditeurs
Au cours de cette étape, vous effectuez les opérations suivantes:
- Mettez à jour la proposition et les accords correspondants.
- rechercher des mises à jour de l'éditeur ;
- Décidez quand accepter les conditions de la proposition.
Vous pouvez appliquer un correctif à une proposition ou à un accord pour apporter des modifications. Lors de la mise à jour d'une proposition, la limite est de proposalRevision.
Annuler la négociation
Que se passe-t-il lorsque vous annulez la négociation d'une proposition et des accords correspondants varie selon que la proposition dispose d'un proposalRevision finalisé ou non.
Si aucun élément proposalRevision finalisé n'existe, l'état de la proposition est TERMINATED, et celle-ci n'est plus disponible à la négociation. Dans ce cas, vous devez envoyer une nouvelle proposition pour reprendre la négociation avec l'éditeur.
Dans le cas contraire, la dernière version (proposalRevision) finalisée de la proposition et de ses accords revient à la dernière version finalisée.
Vous ne pouvez pas annuler des propositions pour des accords d'enchères privées avec l'API Marketplace. Vous pouvez archiver des accords d'enchères privées dans l'interface utilisateur de la place de marché Authorized Buyers.
Finaliser les accords
Une fois que les deux parties ont accepté une proposition, les accords qu'elle contient sont considérés comme finalisés. Vous pouvez utiliser la ressource buyers.finalizedDeals pour gérer vos accords finalisés.
Si une proposition est modifiée avant que les deux parties ne l'acceptent, elles doivent toutes les deux accepter la nouvelle révision avant que les accords de la proposition ne soient considérés comme finalisés.
Diffuser des accords finalisés
Une fois qu'un accord est finalisé, il apparaît dans les demandes d'enchères en fonction de la période spécifiée par flightStartTime et flightEndTime. Si aucune période de diffusion n'est spécifiée (uniquement possible pour les accords d'enchères privées), l'accord est diffusé indéfiniment.
Une fois finalisés, les accords commencent à être diffusés dès que possible. La diffusion commence généralement à l'heure flightStartTime spécifiée.
Si vous souhaitez désactiver le comportement de diffusion par défaut et indiquer manuellement quand vous êtes prêt à commencer à recevoir des demandes d'enchères, demandez à votre responsable de compte technique de vous permettre de définir manuellement les accords comme prêts pour la diffusion.
Google vous recommande de commencer manuellement à diffuser des accords de programmatique garanti si vous devez préparer des créations pour ces accords afin de vous assurer que les créations sont examinées et prêtes à être soumises dans les enchères pour les enchères en temps réel avant que les accords ne commencent à être diffusés. Une fois que vous avez ajouté les créations que vous souhaitez placer avec un accord de programmatique garanti, nous vous recommandons de vérifier les créations associées à l'accord avant de commencer à diffuser des annonces.
Dans les demandes d'enchères, les accords peuvent être représentés par l'un des champs suivants, en fonction du protocole:
- Google:
BidRequest.adslot[].matching_ad_data[].direct_deal[].direct_deal_id - OpenRTB:
BidRequest.imp[].pmp.deals[].id
Vous pouvez mettre en veille et réactiver les accords préférés et les accords de programmatique garanti lorsqu'ils ont commencé à être diffusés. Si vous mettez en veille un accord, vous ne recevrez plus de demandes d'enchères le concernant jusqu'à ce que vous le réactiviez.
Seul l'éditeur peut mettre en veille les accords d'enchères privées.
Lancer la renégociation
Les acheteurs et les éditeurs peuvent commencer à renégocier les accords préférés et les accords de programmatique garanti finalisés. Vous pouvez commencer la renégociation en modifiant une proposition ou ses accords. Vous pouvez ensuite renégocier jusqu'à ce que les deux parties acceptent les modifications ou jusqu'à ce que la renégociation soit annulée.
En cas d'acceptation, les accords révisés de la proposition remplacent les accords finalisés existants et sont diffusés sur la base des conditions mises à jour.
En cas d'annulation, la proposition et ses accords retrouvent la dernière valeur proposalRevision finalisée.
Lors de la renégociation, les accords précédemment finalisés continuent d'être diffusés. Vous pouvez continuer à consulter vos accords finalisés et leur dernière révision de proposition.
La renégociation n'est pas possible pour les accords d'enchères privées.
Arrêter la diffusion
L'attribut dealServingStatus des accords finalisés pour tous les types d'accords compatibles est défini sur ENDED une fois qu'ils ne sont plus diffusés. Voici quelques exemples de conditions susceptibles de mettre fin à la période de diffusion d'un accord:
- La période définie dans
flightStartTimeetflightEndTimeest transmise. Cette pratique est courante pour les accords préférés ou les accords de programmatique garanti, car ces champs sont obligatoires. - Le
impressionCapde l'accord de programmatique garanti a été atteint.
Les accords d'enchères privées qui ne définissent pas de flightStartTime ni de flightEndTime peuvent être diffusés indéfiniment.