Processus d’intégration

Ce document inclut les informations nécessaires pour permettre aux partenaires fournisseurs de passer en revue, de planifier et d’exécuter une nouvelle intégration OpenRTB, ou de migrer d’une intégration de protocole SSP personnalisée vers la norme OpenRTB, de manière autonome.

Liste de vérification des prérequis

1. Contactez votre responsable de compte (ou ouvrez un ticket avec notre équipe de support technique) pour confirmer les informations suivantes :
   • ID du siège de membre et, s’il n’est pas encore demandé, création de nouveau siège de membre et informations d’identification de connexion à l’API de Xandr.
   • Points de terminaison pour les demandes d’enchères entrantes et, s’il n’est pas encore demandé, création d’un nouveau point de terminaison sur Xandr.
2. Passez en revue la documentation décrite ci-dessous et discutez des questions ouvertes :
   • Spécifications OpenRTB
   • FAQ - Processus d’intégration
   • Hiérarchie d’objets
   • Mappage d’inventaire
   • Synchronisation de l’utilisateur
   • Ads.txt/App-Ads.txt
   • Offres (le cas échéant)

• L’engagement devrait prendre 3 à 4 semaines.
• Le client doit examiner entièrement la liste de vérification des prérequis (ce document) et collecter toutes les informations avant de suivre les étapes ci-dessous.

Étape 1 : Formation de l’API/interface utilisateur autoguidée et création d’objets d’éditeur et de placement (durée estimée : 7 à 10 jours)

1. Passez en revue la documentation sur la hiérarchie d’objets Xandr et l’API/interface utilisateur.

2. Provisionnez les objets dont vous aurez besoin pour le test initial, via ou l’API. Pour plus d’informations , consultez la documentation de l’API .

3. Create des objets côté vente pour synchroniser les inventaires (au moins ceux qui sont nécessaires pour les tests fonctionnels initiaux) via l’interface utilisateur/l’API

   • Passer en revue la hiérarchie d’objets Xandr : groupe de placement → éditeur → membre → placement
   • Create un éditeur et un emplacement pour le test
     • Dans chaque objet, la valeur de code doit être remplie avec l’identificateur externe que le fournisseur de services partagés transmettra dans la demande d’enchère.
   • Documentation associée sur l’API
     • Service membre
     • Service d’éditeur
     • Service de groupe de placement (service de site)
     • Placement Service

4. Configurez un placement par défaut au niveau de l’éditeur et du membre. (si nous ne pouvons pas identifier l’inventaire à partir de la demande d’offre, l’impression sera consignée dans ce placement par défaut.)

5. Utilisez le code champ pour mapper vos demandes d’enchères à vos éditeurs et emplacements. Pour plus d’informations et d’exemples, consultez le FAQ sur l’intégration.

   Remarque

   Afin de fournir de la transparence à nos acheteurs et d’améliorer notre optimisation, nous demandons à nos partenaires de diviser leur inventaire par éditeur. Pour plus d’informations sur nos normes de structure d’inventaire, consultez notre page wiki Utiliser l’API pour synchroniser votre structure d’inventaire.

6. Utilisez le service serveur de publication pour créer des éditeurs mappés à votre inventaire.

   Remarque

   • Le code champ est obligatoire pour tous les vendeurs externes au niveau de l’éditeur et du placement. Il est vivement recommandé à tous les autres vendeurs de s’assurer que votre inventaire est aussi précis que possible afin qu’il puisse être examiné avec précision pour les problèmes de qualité, et en particulier pour la détection du domaine. Cette étape vous aidera à fractionner votre inventaire en balises hautement détectables et moins détectables, ce qui vous permettra d’isoler les impacts des domaines non détectables sur le reste de la viabilité de votre inventaire.
   • Pour créer ou modifier des éditeurs dans ou l’API, vous devez déclarer la relation d’inventaire. Les informations demandées sont des informations commerciales de base sur la façon dont l’inventaire est accessible et seront utilisées pour soutenir les efforts de qualité de l’inventaire de Xandr. Pour obtenir la liste complète des champs et leurs exigences d’utilisation, reportez-vous à la documentation du service publisher .

