Guide de dépannage des règles de liaison de graphiques d’identité

Lorsque vous testez et validez des règles de liaison de graphiques d’identités, vous pouvez rencontrer des problèmes liés à l’ingestion de données et au comportement des graphiques. Lisez ce document pour savoir comment résoudre certains problèmes courants que vous pouvez rencontrer lors de l’utilisation de règles de liaison de graphiques d’identités.

Flux d’ingestion de données - Aperçu data-ingestion-flow-overview

Le diagramme suivant est une représentation simplifiée de la manière dont les données sont transférées dans Adobe Experience Platform et les applications. Utilisez ce diagramme comme référence pour mieux comprendre le contenu de cette page.

Il est important de noter les facteurs suivants :

Problèmes d’ingestion des données data-ingestion-issues

Mes identités ne sont pas ingérées dans Identity Service my-identities-are-not-getting-ingested-into-identity-service

Plusieurs raisons peuvent expliquer cette situation, notamment, mais sans s’y limiter, les suivantes :

Dans le contexte des règles de liaison de graphiques d’identités, un enregistrement peut être rejeté d’Identity Service, car l’événement entrant comporte au moins deux identités avec le même espace de noms unique, mais une valeur d’identité différente. Ce scénario se produit généralement en raison d’erreurs de mise en oeuvre.

Tenez compte de l’événement suivant avec deux hypothèses :

L’événement suivant renvoie un message d’erreur indiquant que l’ingestion a échoué.

{
  "_id": "random_string",
  "eventType": "web browsing event",
  "identityMap": {
    "ECID": [
      {
        "id": "11111111111111111111111111111111111111",
        "primary": false
      }
    ],
    "CRMID": [
      {
        "id": "Alice",
        "primary": true
      }
    ]
  },
  "CRMID": "Bob",
  "timestamp": "2024-08-17T15:22:51+00:00",
  "web": {
    "webPageDetails": {
      "URL": "https://www.adobe.com/acrobat.html",
      "name": "Adobe Acrobat"
    }
  }
}

Étapes de dépannage

Pour résoudre cette erreur, vous devez d'abord collecter les informations suivantes :

Ensuite, utilisez Adobe Experience Platform Query Service et exécutez la requête suivante :

  SELECT key, col.id as identityValue, timestamp, _id, identityMap, *
  FROM (SELECT key, explode(value), *
  FROM (SELECT explode(identityMap), *
  FROM dataset_name)) WHERE col.id = 'identity_value'

Après avoir exécuté votre requête, recherchez l’enregistrement d’événement que vous attendiez de générer un graphique, puis validez que les valeurs d’identité sont différentes dans la même ligne. Affichez l’image suivante pour un exemple :

Les ExperienceEvents de post-authentification sont attribués à un profil authentifié incorrect

La priorité d’espace de noms joue un rôle important dans la manière dont les fragments d’événement déterminent l’identité principale.

Pour que les événements d’utilisateur authentifiés soient liés à l’espace de noms de la personne, tous les événements authentifiés doivent contenir l’espace de noms de la personne (CRMID). Cela signifie que même après la connexion d’un utilisateur, l’espace de noms de la personne doit toujours être présent sur chaque événement authentifié.

Vous pouvez continuer à voir l’indicateur "events" primary=true lors de la recherche d’un profil dans la visionneuse de profils. Cependant, cette opération est ignorée et ne sera pas utilisée par Profile.

Les AAID sont bloqués par défaut. Par conséquent, si vous utilisez le connecteur source Adobe Analytics, vous devez vous assurer que l’ECID a une priorité supérieure à l’ECID afin que les événements non authentifiés aient une identité principale d’ECID.

Étapes de dépannage

Mes fragments d’événement d’expérience ne sont pas ingérés dans Profile my-experience-event-fragments-are-not-getting-ingested-into-profile

Plusieurs raisons expliquent pourquoi les fragments d’événement d’expérience ne sont pas ingérés dans Profile, notamment :

Dans le contexte de la priorité d’espace de noms, Profile rejettera :

