Show Menu
SUJETS×

Declared IDs

Comment declared IDs fonctionner, configurer des procédures, des exemples de code et des variables.

Declared ID Ciblage

Échangez et synchronisez les identifiants des utilisateurs avec Audience Manager les périphériques ou navigateurs qui n’utilisent pas ou n’acceptent pas les mécanismes d’enregistrement persistants, tels que les tiers cookies.

Objectif du Declared ID ciblage

Certains navigateurs et la plupart des périphériques mobiles n’acceptent pas les tiers cookies. Il est donc 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 de événement. En outre, un declared ID peut agir en tant qu’identifiant universel qui s’applique au même utilisateur dans toutes les solutions du Experience Cloud. Le tableau suivant décrit le processus de ciblage/correspondance des identifiants :
Processus Description
Appel Événement
Pour fonctionner, vous avez besoin de code DIL et du code du service d'identité d'Adobe Experience Platform sur la page. Le code DIL récupère les identifiants déclarés de la setVisitorID fonction fournie par le service d'identité de l' Adobe Experience Platform et les transmet à l' d'Audience Manager .
Identifiant de correspondance
L’Audience Manager tente de faire correspondre l’ID du client et du visiteur avec un ID correspondant dans notre système. Si aucun ID correspondant n’existe, l’Audience Manager crée un nouvel ID et l’associe à l’ID du client et de l’visiteur.
Remarque : Le mappage le plus récent est utilisé si votre ID correspond à plusieurs identifiants d’Audience Manager.
ID de retour
L’Audience Manager écrit son identifiant synchronisé dans un cookie propriétaire (ou tout autre espace d’enregistrement adressable) dans le domaine ou l’application client.
Appels de Événement consécutifs
D’autres appels de événement lisent l’ID d’Audience Manager du domaine du client et l’envoient à l’Audience Manager.
Pour commencer, vous devez configurer le service d’ Experience Cloud ID et DIL les pages de votre site que vous souhaitez utiliser pour la collecte de données. Voir DIL create and Declared ID Variables .

Appels d’exclusion

Le declared ID processus respecte les préférences du visiteur du site pour l’exclusion du Audience Manager ciblage par votre site Web. When Audience Manager receives an opt-out request, the JSON returned by the DCS contains the error code 171, with the message Encountered opt out tag , instead of the Audience Manager user ID.
  • Audience Manager peut transmettre une declared ID exclusion en même temps qu’une UUID dans le URL.
  • L' declared ID exclusion est stockée dans le serveur de cache de Profil [ (PCS) par partenaire. Il n’existe pas d’exclusion au niveau de la plateforme utilisant declared IDs. En outre, Audience Manager désactive l’utilisateur de cette région spécifique sur le bord (l’exclusion ne s’applique pas à DCS plusieurs régions).
Voir Confidentialité des données pour en savoir plus sur l’exclusion de la collecte de données.

Declared ID Exemples d’exclusion

You can make a declared ID opt-out requests with the d_cid and d_cid_ic key-value pairs. 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 .
Exclusion à l’aide Exemple de code
d’un identifiant de fournisseur de données et d’un identifiant utilisateur.
https:// domain name /demoptout.jpg?d_cid=123%01987...
d’un code d’intégration et d’un identifiant utilisateur.
https:// domain name /demoptout?d_cid_ic=456%01321...
Plusieurs paires d_cid et d_cid_ic clé-valeur.
https:// domain name /demoptout?d_cid=123%01987&d_cid_ic=456%01321...

Exclusions avec DPID, DPUUIDet UUID (obsolète)

Ces méthodes fonctionnent toujours mais sont considérées comme obsolètes. Ces renseignements sont fournis à des fins héritées et à titre de référence. Les exclusions héritées comprennent :
Exclusion (obsolète) Exemple de code
d_uuid uniquement
https:// domain /demoptout.jpg?d_uuid=AAM ID
Exclusion au niveau du partenaire
https://demoptout.jpg?d_dpuuid= user ID&d_dpid= data provider ID
Une exclusion au niveau du partenaire est stockée pour la dernière mise en correspondance de cette paire dpid + dpuuid avec 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, dans ce cas, l’utilise pour stocker l’exclusion. Dans le cas contraire, l’Audience Manager génère un nouvel identifiant UUID AAM et stocke l’exclusion sous-jacente.
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 demande ( d_uuid ).

Variables et syntaxe pour Declared IDs

