Configuración de la integración entrante
Este artículo detalla los requisitos previos, responsabilidades, pasos para comprobar, pasos para solucionar problemas y criterios de finalización para configurar la integración entrante de la Visibilidad de la marca con Customer Journey Analytics.
Requisitos previos
Tenga en cuenta los siguientes requisitos previos antes de habilitar la integración entrante. Use el procedimiento de verificación a continuación para confirmar cada requisito previo.
Reenvío de registros BYOCDN
Adobe Brand Visibility debe reenviar y recibir los registros de acceso de CDN para cada sitio de Visibilidad de la marca antes de que el conector de origen de Visibilidad de la marca pueda ser viable.
Este requisito se aplica a cada lugar de Visibilidad de la marca. Una configuración de CDN o fuente de registro para un sitio, dominio o subdominio cubre solo ese sitio.
Confirme ambas partes del envío:
- Ha configurado la CDN o la canalización de registro relevantes para reenviar los registros de acceso necesarios al destino de Amazon S3 proporcionado por Adobe.
- La visibilidad de la marca de está recibiendo y detectando los registros del sitio correspondiente. A continuación, el sitio está disponible para su selección en la fuente de Adobe Brand Visibility en Experience Platform.
El reenvío de registros de BYOCDN proporciona los datos de solicitud de CDN del lado del servidor que se utilizan para el análisis del tráfico de agente automatizado. Los datos no dependen de las etiquetas de JavaScript que se ejecuten en un explorador. El requerido
La fuente de registro de CDN garantiza que el conjunto de datos de resumen descendente contenga la Visibilidad de la marca de datos de tráfico auténtico. Consulte la referencia de reenvío de registro BYOCDN para obtener más información.
Información requerida
Asegúrese de que tiene valores para todos los detalles necesarios enumerados en la siguiente tabla para cada sitio de Visibilidad de la marca.
Antes de continuar, confirme que cada sitio está disponible para su selección en la fuente de Adobe Brand Visibility.
Zona protegida
Puede agregar el conjunto de datos a la conexión de CJA después de que el conjunto de datos aparezca en Conjuntos de datos en esa zona protegida.
Confirme lo siguiente:
- Organización de IMS
- Entorno aislado de Experience Platform de Target
La zona protegida de AEP de destino es la misma zona protegida con nombre utilizada por la conexión o conexiones de Customer Journey Analytics correspondientes que incluyen el conjunto de datos.
El cliente puede agregar el conjunto de datos a la conexión de CJA adecuada solo después de que Adobe confirme que se ha creado el conjunto de datos administrado.
Conjunto de datos resumidos
La integración entrante proporciona un conjunto de datos de resumen agregado en Experience Platform que contiene información de solicitud de CDN del lado del servidor asociada a LLM, bot y automated-agent
tráfico.
La visibilidad de la marca de utiliza registros de acceso de CDN para identificar solicitudes de bots y agentes automatizados. Este tráfico no activa las etiquetas JavaScript del explorador y, por lo tanto, no se captura a través de una implementación convencional de análisis web.
Para obtener la descripción detallada de la integración entrante, la estructura del conjunto de datos y los campos disponibles, consulte información sobre el conjunto de datos.
El origen de Visibilidad de la marca crea el conjunto de datos de resumen en Experience Platform mediante:
- La clase Métricas de resumen de XDM
- El grupo de campos Resumen de solicitudes de CDN
- Campos organizados bajo un objeto cdn
El conector crea el conjunto de datos para cada sitio de Visibilidad de la marca, utilizando el siguiente patrón de nomenclatura: Conjunto de datos de Adobe Brand Visibility (ABV) - baseUrl sin esquema.
Por ejemplo Adobe Brand Visibility (ABV) Dataset - example.com para el sitio https://example.com.
Los conjuntos de datos creados antes de que se adoptara esta convención de nomenclatura muestran el conjunto de datos de optimización de LLM (LLMO) de patrón anterior: baseUrl sin esquema``.
Busque el conjunto de datos en Conjuntos de datos dentro de la zona protegida donde creó el flujo de datos.
El conjunto de datos es un resumen de datos agregado. Al analizar el volumen de solicitudes en Customer Journey Analytics, utilice la métrica Recuento de solicitudes de CDN proporcionada en lugar de contar las filas del conjunto de datos.
Compruebe los campos disponibles en el esquema del conjunto de datos creado para el sitio de Visibilidad de la marca específico. Para planificar la configuración de la vista de datos, revise los campos.
Responsabilidades
Después de habilitar el origen de Visibilidad de la marca, haga lo siguiente en Visibilidad de la marca:
- Envía el conjunto de datos de resumen del sitio seleccionado.
- Aterriza el conjunto de datos en el entorno limitado en el que ha creado el flujo de datos.
Sus responsabilidades como cliente son:
- Para asegurarse de que los registros de CDN se reenvíen y reciban por Visibilidad de la marca para cada sitio de Visibilidad de la marca.
- Para habilitar el origen de la Visibilidad de la marca en el entorno limitado correcto, confirme que el sitio está disponible para seleccionarlo.
- Para seleccionar la conexión de Customer Journey Analytics que debe incluir el conjunto de datos.
- Para agregar el conjunto de datos a esa conexión.
- Para seleccionar los campos que se van a exponer como componentes en la vista de datos de Customer Journey Analytics correspondiente.
- Para validar que las dimensiones y métricas resultantes admiten el análisis deseado.
El conjunto de datos no está disponible para el análisis de Customer Journey Analytics hasta que se agrega el conjunto de datos a una conexión. Los datos
no está disponible para los usuarios a través de una vista de datos hasta que se hayan agregado los campos relevantes a esa vista de datos.
Para habilitar el origen:
-
En Experience Platform, seleccione la zona protegida en la que desea el conjunto de datos. Un sitio se puede asignar solo una vez, por lo que asegúrese de que esta zona protegida sea la que desee.
-
Vaya a Sources, luego a Catalog y después a las aplicaciones de Adobe. En la tarjeta Adobe Brand Visibility, selecciona Configurar la primera vez. Después, la tarjeta muestra Agregar datos.
-
Seleccione Agregar datos.
-
En el paso ➊ Seleccionar datos:
-
Seleccione el sitio de la tabla Nombre del sitio. Una vez que un sitio se asigna a un flujo de datos, no se puede volver a seleccionar en ese sitio o en cualquier otro entorno limitado.
-
Seleccione Siguiente.
-
-
En el paso ➋ Detalle del flujo de datos:
-
Escriba un nombre de flujo de datos y una descripción opcional. También puede suscribirse a las alertas Inicio de ejecución del flujo de datos de origen, Éxito de ejecución del flujo de datos de origen y Error de ejecución del flujo de datos de origen.
-
Seleccione Siguiente.
-
-
En el paso ➌ Revisar:
-
Compruebe la conexión y la asignación del conjunto de datos.
-
seleccione Finalizar.
-
El conjunto de datos se asigna automáticamente y no se requiere ninguna asignación de campo.
Verificación
Utilice el siguiente procedimiento para verificar la integración entrante:
-
Confirme la preparación del sitio ABV y del registro de CDN.
Para cada sitio ABV:
- Confirme el sitio o dominio exacto cubierto por el reenvío de registro de CDN.
- Confirme que el sitio está disponible para su selección en el origen de Visibilidad de la marca dentro de Experience Platform. Hay un sitio disponible en función de la disponibilidad de los registros de CDN analizados en la Visibilidad de la marca.
- No continúe con una declaración general de que “los registros de CDN están habilitados”. Continúe cuando el sitio ABV específico esté disponible para su selección.
- Confirme que la Visibilidad de la marca está recibiendo o detectando registros para ese sitio.
- Obtenga de Adobe la confirmación de preparación para Visibilidades de la marca del sitio.
-
Compruebe el conjunto de datos en Experience Platform.
Después de crear el flujo de datos:
-
Inicie sesión en Experience Platform.
-
Seleccione la zona protegida en la que ha creado el flujo de datos.
-
Busque el conjunto de datos de su sitio de Visibilidad de la marca en Conjuntos de datos.
-
Confirme que el conjunto de datos está asociado con el sitio de Visibilidad de la marca esperado.
-
Registre el ID del conjunto de datos y el esquema vinculado.
-
Revise el recuento de registros del conjunto de datos, la información de ingesta más reciente y los datos de ejemplo disponibles donde se permita.
-
Abra el esquema vinculado y compruebe la estructura XDM esperada:
- Clase: Métricas de resumen de XDM
- Grupo de campos: Resumen de solicitudes de CDN
- Objeto: cdn
- Dimensiones y métricas esperadas, como botType, cdnProvider, url, host, status, requests y timeToFirstByte.
-
-
Añadir el conjunto de datos a una conexión
El administrador de Customer Journey Analytics debe agregar el conjunto de datos a la conexión deseada:
- Inicie sesión en Customer Journey Analytics.
- Cree una nueva conexión o edite la conexión existente deseada. Confirme que la conexión utiliza el mismo entorno limitado de Experience Platform en el que se creó el conjunto de datos.
- Busque el conjunto de datos por nombre o ID de conjunto de datos.
- Agregue el conjunto de datos a la conexión.
- Configure los ajustes del conjunto de datos según el diseño de Customer Journey Analytics del cliente.
- Guarde la conexión.
- Para confirmar que el conjunto de datos está incluido y que la ingesta está progresando, revise los detalles de conexión.
-
Configuración o actualización de la vista de datos
Una vez que el conjunto de datos forme parte de la Conexión:
-
Inicie sesión en Customer Journey Analytics.
-
Cree una nueva vista de datos o edite la vista de datos asociada con el caso de uso de creación de informes deseado.
-
Seleccione la conexión que contiene el conjunto de datos de Visibilidad de la marca administrado.
-
Añada los campos de esquema requeridos como dimensiones o métricas.
-
Incluya los campos necesarios para el análisis planificado, como:
- Tipo de bot de CDN
- Proveedor de CDN
- URL DE CDN
- Host de CDN
- Estado HTTP de CDN
- Recuento de solicitudes de CDN
- Tiempo promedio de CDN a primer byte
-
Guarde la vista de datos.
-
Valide los campos de Analysis Workspace o el flujo de trabajo de creación de informes seleccionado del cliente.
-
-
Validación del resultado de extremo a extremo
Utilice un período de informe reciente y compruebe que:
- Se representa el sitio de Visibilidad de la marca esperado.
- El proveedor de CDN y los valores de host esperados están presentes.
- Se representa el tráfico de bots o de agentes automatizados.
- Las dimensiones de URL y estado HTTP contienen los valores esperados.
- Están disponibles las métricas de rendimiento y Recuento de solicitudes de CDN.
- El conjunto de datos se incluye en la conexión deseada.
- Los campos obligatorios se exponen en la vista de datos deseada.
El tiempo exacto necesario para que los datos estén disponibles depende de la ingesta y del flujo de trabajo de procesamiento de Customer Journey Analytics.
Solucionar problemas
Revise los siguientes pasos si se producen problemas:
-
El conjunto de datos no aparece en AEP.
Compruebe que:
- La organización de IMS es correcta.
- La zona protegida de Experience Platform seleccionada es correcta.
- El origen se habilitó después de que funcionara el reenvío de registro de CDN.
- Se ha utilizado el nombre o ID del conjunto de datos proporcionado por Adobe.
- El conjunto de datos se creó para el sitio de Visibilidad de la marca correcto.
-
El conjunto de datos existe, pero no contiene los datos esperados.
Compruebe que:
- Los registros de CDN se están reenviando para el sitio de Visibilidad de la marca exacto.
- La visibilidad de la marca está recibiendo o detectando registros para el sitio.
- El sitio o dominio de la configuración de CDN coincide con el sitio de Visibilidad de la marca.
- El conector administrado se habilitó después de que se confirmara la preparación del registro de CDN.
- El intervalo de fechas seleccionado incluye el período posterior al inicio de la ingesta de registros.
-
El conjunto de datos existe en Experience Platform, pero no está disponible en Customer Journey Analytics.
Compruebe que:
- La conexión de Customer Journey Analytics utiliza la misma zona protegida de Experience Platform.
- El conjunto de datos se ha agregado explícitamente a la conexión.
- El administrador de Customer Journey Analytics tiene los permisos necesarios.
- La conexión se ha guardado después de agregar el conjunto de datos.
-
El conjunto de datos está en la conexión, pero los campos no están disponibles para la creación de informes.
Compruebe que:
- La vista de datos selecciona la conexión de Customer Journey Analytics correcta.
- Los campos de esquema esperados se agregaron como componentes de vista de datos.
- Los campos se colocaron en la sección Dimensiones o Métricas deseada.
- La vista de datos se guardó después de agregar los componentes.
- El esquema del conjunto de datos coincide con la estructura del grupo de campos Resumen de solicitudes de CDN esperado.
-
El sitio no está en la lista.
Compruebe que:
- Hay un sitio disponible para seleccionar en función de la disponibilidad de los registros de CDN analizados en la Visibilidad de la marca.
- El reenvío de registros de CDN está configurado y funciona para el sitio.
-
No se puede seleccionar el sitio.
Tenga en cuenta que una vez que un sitio se asigna a un flujo de datos, no se puede volver a seleccionar en ese sitio o en cualquier otra zona protegida. Para utilizar el sitio en una zona protegida diferente, elimine el flujo de datos al que está asignado el sitio. A continuación, se puede volver a seleccionar el sitio. La eliminación del flujo de datos afecta a cualquier conexión de Customer Journey Analytics o vista de datos que dependa de los datos de este origen.
-
El flujo de datos muestra un estado de error.
Use el panel Supervisión. La descripción general de Sources indica que un flujo de datos de origen que falla continuamente durante 30 días se deshabilita automáticamente.
Criterios de finalización
La integración entrante está lista para la configuración de Customer Journey Analytics del lado del cliente cuando se confirmen todas las siguientes opciones:
- Los registros de CDN se reenvían y reciben por Visibilidad de la marca para cada sitio ABV solicitado.
- Cada sitio de Visibilidad de la marca está disponible para su selección en el origen de Adobe Brand Visibility.
- Ha habilitado la fuente de Adobe Brand Visibility en la zona protegida deseada.
- El conjunto de datos de resumen por sitio aparece en esa zona protegida.
- Ha verificado el conjunto de datos y su esquema XDM.
- Ha agregado el conjunto de datos a la conexión de CJA deseada.
- Ha configurado los componentes relevantes de la vista de datos de CJA.