View a markdown version of this page

Client-side integraciones de seguimiento de anuncios - AWS Elemental MediaTailor
Abra el SDK de mediciónSDKs de reproductor gratuitos de DatazoomRAFTheoPlayerMediaTailor SDK

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Client-side integraciones de seguimiento de anuncios

En esta sección se describen las integraciones entre varios servidores de seguimiento de anuncios del lado del cliente MediaTailor y entre ellos.

Open Measurement SDK

El Open Measurement SDK (OM SDK) de Interactive Advertising Bureau (IAB) facilita la medición por parte de terceros de la visibilidad y la verificación de los anuncios que se publican en entornos de aplicaciones nativas y vídeos web.

En el caso de los documentos antiguos de la versión 3 de VAST, el código de verificación debe cargarse con el nodo de extensión, con el tipo de extensión. AdVerifications La raíz del nodo de extensión es un AdVerifications nodo con el mismo esquema que el elemento VAST 4.1.

Para facilitar la adopción del SDK de OM, se MediaTailor ha asociado con Datazoom para ofrecer SDK de reproductor gratuitos configurados y verificados para Open Measurement. Para obtener más información, consulte SDKs de reproductor gratuitos de Datazoom.

nota

MediaTailor actualmente solo es compatible con la versión 3 de VAST.

