View a markdown version of this page

Client-side integraciones de seguimiento de anuncios - AWS Elemental MediaTailor
Abra el SDK de mediciónSDK 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 MediaTailor cliente.

Abra el SDK de medición

El SDK Open Measurement (OM SDK) de la Oficina de Publicidad Interactiva (IAB) facilita la medición de la visibilidad y la verificación por parte de terceros de los anuncios publicados en entornos de vídeo web y aplicaciones nativas.

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 OM, se MediaTailor ha asociado con Datazoom para ofrecer SDK de jugadores gratuitos que se configuran y verifican para Open Measurement. Para obtener más información, consulte SDK 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 AdVerifications 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 tecnológico del IAB para garantizar que las solicitudes se certifiquen anualmente para garantizar su conformidad.

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

SDK de reproductor gratuitos de Datazoom

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

El SDK para reproductores de Datazoom es compatible con las siguientes funciones:

  • Listas de reproducción en directo y VOD

  • Especificaciones de DASH y HLS

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

  • La certificación de medición abierta del IAB Tech Lab, si está disponible en dispositivos seleccionados

  • Click-through gestión de eventos

  • Ad-event despachadores, como temporizadores de cuenta regresiva de anuncios, eventos superpuestos y no lineales, inicio y finalización de anuncios

  • Client-side y balizamiento

  • El SDK de la biblioteca de acceso programático (PAL) de Google, como ajuste 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 activar y controlar la telemetría del SDK del reproductor 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 añadido, utilice la información de contacto del sitio de Datazoom.

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. En particular, la aplicación siempre debe utilizar la transmisión de eventos del lado del cliente a través de la RAF. MediaTailor, como proveedor de inserción de anuncios en el servidor (SSAI), admite la activación de eventos en el lado del cliente. Los adaptadores SSAI de RAFX proporcionan interfaces tanto para los servidores de manifiestos de SSAI, o Stitchers, como para RAF. Estas interfaces incluyen:

  • Analizar la masterURL respuesta y extraer playURL y AdURL añadir metadatos.

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

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

  • Hacer coincidir los eventos de la transmisión, los metadatos de los anuncios y los píxeles del evento de disparo a tiempo.

  • Pinging/polling luegoAdURL, según lo requiera el servidor de manifiestos del MediaTailor SSAI, luego analizará y reconfigurará la RAF.

Para obtener más información sobre los adaptadores SSAI para RAF, consulte Implementación de la inserción de Server-Side anuncios con adaptadores Roku en el sitio web de Roku.

TheoPlayer

TheoPlayer la integración con MediaTailor hace lo siguiente:

  • Proporciona una funcionalidad que permite el seguimiento de eventos por MediaTailor parte del cliente para HLS y DASH, tanto para flujos de trabajo a la carta como en directo.

  • Admite el envío de balizas de seguimiento solo para anuncios lineales.

  • Desactiva la búsqueda durante un anuncio. Sin embargo, no existe ninguna lógica para reproducir un anuncio cuando el usuario busca más allá de la pausa publicitaria.

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

MediaTailor SDK

AWS Elemental mantiene un kit JavaScript-based de 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 simplificar tu proceso de iniciación y uso. MediaTailor El SDK muestra cómo interactuar con la API de seguimiento del MediaTailor lado del cliente. El SDK implementa el seguimiento de anuncios y la elaboración de informes por parte del cliente para los jugadores. HTML5-based El SDK inicia una sesión de informes por MediaTailor parte 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 estas funciones:

  • Listas de reproducción en directo y VOD

  • Especificaciones de DASH y HLS

  • Click-through manejo de eventos

  • Ad-event despachadores

  • Ganchos para eventos personalizados

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

nota

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