View a markdown version of this page

Ad-tracking cronología de la actividad - AWS Elemental MediaTailor

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.

Ad-tracking cronología de la actividad

Con los informes del lado del cliente, el jugador debe emitir eventos de seguimiento (balizas) con un nivel de precisión. Al utilizar el esquema de seguimiento MediaTailor del lado del cliente, puedes asegurarte de que, en todos los casos, esté presente información sobre anuncios, eventos complementarios, superpuestos y de seguimiento, así como información sobre el tiempo y la duración, y en diferentes formatos.

Usa los siguientes MediaTailor key/value pares para que el reproductor pueda conciliar con precisión las actividades de los eventos publicitarios, como el seguimiento de los eventos, con la posición de reproducción:

HLS y DASH implementan el valor de y de startTime manera diferente: startTimeInSeconds

  • HLS: los startTime valores son relativos al inicio de la sesión de reproducción. El inicio de la sesión de reproducción se define como tiempo cero. El anuncio startTime es la suma de los valores acumulados de todas las duraciones de los EXT-INF segmentos anteriores a su publicación. El número de secuencia multimedia del segmento en el que se encuentra el anuncio o el evento de seguimiento también corresponde a la respuesta de seguimiento del cliente adId o de la respuesta eventId de seguimiento.

  • DASH:

    • Live/dynamic manifiestos: los startTime valores son relativos a los del manifiesto MPD@availabilityStartTime de DASH. MPD@avaibilityStartTimeEs un ancla de temporización para todas MediaTailor las sesiones que consumen la transmisión.

    • VOD/static manifiestos: los startTime valores son relativos al inicio de la sesión de reproducción. El inicio de la sesión de reproducción se define como tiempo cero. Cada anuncio incluido en Avail está contenido dentro de su propio Period elemento. El Period elemento tiene un @start atributo con un valor que es igual a los startTime valores de la carga útil de seguimiento del lado del cliente. PeriodIdTambién corresponde a la adId o eventId en la respuesta de seguimiento del lado del cliente.

ejemplo HLS:

En el siguiente ejemplo, se inició la MediaTailor sesión y el siguiente manifiesto es el primero que se envía al cliente:

#EXTM3U
#EXT-X-VERSION:6
#EXT-X-TARGETDURATION:6
#EXT-X-MEDIA-SEQUENCE:4603263
#EXT-X-DISCONTINUITY-SEQUENCE:0
#EXT-X-PROGRAM-DATE-TIME:2023-05-03T21:24:23.295678Z
#EXTINF:4.010667,
https://123.cloudfront.net/out/v1/index_1_34.ts
#EXT-X-PROGRAM-DATE-TIME:2023-05-03T21:24:27.306345Z
#EXTINF:4.010667,
https://123.cloudfront.net/out/v1/index_1_35.ts
#EXT-X-PROGRAM-DATE-TIME:2023-05-03T21:24:31.317012Z
#EXTINF:4.010667,
https://123.cloudfront.net/out/v1/index_1_36.ts
#EXT-X-PROGRAM-DATE-TIME:2023-05-03T21:24:35.327679Z
#EXTINF:4.010667,
https://123.cloudfront.net/out/v1/index_1_37.ts
#EXT-X-PROGRAM-DATE-TIME:2023-05-03T21:24:39.338346Z
#EXTINF:2.538667,
https://123.cloudfront.net/out/v1/index_1_38.ts
#EXT-X-DISCONTINUITY
#EXT-X-KEY:METHOD=NONE
#EXT-X-PROGRAM-DATE-TIME:2023-05-03T21:24:41.453Z
#EXTINF:2.0,
https://123.cloudfront.net/tm/asset_1080_4_8_00001.ts
#EXT-X-PROGRAM-DATE-TIME:2023-05-03T21:24:43.453Z
#EXTINF:2.0,
https://123.cloudfront.net/tm/asset_1080_4_8_00002.ts
#EXT-X-PROGRAM-DATE-TIME:2023-05-03T21:24:45.453Z
#EXTINF:2.0,
https://123.cloudfront.net/tm/asset_1080_4_8_00003.ts

En la carga útil JSON de seguimiento del lado del cliente, se aplican los siguientes valores:

  • startTime: "PT18.581355S"

  • startTimeInSeconds: 18.581

  • availProgramDateTime: "2023-05-03T21:24:41.453Z"

  • adId: 4603269

ejemplo DASH:

En el siguiente ejemplo, la MediaTailor sesión ocupa un lugar central en el manifiesto. Ten en cuenta que el valor del @start atributo del segundo período, que es el período publicitario, tiene un valor relativo al MPD@availabilityStartTime valor. Este valor es el que se incluye en MediaTailor los startTime campos de respuesta al seguimiento del lado del cliente, para todas las sesiones.

<?xml version="1.0" encoding="UTF-8"?>
<MPD availabilityStartTime="2022-10-05T19:38:39.263Z" minBufferTime="PT10S" minimumUpdatePeriod="PT2S" profiles="urn:mpeg:dash:profile:isoff-live:2011" publishTime="2023-05-03T22:06:48.411Z" suggestedPresentationDelay="PT10S" timeShiftBufferDepth="PT1M30S" type="dynamic" xmlns="urn:mpeg:dash:schema:mpd:2011" xmlns:scte35="urn:scte:scte35:2013:xml" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="urn:mpeg:dash:schema:mpd:2011 http://standards.iso.org/ittf/PubliclyAvailableStandards/MPEG-DASH_schema_files/DASH-MPD.xsd">
    <BaseURL>https://123.channel-assembly.mediatailor.us-west-2.amazonaws.com/v1/channel/my-channel/</BaseURL>
    <Location>https://123.cloudfront.net/v1/dash/94063eadf7d8c56e9e2edd84fdf897826a70d0df/MediaTailor-Live-HLS-DASH/channel/channel1/dash.mpd?aws.sessionId=794a15e0-2a7f-4941-a537-9d71627984e5</Location>
    <Period id="1683151479166_1" start="PT5042H25M59.903S" xmlns="urn:mpeg:dash:schema:mpd:2011">
        <BaseURL>https://123.cloudfront.net/out/v1/f1a946be8efa45b0931ea35c9055fb74/ddb73bf548a44551a0059c346226445a/eaa5485198bf497284559efb8172425e/</BaseURL>
        <AdaptationSet ...>
            ...
        </AdaptationSet>
    </Period>
    <Period id="1683151599194_1_1" start="PT5042H27M59.931S">
        <BaseURL>https://123.cloudfront.net/tm/94063eadf7d8c56e9e2edd84fdf897826a70d0df/fpc5omz5wzd2rdepgieibp23ybyqyrme/</BaseURL>
        <AdaptationSet ...>
            ...
        </AdaptationSet>
    </Period>
</MPD>

En la carga útil JSON de seguimiento del lado del cliente, se aplican los siguientes valores:

  • startTime: "PT5042H27M59.931S"

  • startTimeInSeconds: 18152879.931

  • availProgramDateTime: null

  • adId: 1683151599194_1_1