Instructions d’intégration des données en temps réel

Bien que la configuration soit légèrement différente de celle des soumissionnaires réguliers qui achètent des médias, les fournisseurs de données avec des intégrations en temps réel sont configurés en tant que « soumissionnaires » dans notre système. Une fois que votre fournisseur de données a été créé et que vous avez reçu des informations d’identification, vous pouvez commencer à le configurer en suivant les étapes ci-dessous.

Implémenter l’API Impression Bus

Effectuez les étapes suivantes pour commencer à utiliser l’API Impression Bus (api.adnxs.com) :

Étape 1 : Utilisez vos informations d’identification d’API pour vous authentifier.

Étape 2 : Vous devez définir vos paramètres de liste de contrôle d’accès afin d’accepter les plages d’adresses IP du bus d’impression de Xandr. Veillez à autoriser les plages d’adresses IP des centres de données où vous écoutez le trafic et les adresses IP de bus d’impression de liste verte exclusivement (contactez votre responsable de compte Xandr pour obtenir la liste des listes de contrôle d’accès spécifiques à Xandr). N’oubliez pas d’autoriser les plages d’adresses IP NYM1 et NYM2 si vous êtes dans le centre de données de New York et d’autoriser les plages d’adresses IP AMS3 et FRA1 si vous êtes dans le centre de données AMS.

Étape 3 :Create votre profil parent via le service de profil du soumissionnaire d’API. Le profil vous permet de préfiltrer le trafic par paramètres tels que le pays, le vendeur et le pourcentage global. À des fins de test, il est recommandé de définir le passthrough_percent champ sur quelque chose de petit comme 5 % jusqu’à ce que vous soyez prêt à en prendre une plus grande quantité. Les fournisseurs de données ne peuvent pas avoir de profils enfants, ils ne peuvent avoir qu’un seul profil parent.

Étape 4 : Configurez votre soumissionnaire en définissant les bid_uri champs (point de terminaison pour les demandes d’enchères), ready_uri (point de terminaison pour les demandes prêtes) et parent_profile_id . Doit parent_profile_id être l’ID du profil que vous avez créé à l’étape 3. Les autres champs d’objet soumissionnaire (notify_uri, , pixel_uriclick_uri, etc.) ne doivent pas être définis, car ils ne s’appliquent pas aux fournisseurs de données.

  • Veillez à inclure au moins une de nos macros dans votre bid_uri. Pour obtenir la liste complète des macros disponibles, consultez Macros Xandr pour les fournisseurs de données.

Étape 5 : Ajoutez au moins un soumissionnaire instance. En production, au moins un soumissionnaire instance doit être inscrit auprès de chaque centre de données pour lequel vous souhaitez voir le trafic.

Étape 6 : Create segments à l’aide du service de segment. Le code champ correspond à ce que vous retournerez dans votre réponse d’offre. Vous pouvez également créer des segments dans notre interface utilisateur du soumissionnaire sous l’onglet Segments.

Remarque

Vous pouvez uniquement créer des segments dans votre propre siège de membre.

Étape 7 : Commencez à répondre aux demandes prêtes avec un 1 et aux demandes d’enchères avec des codes de segment. Si vous ne pouvez pas répondre dans un délai de 8 à 10 ms ou si vous n’avez pas de segments pour une impression donnée, répondez avec une nouvelle ligne :

  • Demandes prêtes : répondre avec '1\n'
  • Demandes d’enchères : répondre avec 'segmentCode1\nsegmentCode2\n' or '\n'

Conseil

Comme principe directeur, votre soumissionnaire doit chercher à approcher un taux de délai d’expiration de 0 %. Pour ce faire, il est très important que votre soumissionnaire réponde à TOUTES les demandes d’offre (avec des codes ou avec une nouvelle ligne) dans un délai d’environ 7 millisecondes pour tenir compte de la gigue.

Étape 8 : Vérifiez que votre intégration fonctionne correctement en examinant les métriques dans notre interface utilisateur du soumissionnaire.

Étape 9 : Partagez vos segments avec des clients à l’aide du service de partage de données membres.

Étape 10 : En cours : surveillez vos métriques dans l’interface utilisateur du soumissionnaire sous l’onglet Métriques.

Autres considérations

  • Étant donné le temps de réponse requis de 10 ms ou moins, les fournisseurs de données en temps réel doivent envisager la colocalisation dans les centres de données utilisés par Xandr pour réduire la latence et s’assurer que les temps de réponse sont de 10 ms ou moins.
  • L’intégration du fournisseur de données en temps réel prend généralement plusieurs mois. Nous encourageons les fournisseurs de données potentiels à en tenir compte avant de commencer l’intégration à Xandr.
  • Last updated on