Le tableau suivant liste les paires clé-valeur qui transmettent l’ID de votre fournisseur de données et vos ID d’utilisateur ou codes d’intégration, le cas échéant. Audience Manager Note, italics indicates a variable placeholder. 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.
Variable Description
d_cid = data provider ID %01 user ID
Contient un ID de fournisseur de données et un ID d’utilisateur unique associé dans une seule paire clé-valeur. 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 %01 user ID
Contient un code d’intégration et un ID utilisateur unique associé dans une seule paire clé-valeur. 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 de Événement

Compte tenu de ces paires clé-valeur et de leur syntaxe requise, vous effectueriez des appels de événement comme illustré ci-dessous.
L'appel de Événement inclut Exemple de code
d’un identifiant de fournisseur de données et d’un identifiant utilisateur.
https:// domain name /event?d_cid=123%01987...
d’un code d’intégration et d’un identifiant utilisateur.
https:// domain name /event?d_cid_ic=456%01321...
Plusieurs paires d_cid et d_cid_ic clé-valeur.
https:// domain name /event?d_cid=123%01987&d_cid_ic=456%01321...

Declared ID Variables

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

DIL utilise Adobe Experience Platform Identity Service to Pass Declared IDs

Lorsqu'il est utilisé avec le service d'identité de l' Adobe Experience Platform, il n'est plus nécessaire de transmettre declared IDs les variables dpid et dpuuid les variables obsolètes. Au lieu de cela, les versions actuelles de DIL reposent sur la visitorService fonction pour obtenir la declared IDs de la fonction setCustomerIDs dans le Adobe Experience Platform Identity Service. For more information, see Customer IDs and Authentication States . Vous appellerez 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 clé-valeur, MCORG correspond votre Experience Cloud ID d’organisation. Si vous ne possédez pas cet identifiant, vous pouvez le trouver dans la Administration section du Experience Cloud tableau de bord. Vous avez besoin d'autorisations d'administrateur pour vue ce tableau de bord. See Administration: Core Services .

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. C'est parce que DIL maintenant repose sur la visitorService fonction illustrée dans l'exemple de code ci-dessus. Cette fonction provient declared IDs 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 un exemple de configuration DIL.create pour obtenir un declared ID formulaire à partir du Visitor ID Service. Le tableau suivant décrit les variables héritées utilisées par l’ declaredId objet :
Nom Type Description
dpid Chaîne
ID de partenaire de données attribué par Audience Manager.
dpuuid Chaîne
L’identifiant unique du fournisseur de données pour l’utilisateur.

DPID et DPUUID

Audience Manager compare et correspond à la combinaison DPID et DPUUID à un ID utilisateur correspondant dans notre système. Si un ID n’existe pas, Audience Manager crée un nouvel ID utilisateur et le synchronise avec la DPID/DPUUID combinaison. Une fois que Audience Manager correspond ou crée un ID utilisateur (le UUID ), il renvoie cet ID dans la JSON réponse au cookie domaine du client (propriétaire cookie) ou à un autre enregistrement local.
Appelez cette fonction lorsque vous utilisez DIL v6.1 ou une version antérieure. Cependant, cette fonction a été abandonnée en faveur de la nouvelle version qui provient declared IDs de la Adobe Experience Platform Identity Service.
DIL.create({
    partner : "partner name",
    declaredId : {
       dpuuid : dpuuid,
       DPID : dpid
    }
 });

Vous devez développer par programmation le code qui fournit les valeurs d’ID pour les clés d_dpuuid et d_dpid clés.

Transmission d’ID après DIL instanciation

Si vous effectuez un API appel avec une declaredID combinaison différente, la nouvelle combinaison sera utilisée pour cet appel uniquement. D'autres événements réguliers utiliseront la DIL.create declaredID combinaison originale.
DIL.getDil('partner name').api.signals({...}).declaredId({
  dpuuid : dpuuid
  dpid : dpid
}).submit();

Exemples de demandes/réponses

La demande 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’identifiant d’Audience Manager ( UUID par exemple) écrit dans un cookie propriétaire du domaine de la page.
myCallback({
...
   "uuid":"abc123"
})

Appels de non-Cible et d’exclusion

Le declared ID processus respecte les préférences du visiteur du site pour l’exclusion du Audience Manager ciblage par votre site Web. Lorsque Audience Manager reçoit une demande d’exclusion, le DCS renvoie un JSON objet vide au lieu de l’ Audience Manager ID utilisateur.