ejemplo: Nodo de verificación en VAST 3, anterior a la versión 4.1
...
<Extensions>
    <Extension type="AdVerifications">
        <AdVerifications>
            <Verification vendor="company.com-omid">
                <JavaScriptResource apiFramework="omid" browserOptional="true">
                    <![CDATA[https://verification.com/omid_verification.js]]>
                </JavaScriptResource>
                <TrackingEvents>
                    <Tracking event="verificationNotExecuted">
                        <![CDATA[https://verification.com/trackingurl]]>
                    </Tracking>
                </TrackingEvents>
                <VerificationParameters>
                    <![CDATA[verification params key/value pairs]]>
                </VerificationParameters>
            </Verification>
        </AdVerifications>
    </Extension>
</Extensions>

MediaTailor extrae los AdVerifications datos del <Extensions> nodo y los coloca en la adVerifications matriz en la respuesta de seguimiento del lado del cliente.

ejemplo: matriz de verificaciones en la respuesta de seguimiento del lado del cliente
{
  "avails": [
    {
      "adBreakTrackingEvents": [],
      "adMarkerDuration": null,
      "ads": [
        {
          "adId": "3062770",
          "adParameters": "",
          "adProgramDateTime": "2023-08-23T16:25:40.914Z",
          "adSystem": "2.0",
          "adTitle": "AD-polarbear-15",
          "adVerifications": [
            {
              "executableResource": [],
              "javaScriptResource": [
                {
                  "apiFramework": "omid",
                  "browserOptional": "true",
                  "uri": "https://verification.com/omid_verification.js"
                }
              ],
              "trackingEvents": [
                {
                  "event": "verificationNotExecuted",
                  "uri": "https://verification.com/trackingurl"
                }
              ],
              "vendor": "company.com-omid",
              "verificationParameters": "verification params key value pairs"
            }
          ],
          "companionAds": [],
          "creativeId": "00006",
          "creativeSequence": "1",
          "duration": "PT14.982S",
          "durationInSeconds": 14.982,
          "extensions": [
            {
              "content": "<AdVerifications>\n\t\t\t\t\t\t<Verification vendor=\"company.com-omid\">\n\t\t\t\t\t\t\t<JavaScriptResource apiFramework=\"omid\" browserOptional=\"true\"><![CDATA[https://verification.com/omid_verification.js;]]></JavaScriptResource>\n\t\t\t\t\t\t\t<TrackingEvents>\n\t\t\t\t\t\t\t\t<Tracking event=\"verificationNotExecuted\"><![CDATA[;https://verification.com/trackingurl;]]></Tracking>\n\t\t\t\t\t\t\t</TrackingEvents>\n\t\t\t\t\t\t\t<VerificationParameters><![CDATA[verification params key/value pairs;]]></VerificationParameters>\n\t\t\t\t\t\t</Verification>\n\t\t\t\t\t</AdVerifications>",
              "type": "AdVerifications"
            }
          ],
          "mediaFiles": {
            "mediaFilesList": [],
            "mezzanine": ""
          },
          "skipOffset": null,
          "startTime": "PT10.11S",
          "startTimeInSeconds": 10.11,
          "trackingEvents": [
            {
              "beaconUrls": [
                "https://n8ljfs0h09.execute-api.us-west-2.amazonaws.com/v1/impression"
              ],
              "duration": "PT14.982S",
              "durationInSeconds": 14.982,
              "eventId": "3062770",
              "eventProgramDateTime": null,
              "eventType": "impression",
              "startTime": "PT10.11S",
              "startTimeInSeconds": 10.11
            }
          ],
          "vastAdId": ""
        }
      ],
      "availId": "3062770",
      "availProgramDateTime": "2023-08-23T16:25:40.914Z",
      "duration": "PT14.982S",
      "durationInSeconds": 14.982,
      "meta": null,
      "nonLinearAdsList": [],
      "startTime": "PT10.11S",
      "startTimeInSeconds": 10.11
    }
  ],
  "dashAvailabilityStartTime": null,
  "hlsAnchorMediaSequenceNumber": null,
  "nextToken": "UFQxMC4xMVNfMjAyMy0wOC0yM1QxNjoyNjoyNC4yNDYxMDIxOTBaXzE%3D",
  "nonLinearAvails": []
}
nota

Póngase en contacto con el laboratorio técnico de la IAB para garantizar que las aplicaciones se certifiquen anualmente a fin de garantizar su cumplimiento.

Para obtener más información sobre el SDK de OM, consulte Open Measurement SDK en el sitio web del IAB Tech Lab.

SDKs de reproductor gratuitos de Datazoom

Para facilitar la adopción de los SDK para jugadores, se MediaTailor ha asociado con Datazoom para ofrecer SDK gratuitos para jugadores que se configuran y prueban con IAB Tech y con IAB Tech. Client-side AWS Elemental MediaTailor integración con Google Ad Manager Open Measurement SDK

El SDK del reproductor Datazoom admite las siguientes funciones:

  • Listas de reproducción en vivo y VOD

  • Especificaciones de DASH y HLS

  • Soporte de proveedores de reproductores para Bitmovin, exoplayer, reproductor multimedia Android, Apple AVPlayer, Brightcove, Chromecast Receiver, hls.js, JWPlayer, Shaka Dash.js, THEO player, Roku y más Video.js

  • La certificación IAB Tech Lab Open Measurement, si está disponible en algunos dispositivos

  • Click-through gestión de eventos

  • Ad-event los despachadores, como los temporizadores de cuenta regresiva de anuncios, los eventos no lineales y de superposición de anuncios, el inicio de la pausa publicitaria, el final de la pausa publicitaria

  • Client-side balizas publicitarias

  • El SDK de la biblioteca de acceso programático (PAL) de Google, como opción de configuración opcional

Datazoom también ofrece un servicio de telemetría y análisis de pago compatible con los SDK del reproductor. Los clientes pueden optar por la telemetría del SDK del reproductor y controlarla desde la consola de administración de Datazoom. Para acceder a los SDK del reproductor de Datazoom y obtener más información sobre el servicio de telemetría y análisis de valor agregado, usa la información de contacto del sitio de Datazoom. https://www.datazoom.io/partner-aws

Roku Advertising Framework (RAF)

El Roku Ad Framework (RAF) mantiene una experiencia publicitaria uniforme en toda la plataforma Roku. Todos los canales, incluidos los anuncios de vídeo, deben cumplir los requisitos de certificación de Roku para la RAF. Cabe destacar que la aplicación siempre debe utilizar la función de lanzar eventos del lado del cliente a través de la RAF. MediaTailor, como proveedor de inserción de anuncios del lado del servidor (SSAI), admite la activación de eventos del lado del cliente. Los adaptadores SSAI de RAFX proporcionan interfaces tanto para los servidores de manifiestos de SSAI, o stitchers, como para la RAF. Estas interfaces incluyen:

  • Analizar la masterURL respuesta y extraerla playURLAdURL, así como los metadatos del anuncio.

  • Transformar MediaTailor los metadatos de los anuncios del SSAI en metadatos RAF-usable publicitarios y configurar el RAF para su reproducción.

  • Observar los eventos de transmisión y los metadatos cronometrados.

  • Hacer coincidir puntualmente los eventos de transmisión, los metadatos de los anuncios y los píxeles de los eventos de activación.

  • Pinging/polling luegoAdURL, según lo requiera el servidor de manifiestos de MediaTailor SSAI, analizar y volver a configurar la RAF.

Para obtener más información sobre los adaptadores SSAI para la RAF, consulta Cómo implementar la inserción de Server-Side anuncios mediante adaptadores Roku en el sitio web de Roku.

TheoPlayer

TheoPlayer la integración con MediaTailor hace lo siguiente:

  • Proporciona funciones que permiten el seguimiento de eventos MediaTailor del lado del cliente para HLS y DASH, tanto para flujos de trabajo en vivo como de VOD.

  • Solo admite el envío de balizas de seguimiento para anuncios lineales.

  • Inhabilita la búsqueda durante un anuncio. Sin embargo, no existe ninguna lógica para reproducir un anuncio cuando el usuario lo busca después de la pausa publicitaria.

Para obtener más información sobre SSAI y revisar los SDK para web, Android, iOS y tvOS MediaTailor, consulta MediaTailor el sitio web. TheoPlayer TheoPlayer

MediaTailor SDK

AWS Elemental mantiene un kit de JavaScript-based desarrollo de software (SDK). AWS Elemental proporciona el SDK tal cual, sin garantía implícita. Usa el SDK como demostración de referencia para agilizar la incorporación al uso. MediaTailor El SDK muestra cómo interactuar con la API de seguimiento del MediaTailor lado del cliente. El SDK implementa el seguimiento de los anuncios del lado del cliente y la generación de informes para los jugadores. HTML5-based El SDK inicializa una sesión de generación de informes del MediaTailor lado del cliente y, a continuación, solicita periódicamente información sobre el seguimiento de los anuncios. Durante la reproducción, el SDK emite eventos de seguimiento de anuncios cuando se detectan nuevos eventos publicitarios.

El MediaTailor SDK admite las siguientes funciones:

  • Listas de reproducción en directo y VOD

  • Especificaciones de DASH y HLS

  • Click-through gestión de eventos

  • Ad-event despachadores

  • Ganchos para eventos personalizados

  • Client-side y balizas. Para obtener más información sobre el envío de balizas publicitarias, consulte. Client-side balizamiento

nota

Envía un ticket de AWS soporte para recibir un JavaScript SDK de muestra para. MediaTailor Recibirás un enlace de descarga para el paquete y sus archivos.