Étapes de dépannage

Si vos données sont envoyées au lac de données, mais pas à Profile, et que vous pensez que cela est dû à l’envoi de deux identités ou plus avec la priorité d’espace de noms la plus élevée dans un seul événement, vous pouvez exécuter la requête suivante pour vérifier qu’il existe deux valeurs d’identité différentes envoyées sur le même espace de noms :

  SELECT identityMap, key, col.id as identityValue, _testimsorg.identification.core.email, _id, timestamp
  FROM (SELECT key, explode(value), *
  FROM (SELECT explode(identityMap), *
  FROM dataset_name)) WHERE col.id != _testimsorg.identification.core.email and key = 'Email'

Vous pouvez également exécuter la requête suivante pour vérifier si l’ingestion dans Profile n’a pas lieu en raison d’un espace de noms supérieur ayant une chaîne vide :

  SELECT identityMap, key, col.id as identityValue, _testimsorg.identification.core.email, _id, timestamp
  FROM (SELECT key, explode(value), *
  FROM (SELECT explode(identityMap), *
  FROM dataset_name)) WHERE (col.id = '' or _testimsorg.identification.core.email = '') and key = 'Email'

Ces deux requêtes supposent que :

Problèmes liés au comportement du graphique graph-behavior-related-issues

Cette section décrit les problèmes courants que vous pouvez rencontrer concernant le comportement du graphique d’identités.

Les ExperienceEvents non authentifiés sont associés à un profil authentifié incorrect.

L’algorithme d’optimisation des identités honorera les liens les plus récemment établis et supprimera les liens les plus anciens. Par conséquent, il est possible qu’une fois cette fonctionnalité activée, les ECID puissent être réaffectés (réliés) d’une personne à une autre. Pour comprendre l’historique des liens entre une identité au fil du temps, procédez comme suit :

Étapes de dépannage

Tout d’abord, vous devez collecter les informations suivantes :

Les symboles d’identité (namespaceCode) sont sensibles à la casse. Pour récupérer tous les symboles d’identité d’un jeu de données donné dans identityMap, exécutez la requête suivante :

SELECT distinct explode(*)FROM (SELECT map_keys(identityMap) FROM dataset_name)

Si vous ne connaissez pas la valeur d’identité de votre identifiant de cookie et que vous souhaitez rechercher un identifiant de cookie qui aurait été lié à plusieurs identifiants de personne, vous devez exécuter la requête suivante. Cette requête considère ECID comme l’espace de noms du cookie et CRMID comme l’espace de noms de la personne.

  SELECT identityMap['ECID'][0]['id'], count(distinct identityMap['CRMID'][0]['id']) as crmidCount FROM dataset_name GROUP BY identityMap['ECID'][0]['id'] ORDER BY crmidCount desc

  SELECT identityMap['ECID'][0]['id'], count(distinct personID) as crmidCount FROM dataset_name group by identityMap['ECID'][0]['id'] ORDER BY crmidCount desc

Maintenant que vous avez identifié les valeurs de cookie liées à plusieurs identifiants de personne, prenez-en une dans les résultats et utilisez-la dans la requête suivante pour obtenir une vue chronologique du moment où cette valeur de cookie a été liée à un autre identifiant de personne :

  SELECT identityMap['CRMID'][0]['id'] as personEntity, *
  FROM dataset_name
  WHERE identitymap['ECID'][0].id ='identity_value'
  ORDER BY timestamp desc

SELECT _experience.analytics.customDimensions.eVars.eVar10 as personEntity, *
FROM dataset_name
WHERE identitymap['ECID'][0].id ='identity_value'
ORDER BY timestamp desc

L’algorithme d’optimisation des identités ne fonctionne pas comme prévu.

Étapes de dépannage

Reportez-vous à la documentation sur l’ algorithme d’optimisation des identités, ainsi que les types de structures graphiques pris en charge.

