Guía de resolución de problemas para reglas de vinculación de gráficos de identidad

A medida que prueba y valida las reglas de vinculación de gráficos de identidad, puede encontrar algunos problemas relacionados con la ingesta de datos y el comportamiento del gráfico. Lea este documento para aprender a solucionar algunos problemas comunes que pueden producirse al trabajar con reglas de vinculación de gráficos de identidad.

Resumen del flujo de ingesta data-ingestion-flow-overview

El diagrama siguiente es una representación simplificada de cómo fluyen los datos a Adobe Experience Platform y aplicaciones. Utilice este diagrama como referencia para comprender mejor el contenido de esta página.

Es importante tener en cuenta los siguientes factores:

Problemas de ingesta de datos data-ingestion-issues

Mis identidades no se están introduciendo en el servicio de identidad my-identities-are-not-getting-ingested-into-identity-service

Esto puede deberse a varios motivos, entre los que se incluyen, entre otros:

En el contexto de las reglas de vinculación de gráficos de identidad, se puede rechazar un registro del servicio de identidad porque el evento entrante tiene dos o más identidades con el mismo área de nombres única pero con un valor de identidad diferente. Este escenario suele ocurrir debido a errores de implementación.

Considere el siguiente evento con dos suposiciones:

El siguiente evento devolverá un mensaje de error que indica que la ingesta ha fallado.

{
  "_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"
    }
  }
}

Pasos para solucionar problemas

Para resolver este error, primero debe recopilar la siguiente información:

A continuación, use Adobe Experience Platform Query Service y ejecute la siguiente consulta:

  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'

Después de ejecutar la consulta, busque el registro de evento que esperaba para generar un gráfico y, a continuación, compruebe que los valores de identidad son diferentes en la misma fila. Vea la siguiente imagen para ver un ejemplo:

Los ExperienceEvents posteriores a la autenticación se atribuyen al perfil autenticado incorrecto

La prioridad del área de nombres desempeña un papel importante en la forma en que los fragmentos de evento determinan la identidad principal.

Para que eventos de usuario autenticados se vinculen al área de nombres de persona, todos los eventos autenticados deben contener el área de nombres de persona (CRMID). Esto significa que, incluso después de que un usuario inicie sesión, el área de nombres de persona debe estar presente en cada evento autenticado.

Puede seguir viendo el indicador "eventos" de primary=true al buscar un perfil en el visor de perfiles. Sin embargo, se ignora y el perfil no lo utiliza.

Los AAID están bloqueados de forma predeterminada. Por lo tanto, si está usando el conector de origen de Adobe Analytics, debe asegurarse de que ECID tenga una prioridad mayor que ECID para que los eventos no autenticados tengan una identidad principal de ECID.

Pasos para solucionar problemas

Mis fragmentos de eventos de experiencia no se están ingiriendo en el perfil my-experience-event-fragments-are-not-getting-ingested-into-profile

Existen varias razones que explican por qué los fragmentos de eventos de experiencia no se incorporan en el perfil, entre ellas, las siguientes:

En el contexto de la prioridad del área de nombres, el perfil rechazará:

Pasos para solucionar problemas

Si los datos se envían al lago de datos, pero no al perfil, y cree que esto se debe a enviar dos o más identidades con la prioridad de área de nombres más alta en un solo evento, puede ejecutar la siguiente consulta para validar que hay dos valores de identidad diferentes enviados con el mismo área de nombres:

  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'

También puede ejecutar la siguiente consulta para comprobar si la ingesta en el perfil no se está produciendo debido a que el área de nombres más alta tiene una cadena vacía:

  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'

Estas dos consultas suponen lo siguiente:

Problemas relacionados con el comportamiento de gráficos graph-behavior-related-issues

Esta sección describe problemas comunes que pueden surgir con respecto al comportamiento del gráfico de identidad.

Los ExperienceEvents no autenticados se están adjuntando al perfil autenticado incorrecto

