Guide de migration du profil de soumissionnaire

Les profils de soumissionnaire (le service de profil hérité et les profils de soumissionnaire améliorés) vous permettent de filtrer le trafic que vous recevez de Xandr. Ce guide de migration de profil vous aide à migrer votre configuration des profils de soumissionnaire hérités vers des profils de soumissionnaire améliorés.

Remarque

L’étape 4 de cette page est pertinente uniquement si vous avez reçu une communication par e-mail de changement cassant concernant la migration de profil. Si ce n’est pas le cas, contactez votre responsable de compte à la place.

Avis de modification cassant : si vous n’effectuez pas la migration :

Le 4 octobre 2019, nous autoriserons votre soumissionnaire à bénéficier des profils de soumissionnaire améliorés, auquel cas vos nouveaux profils contrôleront la façon dont vous recevez le trafic et vos profils hérités seront dépréciés. Si vous ne mettez pas à jour vos profils de soumissionnaire améliorés avant cette date, par défaut, aucune restriction d’inventaire n’est configurée pour votre soumissionnaire.

Vue d’ensemble du processus de migration

Obtenez l’état actuel via l’API de service de profil héritée (recommandée) ou l’interface utilisateur du soumissionnaire héritée. (0,25 ~0,5 heure)
Comprenez les modifications et réévaluez les filtres en fonction des besoins de votre entreprise. (0,5 à 1 heure)
Configurez les profils de soumissionnaire améliorés dans la nouvelle interface utilisateur de la plateforme de soumissionnaire (recommandée) ou via le nouveau service de profil de soumissionnaire. (0,5 à 1 heure)
Contactez le support technique pour basculer entre l’utilisation des profils hérités et les profils de soumissionnaire améliorés. (~1 jour ouvrable)

Votre nouvelle configuration de profil de soumissionnaire amélioré dans ou l’API n’a pas d’impact sur le flux de trafic tant que vous n’avez pas terminé l’étape 4 avant le 21 mai 2019.

Processus de migration

Étape 1 : Obtenir l’état actuel (0,25 à 0,5 heure)

Il existe deux façons de case activée l’état actuel. Nous recommandons la méthode API, car l’interface utilisateur héritée peut ne pas afficher tous vos paramètres de ciblage.

Conseil

Comprendre la relation entre le profil parent & enfant dans le profil de soumissionnaire hérité

Dans les profils de soumissionnaire hérités, il existe un profil parent et un ou plusieurs profils enfants (facultatifs). Tout le trafic entrant en provenance de Xandr doit d’abord remplir les conditions du profil parent. En outre, le trafic doit passer l’un des profils enfants si votre soumissionnaire a des profils enfants actifs. Pour résumer, le trafic est envoyé lorsqu’il répond aux critères dans (Parent Profile) AND (Child Profile 1 OR Child Profile 2 OR ... OR Child Profile N).

Exemple :

Si vous incluez le États-Unis dans votre profil parent, incluez le type d’approvisionnement d’application mobile dans votre profil enfant 1 et le type d’approvisionnement Web mobile dans votre profil enfant 2, votre soumissionnaire recevra à la fois le trafic de l’application mobile américaine (via le profil enfant 1) et le trafic web mobile américain (via le profil enfant 2). Votre enchérisseur ne recevra pas de trafic de bureau américain ou non américain.

Pour plus d’informations, reportez-vous au FAQ sur le profil de soumissionnaire hérité.

Méthode 1 : Utilisation de l’API (recommandé)

Vue d’ensemble

Obtenez les objets de profil actifs via l’API du service de soumissionnaire : GET soumissionnaire/[ID du soumissionnaire].
Pour tous les objets de profil actifs, GET profile/[id de profil] via l’API du service de profil de soumissionnaire héritée.
Résumez les résultats.

Étape 1.1 : Obtenir les objets de profil actifs via l’API du service de soumissionnaire : `GET` soumissionnaire/[id du soumissionnaire]

L’ID de profil parent actif se trouve dans le parent_profile_id champ et les ID de profil enfant actifs se trouvent dans le child_profiles tableau.

Référence : Service d’authentification et service de soumissionnaire.

Exemple

-> curl -b cookie -c cookie -s "https://api.adnxs.com/bidder/129" # 129 is a sample bidder ID.
{
    "response": {
        "bidder": {
            ...
            "parent_profile_id": 12345,
            "child_profiles": [
                {
                    "id": 34567
                },
                {
                    "id": 56789
                }
            ],
            ...
        }
    }
}

Étape 1.2 : Pour tous les objets de profil actifs, `GET` profile/[id de profil] via l’API du service de profil de soumissionnaire héritée

