Intégration directe avec le service Experience Cloud Identity direct-integration-with-the-experience-cloud-id-service

Cette implémentation permet aux clients d’utiliser le service d’ID sur les périphériques qui ne peuvent pas accepter ou utiliser notre code JavaScript ou SDK. Cela inclut les périphériques tels que les consoles de jeux, les téléviseurs intelligents ou d’autres appareils compatibles avec Internet. Reportez-vous à cette section pour connaître la syntaxe, voir des exemples de code et les définitions.

Syntaxe section-a4754afec5ad40b6be00d6f1011d68bb

Les appareils qui ne peuvent pas utiliser les bibliothèques de code VisitorAPI.js ou du SDK peuvent appeler directement les serveurs de collecte de données (DCS) utilisés par le service d’ID. Pour ce faire, appelez dpm.demdex.net et formatez votre requête comme indiqué ci-dessous. Le format italique indique un espace réservé variable.

Dans cet exemple de syntaxe, le d_ préfixe identifie les paires clé-valeur de l’appel en tant que variable de niveau système. Vous pouvez transmettre plusieurs d_ paramètres au service d’ID, mais restez concentré sur les paires clé-valeur comme indiqué dans le code ci-dessus. Pour plus d’informations sur les autres variables, voir Attributs pris en charge pour les appels d’API DCS.

Le service d’ID prend en charge les appels HTTP et HTTPS. Utilisez HTTPS pour transmettre des données à partir d’une page sécurisée.

Exemple de requête section-26302b8851704888b6f8e6b2071bcdb0

Votre demande peut ressembler à l’exemple ci-dessous. De longues variables ont été raccourcies.

Exemple de réponse section-89bc103b3e9e4a8b98e74c32897b1200

Le service d’ID renvoie des données dans un objet JSON, comme illustré ci-dessous. Votre réponse peut être différente.

{
     "d_mid":"12345",
     "dcs_region":"6",
     "id_sync_ttl":"604800",
     "d_blob":"wxyz5432"
}

Paramètres de requête et de réponse définis section-4a9912b545364dc4acad4f1ea5ec641d

Paramètres de requête

Paramètre
Description
dpm.demdex.net
Domaine hérité contrôlé par Adobe. Voir Signification des appels vers le domaine Demdex (Understanding Calls to the Demdex Domain).
d_mid
ID de visiteur Experience Cloud. Voir Cookies et service d’identités Experience Cloud.
d_orgid
ID d’organisation Experience Cloud. Pour obtenir de l’aide sur la recherche de cet ID, voir Conditions requises pour le service Experience Cloud Identity.
d_cid

Paramètre facultatif qui transmet l’ID du fournisseur de données (DPID), l’ID d’utilisateur unique (DPUUID) et un ID d’état authentifié au service d’ID. Comme indiqué dans l’exemple de code, séparez le DPID et le DPUUID par le caractère de contrôle non imprimable %01.

DPID et DPUUID

Dans le paramètre d_cid, affectez chaque combinaison DPID et DPUUID associée au même paramètre d_cid. Vous pouvez ainsi renvoyer plusieurs jeux d’ID dans une même requête. En outre, séparez le DPID, le DPUUID et l’indicateur d’authentification facultatif par le caractère de contrôle non imprimable %01. Dans les exemples ci-dessous, les ID de fournisseur et d’utilisateur sont mis en évidence en gras dans la syntaxe.

  • Syntaxe : ...d_cid=DPID%01DPUUID%01état d’authentification...
  • Exemple : ...d_cid=123%01456%011...

État d’authentification

Il s’agit d’un ID facultatif dans le paramètre d_cid. Exprimé sous la forme d’un entier, il identifie les utilisateurs en fonction de leur état d’authentification comme indiqué ci-dessous :

  • 0 (Inconnu)
  • 1 (Authentifié)
  • 2 (Déconnecté)

Pour indiquer un état d’authentification, vous devez définir cet indicateur après la variable ID d’utilisateur (UUID). Séparez l’UUID et l’indicateur d’authentification par le caractère de contrôle non imprimable %01. Dans les exemples ci-dessous, les ID d’authentification sont mis en évidence en gras dans la syntaxe.

Syntaxe : ...d_cid=DPID%01DPUUID%01état d’authentification

Exemples :

  • Inconnu : ...d_cid=123%01456%010...
  • Authentifié : ...d_cid=123%01456%011...
  • Déconnecté : ...d_cid=123%01456%012...
dcs_region
Le service d’ID est un système géographiquement réparti et dont la charge est équilibrée. L’identifiant identifie la région du centre de données qui gère l’appel. Voir ID de zone géographique, emplacements et noms d’hôte du serveur de collecte de données (DCS Region IDs, Locations, and Host Names).
d_cb
(Facultatif) Paramètre de rappel permettant d’exécuter une fonction JavaScript dans le corps de la requête.
d_blob
Bloc chiffré de métadonnées JavaScript. Les contraintes de taille limitent l’objet blob à 512 octets ou moins.
d_ver
Obligatoire. Cette opération définit le numéro de version de l’API. Laissez ce paramètre défini sur d_ver=2.

Paramètres de réponse

Certains paramètres de réponse font partie de la requête et ont été définis dans la section ci-dessus.

Paramètre
Description
id_sync_ttl
Intervalle de resynchronisation, défini en secondes. L’intervalle par défaut est de 604 800 secondes (7 jours).
recommendation-more-help
9c9e8ca9-9f7e-42c9-a5d5-a0d82776362a