Declared IDs

Fonctionnement de declared IDs, configuration des procédures, des exemples de code et des variables.

Declared ID Ciblage

Échangez et synchronisez les 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 cookies tiers.

Objectif du ciblage Declared ID

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 à un appel d’événement. En outre, un declared ID peut agir comme un ID universel qui s’applique au même utilisateur dans toutes les solutions de Experience Cloud. Le tableau suivant décrit le processus de ciblage/correspondance des identifiants :

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’ID déclarées.

Appels d’exclusion

Le processus declared ID honore les préférences des visiteurs du site en ce qui concerne l’exclusion du ciblage Audience Manager par votre site Web. Lorsque Audience Manager reçoit une demande d’opposition, la valeur JSON renvoyée par la balise 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 une declared ID exclusion avec un Audience Manager UUID dans le URL.
• Le droit d’opposition declared ID est stocké dans la balise Profile Cache Server (PCS) 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

Vous pouvez effectuer des demandes d’exclusion declared ID avec les paires d_cid et d_cid_ic clé-valeur. 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.

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 :

Variables et syntaxe pour Declared IDs

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é de ses valeurs associées.
• Le caractère ASCII non imprimable %01 sépare les valeurs.

Exemples d’appels d’événement

Compte tenu de ces paires clé-valeur et de leur syntaxe requise, vous effectueriez des appels d’événement comme illustré ci-dessous.

Declared ID Variables

Décrit les variables de configuration utilisées pour transmettre declared IDs à DIL à Audience Manager…

DIL utilise le Adobe Experience Platform Identity Service à transférer 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. Les versions actuelles de DIL reposent plutôt sur la fonction visitorService pour obtenir la fonction declared IDs de la fonction setCustomerIDs dans la balise 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 namespace valeur-clé, MCORG correspond à votre Experience Cloud ID d’organisation. Si vous ne possédez pas cet ID, 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

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 s’appuie désormais sur la fonction visitorService affichée dans l’exemple de code ci-dessus. Cette fonction récupère declared IDs à partir 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 une declared ID à partir de Visitor ID Service.
Le tableau suivant décrit les variables héritées utilisées par l’objet declaredId :

DPID et DPUUID

Audience Manager compare et fait correspondre la combinaison DPID et DPUUID à un ID utilisateur correspondant dans notre système. Si aucun ID n’existe, Audience Manager crée un 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 à 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
    }
 });

Transmettre les identifiants après les instances DIL

DIL.getDil('partner name').api.signals({...}).declaredId({
  dpuuid : dpuuid
  dpid : dpid
}).submit();

Exemples de requêtes/réponses

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

Le processus declared ID honore les préférences des visiteurs du site en ce qui concerne l’exclusion du ciblage Audience Manager par votre site Web. Lorsque Audience Manager reçoit une demande d’opposition, DCS renvoie un objet JSON vide au lieu de l’ID utilisateur Audience Manager.