Chaque profil a une liste verte et/ou une liste de blocage d’éléments. Il y a généralement des « actions » et des « cibles » par membre, pays, etc.

« ..._action » peut être défini sur « include » ou « exclude ».
« ..._targets » peut avoir une liste d’ID pour le membre vendeur, le pays, etc.

Référence : Service de profil de soumissionnaire hérité

Étape 1.2 : Exemple

-> curl -b cookie -c cookie -s "https://api.adnxs.com/profile/129/12345" # 129 is a sample bidder id and 12345 is a sample bider profile ID.
{
    "response": {
        "profile": {
            "country_action": "include",
            "country_targets": [
                {
                    "active": true,
                    "code": "US",
                    "id": 233,
                    "name": "United States"
                }
            ],
            ...
        }
    }
}

Étape 1.3 : Résumer les résultats

N’oubliez pas d’évaluer la logique de profil parent & enfant : le trafic est envoyé lorsqu’il répond aux critères dans (Parent Profile) AND (Child Profile 1 OR Chile Profile 2 OR ... OR Child Profile N).

Il existe plusieurs champs déconseillés dans le service d’API de profil hérité. Nous vous recommandons de vous concentrer uniquement sur ces champs ciblables ci-dessous. Il existe un guide sur les champs exacts à examiner dans la section Mappage des champs de profil de soumissionnaire hérité à amélioré de cette page.

Pour faciliter la configuration des nouveaux profils de soumissionnaire améliorés, pour chacun de ces champs, répertoriez les attributs inclus/exclus :

Membres vendeurs
Pays
Listes de domaine
Tailles
Types d’approvisionnement
Attributs d’inventaire
Utilisateurs connus uniquement

Remarque

Si vous écoutez uniquement les utilisateurs connus, vous avez un taux de réussite de 0 % dans votre profil de soumissionnaire.
Action d’URL non auditée

Conseil

Qu’est-ce qu’AppNexus Direct ?

En fonction de la configuration de votre profil hérité, l’approvisionnement direct de Xandr peut être inclus dans votre objet de profil, en plus de vos membres vendeurs inclus. Pour plus d’informations, consultez : Microsoft Monétiser l’offre pour les partenaires à la demande externe.

Dans la nouvelle interface utilisateur de la plateforme de soumissionnaires, vous serez en mesure de voir quels membres vendeurs appartiennent au groupe d’échange « direct » de Xandr.

Comment extraire les domaines dans votre liste de domaines ?

Si vous souhaitez passer en revue les domaines de votre liste de domaines, vous pouvez obtenir ou modifier la liste via le service d’API de liste de domaines : Domain List Service.

Méthode 2 : Utilisation de l’interface utilisateur du soumissionnaire hérité

Vue d’ensemble (méthode 2)

Consultez les filtres actuels dans chaque profil de soumissionnaire.
Résumez les résultats.

Étape 1.1 : Voir les filtres actuels dans chaque profil de soumissionnaire

Accédez à https://bidder.adnxs.net/ et connectez-vous avec vos informations d’identification utilisateur du soumissionnaire. Si vous ne pouvez pas vous connecter, case activée d’abord avec l’équipe d’intégration de votre entreprise et contactez le support Xandr.

Accédez à l’onglet Profils sur la gauche. Vous pouvez voir la configuration du profil parent.

Les profils enfants non italiques sont actuellement actifs. Si vous cliquez sur un profil enfant, vous pouvez voir la configuration du profil.

Étape 1.2 : Résumer les résultats

N’oubliez pas d’évaluer la logique de profil parent & enfant : tout le trafic entrant en provenance de Xandr doit d’abord remplir les conditions du profil parent ; En outre, le trafic doit passer l’un des profils enfants si vous avez configuré des profils enfants.

Pour faciliter la configuration des nouveaux profils de soumissionnaire améliorés, pour chacun de ces champs, répertoriez les attributs inclus/exclus :

Membres vendeurs
Pays
Listes de domaine
Tailles
Types d’approvisionnement
Attributs d’inventaire
Utilisateurs connus uniquement

Remarque

Si vous écoutez uniquement les utilisateurs connus, vous avez un taux de réussite de 0 % dans votre profil de soumissionnaire.
Action d’URL non auditée

Conseil

Qu’est-ce qu’AppNexus Direct ?

Il se peut que vous ne le voyiez pas dans l’interface utilisateur du soumissionnaire hérité, mais en plus du membre vendeur ciblant dans un profil, les membres vendeurs de l’approvisionnement direct de Xandr sont inclus dans un profil. Pour plus d’informations, consultez : Microsoft Monétiser l’offre pour les partenaires à la demande externe.

