Présentation
L'API Marketplace Authorized Buyers est un ensemble de ressources que les acheteurs peuvent utiliser pour gérer de manière automatisée les éléments suivants:
- Négociations avec les éditeurs
- Packages d'enchères
- Accès client à l'interface utilisateur de la place de marché Authorized Buyers
Ce guide présente l'API Marketplace et explique comment ses ressources sont mises en correspondance avec les fonctionnalités de la place de marché dans l'interface utilisateur d'Authorized Buyers.
Enchérisseurs et acheteurs
L'API Marketplace est cohérente avec la structure de l'API Real-time Bidding. Ces deux API utilisent bidders
et buyers
comme ressources de niveau racine pour les opérations d'enchérisseur et d'acheteur. Vous pouvez utiliser les mêmes noms d'enchérisseur et d'acheteur dans les chemins de ressources pour les API Real-time Bidding et Marketplace.
Clients et utilisateurs des clients
Vous pouvez utiliser l'API Marketplace pour créer et gérer des clients et des utilisateurs, et pour accorder par programmation aux agences ou aux annonceurs l'accès à votre onglet Place de marché dans l'interface utilisateur Authorized Buyers.
Un Client
représente un client, une agence ou un annonceur associé à votre compte Authorized Buyers.
Un ClientUser
représente une personne spécifique disposant d'un accès à l'UI sous un Client
. Les utilisateurs du client ne peuvent pas accéder à l'API Marketplace. Les utilisateurs du client ont un accès limité à l'onglet Marketplace de votre compte. Les autorisations des utilisateurs du client sont déterminées par les role
spécifiés dans leur Client
parent.
Les autres ressources de l'API Marketplace font référence aux clients par le nom spécifié dans la ressource Clients
.
Pour en savoir plus sur les clients et leurs utilisateurs dans l'interface utilisateur de la place de marché Authorized Buyers, consultez les articles suivants du centre d'aide:
Packages d'enchères
Vous pouvez utiliser l'API Marketplace pour abonner ou désabonner des acheteurs et des clients des packages d'enchères, et pour afficher les packages d'enchères auxquels vous êtes abonné.
Un AuctionPackage
est semblable à un groupe de ciblage pour l'inventaire de la place de marché. Par exemple, un package d'enchères peut cibler un ensemble d'URL et d'ID d'application mobile en rapport avec les centres d'intérêt d'un acheteur.
Vous ne pouvez pas créer de packages d'enchères avec l'API Marketplace. Vous pouvez créer des packages d'enchères à l'aide de l'interface utilisateur de la place de marché Authorized Buyers. L'API Marketplace n'inclut pas d'informations de ciblage spécifiques associées aux packages d'enchères.
Vous pouvez partager des packages d'enchères avec d'autres acheteurs et clients, et faire en sorte que Google ou d'autres acheteurs les partagent avec vous.
Pour en savoir plus, consultez Packages d'enchères.
Profils d'éditeur
Vous pouvez utiliser l'API Marketplace pour afficher les profils des éditeurs avec lesquels vous pouvez négocier.
Un PublisherProfile
représente un éditeur dans l'API Marketplace. Les autres ressources de l'API Marketplace font référence aux éditeurs dont le nom est spécifié dans leur fichier PublisherProfile
.
Les profils d'éditeur contiennent des informations semblables à celles du champ Éditeurs dans l'onglet Découverte de l'interface utilisateur de la place de marché Authorized Buyers.
Pour en savoir plus, consultez Découvrir des éditeurs.
Propositions et accords
Vous pouvez utiliser l'API Marketplace pour négocier des accords avec des éditeurs. Voici quelques façons d'utiliser l'API Marketplace pour gérer des accords:
- Envoyer de nouvelles propositions.
- Négociez avec les éditeurs.
- Conclure des accords
- Diffuser des accords finalisés
- Commencer à renégocier des accords finalisés
Les propositions représentent le dernier état de négociation d'un ou de plusieurs accords entre un acheteur ou un client et un éditeur. Elles sont semblables à l'onglet Négociations de la place de marché Authorized Buyers.
Les accords représentent les dernières conditions d'un accord négocié dans le cadre d'une proposition donnée. Ils sont comparables à ceux figurant dans la liste d'accords intitulée NÉGOCIATION ACTUELLE de l'interface utilisateur de la place de marché Authorized Buyers pour une proposition donnée.
Les accords finalisés représentent les accords qui ont terminé la phase de négociation et qui sont prêts à être diffusés. y compris ceux qui sont déjà diffusés. Les accords finalisés sont semblables à ceux proposés dans l'onglet Accords de l'interface utilisateur de la place de marché Authorized Buyers.
Selon le type d'accord que vous négociez, le comportement peut varier selon les ressources de l'API Marketplace. Par exemple, les acheteurs ne peuvent pas lancer de négociations pour tous les types d'accords. Pour en savoir plus sur l'implémentation de l'API Marketplace pour les négociations, consultez les ressources suivantes:
Pour en savoir plus sur les négociations dans l'interface utilisateur de la place de marché Authorized Buyers, consultez les articles suivants: