Tempistica delle attività di tracciamento degli annunci

Con la reportistica lato client, il giocatore deve emettere eventi di tracciamento (beacon) con un livello di precisione. Utilizzando lo schema di tracciamento MediaTailor lato client, puoi assicurarti che, per ogni pagina, annuncio, complemento, overlay ed eventi di tracciamento, siano presenti informazioni su tempistica e durata e in forme diverse.

Utilizza le seguenti coppie MediaTailor chiave/valore per consentire al giocatore di riconciliare accuratamente le attività pubblicitari-eventi, come il monitoraggio degli eventi, con la posizione di riproduzione:

• startTime

• startTimeInSeconds

• adProgramDateTime

• adID/eventId

HLS e DASH implementano il valore di e in modo diverso: startTime startTimeInSeconds

• HLS - I startTime valori sono relativi all'inizio della sessione di riproduzione. L'inizio della sessione di riproduzione è definito come tempo zero. L'annuncio startTime è la somma dei valori cumulativi di tutte le durate dei EXT-INF segmenti che hanno portato alla disponibilità. Il numero di sequenza multimediale del segmento su cui rientra l'annuncio o l'evento di tracciamento corrisponde anche alla adId o eventId presente nella risposta di tracciamento lato client.

• DASH:

  • Manifesti live/dinamici: startTime i valori sono relativi al manifesto DASH. MPD@availabilityStartTime MPD@avaibilityStartTimeÈ un punto di riferimento temporale per tutte MediaTailor le sessioni che consumano lo streaming.

  • Manifesti VOD/statici: i startTime valori sono relativi all'inizio della sessione di riproduzione. L'inizio della sessione di riproduzione è definito come tempo zero. Ogni annuncio all'interno di Avail è contenuto all'interno del proprio elemento. Period L'Periodelemento ha un @start attributo con un valore uguale ai startTime valori del payload di tracciamento lato client. Corrisponde PeriodId anche alla adId o eventId nella risposta di tracciamento lato client.

Esempio HLS:

Nell'esempio seguente, la MediaTailor sessione è iniziata e il manifesto seguente è il primo inviato al client:

#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

Nel payload JSON di tracciamento lato client, si applicano i seguenti valori:

• startTime: "PT18.581355S"

• startTimeInSeconds: 18.581

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

• adId: 4603269

Esempio DASH:

Nell'esempio seguente, la MediaTailor sessione ottiene un midroll nel manifest. Tieni presente che il valore dell'@startattributo del secondo periodo, che è il periodo dell'annuncio, ha un valore relativo al MPD@availabilityStartTime valore. Questo valore è quello che viene MediaTailor scritto nei startTime campi di risposta al tracciamento sul lato client, per tutte le sessioni.

<?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>

Nel payload JSON di tracciamento lato client, si applicano i seguenti valori:

• startTime: "PT5042H27M59.931S"

• startTimeInSeconds: 18152879.931

• availProgramDateTime: null

• adId: 1683151599194_1_1