Información general sobre la implementación Edge
Adobe Experience Platform Edge Network permite enviar datos destinados a varios productos a un único extremo, que a su vez reenvía la información adecuada a cada producto. Esta es la forma recomendada de implementar la recopilación de medios de streaming y es el único enfoque que admite Adobe Analytics y Customer Journey Analytics desde una sola implementación.
A diferencia del enfoque heredado de Media SDK, que requería instrumentación específica de producto para cada solución de Adobe, una implementación de Edge utiliza un modelo de datos XDM compartido y un único conjunto de datos. Los datos fluyen desde el SDK o la API al Edge Network, que luego los enruta a los productos de Adobe que estén configurados en el conjunto de datos (Analytics, CJA, AJO o RTCDP). Esto significa que cambiar o añadir productos de flujo descendente más adelante no requiere reinstrumentar los eventos de medios.
Independientemente del código base que utilice, primero debe completar la configuración de la plataforma descrita en esta página: crear un esquema, crear un conjunto de datos y configurar una secuencia de datos.
Requisitos previos
-
Complete los requisitos previos generales. Consulte los requisitos previos generales.
-
Confirmar una solución de Adobe compatible. Debe tener una implementación en funcionamiento de al menos una de las siguientes opciones:
- Customer Journey Analytics: el principal destino de generación de informes para los datos multimedia basados en Edge
- Adobe Analytics: compatible junto con o en lugar de CJA a través del mismo conjunto de datos
- Adobe Journey Optimizer o Real-Time Customer Data Platform: Agregue el servicio Adobe Experience Platform a su secuencia de datos al configurar cualquiera de estos
Configuración del esquema en Adobe Experience Platform
Para estandarizar la recopilación de datos en todas las aplicaciones que utilizan Adobe Experience Platform, Adobe ha creado el estándar abierto y documentado públicamente Experience Data Model (XDM).
-
En Adobe Experience Platform, empiece a crear el esquema como se describe en Crear y editar esquemas en la interfaz de usuario.
-
En la página Detalles del esquema, elija Evento de experiencia como clase base para el esquema.
-
Seleccione Siguiente.
-
Especifique un nombre para mostrar y una descripción de esquema y, a continuación, seleccione Finalizar.
-
En el área Composición, en la sección Grupos de campos, seleccione Agregar y, a continuación, busque y agregue los siguientes grupos de campos al esquema:
End User ID DetailsImplementation DetailsMediaAnalytics Interaction Details
Después de agregar los grupos de campos, se muestran en la sección Grupos de campos:
-
Seleccione Guardar para guardar los cambios.
-
(Opcional) Puede ocultar ciertos campos de la interfaz de usuario del esquema. Estos campos son campos de creación de informes calculados por el servidor que Adobe rellena en el servidor: su SDK o API no los envía y no afectan a la recopilación de datos. Ocultarlos no tiene ningún impacto funcional; solo reduce el ruido visual al examinar el esquema en la interfaz de usuario de AEP. Estos campos solo hacen referencia a los del grupo de campos
MediaAnalytics Interaction Details.accordion Amplíe para ver las instrucciones de los campos que puede ocultar. -
En el área Estructura, seleccione el campo
Media Collection Detailsy luego seleccione Administrar campos relacionados.
-
Habilite la opción para Mostrar nombres para mostrar en los campos y, a continuación, actualice el esquema de la siguiente manera:
-
En el campo
Media Collection Details>Advertising Details, oculte los siguientes campos de informe:Ad Completed,Ad StartedyAd Time Played. -
En el campo
Media Collection Details>Advertising Pod Details, oculte el siguiente campo de informe:Ad Break ID -
En el campo
Media Collection Details>Chapter Details, oculte los siguientes campos de informe:Chapter Completed,Chapter ID,Chapter StartedyChapter Time Played. -
En el campo
Media Collection Details, oculte el campoList Of States.
-
En el campo
Media Collection Details>List Of States EndyMedia Collection Details>List Of States Start, oculte los siguientes campos de informe:Player State Count,Player State SetyPlayer State Time.
-
En el campo
Media Collection Details>Qoe Data Details, oculte los siguientes campos de informe:Average Bitrate,Average Bitrate Bucket,Bitrate Change Impacted Streams,Bitrate Changes,Buffer Impacted Streams,Buffer Events,Dropped Frame Impacted Streams,Drops Before Starts,Errors,External Error IDs,Error Impacted Streams,Media SDK Error IDs,Player SDK Error IDs,Stalling Impacted Streams,Stalling Events,Total Buffer DurationyTotal Stalling Duration. -
En el campo
Media Collection Details>Session Details, oculte los siguientes campos de informe:10% Progress Marker,25% Progress Marker,50% Progress Marker,75% Progress Marker,95% Progress Marker,Ad Count,Average Minute Audience,Content Completes,Chapter Count,Content Starts,Content Time Spent,Estimated Streams,Federated Data,Media Segment Views,Media Downloaded Flag,Media Starts,Media Session ID,Media Session Server Timeout,Media Time Spent,Pause Events,Pause Impacted Streams,Pev3,Pccr,Total Pause Duration,Unique Time PlayedyVideo Segment.
-
-
Seleccione Confirmar para guardar los cambios.
-
En el área Estructura, habilite la opción para Mostrar nombres para mostrar para los campos y, a continuación, seleccione el campo
List Of Media Collection Downloaded Content Events. -
Seleccione Administrar campos relacionados y, a continuación, actualice el esquema de la siguiente manera:
-
En el campo
List Of Media Collection Downloaded Content Events>Media Details>Advertising Details, oculte los siguientes campos de informe:Ad Completed,Ad StartedyAd Time Played. -
En el campo
List Of Media Collection Downloaded Content Events>Media Details>Advertising Pod Details, oculte el siguiente campo de informe:Ad Break ID -
En el campo
List Of Media Collection Downloaded Content Events>Media Details>Chapter Details, oculte los siguientes campos de informe:Chapter Completed,Chapter ID,Chapter StartedyChapter Time Played. -
En el campo
List Of Media Collection Downloaded Content Events>Media Details, oculte el campoList Of States. -
En el campo
List Of Media Collection Downloaded Content Events>Media Details>List Of States EndyMedia Collection Details>List Of States Start, oculte los siguientes campos de informe:Player State Count,Player State SetyPlayer State Time. -
En el campo
List Of Media Collection Downloaded Content Events>Media Details>Qoe Data Details, oculte los siguientes campos de informe:Average Bitrate,Average Bitrate Bucket,Bitrate Change Impacted Streams,Bitrate Changes,Buffer Events,Buffer Impacted Streams,Drops Before Starts,Dropped Frame Impacted Streams,Error Impacted Streams,Errors,External Error IDs,Media SDK Error IDs,Player SDK Error IDs,Stalling Events,Stalling Impacted Streams,Total Buffer DurationyTotal Stalling Duration. -
En el campo
List Of Media Collection Downloaded Content Events>Media Details>Session Details, oculte los siguientes campos de informe:10% Progress Marker,25% Progress Marker,50% Progress Marker,75% Progress Marker,95% Progress Marker,Ad Count,Average Minute Audience,Chapter Count,Content Completes,Content Starts,Content Time Spent,Estimated Streams,Federated Data,Media Downloaded Flag,Media Segment Views,Media Session ID,Media Session Server Timeout,Media Starts,Media Time Spent,Pause Events,Pause Impacted Streams,Pccr,Pev3,Total Pause Duration,Unique Time PlayedyVideo Segment. -
En el campo
List Of Media Collection Downloaded Content Events>Media Details, oculte el campoMedia Session ID.
-
-
Seleccione Confirmar para guardar los cambios.
-
En el área Estructura, seleccione el campo
Media Reporting Detailsy luego seleccione Administrar campos relacionados. -
Habilite la opción para Mostrar nombres para mostrar en los campos y, a continuación, actualice el esquema de la siguiente manera:
- En el campo
Media Reporting Details, oculte los campos siguientes:Error Details,List Of States End,List of States StartyMedia Session ID.
- En el campo
-
Seleccione Confirmar > Guardar para guardar los cambios.
-
-
(Opcional) Puede agregar metadatos personalizados al esquema. Esto permite incluir metadatos adicionales definidos por el usuario para necesidades o contextos específicos. Para obtener más información sobre metadatos personalizados con la API de Media Edge, consulte Compatibilidad con metadatos personalizados.
accordion Amplíe para ver instrucciones sobre cómo agregar metadatos personalizados al esquema. -
Busque el nombre de inquilino de la organización seleccionando Información de cuenta > Organizaciones asignadas > Nombre de organización > inquilino.
Los campos personalizados se reciben a través de esta ruta. (Por ejemplo, nombre de inquilino: _dcbl → ruta myCustomField: _dcbl.myCustomField).
-
Agregue un grupo de campos personalizados al esquema de medios definido.
-
Agregue al grupo de campos los campos personalizados que desee rastrear.
-
Use la ruta generada para el campo personalizado en la carga de la solicitud.
-
Creación de un conjunto de datos en Adobe Experience Platform
-
En Adobe Experience Platform, empiece a crear el conjunto de datos como se describe en la Guía de IU de conjuntos de datos.
Al seleccionar un esquema para el conjunto de datos, elija el esquema que creó anteriormente.
Configuración de una secuencia de datos en Adobe Experience Platform
-
Cree una nueva secuencia de datos como se describe en Configurar una secuencia de datos.
Al crear la secuencia de datos, realice las siguientes selecciones:
-
En el campo Esquema de evento, seleccione el esquema que creó en Configurar el esquema en Adobe Experience Platform.
note important IMPORTANT Seleccione Guardar; no seleccione Guardar y agregar asignación. Si se selecciona Guardar y agregar asignación, se producirán errores de asignación en el campo Marca de tiempo.
-
Añada los servicios adecuados al conjunto de datos en función de su solución de Adobe. Para obtener información acerca de cómo agregar un servicio, vea “Agregar servicios a un conjunto de datos” en Configurar un conjunto de datos.
-
Adobe Analytics (si usa Adobe Analytics): defina un grupo de informes como se describe en Crear un grupo de informes.
-
Adobe Experience Platform (si usa Customer Journey Analytics, Adobe Journey Optimizer o Real-Time Customer Data Platform)
-
-
Expanda Opciones avanzadas y, a continuación, habilite la opción Media Analytics.
-
Elija el método de implementación
Con el esquema, el conjunto de datos y el conjunto de datos en su lugar, implemente uno de los siguientes códigos para empezar a enviar datos de medios de streaming a Edge Network. Cada página cubre la configuración específica de los medios de streaming; el código por evento y por variable se encuentra en Events y Variables.
Las implementaciones de In-code escriben llamadas de SDK directamente en el código fuente de la aplicación. Las implementaciones de Using Tags utilizan Adobe Experience Platform Tags, que le permite configurar e implementar reglas de seguimiento sin modificar el código de la aplicación. Elija el enfoque que se ajuste al flujo de trabajo de implementación.
Siguiente paso
Una vez que empiece a recopilar datos, puede configurar la creación de informes:
- Configurar informes para implementaciones de Edge (Customer Journey Analytics)
- Configurar informes para implementaciones solo de Analytics (si el flujo de datos alimenta a Adobe Analytics)