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

  1. Complete los requisitos previos generales. Consulte los requisitos previos generales.

  2. Confirmar una solución de Adobe compatible. Debe tener una implementación en funcionamiento de al menos una de las siguientes opciones:

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).

  1. En Adobe Experience Platform, empiece a crear el esquema como se describe en Crear y editar esquemas en la interfaz de usuario.

  2. En la página Detalles del esquema, elija Evento de experiencia como clase base para el esquema.

    Se agregaron grupos de campos

  3. Seleccione Siguiente.

  4. Especifique un nombre para mostrar y una descripción de esquema y, a continuación, seleccione Finalizar.

  5. 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 Details
    • Implementation Details
    • MediaAnalytics Interaction Details

    Después de agregar los grupos de campos, se muestran en la sección Grupos de campos:

    Se agregaron grupos de campos

  6. Seleccione Guardar para guardar los cambios.

  7. (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.
    1. En el área Estructura, seleccione el campo Media Collection Details y luego seleccione Administrar campos relacionados.

      administrar campos relacionados

    2. 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 Started y Ad 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 Started y Chapter Time Played.

      • En el campo Media Collection Details, oculte el campo List Of States.

        ocultar estados de colección de medios

      • En el campo Media Collection Details > List Of States End y Media Collection Details > List Of States Start, oculte los siguientes campos de informe: Player State Count, Player State Set y Player State Time.

        campos para ocultar

      • 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 Duration y Total 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 Played y Video Segment.

    3. Seleccione Confirmar para guardar los cambios.

    4. 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.

    5. 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 Started y Ad 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 Started y Chapter Time Played.

      • En el campo List Of Media Collection Downloaded Content Events > Media Details, oculte el campo List Of States.

      • En el campo List Of Media Collection Downloaded Content Events > Media Details > List Of States End y Media Collection Details > List Of States Start, oculte los siguientes campos de informe: Player State Count, Player State Set y Player 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 Duration y Total 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 Played y Video Segment.

      • En el campo List Of Media Collection Downloaded Content Events > Media Details, oculte el campo Media Session ID.

    6. Seleccione Confirmar para guardar los cambios.

    7. En el área Estructura, seleccione el campo Media Reporting Details y luego seleccione Administrar campos relacionados.

    8. 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 Start y Media Session ID.
    9. Seleccione Confirmar > Guardar para guardar los cambios.

  8. (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.
    1. 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).

    2. Agregue un grupo de campos personalizados al esquema de medios definido.

      add-custom-metadata

    3. Agregue al grupo de campos los campos personalizados que desee rastrear.

      add-custom-metadata

    4. Use la ruta generada para el campo personalizado en la carga de la solicitud.

      add-custom-metadata

Creación de un conjunto de datos en Adobe Experience Platform

  1. 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

  1. 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.

      Crear secuencia de datos y seleccionar esquema

    • 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)

      Agregar el servicio Adobe Analytics

    • Expanda Opciones avanzadas y, a continuación, habilite la opción Media Analytics.

      Opción de 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.

Código base
En código
Uso de etiquetas
Web
SDK web ​
Extensión de etiqueta Web SDK
iOS
iOS
iOS (etiquetas)
Android
Android
Android (etiquetas)
Roku
Roku Edge
API
API de Media Edge

Siguiente paso

Una vez que empiece a recopilar datos, puede configurar la creación de informes:

recommendation-more-help
media-analytics-help