DocumentaciónAnalyticsGuía de colección de medios de streaming

Implementar el complemento de recopilación de medios de streaming con el Edge Network

Last update: Wed Sep 25 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Temas:

Creado para:

  • Usuario
  • Administrador
  • Desarrollador

La red Edge de Adobe Experience Platform le permite enviar datos destinados a varios productos a una ubicación centralizada. Experience Edge reenvía la información adecuada a los productos deseados. Este concepto le permite consolidar los esfuerzos de implementación, especialmente abarcando varias soluciones de datos.

El siguiente gráfico ilustra cómo se puede implementar el complemento Recopilación de medios de streaming de Adobe para utilizar Experience Platform Edge a fin de que los datos estén disponibles en Analysis Workspace, ya sea en Adobe Analytics o en Customer Journey Analytics:

Flujo de trabajo de CJA

Para obtener una descripción general de todas las opciones de implementación, incluidos los métodos de implementación que no utilizan Experience Platform Edge, consulte Implementar el complemento de recopilación de medios de streaming.

Independientemente de si utiliza el SDK web de Adobe Experience Platform, el SDK móvil de Adobe Experience Platform, el SDK de Adobe Experience Platform Roku o la API para implementar el complemento de recopilación de medios de streaming con Experience Edge, primero debe completar las secciones siguientes:

Configuración del esquema en Adobe Experience Platform

Para estandarizar la recopilación de datos para su uso en todas las aplicaciones que aprovechan Adobe Experience Platform, Adobe ha creado el estándar abierto y documentado públicamente, Experience Data Model (XDM).

Para crear y configurar un esquema:

  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 al crear el esquema, elija Evento de experiencia al elegir la 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 nuevos al esquema:

    • Adobe Analytics ExperienceEvent Template
    • Implementation Details
    • MediaAnalytics Interaction Details

    Después de agregar los grupos de campos, deben mostrarse en la sección Grupos de campos de la siguiente manera:

    Se agregaron grupos de campos

  6. Seleccione Guardar para guardar los cambios.

  7. (Opcional) Puede ocultar determinados campos que no utiliza la API de Media Edge. Al ocultar estos campos, el esquema es más fácil de leer y comprender, pero no es obligatorio. Estos campos solo hacen referencia a los del grupo de campos MediaAnalytics Interaction Details.

Amplíe aquí 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, 25}, Unique Time Played y Video Segment.Total Pause Duration

  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, 25}, Total Pause Duration, Unique Time Played y Video Segment.Pev3

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

  1. (Opcional) Puede agregar metadatos personalizados al esquema. Esto le permite incluir metadatos adicionales definidos por el usuario que se pueden personalizar para necesidades o contextos específicos. Esta flexibilidad es útil en situaciones en las que los esquemas existentes no cubren los puntos de datos deseados. (También puede trabajar con metadatos personalizados con las API de Media Edge. Para obtener más información, consulte Crear metadatos personalizados con las API de Media Edge.)
Amplíe aquí para ver instrucciones sobre cómo agregar metadatos personalizados al esquema.

  1. Busque el nombre del inquilino de la organización seleccionando Información de la cuenta > Organizaciones asignadas > nombre de la organización > inquilino.

    Estos campos personalizados se recibirán 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

  1. Continúe con Crear un conjunto de datos en Adobe Experience Platform.

Crear un conjunto de datos en Adobe Experience Platform

  1. Asegúrese de configurar un esquema como se describe en Configurar el esquema en Adobe Experience Platform.

  2. En Adobe Experience Platform, empiece a crear el conjunto de datos como se describe en Guía de la interfaz de usuario de conjuntos de datos.

    Al seleccionar un esquema para su conjunto de datos, elija el esquema que creó anteriormente, tal como se describe en Configurar el esquema en Adobe Experience Platform.

  3. Continúe con Configuración de una secuencia de datos en el Customer Journey Analytics.

Configuración de una secuencia de datos en Adobe Experience Platform

  1. Asegúrese de crear un conjunto de datos como se describe en Crear un conjunto de datos en Adobe Experience Platform.

  2. Cree una nueva secuencia de datos como se describe en Configurar una secuencia de datos.

    Al crear la secuencia de datos, asegúrese de realizar las siguientes selecciones de configuración:

    • En el campo Esquema de evento al crear la secuencia de datos, asegúrese de seleccionar el esquema que creó en Configurar el esquema en Adobe Experience Platform. Seleccione Guardar.

      note important
      IMPORTANT
      No seleccione Guardar y agregar asignación porque si lo hace se producirán errores de asignación para el campo Marca de tiempo.

      Crear secuencia de datos y seleccionar esquema

    • Agregue cualquiera de los siguientes servicios al conjunto de datos, en función de si utiliza Adobe Analytics o Customer Journey Analytics:

      • Adobe Analytics (si usa Adobe Analytics)

        Si usa Adobe Analytics, asegúrese de definir un grupo de informes, tal como se describe en Crear un grupo de informes.

      • Adobe Experience Platform (si usa el Customer Journey Analytics)

      Para obtener información acerca de cómo agregar un servicio a un conjunto de datos, vea la sección "Agregar servicios a un conjunto de datos" en Configurar un conjunto de datos.

      Agregar el servicio Adobe Analytics

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

      Opción de Media Analytics

  3. Ya está listo para implementar la API de Media Edge o el SDK de Media Edge para empezar a recopilar datos de análisis de medios.

    Después de recopilar algunos datos, puede Crear una conexión en el Customer Journey Analytics.