El algoritmo de optimización de identidad respetará los vínculos establecidos más recientemente y eliminará los vínculos más antiguos. Por lo tanto, es posible que una vez habilitada esta función, los ECID se puedan reasignar (volver a vincular) de una persona a otra. Para comprender el historial de cómo se vincula una identidad a lo largo del tiempo, siga los pasos a continuación:

Pasos para solucionar problemas

En primer lugar, debe recopilar la siguiente información:

Los símbolos de identidad (namespaceCode) distinguen entre mayúsculas y minúsculas. Para recuperar todos los símbolos de identidad de un conjunto de datos determinado en el identityMap, ejecute la siguiente consulta:

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

Si no conoce el valor de identidad del identificador de cookie y desea buscar un ID de cookie que se hubiera vinculado a varios identificadores de persona, debe ejecutar la siguiente consulta. Esta consulta supone que ECID es el área de nombres de la cookie y CRMID es el área de nombres de la persona.

  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

Ahora que ha identificado los valores de las cookies vinculados a varios ID de persona, tome uno de los resultados y utilícelo en la siguiente consulta para obtener una vista cronológica de cuándo ese valor de cookie se vinculó a un identificador de persona diferente:

  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

El algoritmo de optimización de identidad no funciona como se esperaba

Pasos para solucionar problemas

Consulte la documentación sobre algoritmo de optimización de identidad, así como los tipos de estructuras de gráficos admitidos.

También puede usar la herramienta de simulación de gráficos de la interfaz de usuario para simular eventos y configurar su propia configuración de área de nombres y prioridad de área de nombres únicas. Hacerlo puede ayudarle a comprender una línea de base del comportamiento del algoritmo de optimización de identidad.

Si los resultados de la simulación coinciden con las expectativas de comportamiento del gráfico, puede comprobar si la configuración de identidad coincide con la configuración de la simulación.

Todavía veo gráficos contraídos en mi zona protegida incluso después de configurar la identidad

Los gráficos de identidad se ajustarán al área de nombres única configurada y a la prioridad de área de nombres después de guardar la configuración. Cualquier gráfico "contraído" que exista antes de que guarde su nueva configuración no se verá afectado, hasta que se incorporen nuevos datos de manera que se actualice el gráfico contraído. La identidad principal de los fragmentos de evento en el Perfil del cliente en tiempo real no se actualizará incluso después de que cambie la prioridad del área de nombres.

Pasos para solucionar problemas

Puede usar el visualizador de gráficos de identidad para comprobar si el gráfico se ha introducido antes o después de la configuración. Examine la última marca de tiempo actualizada en Propiedades del vínculo para ver cuándo el servicio de identidad ingirió el gráfico. Si la marca de tiempo es anterior a la configuración, eso sugiere que el gráfico "contraído" se creó antes de habilitar la función.

Quiero saber cuántos gráficos "colapsados" existen en mi zona protegida

Utilice el panel de identidad para obtener información sobre el estado del gráfico de identidad, como el recuento de identidades y gráficos. Consulte la métrica "Recuento de gráficos con varias áreas de nombres" para ver un recuento de gráficos que se han contraído: son gráficos que contienen dos o más identidades con el mismo área de nombres. Suponiendo que la zona protegida no tenga datos y que haya configurado un área de nombres (por ejemplo, CRMID) para que sea única, se espera que no haya gráficos que tengan dos o más CRMID. En el ejemplo siguiente, hay dos gráficos que contienen dos o más direcciones de correo electrónico.

Puede encontrar un desglose detallado en el conjunto de datos de exportación de instantáneas de perfil en el lago de datos ejecutando la siguiente consulta:

  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

Puede utilizar la siguiente consulta en el conjunto de datos de exportación de instantáneas de perfil para obtener identidades de muestra de gráficos "contraídos".

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

Preguntas frecuentes faq

En esta sección se describe una lista de respuestas a las preguntas más frecuentes sobre las reglas de vinculación de gráficos de identidad.

Algoritmo de optimización de identidad identity-optimization-algorithm

Lea esta sección para obtener respuestas a las preguntas más frecuentes acerca del algoritmo de optimización de identidad.

