Workflows des API

Créer un accord

1. Vérifiez si un produit a déjà été créé en LISTANT les produits avec le filtre external_deal_id. External_deal_id doit être unique pour tous les produits.

   GET https://dv360seller.googleapis.com/v1beta1/{parent=exchanges/*/orders/*}/products?filter=externalDealId="{external_deal_id}"
   

2. Créer une commande Le nom est généré par DV3. Nous vous recommandons de stocker cet ID quelque part dans votre système pour pouvoir le récupérer ultérieurement.

3. Créez un produit dans une commande. Le nom du produit est généré par DV3. Nous vous recommandons de stocker cet ID quelque part dans votre système pour pouvoir le récupérer ultérieurement.

   Vous pouvez également toujours utiliser LIST avec external_deal_id. Le champ "Nom" contient à la fois l'ID de commande et l'ID de produit, ce qui vous permet d'identifier facilement le parent.

Annuler une offre

1. Mettre à jour l'état de la commande sur "Annulée" Cette option n'est disponible que si la commande n'a pas été acceptée. "Annulée" est un état final. Une fois la commande annulée, vous ne pouvez plus la réactiver.

Obtenir les détails d'une offre

1. Obtenez les détails d'une commande. L'état est mis à jour une fois que l'utilisateur a accepté, archivé ou annulé la commande.
2. Obtenez des informations sur le produit.

Obtenir la liste des offres

1. LIST les commandes avec un filtre d'état pour obtenir toutes les commandes acceptées/en attente d'acceptation.
2. LIST les produits avec le filtre external_deal_id.
3. LIST tous les produits d'une commande.

Modifier un accord

1. Mettre à jour la commande pour les coordonnées de l'éditeur.
   1. name, ne permet pas la mise à jour(ne peut pas être défini dans field_mask). L'état ne peut être défini sur "Annulé" que via l'API.
   2. partner_id ne permet pas la mise à jour.
2. Mettre à jour le produit pour une mise à jour spécifique des conditions de l'accord.
   1. Les champs "name", "externalDealId", "transactionType", "pricingType" et "updateTime" ne peuvent pas être modifiés.
   2. La mise à jour de displayName ne nécessite pas l'acceptation de l'utilisateur.
   3. Si vous modifiez les détails ou creativeConfig du taux de mise à jour, l'état de l'ordre parent passera à "En attente d'acceptation". Les annonceurs DV3 seront invités à accepter les nouvelles conditions sur la page de négociation, que la commande précédente ait été acceptée ou non.

Vérifier si l'utilisateur a accepté l'offre

1. Get Order (Obtenir la commande) si vous connaissez l'ID de commande correspondant. Vérifiez le champ "État".
2. Si l'ID de la commande n'a pas été suivi : List Products with external_deal_id filter, figure out order name from product name, puis Get Order. Vérifiez le champ "État".

Vérifier si l'utilisateur a configuré l'offre(uniquement pour PG)

1. Obtenez une source d'inventaire. Le nom est "exchanges/{exchangeId}/inventorysources/{external_deal_id}". Vérifiez l'état de l'acheteur.
   1. Offres de réservation
      1. BUYER_STATUS_ACTIVE signifie qu'un accord a été accepté et configuré. L'accord devrait générer des dépenses dans cet état lorsque DV360 reçoit une demande d'enchères correspondant aux conditions de l'accord. Un élément de campagne est généré automatiquement lors de l'étape de configuration de l'accord. Pour en savoir plus, consultez Configuration des offres.
      2. BUYER_STATUS_PENDING : la commande a été acceptée, mais l'accord n'a pas encore été configuré. Aucune dépense ne sera effectuée dans cet état.
      3. BUYER_STATUS_PAUSEDsignifie que l'annonceur a explicitement mis en veille l'accord. Aucune dépense ne sera effectuée dans cet état.
   2. Accords sans réservation
      1. BUYER_STATUS_ACTIVE signifie qu'un accord a été accepté. L'accord devrait générer des dépenses dans cet état lorsque DV360 reçoit une demande d'enchères qui correspond aux conditions de l'accord, qu'un élément de campagne actif cible cet accord et que la demande d'enchères correspond aux critères de ciblage de l'élément de campagne. Pour en savoir plus, consultez Élément de campagne.** Il n'existe PAS d'API Seller permettant de vérifier si un accord a été ciblé par des éléments de campagne. **
      2. BUYER_STATUS_PENDINGnon applicable.
      3. BUYER_STATUS_PAUSEDsignifie que l'annonceur a explicitement mis en veille l'accord. Aucune dépense ne sera effectuée dans cet état.

Mettre en veille/Réactiver un accord après l'avoir accepté

1. Mettez à jour la source d'inventaire et l'état du vendeur.
   1. La suspension ou la réactivation n'ont aucune incidence sur la diffusion des accords. Lorsqu'un vendeur met en veille une offre, un message s'affiche pour informer les annonceurs. Cela permet à l'annonceur de résoudre les problèmes liés à un accord sans dépenses.

Renégociation (modifier un accord après l'avoir accepté)

La renégociation désigne les modifications apportées à un accord après son acceptation par l'acheteur. Cela peut être très utile aux plates-formes d'échange et aux acheteurs pour appliquer de nouvelles modifications aux accords acceptés. Par exemple, si l'échange constate que l'heure de fin d'une offre acceptée n'est pas correcte, il peut utiliser le produit Update de DV3 pour envoyer des mises à jour aux acheteurs DV3 si l'offre n'a pas encore commencé.

Modifications autorisées et non autorisées

Pour connaître les modifications autorisées et non autorisées selon les différentes phases de l'accord, cliquez ici.