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 programmatique 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 les ressources de cette API 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 conforme à la structure de l'API d'enchères en temps réel. Les deux API utilisent bidders et buyers comme ressources au niveau racine pour les opérations de l'enchérisseur et de l'acheteur. Vous pouvez utiliser les mêmes noms d'enchérisseur et d'acheteur dans les chemins de ressources des API d'enchères en temps réel et de place de marché.

Clients et utilisateurs du client

Vous pouvez utiliser l'API Marketplace pour créer et gérer des clients et des utilisateurs de clients, et pour accorder de manière programmatique 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'interface utilisateur sous un Client. Les utilisateurs du client ne peuvent pas accéder à l'API Marketplace. Les utilisateurs des clients disposent d'un accès limité à l'onglet Place de marché de votre compte. Les autorisations utilisateur 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:

Responsables du plan média

Un média-planner est une agence ou une autre entité qui négocie des accords de manière indépendante avec les éditeurs, et autorise un ou plusieurs enchérisseurs à placer des enchères pour le compte de leurs accords finalisés. Il s'agit d'enchères privées ou d'accords préférés. Vous ne pourrez pas les afficher ni interagir avec eux tant qu'ils ne seront pas finalisés. Ils apparaîtront ensuite dans la réponse bidders.finalizedDeals.list.

Pour déterminer si un accord finalisé a été négocié par un média-planner, vous pouvez vérifier si le champ mediaPlanner de l'accord a été renseigné. Les média-planners définissent une liste d'ID de siège spécifiques aux DSP qui sont éligibles aux transactions liées à l'accord. Vous pouvez la consulter dans le champ eligibleSeatIds. Dans les demandes d'enchères en temps réel, ces ID de siège peuvent figurer dans des listes d'autorisation ou de blocage définies par l'éditeur, qui déterminent si les enchères sont exclues de la mise aux enchères. Ils peuvent apparaître dans les champs BidRequest suivants:

  • Protocole OpenRTB
    • BidRequest.wseat
    • BidRequest.bseat
    • BidRequest.imp.pmp.deals.wseat
  • Protocole Google RTB
    • BidRequest.adslot.allowed_seat_ids
    • BidRequest.adslot.blocked_seat_ids
    • BidRequest.adslot.matching_ad_data.direct_deal.allowed_seat_ids

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'applications mobiles en rapport avec les intérêts commerciaux d'un acheteur.

Vous ne pouvez pas créer de packages d'enchères avec l'API de la place de marché. Vous pouvez utiliser l'interface utilisateur de la place de marché Authorized Buyers pour créer des packages d'enchères. 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. Vous pouvez également 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

L'API Marketplace vous permet d'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 PublisherProfile.

Les profils d'éditeur contiennent des informations semblables à celles de É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 de la place de marché 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 l'interface utilisateur 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 sont ceux qui ont terminé la phase de négociation et sont prêts à être diffusés. Cela inclut les accords déjà diffusés. Les accords finalisés sont semblables à ceux disponibles 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, un acheteur ne peut 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 ressources suivantes: