CID remplace DPID et 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 d_ prefix.

DPID et DPUUID : Une révision

Le DPID et le DPUUID sont des paires clé-valeur qui contiennent un ID de fournisseur de données et un ID d’utilisateur. Ces paires clé-valeur lient les ID du fournisseur à ceux de l’utilisateur. Ils envoient des données pendant les appels de événement, pour les événements de synchronisation entrants et pour les appels d’ID. Sans eux, Audience Manager et d'autres services ou fonctionnalités, n'auraient pas de moyen de faire correspondre et de synchroniser les ID. Ces variables sont parfois exprimées avec ou sans le préfixe d_, comme illustré ci-dessous. Remarque : dans le code, italics indique un espace réservé de variable.

Variable Syntaxe

ID du fournisseur de données (DPID)

  • d_dpid=data provider ID
  • dpid=data provider ID

ID 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. Mettez à jour votre code pour utiliser CID ou CID_IC à la place.

CID et CID_IC : À propos de

Les paires clé-valeur CID et CID_IC remplacent DPID et DPUUID. Ils offrent les mêmes fonctions que les DPID et DPUUID, mais sont plus efficaces car ils incluent l’ID du fournisseur de données (ou 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 utilisez la syntaxe illustrée ci-dessous. Remarque : dans le code, italics indique un espace réservé de variable.

Variable Syntaxe

ID client (CID)

d_cid=data provider ID%01user ID

Code d’intégration d’ID de client (CID_IC)

d_cid_ic=integration code%01user ID

Un code d'intégration est un autre ID que vous pouvez utiliser à la place de l'ID 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 ID déclarés.

REMARQUE

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 périphériques exécutant le système d’exploitation Android.
  • DSID_20915 pour IDFA, représentant les périphériques 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

  • Nouvelle API: .../event?d_cid=123%01987...
  • Obsolète: .../event?d_dpid=123&d_dpuuid=987...

Synchronisation entrante (IBS)

  • Nouvelle API: .../ibs:d_cid=123%01987...
  • Obsolète: .../ibs:d_dpid=123&d_dpuuid=987

Générer un identifiant d’Audience Manager (ID)

  • Nouvelle API: .../id?d_cid=123%01987...
  • Obsolète: .../id?d_dpid=123&d_dpuuid=987

Chaque appel peut également inclure plusieurs paires de valeurs clés d_cid et d_cid_ic comme celle-ci :

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

Considérations importantes pour les équipes de développement

Élément

Description

Codage de l’URL

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

  • user ID (dpuuid)
  • integration code

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

Le codage d’URL garantit que vos ID utilisateur et codes d’intégration contenant des caractères réservés ou non sûrs, 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 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 périphériques exécutant le système d’exploitation Android.
  • DSID_20915 pour IDFA, représentant les périphériques exécutant le système d’exploitation iOS.

Sur cette page