Criteo Resellers Program API V2 - Guide de référence complet
Notions
Les concepts suivants sont utilisés dans l'API du programme revendeur Criteo
- Budget - un budget limite les dépenses d'un vendeur sur une ou plusieurs campagnes. Il a un montant initial ainsi qu'un montant dépensé. Il a également une date de début et de fin. Les clics sur une annonce vendue via une campagne vendeur sont facturés sur le budget associé selon le tarif négocié. Un budget peut être consommé par plusieurs campagnes de vendeur tant qu'elles appartiennent au même vendeur.
- Campagne - une campagne est un plan d'action pour promouvoir les produits de vos vendeurs.
- Annonceur - L'annonceur est l'entité faisant la publicité au nom du vendeur. En règle générale, l'annonceur est une place de marché utilisant la solution CRP pour monétiser le budget publicitaire du vendeur. Alias : place de marché
- Vendeur - un vendeur vend des produits sur votre marché. Un vendeur profite d'une campagne en obtenant une plus grande visibilité des produits sur Internet via la plateforme Criteo. Cependant, un vendeur n'interagit pas financièrement avec Criteo.
- Campagne de vendeur - une campagne de vendeur est une ressource qui encapsule les règles commerciales convenues par le vendeur à utiliser dans une campagne spécifique. Par exemple, il contient l'enchère maximale que le vendeur est prêt à placer sur une campagne. Différentes plates-formes (web vs mobile) ont généralement des campagnes différentes.
Les ressources exposées dans cette API sont les suivantes :
- Annonceurs (annonceurs)
- Vendeur (vendeurs)
- Campagne vendeur (vendeur-campagnes)
- Budget (budgets)
De plus, la ressource Campagne v1 (/marketing/v1/campaigns) est également référencée à partir de l'API.
Ces ressources ont chacune des identifiants uniques au monde, à l'exception de la campagne vendeur pour laquelle le sellerId et le campaignId servent d'identifiant unique.
La ressource vendeur est associée à un annonceur et possède également un nom unique dans ce contexte.
Conception
La conception du schéma v2 est basée sur le diagramme de relations suivant pour les ressources les plus importantes.
Notez que chaque campagne de vendeur utilise une clé primaire composite composée d'un seul vendeur et d'une seule campagne. Il peut être associé à plusieurs ressources Budget. Un budget peut être consommé par plusieurs campagnes de vendeur tant qu'elles appartiennent au même vendeur. Cependant, les règles métier stipulent qu'il y a au plus un budget courant quotidien et un budget courant non quotidien. Un budget quotidien peut être configuré sans budget non quotidien derrière lui, mais en soi un budget quotidien n'est pas suffisant pour activer une campagne de vendeur et commencer à diffuser des annonces ; un budget non quotidien ("total") est requis.
Points de terminaison de l'API
- Ce document de conception décrit les services trouvés sous la racine de service suivante : https://api.criteo.com/marketing/v2/crp
- Une description swagger de l'API sera disponible ici : https://api.criteo.com/marketing/swagger
Cette racine de service sera utilisée exclusivement pour le domaine du programme Revendeur. Dans le passé, le programme Revendeur faisait partie de la racine de service https://api.criteo.com/marketing/v1/ sous le segment de chemin URI des vendeurs.
Le reste de cette section est organisé par adresse URI. Il y a quatre sous-sections principales :
- Annonceurs
- Vendeurs (vendeurs)
- Campagnes de vendeurs (campagnes de vendeurs)
- Budgets (budgets)
Chaque sous-section commence par un tableau des terminaux pris en charge.