Créer un accord
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}"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.
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. Vous pouvez donc identifier facilement le parent de cette manière.
Annuler une offre
- 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 annulée, la commande ne peut pas être réactivée.
Obtenir les détails d'un accord
- Obtenez les détails d'une commande. L'état est mis à jour une fois que l'utilisateur a accepté, archivé ou annulé la commande.
- Obtenez des informations sur le produit.
Obtenir la liste des offres
- LIST les commandes avec un filtre d'état pour obtenir toutes les commandes acceptées/en attente d'acceptation.
- LIST les produits avec le filtre external_deal_id.
- LIST tous les produits d'une commande.
Modifier un accord
- Mettez à jour les coordonnées de l'éditeur pour la commande.
- 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.
- partner_id ne permet pas la mise à jour.
- Mettre à jour le produit pour une mise à jour spécifique des conditions de l'accord.
- Les champs "name", "externalDealId", "transactionType", "pricingType" et "updateTime" ne peuvent pas être modifiés.
- La mise à jour de displayName ne nécessite pas l'acceptation de l'utilisateur.
- Si vous modifiez rateDetails ou creativeConfig, l'état de l'ordre parent passe à "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'accord
- Get Order (Obtenir la commande) si vous connaissez l'ID de commande correspondant. Vérifiez le champ "État".
- 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)
- Obtenez une source d'inventaire. Le nom est "exchanges/{exchangeId}/inventorysources/{external_deal_id}". Vérifiez l'état de l'acheteur.
- Offres de réservation
BUYER_STATUS_ACTIVEsignifie 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.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.BUYER_STATUS_PAUSEDsignifie que l'annonceur a explicitement mis en veille l'accord. Aucune dépense ne sera effectuée dans cet état.
- Offres sans réservation
BUYER_STATUS_ACTIVEsignifie 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ère qui correspond aux conditions de l'accord, qu'il existe un élément de campagne actif ciblant cet accord et que la demande d'enchère 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. **BUYER_STATUS_PENDINGnon applicable.BUYER_STATUS_PAUSEDsignifie que l'annonceur a explicitement mis en veille l'accord. Aucune dépense ne sera effectuée dans cet état.
- Offres de réservation
Mettre en veille/Réactiver un accord après l'avoir accepté
- Mettez à jour la source d'inventaire et l'état du vendeur.
- La suspension ou la réactivation n'ont aucune incidence sur la diffusion des offres. 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, une place de marché peut constater que l'heure de fin d'une offre acceptée n'est pas correcte. Elle peut alors utiliser le produit Mettre à jour 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
Nous autorisons les modifications de tous les champs, à l'exception de certains champs critiques pour la diffusion, tels que startTime, endTime, rateDetails, creativeConfig, etc. Nous avons mis en place des validations pour ces champs critiques pour la diffusion. En règle générale, les modifications apportées à ces champs, à l'exception de creativeConfig, sont autorisées si l'heure de début de la promotion est au moins un jour plus tard. Seules les mises à jour incrémentielles sont autorisées pour les offres en cours dont l'heure de début est passée, mais dont l'heure de fin est future. Aucune modification n'est autorisée pour les accords terminés dont l'heure de fin est passée. Par exemple, il n'est pas autorisé de modifier le rateDetails d'un accord conclu il y a un an. Dans ce cas, le produit DV3 Update générera une erreur de validation.