API Marketplace

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:

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: