Declared IDs declared-ids
Fonctionnement de declared IDs, configuration de procédures, d’exemples de code et de variables.
Declared ID Ciblage declared-id-targeting
Exchange et synchronisation des ID utilisateur avec Audience Manager à partir de périphériques ou de navigateurs qui n’utilisent pas ou n’acceptent pas les mécanismes de stockage persistant, tels que le tiers cookies.
Objectif du ciblage Declared ID declared-id-targeting-purpose
Certains navigateurs, et la plupart des périphériques mobiles, n’acceptent pas les cookies tiers. Il est ainsi difficile de conserver des informations sur les visiteurs du site ou d’attribuer des identifiants persistants. Pour résoudre ce problème, Audience Manager utilise DIL pour vous permettre de transmettre declared IDs sur un appel d’événement. En outre, un declared ID peut agir comme un ID universel qui s’applique au même utilisateur à l’échelle de toutes les solutions dans Experience Cloud. Le tableau suivant décrit le processus de ciblage/correspondance des identifiants :
setVisitorID
fournie par le Adobe Experience Platform Identity Service et transmet cette information à l'Audience Manager .L’Audience Manager tente de faire correspondre l’identifiant client et l’identifiant visiteur avec un identifiant correspondant dans notre système. Si aucun identifiant correspondant n’existe, l’Audience Manager crée un nouvel identifiant et l’associe à l’identifiant client et à l’identifiant visiteur.
Remarque : Le mappage le plus récent est utilisé si votre ID correspond à plusieurs ID d’Audience Manager.
Pour commencer, vous devez configurer le service Experience Cloud ID et DIL sur les pages de votre site que vous souhaitez utiliser pour la collecte de données. Voir Création de DIL et Variables d’identifiant déclaré.
Appels d’exclusion opt-out-calls
Le processus declared ID honore les préférences des visiteurs du site pour l’exclusion du ciblage Audience Manager par votre site web. Lorsque Audience Manager reçoit une demande d’opposition, le JSON renvoyé par l’ DCS contient le code d’erreur 171, avec le message Encountered opt out tag
, au lieu de l’ID utilisateur Audience Manager.
- Audience Manager peut transmettre un droit d’opposition declared ID aux côtés d’un Audience Manager UUID dans URL.
- L’exclusion declared ID est stockée dans Profile Cache Server (PCS) sur une base par partenaire. Il n’existe pas de droit d’opposition au niveau de la plateforme utilisant declared IDs. En outre, Audience Manager exclut l’utilisateur de cette région spécifique sur le bord (l’exclusion ne traverse pas DCS régions).
Voir Confidentialité des données pour plus d’informations sur l’exclusion de la collecte de données.
Declared ID Exemples d’exclusion opt-out-examples
Vous pouvez effectuer des demandes d’exclusion declared ID avec les paires clé-valeur d_cid
et d_cid_ic
. Les paramètres hérités comme d_dpid
et d_dpuuid
fonctionnent toujours, mais sont considérés comme obsolètes. Voir CID remplace DPID et DPUUID. Dans les exemples, le texte en italique indique un espace réservé de variable.
Exclusions avec CID et CID_IC
Pour obtenir une description et une syntaxe, consultez les variables et la syntaxe d’URL pour les identifiants déclarés.
https://domain name/demoptout.jpg?d_cid=123%01987...
https://domain name/demoptout?d_cid_ic=456%01321...
d_cid
et d_cid_ic
.https://domain name/demoptout?d_cid=123%01987&d_cid_ic=456%01321...
Exclusions avec DPID, DPUUID et UUID (obsolète)
Ces méthodes fonctionnent toujours, mais sont considérées comme obsolètes. Ces informations sont fournies à des fins héritées et à titre de référence. Les désinscriptions héritées incluent :
d_uuid
uniquementhttps://domain/demoptout.jpg?d_uuid=AAM ID
https://demoptout.jpg?d_dpuuid= user ID&d_dpid= data provider ID
Une exclusion au niveau du partenaire est stockée pour le dernier mappage de cette paire dpid
+ dpuuid
à un UUID AAM. S’il n’existe aucun mappage existant auparavant, l’Audience Manager vérifie si la requête contient un UUID AAM dans le cookie et, si tel est le cas, l’utilise pour stocker l’exclusion. Dans le cas contraire, l’Audience Manager génère un nouvel UUID AAM et stocke l’exclusion sous celui-ci.
d_dpuuid
+ d_dpid
et explicite d_uuid
https://domain/demoptout.jpg?d_uuid= user ID&d_dpuuid= data provider's user ID&d_dpid=data provider ID
d_uuid
a toujours la priorité. Si la combinaison dpid
+ dpuuid
correspond à un autre UUID AAM, l’exclusion est stockée sous l’UUID AAM transmis dans la requête ( d_uuid
).
Variables et syntaxe pour Declared IDs variables-and-syntax
Le tableau suivant répertorie les paires clé-valeur qui transmettent l’ID de fournisseur de données Audience Manager et les ID utilisateur ou les codes d’intégration, le cas échéant. Remarque : italics indique un espace réservé de variable. Des espaces ont été ajoutés pour les rendre plus faciles à lire.
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 =data provider ID %01user ID
d_cid
remplace d_dpid
et d_dpuuid
, qui sont considérés comme obsolètes, mais toujours pris en charge. Voir CID remplace DPID et DPUUID.d_cid_ic =integration code %01user ID
d_cid_ic
remplace d_dpid
et d_dpuuid
, qui sont obsolètes, mais toujours pris en charge. Voir CID remplace DPID et DPUUID.Exemples d’appels d’événement sample-event-calls
Compte tenu de ces paires clé-valeur et de leur syntaxe requise, vous effectueriez des appels d’événement comme illustré ci-dessous.
https://domain name/event?d_cid=123%01987...
https://domain name/event?d_cid_ic=456%01321...
d_cid
et d_cid_ic
.https://domain name/event?d_cid=123%01987&d_cid_ic=456%01321...
Declared ID Variables declared-id-variables
Décrit les variables de configuration utilisées pour transmettre declared IDs à DIL vers Audience Manager…
DIL utilise le Adobe Experience Platform Identity Service à transférer Declared IDs dil-id-service-pass-declared-ids
Lorsqu’il est utilisé avec le service Adobe Experience Platform Identity, vous n’avez plus besoin de transmettre declared IDs avec les variables dpid
et dpuuid
obsolètes. Au lieu de cela, les versions actuelles de DIL reposent sur la fonction visitorService
pour obtenir la fonction declared IDs de la fonction setCustomerIDs
dans Adobe Experience Platform Identity Service. Pour plus d’informations, voir ID de client et états d’authentification. Vous appelleriez visitorService
dans DIL.create
comme illustré ci-dessous.
var vDil = DIL.create({
partner:"partner name",
visitorService:{
namespace:"INSERT-MCORG-ID-HERE"
}
});
Dans la paire clé-valeur namespace
, MCORG
est votre ID d’organisation Experience Cloud. Si vous ne possédez pas cet identifiant, vous pouvez le trouver dans la section Administration du tableau de bord Experience Cloud. Vous avez besoin des autorisations d’administrateur pour afficher ce tableau de bord. Voir Administration : services principaux.
Fonctions obsolètes deprecated-functions
Avec les dernières versions de DIL (6.2+), vous n’avez pas besoin d’utiliser ces paires clé-valeur pour transmettre declared IDs. En effet, DIL repose désormais sur la fonction visitorService
affichée dans l’exemple de code ci-dessus. Cette fonction récupère declared IDs de Adobe Experience Platform Identity Service. Cependant, nous référençons ces variables ici à des fins historiques et héritées. Consultez le code ci-dessous pour obtenir un exemple de configuration de DIL.create
pour obtenir un declared ID de Visitor ID Service.
Le tableau suivant décrit les variables héritées utilisées par l’objet declaredId
:
dpid
dpuuid
DPID et DPUUID
Audience Manager compare et fait correspondre les DPID
et DPUUID
combinés à un identifiant utilisateur correspondant dans notre système. Si aucun ID n’existe, Audience Manager crée un nouvel ID utilisateur et le synchronise avec la combinaison DPID/DPUUID
. Une fois que Audience Manager correspond ou crée un ID utilisateur (le UUID
), il renvoie cet ID dans la réponse JSON à l’ cookie dans le domaine du client (propriétaire cookie) ou tout autre stockage local.
Appelez cette fonction lorsque vous utilisez DIL v6.1 ou une version antérieure. Cependant, cette fonction a été abandonnée au profit de la nouvelle version qui obtient declared IDs à partir de Adobe Experience Platform Identity Service.
DIL.create({
partner : "partner name",
declaredId : {
dpuuid : dpuuid,
DPID : dpid
}
});
d_dpuuid
et d_dpid
.Transmettre des identifiants après l’instanciation de DIL
declaredID
différente, la nouvelle combinaison sera utilisée pour cet appel uniquement. D’autres appels d’événement standard utiliseront la combinaison DIL.create
declaredID
d’origine.DIL.getDil('partner name').api.signals({...}).declaredId({
dpuuid : dpuuid
dpid : dpid
}).submit();
Exemples de requêtes/réponses request-response-examples
La requête envoie un fournisseur de données et un ID utilisateur à Audience Manager :
https://my_domain.net/event?d_rtbd=json&d_cb=myCallback&key=val&d_dpuuid=1234&d_dpid=5678
La réponse renvoie l’ID d’Audience Manager (par exemple, UUID
) qui est écrit dans un cookie propriétaire dans le domaine de la page.
myCallback({
...
"uuid":"abc123"
})
Ne pas cibler et exclure les appels do-not-target
Le processus declared ID honore les préférences des visiteurs du site pour l’exclusion du ciblage Audience Manager par votre site web. Lorsque Audience Manager reçoit une demande d’exclusion, DCS renvoie un objet JSON vide au lieu de l’identifiant utilisateur Audience Manager.