Crear una conexión en Customer Journey Analytics

NOTE
El siguiente procedimiento solo es necesario si utiliza Customer Journey Analytics.

  1. Asegúrese de crear una secuencia de datos como se describe en Configuración de una secuencia de datos en el Customer Journey Analytics.

  2. En Customer Journey Analytics, cree una conexión como se describe en Crear una conexión.

    Al crear la conexión, se requieren las siguientes selecciones de configuración para implementar el complemento de recopilación de medios de streaming:

    1. Seleccione el conjunto de datos que creó anteriormente, tal como se describe en Crear un conjunto de datos en Adobe Experience Platform.

    2. Asegúrese de que la opción Importar todos los datos nuevos esté habilitada.

  3. Continúe con Crear una vista de datos en el Customer Journey Analytics.

Creación de una vista de datos en Customer Journey Analytics

NOTE
El siguiente procedimiento solo es necesario si utiliza Customer Journey Analytics.

  1. Asegúrese de crear una conexión en el Customer Journey Analytics como se describe en Crear una conexión en el Customer Journey Analytics.

  2. En Customer Recorrido Analytics, cree una vista de datos como se describe en Crear o editar una vista de datos.

    Al crear la vista de datos, se requieren las siguientes selecciones de configuración para implementar el complemento de recopilación de medios de streaming:

    1. En el campo Conexión, seleccione la conexión que creó anteriormente, tal como se describe en Crear una conexión en el Customer Journey Analytics.

      La conexión que ha creado puede tardar hasta 15 minutos en estar disponible para su selección.

    2. En la ficha Componentes, en la sección Campos de esquema, busque cada componente enumerado en las tablas siguientes y arrástrelo al panel Métricas. Si existen varios campos con el mismo nombre, utilice la ruta XDM para asegurarse de que sea el campo correcto.

      Contenido principal - Métricas de contenido

      table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2
      Nombre del componente Ruta de XDM
      Inicios de contenidos mediaReporting.sessionDetails.isViewed
      Vistas de segmentos de medios mediaReporting.sessionDetails.hasSegmentView
      Inicio de contenido mediaReporting.sessionDetails.isPlayed
      Finalización de contenido mediaReporting.sessionDetails.isCompleted
      Tiempo invertido en contenido mediaReporting.sessionDetails.timePlayed
      Tiempo invertido en contenido mediaReporting.sessionDetails.totalTimePlayed
      Tiempo de reproducción única mediaReporting.sessionDetails.uniqueTimePlayed
      Marcador de progreso del 10% mediaReporting.sessionDetails.hasProgress10
      Promedio de audiencia por minuto mediaReporting.sessionDetails.averageMinuteAudience

      Capítulo y anuncios - Métricas de capítulo y anuncios

      table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
      Nombre del componente Ruta de XDM
      Capítulo iniciado mediaReporting.chapterDetails.isStarted
      Capítulo completado mediaReporting.chapterDetails.isCompleted
      Tiempo de reproducción del capítulo mediaReporting.chapterDetails.timePlayed
      Anuncio iniciado mediaReporting.advertisingDetails.isStarted
      Anuncio completado mediaReporting.advertisingDetails.isCompleted
      Tiempo de reproducción del anuncio mediaReporting.advertisingDetails.timePlayed

      QoE - métricas de QoE

      table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2
      Nombre del componente Ruta de XDM
      Tiempo para el inicio mediaReporting.qoeDataDetails.timeToStart
      Pérdidas antes del inicio mediaReporting.qoeDataDetails.isDroppedBeforeStart
      Flujos afectados por el búfer mediaReporting.qoeDataDetails.hasBufferImpactedStreams
      Flujos afectados por el cambio en la velocidad de bits mediaReporting.qoeDataDetails.hasBitrateChangeImpactedStreams
      Cambios en la velocidad de bits mediaReporting.qoeDataDetails.bitrateChangeCount
      Velocidad de bits media mediaReporting.qoeDataDetails.bitrateAverage
      Fotogramas perdidos mediaReporting.qoeDataDetails.droppedFrames
      Errores mediaReporting.qoeDataDetails.errorCount
      Flujos afectados por el error mediaReporting.qoeDataDetails.hasErrorImpactedStreams
      Flujos afectados por la pérdida de cuadros mediaReporting.qoeDataDetails.hasDroppedFrameImpactedStreams

      Estado del reproductor - Métricas de estado del reproductor

      table 0-row-2 1-row-2 2-row-2 3-row-2
      Nombre del componente Ruta de XDM
      Conjunto de estado del reproductor mediaReporting.states.isSet
      Recuento de estados del reproductor mediaReporting.states.count
      Hora de estado del reproductor mediaReporting.states.time

    3. Actualice las etiquetas (en el menú desplegable Context labels) de los componentes de la siguiente tabla. Busque y arrastre cualquier componente que no esté ya en el panel de métricas al panel.

      table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2
      Nombre del componente Etiqueta de contexto
      Tiempo de espera del servidor de sesión multimedia Medios: Segundos desde la última llamada
      Tiempo invertido en contenido Medios: tiempo invertido en contenido
      Duración total del búfer Medios: Duración total del búfer
      Tiempo para el inicio Medios: tiempo para el inicio
      Duración de la pausa Medios: Duración total de la pausa

    4. Para agregar desgloses al proyecto de Customer Journey Analytics, agregue las siguientes dimensiones al panel Dimension:

      table 0-row-2 1-row-2 2-row-2
      Ruta de XDM Nombre del componente
      mediaReporting.states.name Nombre del estado del reproductor
      mediaReporting.sessionDetails.ID ID de sesión de contenidos

      Además de las dimensiones de esta tabla, puede agregar cualquier otra dimensión que desee que esté disponible para filtrar datos en proyectos de Customer Journey Analytics.

  3. Seleccione Guardar y continuar > Guardar y finalizar para guardar los cambios.

  4. Continúe con Crear y configurar un proyecto en Customer Journey Analytics.