Dans la nouvelle interface utilisateur de la plateforme de soumissionnaires, vous serez en mesure de voir quels membres vendeurs appartiennent au groupe d’échange « direct » de Xandr.

Comment extraire les domaines dans votre liste de domaines ?

Si vous souhaitez passer en revue les domaines de votre liste de domaines, vous pouvez obtenir ou modifier la liste via le service d’API de liste de domaines : Domain List Service.

Étape 2 : Comprendre les modifications et réévaluer les filtres (0,5 ~1 heure)

Les profils de soumissionnaire améliorés offrent les avantages suivants :

Hiérarchie plate : le modèle de profil parent et enfant a été supprimé.
Types d’annonces : vous pouvez désormais facilement cibler les quatre types d’annonces main que vous souhaitez recevoir : Bannière, Vidéo, Native et Audio.
Échanges : nous avons regroupé les membres vendeurs en Échanges pour faciliter le ciblage.
Profil simplifié : nous avons limité le profil aux seuls champs pertinents pour votre entreprise.
Nouvelle interface utilisateur de la plateforme de soumissionnaire : nous avons créé une nouvelle interface utilisateur pour vous permettre de gérer et de gérer vos profils. Des fonctionnalités supplémentaires seront ajoutées à cette interface utilisateur tout au long de l’année 2019.

Passez d’abord en revue ces pages : Journal des modifications pour les profils de soumissionnaire améliorés et Forum aux questions (FAQ) sur les profils de soumissionnaire améliorés.

Étape 3 : Configurer les profils de soumissionnaire améliorés (0,5~1 heure)

Remarque

La configuration améliorée du profil de soumissionnaire dans la nouvelle API du service profil de soumissionnaire ou la nouvelle interface utilisateur de la plateforme de soumissionnaire n’affecte PAS le flux de trafic à partir de Xandr tant que vous n’avez pas terminé l’étape 4 : Contacter le support Xandr et retourner le commutateur dans le back-end avant le 21 mai 2019.

Il existe deux façons de configurer des profils de soumissionnaire améliorés. Nous vous recommandons d’utiliser la nouvelle interface utilisateur de la plateforme de soumissionnaire sur l’API.

Interface utilisateur de la plateforme de soumissionnaire (recommandée) : https://bidder.appnexus.com/login
- Interface utilisateur de la plateforme de soumissionnaire
- Écran profils
API du service nouveau profil de soumissionnaire

Utilisation de plusieurs profils dans le profil de soumissionnaire amélioré

L’impression doit répondre aux exigences d’un seul profil à envoyer à votre soumissionnaire. Si vous créez plusieurs profils, la logique entre les profils est OR. En d’autres termes, l’impression est envoyée lorsqu’elle répond aux critères de (Profile 1 OR Profile 2 OR ... Profile N).

Mappage des champs de profil de soumissionnaire hérités aux champs de profil de soumissionnaire améliorés

