GAM Demand Mediation - Topsort Documentation

GAM Demand Mediation permet aux marketplaces de générer des revenus incrémentaux à partir d’impressions de bannières qui resteraient autrement non pourvues, sans modifier la configuration Topsort existante. Pour les emplacements de bannières existants, la demande GAM peut être activée par l’équipe compte Topsort. Si Topsort renvoie de la demande, la marketplace affiche la bannière Topsort. Si Topsort ne renvoie pas de bannière, la réponse d’enchère inclut une balise qui demande une publicité display à GAM. Si GAM renvoie une publicité, elle est affichée aux mêmes dimensions que l’emplacement de bannière configuré, par exemple un emplacement 300 × 200 sur la page d’accueil.

GAM Demand Mediation peut aussi être utilisé par des marketplaces qui ne sont pas onboardées aux publicités bannières Topsort. Dans cette configuration, Topsort renvoie la balise GAM pour les emplacements activés plutôt qu’une bannière Topsort.

Avantages

Monétiser l’inventaire invendu : Les marketplaces peuvent générer des revenus à partir des emplacements de bannières même en l’absence de demande Topsort.
Sources de demande flexibles : Les emplacements GAM peuvent être configurés pour accéder à l’Open Auction pour la demande non endémique ou à des private marketplace deals pour des annonceurs sélectionnés.

Disponibilité

GAM Demand Mediation est disponible pour les marketplaces Topsort dans le monde entier, sous réserve de l’approbation de Google.

Sources de demande

Marques endémiques

Google peut travailler avec les retailers pour faire passer sur GAM des marques endémiques existantes qui ne sont pas encore onboardées chez Topsort, ou qui ne sont pas prêtes à s’onboarder chez Topsort. La demande GAM peut alors servir à pourvoir les emplacements de bannières chez le retailer. Les marques ou leurs agences achètent cet inventaire via une demand-side platform (DSP), telle que Google Display & Video 360 (DV360). Une DSP est une plateforme que les annonceurs et les agences utilisent pour acheter de l’inventaire publicitaire de manière programmatique auprès de différents éditeurs. Les campagnes peuvent être transactées via un Preferred Deal ou une Private Auction :

Un Preferred Deal est un accord non garanti entre le retailer et un acheteur spécifique à un CPM fixe. L’acheteur bénéficie d’un accès préférentiel aux impressions éligibles à ce prix, mais n’est pas tenu d’acheter chaque impression disponible. Pour les Preferred Deals, la marque ou son agence peut lancer un RFP (request for proposal) depuis sa plateforme d’achat. Un RFP démarre le processus de négociation entre l’acheteur et l’éditeur pour le deal.
Une Private Auction est une enchère non garantie dans laquelle le retailer sélectionne les acheteurs autorisés à participer et définit un CPM floor minimum. Les acheteurs invités enchérissent les uns contre les autres, et l’enchère détermine le prix gagnant. Le retailer crée le deal dans GAM, et la marque ou l’agence invitée l’accepte et enchérrit via sa DSP.

Dans les deux cas, le retailer et la marque s’alignent sur les détails de la campagne, notamment les exigences créatives, les dates, les objectifs de dépense ou de diffusion le cas échéant, l’URL de destination, et le CPM fixe ou le floor d’enchère. Le retailer peut exiger que l’URL de destination renvoie vers son site. Topsort configure ensuite le deal correspondant dans GAM, et la marque achète contre ce deal via sa DSP.

Marques non endémiques

L’Open Auction de GAM donne accès à la demande du web ouvert. Elle convient généralement aux emplacements où les publicités peuvent renvoyer les utilisateurs hors de la marketplace, par exemple après le checkout. La marketplace définit des règles de tarification, notamment des CPM floors ou des CPM cibles. Les acheteurs éligibles enchérissent en temps réel, et l’enchère détermine le gagnant et le prix de clearing.

Protections

Pour les marques endémiques, les Preferred Deals ou les Private Auctions peuvent être utilisés. Ces options permettent au retailer de contrôler quels acheteurs sont éligibles à accéder à l’inventaire. Pour les emplacements non endémiques, l’Open Auction peut être utilisée avec deux contrôles principaux :

Protections : Le retailer peut configurer des exclusions et des filtres GAM pour empêcher des catégories d’annonceurs indésirables ou d’autres demandes inadaptées.
Contexte de page et pertinence : La demande non endémique peut n’être activée que sur les emplacements où elle est appropriée, par exemple après le checkout plutôt qu’avant. Des signaux contextuels pertinents sur la page et l’emplacement peuvent aussi être transmis à Google pour éclairer la sélection des publicités.

