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 de fonctionner, mais vous devez les considérer comme obsolètes. Cela inclut les variantes DPID et DPUUID sans le d_ prefix.

DPID et DPUUID : Une révision

Les DPID et le DPUUID sont des paires clé-valeur qui contiennent un identifiant de fournisseur de données et un identifiant d’utilisateur. Ces paires clé-valeur lient les ID de fournisseur aux ID d’utilisateur. Ils envoient des données lors d’appels d’événement, pour les événements de synchronisation entrants et pour les appels d’identifiant. Sans eux, Audience Manager et d’autres services ou fonctionnalités, n’auraient pas de 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. Remarque : dans le code, italics indique un espace réservé de variable.

Variable Syntaxe

Identifiant du fournisseur de données (DPID)

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

Identifiant 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 : A propos

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

  • Le symbole = sépare la clé des valeurs qui lui sont 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 de 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 et syntaxe d’URL 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 l’UUID (ID) de l’Audience Manager

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

Chaque appel peut également inclure plusieurs paires d_cid et d_cid_ic valeur de clé comme ceci :

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

Points importants pour les équipes de développement

Élément

Description

Encodage des URL

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

  • user ID (dpuuid)
  • integration code

Remarque : Vous devez coder l’URL de l’ID utilisateur et du code d’intégration avant de les concaténer dans une chaîne. En effet, 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 à titre de référence.

Utilisation de 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