Ciblage	Champs de l’API Profil de soumissionnaire hérité	Amélioration de l’interface utilisateur du profil de soumissionnaire & champs de l’API
Membres vendeurs/Groupes	`member_targets` champs et `seller_member_group_targets` dans l’API	Onglet Échanges et Membres dans. Tous les membres vendeurs appartiennent à l’un des trois échanges, et vous pouvez voir quels membres vendeurs appartiennent à chaque Exchange dans. `exchanges` champ dans l’API (Pour le contrôle au niveau du membre, utilisez `excluded_members` et `included_members` les tableaux sous les échanges).
Pays	`country_action` le champ a `include` ou `exclude`. `country_targets` le tableau contient une liste de pays.	Onglet Pays dans. `countries` champ dans l’API. (Utilisez `action` et `targets` sous `countries`. Pour les cibles, utilisez les ID récupérés à partir de Country Service.)
Listes de domaine	`domain_list_action` le champ a `include` ou `exclude`. `domain_list_targets` array a une liste de liste de domaines. Utilisez le service de liste de domaines pour créer, afficher ou modifier des domaines.	Onglet Domaine Listes dans (Pour modifier des domaines, utilisez Domain List Service). `domain_lists` champ dans l’API. (Utilisez `action` et `targets` sous `domain_lists`. Pour les cibles, utilisez les ID récupérés à partir du service de liste de domaines.)
Tailles (et types d’annonces)	`size_targets` tableau (inclure uniquement).	Onglet Types d’annonces dans. Vous pouvez d’abord sélectionner Types d’annonces à inclure. Si vous incluez le type d’annonce bannière, vous pouvez sélectionner des tailles à inclure. `ad_types` champ dans l’API. Pour chaque type d’annonce, définissez sur `actioninclude` ou `exclude`. Pour `banner` le type d’annonce, vous pouvez inclure des tailles dans le `sizes` tableau.
Types d’approvisionnement	`supply_type_action` le champ a `include` ou `exclude`. `supply_type_targets` array a web, web mobile ou application mobile.	Onglet Types de fourniture dans . `supply_types` champ dans l’API. (Utilisez `action` et `targets` sous `supply_types`. Pour les cibles, les valeurs possibles sont `web`, `mobile_web`et `mobile_app`.)
Attributs d’inventaire	`use_inventory_attribute_targets` a la valeur true ou false. `inventory_attribute_targets` le tableau contient une liste d’attributs d’inventaire (inclure uniquement).	Onglet Attributs sensibles dans . `inventory_attributes` champ dans l’API. (L’action est include uniquement. Pour les cibles, utilisez les ID récupérés à partir du service d’attribut d’inventaire.)
Réception d’utilisateurs connus uniquement	Si `passthrough_percent` champ a 0 et que votre objet Soumissionnaire a `always_send_owned_segments` défini sur true, vous n’écoutez que les utilisateurs connus. Votre profil de soumissionnaire peut également inclure un ID de segment pour cibler uniquement les utilisateurs connus.	Note: Pour utiliser cette fonctionnalité, vous devez utiliser/setuid URL avec Xandr pour la correspondance utilisateur. Utilisateurs inconnus bascule. Définissez sur `Allow Unknown Users` exclu. `user_not_in_segment_action` champ dans l’API. Définissez sur `exclude` pour écouter uniquement les utilisateurs connus.
Action d’URL non auditée	`non_audited_url_action` champ dans l’API.	`non_audited_url_action` champ dans l’API.

Ajustement du volume du trafic : alternative au pourcentage de passage

Dans le profil de soumissionnaire hérité, certains clients utilisaient passthrough_percent pour contrôler le volume du trafic ou les requêtes QPS (requête par seconde). Le profil de soumissionnaire amélioré n’a pas de fonctionnalité de contrôle du volume ; à la place, utilisez le qps_limit champ dans Instance du soumissionnaire pour configurer une limite de sécurité QPS par centre de données. Pour voir votre volume de trafic actuel, consultez l’onglet Métriques dans l’interface utilisateur du soumissionnaire hérité : https://bidder.adnxs.net/metrics.

Si vous avez des limites de sécurité QPS dans toutes les instances de soumissionnaire, vous avez la possibilité d’activer la fonctionnalité d’Stream d’enchère optimisée. Tout le trafic est envoyé jusqu’à ce que votre limite QPS soit atteinte ; lorsqu’il y a plus de trafic disponible que votre limite QPS, au lieu de couper le volume de trafic de manière aléatoire pour atteindre votre limite QPS, le trafic de faible priorité basé sur votre comportement d’achat qui dépasse votre limite QPS sera réduit. Pour plus d’informations, consultez Stream FAQ sur les enchères optimisées. Si la fonctionnalité vous intéresse, contactez votre responsable de compte ou le support Xandr.

Activation d’un nouveau profil de soumissionnaire

Pour activer un nouveau profil de soumissionnaire dans l’API, définissez le champ actif sur true. Vous n’avez plus besoin de définir un ID de profil dans l’API du service de soumissionnaire pour activer un profil. Une fois l’étape 4 ci-dessous terminée, parent_profile_id l’objet child_profiles API du soumissionnaire est ignoré.

Vous devez cliquer sur le bouton Activer dans l’écran du profil pour activer le profil. Les profils non italiques sont actifs.

Activez vos nouveaux profils de soumissionnaire avant de passer à l’étape 4. La configuration de votre profil de soumissionnaire amélioré n’affecte pas le flux de trafic tant que le commutateur principal n’est pas retourné par le support Xandr à l’étape 4 avant le 21 mai 2019.

Étape 4 : Contactez le support Xandr pour terminer la migration (environ 1 jour ouvrable)

Remarque

Cette section n’est pertinente que si vous avez reçu une communication par e-mail de changement cassant concernant la migration de profil. Si ce n’est pas le cas, ne suivez pas cette étape. Au lieu de cela, contactez votre responsable de compte.

Avertissement

Votre nouvelle configuration de profil de soumissionnaire amélioré n’a pas d’impact sur le flux de trafic tant que vous n’avez pas terminé cette étape avant le 21 mai 2019.