Tengo un CRMID para cada una de mis unidades de negocio (B2C CRMID, B2B CRMID), pero no tengo un área de nombres única en todos mis perfiles. ¿Qué sucederá si marco B2C CRMID y B2B CRMID como únicos y habilito mi configuración de identidad?

Este escenario no es compatible. Por lo tanto, es posible que vea que los gráficos se contraen cuando un usuario utiliza su CRMID B2C para iniciar sesión y otro usuario utiliza su CRMID B2B para iniciar sesión. Para obtener más información, lea la sección sobre requisito del área de nombres de una sola persona en la página de implementación.

¿El algoritmo de optimización de identidad "corrige" los gráficos contraídos existentes?

Los gráficos contraídos existentes solo se verán afectados ("corregidos") por el algoritmo de gráficos si estos gráficos se actualizan después de guardar la nueva configuración.

Si dos personas inician y finalizan sesión con el mismo dispositivo, ¿qué sucede con los eventos? ¿Se transferirán todos los eventos al último usuario autenticado?

Para obtener más información, lea la guía sobre determinar la identidad principal para los eventos de experiencia.

¿Cómo se verán afectados los recorridos en Adobe Journey Optimizer cuando el ECID se transfiera de una persona a otra?

El CRMID del último usuario autenticado se vinculará al ECID (dispositivo compartido). Los ECID se pueden reasignar de una persona a otra según el comportamiento del usuario. El impacto dependerá de cómo se construya la recorrido, por lo que es importante que los clientes prueben la recorrido en un entorno de zona protegida de desarrollo para validarla.

Los puntos clave a destacar son los siguientes:

Prioridad de espacios de nombres

Lea esta sección para obtener respuestas a las preguntas más frecuentes acerca de prioridad del área de nombres.

He habilitado mi configuración de identidad. ¿Qué sucede con mi configuración si deseo agregar un área de nombres personalizada después de habilitar la configuración?

Hay dos "bloques" de áreas de nombres: áreas de nombres de persona y áreas de nombres de dispositivo/cookie. El área de nombres personalizada recién creada tendrá la prioridad más baja en cada "bloque" para que este nuevo área de nombres personalizada no afecte a la ingesta de datos existente.

Si el perfil del cliente en tiempo real ya no utiliza el indicador "principal" en identityMap, ¿sigue siendo necesario enviar este valor?

Sí, otros servicios utilizan el indicador "principal" en identityMap. Para obtener más información, lea la guía sobre las implicaciones de la prioridad del área de nombres en otros servicios de Experience Platform.

¿Se aplicará la prioridad de área de nombres a los conjuntos de datos de registro de perfil en el Perfil del cliente en tiempo real?

No. La prioridad de área de nombres solo se aplicará a los conjuntos de datos de Experience Event que utilicen la clase XDM ExperienceEvent.

¿Cómo funciona esta función en conjunto con las protecciones del gráfico de identidad de 50 identidades por gráfico? ¿Afecta la prioridad de área de nombres a esta protección definida por el sistema?

El algoritmo de optimización de identidad se aplicará primero para garantizar la representación de la entidad de la persona. Después, si el gráfico intenta superar la protección del gráfico de identidad (50 identidades por gráfico), se aplicará esta lógica. La prioridad del área de nombres no afecta a la lógica de eliminación de la protección de 50 identidades/gráficos.

Pruebas

Lea esta sección para obtener respuestas a las preguntas más frecuentes acerca de las características de prueba y depuración en las reglas de vinculación de gráficos de identidad.

¿Cuáles son algunos de los escenarios que debería probar en un entorno de zona protegida de desarrollo?

En términos generales, las pruebas en una zona protegida de desarrollo deben imitar los casos de uso que tiene intención de ejecutar en la zona protegida de producción. Consulte la siguiente tabla para conocer algunas áreas clave que se deben validar al realizar pruebas exhaustivas:

¿Cómo valido que esta función funciona según lo esperado?

Use la herramienta de simulación de gráficos para comprobar que la característica funciona a nivel de gráfico individual.

Para validar la característica en un nivel de zona protegida, consulte la sección Recuento de gráficos con varias áreas de nombres en el panel de identidad.