Creación y configuración de un proyecto en Customer Journey Analytics

  1. Asegúrese de haber creado una vista de datos en el Customer Journey Analytics como se describe en Crear una vista de datos en el Customer Journey Analytics.

  2. En Customer Journey Analytics, en la ficha Workspace, en el área de Proyectos, seleccione Crear proyecto.

  3. Seleccione Proyecto en blanco > Crear.

  4. En el nuevo proyecto, seleccione la vista de datos que creó anteriormente.

    Al crear paneles en el proyecto, puede utilizar cualquier componente que haya agregado a la vista de datos, tal como se describe en Crear una vista de datos en el Customer Journey Analytics.

    Los siguientes 4 paneles son ejemplos de paneles que puede crear:

    Panel de contenido principal

    Capítulo y panel de anuncios

    Panel QoE

    Panel de estado de Plater

  5. Seleccione el icono Paneles en el carril izquierdo y, a continuación, arrastre el panel Visualizadores simultáneos de medios y el panel Tiempo invertido en la reproducción de medios.

    Los dos paneles deben tener un aspecto similar al siguiente:

    Panel de visualizadores simultáneos de medios

    Panel de tiempo invertido en la reproducción de medios

  6. (Condicional) Si agregó metadatos personalizados al esquema, tal como se describe en el paso 8 de Configurar el esquema en Adobe Experience Platform, deberá establecer la persistencia para los campos personalizados, tal como se describe en Configuración del componente de persistencia en la guía del Customer Journey Analytics.

    Cuando los datos lleguen a Customer Journey Analytics, estará disponible la dimensión de ID de usuario personalizado.

    setup-custom-metadata

    note note
    NOTE
    Si configura Adobe Analytics como flujo ascendente para el conjunto de datos, los metadatos personalizados también están presentes en ContextData, con el nombre que establezca en el esquema (sin el prefijo de inquilino, por ejemplo myCustomField). Esto permite usar todas las características de Adobe Analytics disponibles para ContextData, como crear una regla de procesamiento.

  7. Comparta el proyecto como se describe en Compartir proyectos.

    note note
    NOTE
    Si los usuarios con los que desea compartir no están disponibles, asegúrese de que los usuarios tengan acceso de usuario y administrador a Customer Journey Analytics en Adobe Admin Console.

  8. Continuar con Enviar datos al Experience Platform Edge.

Envío de datos al Experience Platform Edge

Según el tipo de datos que desee enviar a Experience Platform Edge, puede utilizar cualquiera de los siguientes métodos:

Web: Uso del SDK web de Adobe Experience Platform

Móvil: usar el SDK de Adobe Experience Platform Mobile

Utilice los siguientes recursos de documentación para completar la implementación tanto para iOS como para Android:

Roku: SDK de Adobe Experience Platform Roku

API: web y otros

Actualmente, la API es la única forma admitida de enviar datos web al Experience Platform Edge.

La API también está disponible si desea utilizar una implementación personalizada de las API de Edge.

Para obtener más información sobre la API de Media Edge, consulte los siguientes recursos:

recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb