Partager via


Synchroniser vos ID d’utilisateur

Cette page présente la synchronisation des ID utilisateur et fournit des détails sur le mappage entre les ID utilisateur Xandr et les ID utilisateur compris par votre soumissionnaire.

L’intégration entre votre soumissionnaire et Xandr est une intégration côté serveur. En d'autres termes :

  • La communication se produit strictement entre le bus d’impression de Xandr et vos instances de soumissionnaire
  • Pendant le processus d’appel d’offres, vous n’aurez pas d’accès direct à vos cookies dans le navigateur de l’utilisateur

Si nous recevons l’impression via une intégration côté serveur de la part du partenaire fournisseur, nous n’aurons pas accès à notre cookie dans le navigateur de l’utilisateur. Pour cette raison, nous effectuons la synchronisation utilisateur avec nos partenaires fournisseurs. Il en résulte un mappage entre l’ID utilisateur Xandr et l’ID du partenaire fournisseur. Le mappage peut être stocké par Xandr, dans notre magasin de cookies côté serveur ou par le partenaire fournisseur.

Une solution similaire est disponible pour les soumissionnaires et les fournisseurs de données. Pour effectuer la synchronisation, nous devons d’abord identifier l’emplacement où le mappage doit être stocké.

Avertissement

Votre soumissionnaire doit être défini sur actif Votre soumissionnaire, ou le fournisseur de données doit être défini sur actif pour que cette synchronisation se produise.

Stockage du mappage avec Xandr

Remarque

Depuis le 22 avril 2019, Xandr ne prend plus en charge les userdata_javascript champs et setuid_function . Les soumissionnaires peuvent effectuer l’appel setuid directement.

Pour stocker le mappage avec Xandr,

  1. Ajoutez la fonction suivante au champ « userdata_javascript » de votre soumissionnaire sur le service soumissionnaire :

       function setuid(code){ ud.uid = code; }
    
  2. Ensuite, définissez le champ « setuid_function » sur le service soumissionnaire comme suit :

    setuid
    
  3. À présent, vous pouvez utiliser l’URL suivante dans un appel de pixels pour envoyer votre ID utilisateur dans le cookie de l’utilisateur et le magasin de cookies côté serveur Xandr :

    https://ib.adnxs.com/setuid?entity=[BIDDER_ID]&code=[USER_ID]
    
    
  4. Remplacez [BIDDER_ID] par l’ID de votre soumissionnaire (disponible à partir du service soumissionnaire) et [USER_ID] par l’ID utilisateur que vous avez stocké pour cet utilisateur.

    Si des signaux TCF sont disponibles sur la page, les paramètres « rgpd » et "gdpr_consent", GET doivent être inclus à la fin de l’URL /setuid :

    https://ib.adnxs.com/setuid?entity=[BIDDER_ID]&code=[UID]&gdpr=[GDPR_APPLIES]&gdpr_consent=[GDPR_CONSENT_STRING]
    
    

    Avertissement

    Depuis le 22 avril 2019, Xandr ne prend plus en charge le "userdata_json" champ dans la demande d’offre. Vous pouvez recevoir votre ID d’utilisateur unique via le champ «buyeruid" .

    Vous recevrez votre ID d’utilisateur dans le champ de "userdata_json" la demande d’enchère, comme dans l’exemple ci-dessous :

{
  "bid_request": {
      ...
      "bid_info": {
          ...,
          "userdata_json": "{\"global_freq\":3,\"last_seen\":1237220391,\"uid\":\"HeVQkH6inotalk0Livh8Vw\"}",
          ...
      },
      ...
  }
}

Vous recevrez votre ID d’utilisateur dans le champ « buyeruid » de la demande d’offre, comme dans l’exemple ci-dessous :

{
    "request": {
        ...
        "user": {
            ...,
            "buyeruid": "HeVQkH6inotalk0Livh8Vw",
            ...
        },
        ...
    }
}

Exemple setUID

https://ib.adnxs.com/setuid?entity=123&code=HeVQkH6inotalk0Livh8Vw&gdpr=1&gdpr_consent=CPaPwEAPaPwEAACAKAFRBWCgAP_AAH_AAAqIHttf_X__b3_j-_59__t0eY1f9_7_v-0zjhfdt

Mappage stocké du fournisseur de données/soumissionnaire

Pour extraire l’ID utilisateur Xandr d’un utilisateur donné, vous dirigerez l’utilisateur vers notre service getUID via un appel de pixel. Le bus d’impression redirige l’utilisateur vers l’URL spécifiée dans l’appel getUID, en remplaçant une macro d’ID utilisateur par l’ID que nous avons stocké pour cet utilisateur. Ce processus nous donne accès à notre cookie dans le navigateur de cet utilisateur et nous permet de lire l’ID.

Le format du service getUID est le suivant :

https://ib.adnxs.com/getuid?[REDIRECT_URL]

La redirection doit contenir la macro d’ID utilisateur, au format $UID, avec l’ID que nous avons pour cet utilisateur. L’exemple d’appel ci-dessous entraîne les résultats suivants :

  1. Diriger l’utilisateur vers https://ib.adnxs.com/getuid?https://ad.adserver.com/pixel?adnxs_uid=$UID
  2. Remplacez la macro $UID par a9f4072b-ec2d-42cb-8930-e3388a7d47c2
  3. Rediriger l’utilisateur vers https://ad.adserver.com/pixel?adnxs_uid=a9f4072b-ec2d-42cb-8930-e3388a7d47c2

Si des signaux TCF sont disponibles sur la page « rgpd » et « gdpr_consent », les paramètres GET doivent être inclus à la fin de l’URL /getuid :

https://ib.adnxs.com/getuid?https://ad.adserver.com/pixel?adnxs_uid=$UID&gdpr=[GDPR_APPLIES]&gdpr_consent=[GDPR_CONSENT_STRING]

Exemple getUID

https://ib.adnxs.com/getuid?https://ad.adserver.com/pixel?adnxs_uid=$UID&gdpr=1&gdpr_consent=CPaPwEAPaPwEAACAKAFRBWCgAP_AAH_AAAqIHttf_X__b3_j-_59__t0eY1f9_7_v-0zjhfdt

Étape suivante : Réception d’une demande de notification

Considérations relatives à la confidentialité

Remarque

Pour les deux points de terminaison, si les paramètres TCF sont passés dans l’URL de redirection, Xandr utilise les paramètres TCF pour déterminer si une synchronisation de cookie peut être effectuée. Si les signaux reçus sont interprétés avec une base juridique insuffisante, Xandr ne pourra pas traiter la demande de synchronisation des cookies et retournera le message d’erreur suivant : « La demande a échoué en raison de signaux de confidentialité ».