Ouvrez un ticket de support. Lors de la saisie d’informations :

Catégorie : Sélectionnez Support produit
Que pouvons-nous aider ?: Sélectionner l’intégration du soumissionnaire externe

Utiliser ce modèle pour votre ticket de support

J’ai examiné et configuré les profils de soumissionnaire améliorés. Migrer la configuration de mon profil.

ID du soumissionnaire et nom du soumissionnaire :
Avez-vous configuré à l’aide de la nouvelle API ou de l’interface utilisateur de la plateforme de soumissionnaire ? :
Fournissez une brève explication des modifications apportées à la configuration actuelle du profil (si aucune modification n’est apportée, écrivez « N/A ») :

Que va-t-il se passer ensuite ?

Nos spécialistes du support examineront d’abord la configuration du profil de soumissionnaire hérité et amélioré. S’ils semblent corrects, les spécialistes du support technique retournent le commutateur dans le back-end et vous envoient une note de confirmation. Dans ce cas, votre nouvelle configuration de profil de soumissionnaire amélioré commence à avoir une incidence sur le flux de trafic, et la configuration du profil de soumissionnaire héritée est ignorée.

Surveillez votre flux de trafic à l’aide de l’onglet Métriques de l’interface utilisateur du soumissionnaire hérité : https://bidder.adnxs.net/metrics. En cas de problème, les spécialistes du support technique peuvent revenir immédiatement à la configuration du profil hérité (qui prendra effet sur le flux de trafic en 5 à 10 minutes), et vous pouvez travailler à la résolution des problèmes de configuration du profil de soumissionnaire amélioré.

S’il n’y a aucun problème sur le flux de trafic pendant un jour, votre migration est terminée et le ticket de support est fermé.

Conseil

Les profils de soumissionnaire hérités sont toujours affichés comme actifs dans l’API et dans l’interface utilisateur du soumissionnaire hérité une fois la migration terminée. Tant qu’il est migré dans le back-end, la configuration du profil hérité est ignorée et n’a pas d’impact sur le flux de trafic.

Si vous n’avez pas terminé l’étape 4

Le 21 mai 2019, nous autoriserons votre soumissionnaire à bénéficier des profils de soumissionnaire améliorés, auquel cas vos nouveaux profils contrôleront la façon dont vous recevez le trafic et vos profils hérités seront dépréciés. Si vous ne mettez pas à jour vos profils de soumissionnaire améliorés avant cette date, par défaut, aucune restriction d’inventaire n’est configurée pour votre soumissionnaire.

Last updated on 2025-04-01

Partager via

Guide de migration du profil de soumissionnaire

Vue d’ensemble du processus de migration

Processus de migration

Étape 1 : Obtenir l’état actuel (0,25 à 0,5 heure)

Méthode 1 : Utilisation de l’API (recommandé)

Vue d’ensemble

Étape 1.1 : Obtenir les objets de profil actifs via l’API du service de soumissionnaire : GET soumissionnaire/[id du soumissionnaire]

Exemple

Étape 1.2 : Pour tous les objets de profil actifs, GET profile/[id de profil] via l’API du service de profil de soumissionnaire héritée

Étape 1.2 : Exemple

Étape 1.3 : Résumer les résultats

Méthode 2 : Utilisation de l’interface utilisateur du soumissionnaire hérité

Vue d’ensemble (méthode 2)

Étape 1.1 : Voir les filtres actuels dans chaque profil de soumissionnaire

Étape 1.2 : Résumer les résultats

Étape 2 : Comprendre les modifications et réévaluer les filtres (0,5 ~1 heure)

Étape 3 : Configurer les profils de soumissionnaire améliorés (0,5~1 heure)

Utilisation de plusieurs profils dans le profil de soumissionnaire amélioré

Mappage des champs de profil de soumissionnaire hérités aux champs de profil de soumissionnaire améliorés

Ajustement du volume du trafic : alternative au pourcentage de passage

Activation d’un nouveau profil de soumissionnaire

Étape 4 : Contactez le support Xandr pour terminer la migration (environ 1 jour ouvrable)

Utiliser ce modèle pour votre ticket de support

Que va-t-il se passer ensuite ?

Si vous n’avez pas terminé l’étape 4

Ressources supplémentaires

Étape 1.1 : Obtenir les objets de profil actifs via l’API du service de soumissionnaire : `GET` soumissionnaire/[id du soumissionnaire]

Étape 1.2 : Pour tous les objets de profil actifs, `GET` profile/[id de profil] via l’API du service de profil de soumissionnaire héritée