Declared IDs declared-ids

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

Declared ID Ciblage declared-id-targeting

Échangez et synchronisez les ID utilisateur avec des Audience Manager provenant d’appareils ou de navigateurs qui n’utilisent pas ou n’acceptent pas les mécanismes de stockage persistants, tels que les cookies tiers.

Objectif du ciblage Declared ID declared-id-targeting-purpose

Certains navigateurs et la plupart des appareils mobiles n’acceptent pas les cookies tiers. Il est donc difficile de conserver les 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 des declared IDs lors d’un appel d’événement. En outre, un declared ID peut agir comme un identifiant universel qui s’applique au même utilisateur pour toutes les solutions du Experience Cloud. Le tableau suivant décrit le processus de ciblage/correspondance des identifiants :

Pour commencer, vous devez configurer le service d’ID de Experience Cloud et les DIL sur les pages de votre site que vous souhaitez utiliser pour la collecte de données. Voir les sections CréationDIL et Variables d’ID déclarées.

Appels d’opt-out opt-out-calls

Le processus declared ID respecte les préférences des visiteurs du site pour leur permettre de se désabonner du ciblage Audience Manager par votre site web. Lorsqu'Audience Manager reçoit une demande d'opt-out, le JSON renvoyé par le DCS contient le code d'erreur 171, avec le message Encountered opt out tag, au lieu de l'identifiant utilisateur Audience Manager.

Consultez Confidentialité des donnéespour plus d’informations sur le droit d’opposition à la collecte de données.

Exemples d’opt-out Declared ID opt-out-examples

Vous pouvez effectuer des demandes d’opt-out 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.

Opt-outs 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.

Opt-outs 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 opt-outs hérités sont les suivants :

Variables et syntaxe pour Declared IDs variables-and-syntax

Le tableau suivant répertorie les paires clé-valeur qui transmettent l’ID de votre fournisseur de données Audience Manager et les ID utilisateur ou les codes d’intégration, le cas échéant. Notez que l’italique indique un espace réservé de variable. Des espaces ont été ajoutés pour faciliter leur lecture.

Dans chaque paire clé-valeur :

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.

Declared ID Variables declared-id-variables

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

DIL utilise l’Adobe Experience Platform Identity Service pour transmettre des Declared IDs dil-id-service-pass-declared-ids

Lorsqu’il est utilisé avec le service d’identités Adobe Experience Platform, vous n’avez plus besoin de transmettre des 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 le declared IDs de la fonction setCustomerIDs dans le Adobe Experience Platform Identity Service. Pour plus d’informations, voir ID de client et états d’authentification. Vous pouvez appeler visitorService en 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 correspond à l’ID d’organisation Experience Cloud. Si vous ne disposez pas de cet identifiant, vous pouvez le trouver dans la section Administration du tableau de bord Experience Cloud. Vous avez besoin d’autorisations d’administrateur pour afficher ce tableau de bord. Voir Prise en main des services Experience Cloud.

Fonctions obsolètes deprecated-functions

Avec les dernières versions d’DIL (6.2+), vous n’avez pas besoin d’utiliser ces paires clé-valeur pour transmettre des declared IDs. En effet, DIL repose désormais sur la fonction visitorService affichée dans l’exemple de code ci-dessus. Cette fonction est declared IDs à partir du 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 d’DIL.create afin d’obtenir un declared ID à partir de l’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 associe les DPID et DPUUID combinés à un identifiant utilisateur correspondant dans notre système. S’il n’existe pas d’ID, Audience Manager crée un ID utilisateur et le synchronise avec la combinaison DPID/DPUUID. Une fois qu’Audience Manager correspond à un ID utilisateur (l’UUID) ou qu’il le crée, il le renvoie dans la réponse JSON au cookie dans le domaine du client (cookie propriétaire) ou dans 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 est declared IDs à partir du Adobe Experience Platform Identity Service.

DIL.create({
    partner : "partner name",
    declaredId : {
       dpuuid : dpuuid,
       DPID : dpid
    }
 });

Transmission Des Identifiants Après L’Instanciation De DIL

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 identifiant 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 Audience Manager (par exemple, UUID) qui est écrit dans un cookie propriétaire dans le domaine de la page.

myCallback({
...
   "uuid":"abc123"
})

Appels de non-ciblage et d’opt-out do-not-target

Le processus declared ID respecte les préférences des visiteurs du site pour leur permettre de se désabonner du ciblage Audience Manager par votre site web. Lorsqu’Audience Manager reçoit une demande d’opt-out, le DCS renvoie un objet JSON vide au lieu de l’ID utilisateur Audience Manager.