Vous pouvez également utiliser l’outil de simulation graphique de l’interface utilisateur pour simuler des événements et configurer vos propres paramètres de priorité d’espace de noms et d’espace de noms uniques. Cela peut vous aider à comprendre de base le comportement de l’algorithme d’optimisation des identités.

Si les résultats de la simulation correspondent aux attentes de comportement du graphique, vous pouvez vérifier si vos paramètres d’identité correspondent aux paramètres que vous avez configurés dans votre simulation.

Je vois toujours des graphiques réduits dans mon environnement de test même après la configuration des paramètres d’identité.

Les graphiques d’identités se conforment à la priorité d’espace de noms et d’espace de noms uniques que vous avez configurée après l’enregistrement des paramètres. Les graphiques "réduits" qui existent avant l’enregistrement de vos nouveaux paramètres ne seront pas affectés tant que de nouvelles données n’auront pas été ingérées afin que le graphique réduit soit mis à jour. L’identité principale des fragments d’événement sur Real-time Customer Profile ne sera pas mise à jour même après les modifications de la priorité de l’espace de noms.

Étapes de dépannage

Vous pouvez utiliser la visionneuse de graphiques d’identités pour vérifier si votre graphique a été ingéré avant ou après vos paramètres. Examinez la dernière date et heure mises à jour sous Propriétés du lien pour savoir quand Identity Service a ingéré le graphique. Si l’horodatage est antérieur à la configuration, cela suggère que le graphique "réduit" a été créé avant d’activer la fonction.

Je veux savoir combien de graphiques "réduits" existent dans mon environnement de test.

Utilisez le tableau de bord des identités pour obtenir des informations sur l’état de votre graphique d’identités, telles que le nombre d’identités et de graphiques. Reportez-vous à la mesure "Nombre de graphiques avec plusieurs espaces de noms" pour le nombre de graphiques qui se sont réduits : il s’agit de graphiques qui contiennent deux identités ou plus avec le même espace de noms. En supposant que l’environnement de test ne comporte aucune donnée et que vous ayez configuré un espace de noms (CRMID, par exemple) pour qu’il soit unique, vous vous attendez à ce qu’aucun graphique ne comporte deux ou plusieurs CRMID. Dans l’exemple ci-dessous, deux graphiques contiennent au moins deux adresses électroniques.

Vous trouverez une ventilation détaillée dans le jeu de données d’exportation instantané de profil dans le lac de données en exécutant la requête ci-dessous :

  SELECT key, identityCountInGraph, count(identityCountInGraph) as graphCount
  FROM (SELECT key, cardinality(value) as identityCountInGraph
  FROM (SELECT explode(identityMap)
  FROM dataset_name
  WHERE cardinality(identityMap) > 1)) /* by definition, graphs have 2 or more identities */
  WHERE key not in ('ecid', 'aaid', 'idfa', 'gaid') /* filter out common device/cookie namespaces */
  GROUP BY 1, 2
  ORDER BY 1, 2 asc

Vous pouvez utiliser la requête suivante dans le jeu de données d’exportation d’instantanés de profil pour obtenir des exemples d’identités à partir de graphiques "réduits".

  SELECT identityMap
  FROM dataset_name
  WHERE cardinality(identityMap['CRMID'])>1 /* any graphs with 2+ CRMID. Change CRMID namespace if needed */

Questions fréquentes faq

Cette section présente une liste de réponses aux questions fréquentes sur les règles de liaison des graphiques d’identités.

Algorithme d’optimisation des identités identity-optimization-algorithm

Lisez cette section pour obtenir des réponses aux questions fréquentes sur l’algorithme d’optimisation des identités.

J’ai un CRMID pour chacune de mes unités commerciales (CRMID B2C, CRMID B2B), mais je n’ai pas d’espace de noms unique sur tous mes profils. Que se passe-t-il si je marque le CRMID B2C et le CRMID B2B comme uniques, et que j’active mes paramètres d’identité ?

