Apprenez à utiliser l’API d’enchères de marques sponsorisées pour créer des enchères pour les promotions de marques.
L’API d’enchères de marques sponsorisées vous permet d’organiser des enchères pour promouvoir des marques en utilisant des ressources, du texte et des produits associés.
Avant de commencer
Pour utiliser l’API d’enchères de marques sponsorisées, assurez-vous d’avoir effectué les étapes suivantes :
Le point de terminaison /auctions/sponsored-brand vous permet d’organiser des enchères pour les emplacements de marques sponsorisées.Pour la spécification complète de ce point de terminaison, consultez la documentation de l’API.
auctions : un tableau contenant des objets d’enchères.
winners : le nombre maximum de gagnants pour l’enchère.
placementId : l’ID de l’emplacement où l’annonce apparaîtra.
triggers : critères de ciblage comprenant :
products.ids : un tableau d’ID de produits associés à l’enchère.
searchQuery : termes de recherche pour le ciblage basé sur les mots-clés.
category.id : catégorie de produit pour un ciblage plus large.
geoTargeting : (Optionnel) identifiant de localisation géographique pour le filtrage des campagnes basées sur l’emplacement.
opaqueUserId : (Optionnel) identifiant d’utilisateur anonyme pour la personnalisation et le ciblage amélioré.
Réponse
Ne mettez pas en cache cette réponse ni ses résultats. Les enchères doivent rester uniques par vue de page pour garantir un bon fonctionnement.La mise en cache peut entraîner des résultats répétés pour plusieurs utilisateurs ou sessions.
Si aucune erreur de requête ne se produit, le point de terminaison renvoie les résultats de l’enchère.
Réponse avec gagnants
Exemple de réponse lorsque des gagnants sont trouvés :
content.aiGeneratedAssets est un tableau optionnel contenant les URL des assets image que l’annonceur a déclaré générés ou modifiés avec l’IA. Faites correspondre ces URL aux assets que vous affichez pour déterminer quels créatifs portent une déclaration de l’annonceur.Seuls les assets déclarés positivement sont inclus.
Réponse sans gagnants
Exemple de réponse lorsqu’aucun gagnant n’est trouvé :