CID remplace DPID et DPUUID cid-replaces-dpid-and-dpuuid

Mettez à jour votre code pour utiliser d_cid ou d_cid_ic au lieu de d_dpid et d_dpuuid. Les variables DPID et DPUUID continueront à fonctionner, mais vous devez les considérer comme obsolètes. Cela inclut les variantes DPID et DPUUID sans le d_ prefix .

DPID et DPUUID : examen dpid-dpuuid-review

Le DPID et le DPUUID sont des paires clé-valeur contenant un ID de fournisseur de données et un ID d’utilisateur. Ces paires clé-valeur relient les ID de fournisseur aux ID d’utilisateur. Ils envoient des données lors des appels d’événement, pour les événements de synchronisation entrante et pour les appels d’ID. Sans eux, Audience Manager et d’autres services ou fonctionnalités n’auraient aucun moyen de faire correspondre et de synchroniser les identifiants. Ces variables sont parfois exprimées avec ou sans le préfixe d_, comme illustré ci-dessous. Notez que dans le code, l’italique indique un espace réservé pour la variable.

Variable
Syntaxe
Identifiant du fournisseur de données (DPID)
  • d_dpid=data provider ID
  • dpid=data provider ID
ID d’utilisateur unique du fournisseur de données (DPUUID)
  • d_dpuuid=data provider unique user ID
  • dpuuid=data provider unique user ID

Ces paires clé-valeur fonctionnent toujours, mais elles sont obsolètes. Vous devez mettre à jour votre code pour utiliser CID ou CID_IC à la place.

CID et CID_IC : à propos cid-cidic-about

Les paires clé-valeur CID et CID_IC remplacent DPID et DPUUID. Ils fournissent les mêmes fonctions que DPID et DPUUID, mais sont plus efficaces car ils incluent l’ID du fournisseur de données (ou le code d’intégration) et l’ID utilisateur dans une seule paire clé-valeur. Dans chaque paire clé-valeur :

  • Le symbole = sépare la clé de ses valeurs associées.
  • Le caractère ASCII non imprimable %01 sépare les valeurs.

d_cid et d_cid_ic utiliser la syntaxe illustrée ci-dessous. Notez que dans le code, l’italique indique un espace réservé pour la variable.

Variable
Syntaxe
ID de client (CID)
d_cid=data provider ID%01user ID
Code d’intégration de l’ID client (CID_IC)

d_cid_ic=integration code%01user ID

Un code d’intégration est un autre identifiant que vous pouvez utiliser à la place de l’identifiant de Source de données, attribué par Audience Manager. Voir Création d’une Source de données si vous devez configurer un code d’intégration.

Voir aussi Variables d’URL et syntaxe pour les identifiants déclarés.

NOTE
Vous pouvez utiliser des codes d’intégration pour vos propres sources de données et pour les sources de données partagées globales auxquelles vous avez accès. Par exemple, vous pouvez utiliser des codes d’intégration lorsque vous utilisez des sources de données d’identifiants mobiles. Utilisez les codes d’intégration suivants, exactement comme indiqué ci-dessous :
  • DSID_20914 pour GAID, représentant les appareils exécutant le système d’exploitation Android.
  • DSID_20915 pour IDFA, représentant les appareils exécutant le système d’exploitation iOS.

Exemples

Le tableau suivant fournit des exemples par type d’événement.

Type d’événement
Exemple
Événement
  • Nouveau : .../event?d_cid=123%01987...
  • Obsolète : .../event?d_dpid=123&d_dpuuid=987...
Synchronisation entrante (IBS)
  • Nouveau : .../ibs:d_cid=123%01987...
  • Obsolète : .../ibs:d_dpid=123&d_dpuuid=987
Générer l’UUID Audience Manager (ID)
  • Nouveau : .../id?d_cid=123%01987...
  • Obsolète : .../id?d_dpid=123&d_dpuuid=987

Chaque appel peut également inclure plusieurs d_cid et d_cid_ic paires clé-valeur comme suit :

...?d_cid=123%01456&d_cid=123%01789&d_cid_ic=543%01333...

Points importants pour les équipes de développement dev-considerations

Élément
Description
Encodage de l’URL

Vos équipes de développement doivent appliquent le codage d’URL aux variables suivantes dans la paire clé-valeur CID :

  • user ID (dpuuid)
  • integration code

Remarque : vous devez encoder par URL l’ID utilisateur et le code d’intégration avant de les concaténer dans une chaîne. Ceci est dû au fait que le caractère ASCII %01 qui sépare les deux variables ne doit pas être capturé dans le codage de l'URL.

Le codage d'URL garantit que vos identifiants d'utilisateur et codes d'intégration qui contiennent des caractères réservés ou non sécurisés tels que, mais sans s'y limiter, + ou = sont correctement transmis à nos serveurs.

Utilisez la table de codage ASCII pour référence.

Utilisation des codes d’intégration pour les sources de données partagées globales

Vous pouvez utiliser des codes d’intégration pour vos propres sources de données et pour les sources de données globales partagées auxquelles vous avez accès. Par exemple, vous pouvez utiliser des codes d’intégration lorsque vous utilisez des sources de données d’identifiants mobiles. Utilisez les codes d’intégration suivants, exactement comme indiqué ci-dessous :

  • DSID_20914 pour GAID, représentant les appareils exécutant le système d’exploitation Android.
  • DSID_20915 pour IDFA, représentant les appareils exécutant le système d’exploitation iOS.
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695