Ce scénario n’est pas pris en charge. Par conséquent, vous pouvez voir les graphiques s’effondrer lorsqu’un utilisateur utilise son CRMID B2C pour se connecter et qu’un autre utilisateur utilise son CRMID B2B pour se connecter. Pour plus d’informations, consultez la section sur l’ exigence d’espace de noms d’une seule personne dans la page de mise en oeuvre.

L’algorithme d’optimisation des identités "corrige"-t-il les graphiques réduits existants ?

Les graphiques réduits existants seront affectés ('fixes') par l’algorithme graphique uniquement si ces graphiques sont mis à jour après l’enregistrement de vos nouveaux paramètres.

Si deux personnes se connectent et se déconnectent à l’aide du même appareil, qu’advient-il des événements ? Tous les événements seront-ils transférés vers le dernier utilisateur authentifié ?

Pour plus d’informations, consultez le guide sur la détermination de l’identité principale pour les événements d’expérience.

Comment les parcours dans Adobe Journey Optimizer seront-ils affectés lorsque l’ECID est transféré d’une personne à une autre ?

Le CRMID du dernier utilisateur authentifié sera lié à l’ECID (appareil partagé). Les ECID peuvent être réaffectés d’une personne à une autre en fonction du comportement de l’utilisateur. L’impact dépendra de la manière dont le parcours est construit. Il est donc important que les clients testent le parcours dans un environnement de test de développement pour valider le comportement.

Les points clés à mettre en évidence sont les suivants :

Priorité des espaces de noms

Lisez cette section pour obtenir des réponses aux questions fréquentes sur la priorité d’espace de noms.

J’ai activé mes paramètres d’identité. Qu’advient-il de mes paramètres si je souhaite ajouter un espace de noms personnalisé une fois les paramètres activés ?

Il existe deux "compartiments" d’espaces de noms : espaces de noms de personne et espaces de noms d’appareil/de cookie. L’espace de noms personnalisé nouvellement créé aura la priorité la plus faible dans chaque "compartiment" afin que ce nouvel espace de noms personnalisé n’ait aucune incidence sur l’ingestion des données existantes.

Si Real-Time Customer Profile n’utilise plus l’indicateur "principal" sur identityMap, cette valeur doit-elle toujours être envoyée ?

Oui, l’indicateur "principal" sur identityMap est utilisé par d’autres services. Pour plus d’informations, consultez le guide sur les implications de la priorité d’espace de noms sur les autres services Experience Platform.

La priorité d’espace de noms s’applique-t-elle aux jeux de données d’enregistrement de profil dans Real-time Customer Profile ?

Non. La priorité d’espace de noms s’applique uniquement aux jeux de données Experience Event utilisant la classe XDM ExperienceEvent.

Comment cette fonctionnalité fonctionne-t-elle en tandem avec les barrières de sécurité des graphiques d’identités de 50 identités par graphique ? La priorité de l’espace de noms affecte-t-elle cette barrière de sécurité définie par le système ?

L’algorithme d’optimisation des identités sera appliqué en premier pour garantir la représentation des entités de personne. Par la suite, si le graphique tente de dépasser la barrière de sécurité du graphique d’identités (50 identités par graphique), cette logique sera appliquée. La priorité de l’espace de noms n’affecte pas la logique de suppression de la barrière de sécurité 50 identités/graphiques.

Test

Lisez cette section pour obtenir des réponses aux questions fréquentes sur le test et le débogage des fonctionnalités dans les règles de liaison des graphiques d’identités.

Quels scénarios dois-je tester dans un environnement de test de développement ?

En règle générale, le test sur un environnement de test de développement doit reproduire les cas d’utilisation que vous avez l’intention d’exécuter sur votre environnement de test de production. Consultez le tableau suivant pour connaître les principaux domaines à valider lors d’un test complet :

Comment puis-je vérifier que cette fonctionnalité fonctionne comme prévu ?

Utilisez l’ outil de simulation graphique pour vérifier que la fonctionnalité fonctionne à un niveau de graphique individuel.

Pour valider la fonctionnalité au niveau de l’environnement de test, reportez-vous à la section Nombre de graphiques avec plusieurs espaces de noms dans le tableau de bord des identités.