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 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 dpid-dpuuid-review
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. Notez que dans le code, italics indique un espace réservé de variable.
d_dpid=data provider ID
dpid=data provider ID
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 cid-cidic-about
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
utilisent la syntaxe illustrée ci-dessous. Notez que dans le code, italics indique un espace réservé de variable.
d_cid=data provider ID%01user ID
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 Source de données, attribué par Audience Manager. Voir Création d’une Source de donnéessi vous devez configurer un code d’intégration.
Voir aussi Variables d’URL et syntaxe pour les identifiants déclarés.
- 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.
- Nouveau :
.../event?d_cid=123%01987...
- Obsolète :
.../event?d_dpid=123&d_dpuuid=987...
- Nouveau :
.../ibs:d_cid=123%01987...
- Obsolète :
.../ibs:d_dpid=123&d_dpuuid=987
- Nouveau :
.../id?d_cid=123%01987...
- Obsolète :
.../id?d_dpid=123&d_dpuuid=987
Chaque appel peut également inclure plusieurs paires clé-valeur d_cid
et d_cid_ic
comme ceci :
...?d_cid=123%01456&d_cid=123%01789&d_cid_ic=543%01333...
Points importants pour les équipes de développement dev-considerations
Vos équipes de développement doivent appliquer un codage d’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.
Vous pouvez utiliser des codes d’intégration pour vos propres sources de données et pour les sources de données partagéesglobales 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.