Par ailleurs, les contrôles GAM peuvent restreindre des catégories d’annonceurs ou des annonceurs spécifiques. Google utilise aussi des processus automatisés pour filtrer les créatives.

Paiements

Pour la demande transactée via GAM, Google verse à Topsort les revenus publicitaires applicables après ses frais, puis Topsort verse au retailer sa part.

Reporting

Topsort fournira au retailer un dashboard couvrant sa performance GAM, y compris des métriques telles que les impressions, les clics, les revenus et le fill rate. Le reporting peut aussi être exporté et partagé avec les marques endémiques le cas échéant.

Processus d’onboarding

Les marketplaces intéressées par GAM Demand Mediation doivent contacter leur équipe compte Topsort. Une intégration type ne nécessite que quelques heures d’ingénierie côté marketplace et peut généralement être réalisée lors d’une seule session de travail avec un ingénieur d’intégration Topsort.

Créer un compte GAM

Créez un compte GAM s’il n’en existe pas déjà un.Le retailer doit disposer de son propre compte GAM pour établir la relation MCM Manage Inventory avec Topsort.

Aligner le périmètre du pilote

Sélectionnez deux à trois emplacements de bannières pour le pilote initial et convenez des politiques de modération de contenu applicables.

Configurer la connexion GAM MCM

Liez les comptes Topsort et retailer à l’aide du modèle Multiple Customer Management (MCM) Manage Inventory de GAM. Avec Manage Inventory, le retailer délègue l’inventaire publicitaire concerné à Topsort pour monétisation. L’inventaire, la configuration de la demande et le reporting sont gérés via le réseau GAM de Topsort, tandis que le retailer conserve son propre compte GAM.Le retailer ajoute les entrées requises à son fichier ads.txt. Topsort gère toute configuration sellers.json requise de son côté.

Implémenter le flux de passback

Ajoutez un petit extrait de code à chaque emplacement de bannière activé afin que l’emplacement puisse afficher une publicité Topsort ou une publicité GAM.

Tester l'intégration

Topsort valide l’intégration avant le lancement.

Exemple de réponse

Lorsqu’aucune demande Topsort n’est disponible pour un emplacement de bannière activé pour GAM Demand Mediation, l’endpoint d’enchères renvoie un snippet GAM dans le champ asset du gagnant. La marketplace affiche ce snippet pour montrer la bannière GAM.

{
  "results": [
    {
      "resultType": "banners",
      "winners": [
        {
          "asset": [
            {
              "content": "{\"type\": \"gam_snippet\", \"content\": \"<div id=\\\"gam-ad\\\"><script>googletag.cmd.push(function() { googletag.display(\\\"div-gpt-ad-12345\\\"); });</script></div>\"}"
            }
          ],
          "type": "url",
          "id": "https://www.example.com",
          "resolvedBidId": "PHRSCwoQBpvFL1sveOSZBCyVii_LCRIQAAAAAAAAAAAAAAAAAAAAABoQAAAAAAAAAAAAAAAAAAAAACIbChdodHRwczovL3d3dy5leGFtcGxlLmNvbRAFUIDQzO7O7_H__wFyEAAAAAAAAAAAAAAAAAAAAAA",
          "rank": 1
        }
      ],
      "error": false
    }
  ]
}

Chaque entrée du tableau asset contient un champ content avec une chaîne JSON de type gam_snippet. La marketplace analyse ce contenu et affiche le HTML/JavaScript intégré pour montrer la bannière GAM.

Flux de passback

Le seul développement requis côté marketplace est un petit extrait de code dans chaque emplacement de bannière activé pour la demande GAM. Si la réponse contient une balise de passback GAM, la page affiche la publicité GAM. Sinon, elle affiche la publicité Topsort standard.

// response is response from Topsort auction endpoint
const { results } = await response.json();

const passback = results?.[0]?.winners?.[0]?.metadata?.passbacktag;

if (passback) {
  const iframe = document.createElement("iframe");
  document.getElementById("banner-slot-3")?.appendChild(iframe);

  iframe.contentDocument.write(passback);
  iframe.contentDocument.close();
} else {
  // render normal Topsort ad
}

​Avantages

​Disponibilité

​Sources de demande

​Marques endémiques

​Marques non endémiques

​Protections

​Paiements

​Reporting

​Processus d’onboarding

​Exemple de réponse

​Flux de passback

Avantages

Disponibilité

Sources de demande

Marques endémiques

Marques non endémiques

Protections

Paiements

Reporting

Processus d’onboarding

Exemple de réponse

Flux de passback