Questions fréquentes sur l'API Deal Sync

Trouvez les réponses aux questions fréquentes sur l'intégration à l'API Display & Video 360 Deal Sync.

Q : Qu'est-ce que mon ID d'échange ?

R : L'ID de place de marché est attribué par l'équipe Display & Video 360 lors de la configuration de l'authentification.

Q : Quel est l'objectif de la hiérarchie des commandes et des produits ?

R : Cette hiérarchie permet aux éditeurs et aux annonceurs de négocier plusieurs accords et de les envoyer ensemble sous la forme d'un seul objet de négociation. Des restrictions s'appliquent : tous les produits d'une même commande doivent partager le même type de transaction et le même type de prix. Vous pouvez toujours utiliser une configuration avec une commande et un produit.

Q : Existe-t-il un type d'accord disponible pour TOUS les annonceurs ?

R : L'API Deal Sync est conçue pour les offres privées. Pour les accords publics sélectionnés pour tous les annonceurs, consultez Packages d'enchères (packages d'inventaire).

Q : Que se passe-t-il si une offre n'a pas de date de fin ?

R : Une date de fin est requise. Vous pouvez donc définir une date future. L'année maximale autorisée est 2036. Les dates de fin peuvent être modifiées ou prolongées à l'avenir.

Q : Le champ "dimensionCreativeConfig" autorise-t-il plusieurs tailles ?

R : Oui, mais un seul type de création est autorisé par produit.

Q : Les créations natives sont-elles acceptées pour les accords programmatiques garantis ?

R : Non. Les accords par réservation (garantis) ne sont pas compatibles avec les créations natives (CREATIVE_TYPE_NATIVE).

Contactez votre représentant Google si vous souhaitez diffuser des accords programmatiques garantis qui acceptent les créations natives.

Q : Acceptez-vous les prix d'enchères pour les transactions réservées ?

R : Non. Les accords avec réservation (garantis) n'acceptent que les prix fixes.

Q : La durée est-elle obligatoire pour les accords de programmatique garanti (PG) vidéo ?

R : Non. Si la durée n'est pas définie, la valeur par défaut est ANY.

Q : Certains états de commande empêchent-ils un accord d'effectuer des transactions ?

R : Non. La commande est un objet de négociation uniquement. Les modifications apportées à la diffusion des annonces ne prennent effet que lorsque l'annonceur accepte la commande.

Q : Que se passe-t-il pour un accord accepté si la place de marché envoie un appel de mise à jour ?

R : L'accord continue d'être diffusé selon les conditions précédemment acceptées. Une fois que l'annonceur a accepté les nouvelles conditions, l'accord commence à diffuser des annonces avec les nouvelles conditions.

Q : Une offre continuera-t-elle d'être diffusée si les conditions mises à jour n'ont pas encore été acceptées ?

R : En supposant que le CPM a déjà été modifié au niveau de la place de marché et qu'il est indiqué dans la demande d'enchère :

1. Pour les accords par réservation : l'accord ne dépensera pas tant que l'annonceur ne l'aura pas accepté à nouveau. Les éléments de campagne sont générés en fonction des conditions de l'accord. Les modifications restent en négociation jusqu'à ce qu'elles soient acceptées par l'annonceur.
2. Pour les accords sans réservation : la diffusion dépend du ciblage d'élément de campagne de l'accord. Si les demandes d'enchères correspondent aux critères de ciblage de l'élément de campagne pour cette offre, la diffusion se poursuit.

Q : Pouvons-nous réutiliser un ID d'offre pour plusieurs offres ?

R : Non. Les external_deal_id doivent être uniques pour tous les produits.

Q : Une offre peut-elle avoir plusieurs partenaires ?

R : Si vous souhaitez associer un accord à plusieurs partenaires, envoyez-le à un partenaire central.

Q : L'ID de partenaire associé à un accord peut-il être modifié après sa création ?

R : Non. Une fois une commande créée, le partenaire ne peut plus être modifié.

Q : Acceptez-vous plusieurs noms d'éditeur dans une commande ?

R : Le champ "Nom de l'éditeur" est une chaîne utilisée à des fins d'information pour l'annonceur. Vous pouvez spécifier plusieurs noms d'éditeurs séparés par des virgules ou indiquer "Plusieurs éditeurs de la place de marché X".

Q : Quelle est la différence entre les états de commande "ANNULÉE" et "ARCHIVÉE" ?

R : Les utilisateurs peuvent archiver et restaurer des commandes. Une fois annulée, une commande ne peut pas être réactivée ni annulée.

Q : Que sont les "accords instantanés" ?

R : Les offres instantanées nécessitent un effort d'intégration distinct à l'aide du point de terminaison de l'API Seller. Ignorez les attributs spécifiques aux offres instantanées, car ils ne sont pas liés au workflow de synchronisation des offres.

Q : Que dois-je vérifier si je reçois une erreur "Requête incorrecte" ?

R : Voici quelques causes courantes :

1. Consultez le guide de référence pour vous assurer que tous les champs obligatoires sont renseignés.
2. Vérifiez que external_deal_id est unique pour tous les produits.
3. Assurez-vous que les offres de réservation ne spécifient pas de tarification par enchères.

Si le problème persiste, testez la requête avec un client HTTP tel que Postman pour inspecter les messages d'erreur détaillés dans le corps de la réponse.

Si aucune des solutions précédentes ne résout le problème, contactez l'équipe d'assistance de l'API Display & Video 360 Seller.