7. Configuration de la synchronisation utilisateur
   Stockez la table de mappage utilisateur entre Xandr et le vôtre à l’aide du service getUID. Découvrez plus d’informations dans La section Mappage d’ID utilisateur.

Étape 2 : Test du point de terminaison de demande d’enchère OpenRTB (durée estimée : 3 à 4 jours)

Xandr prend en charge le protocole OpenRTB 2.4pour recevoir toutes les impressions de type de média. Suivez la spécification OpenRTB 2.4 de IAB.

Utilisez les points de terminaison ci-dessous pour envoyer des demandes d’enchères OpenRTB de serveur à serveur à Xandr :

• http://MEMBER_ALIAS-useast..com/openrtb2member_id=MEMBER_ID&test=1
• http://MEMBER_ALIAS-uswest..com/openrtb2member_id=MEMBER_ID&test=1
• http://MEMBER_ALIAS-emea..com/openrtb2?member_id=MEMBER_ID&test=1
• http://MEMBER_ALIAS-apac..com/openrtb2?member_id=MEMBER_ID&test=1

N’hésitez pas à utiliser les exemples de demandes d’enchères de la page Demande d’enchère entrante auprès des fournisseurs de services de sécurité et à ajuster les champs de code en conséquence pour qu’ils correspondent à votre éditeur et à votre mappage d’inventaire de placement.

Vous devez utiliser le paramètre de chaîne de "test=1" requête sur vos appels pour identifier une impression de test. Il ne sera pas connecté aux rapports.

Étape 3 : Tests manuels

1. Fournissez un exemple de demande d’offre à Xandr.

2. Configurez un placement de test sur la plateforme Xandr et vérifiez que l’inventaire est correctement mappé.

3. Fournissez un exemple de création qui répond à toutes les exigences du placement du test.

4. Configurer la règle de qualité des annonces qui autorise uniquement l’acheteur de test Xandr à acheter des impressions sur le placement de test.

5. Supprimez "&test=1" de la chaîne de requête de point de terminaison au démarrage du test.

   Remarque

   Si vous ne supprimez "&test=1"pas , les imps ne seront pas enregistrés côté Xandr.

6. Déclenchez le trafic manuellement à partir de l’emplacement de test pour confirmer la réception d’une réponse d’offre, la créativité servie et les impressions enregistrées de votre côté.

7. Xandr exécutera un test de livraison à partir d’un siège de membre buy-side dédié et vous informera de tout écart avant de mettre à l’échelle votre inventaire.

8. Xandr valide vos demandes d’enchères OpenRTB et vous avertit au cas où le format doit être corrigé.  

Étape 4 : Test fonctionnel programmatique (trafic en direct)

1. Ouvrez une petite partie mais substantielle du trafic vers Xandr sur le point de terminaison établi (au moins plusieurs milliers d’imps par jour). Xandr confirme le volume de trafic envoyé et vérifie que les impressions sont transmises via nos rapports et qu’elles s’alignent sur vos rapports internes.
2. Exécutez le test pendant environ un jour et comparez les nombres pour vous assurer que l’écart entre vos rapports et Xandr est acceptable.

Étape 5 : Mise en ligne

1. Mapper tous vos inventaires sur la plateforme Xandr avant de passer en ligne avec 100 % du trafic.
2. Une fois le mappage d’inventaire terminé, accélèrez le trafic et supprimez les filtres qui peuvent être imposés pendant les tests, tels que le pré-ciblage du pays, le pré-ciblage des appareils et la limitation du volume d’enchères.

Étape 6 : Achèvement/Suivi (durée estimée : 2 à 3 jours)

Nous encourageons une montée en puissance progressive du trafic où des parties distinctes de votre inventaire sont envoyées à Xandr. La recommandation générale est de commencer par une petite partie du trafic (100-200 QPS).

Informez votre contact Xandr de la fin de l’intégration/migration auto-rythmée ; votre contact lancera les derniers tests de validation des exigences OpenRTB et vous fournira les résultats finaux et les commentaires.