View a markdown version of this page

Ad-tracking tempistica delle attività - AWS Elemental MediaTailor

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Ad-tracking tempistica delle attività

Con i report sul lato client, il giocatore deve emettere eventi di tracciamento (beacon) con un livello di precisione. Utilizzando lo schema di tracciamento MediaTailor lato client, potete assicurarvi che, per ogni utilizzo, annuncio, integrazione, sovrapposizione e tracciamento degli eventi, dei tempi e della durata siano presenti e in diverse forme.

Usa le seguenti MediaTailor key/value coppie per consentire al giocatore di riconciliare con precisione le attività relative agli eventi pubblicitari, come il monitoraggio degli eventi, con la posizione di riproduzione:

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 precedenti all'utilizzo. Il numero di sequenza multimediale del segmento in cui si trova l'annuncio o l'evento di tracciamento corrisponde anche all'o nella risposta di tracciamento sul lato adId client. eventId

  • DASH:

    • Live/dynamic manifesti: i startTime valori sono relativi al manifesto DASH. MPD@availabilityStartTime MPD@avaibilityStartTimeÈ un ancoraggio temporale per tutte le MediaTailor sessioni che consumano lo streaming.

    • VOD/static manifests - 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 dell'avail è contenuto all'interno di Period un proprio elemento. L'Periodelemento ha un @start attributo con un valore uguale ai startTime valori del payload di tracciamento lato client. Corrisponde PeriodId anche al valore adId o eventId nella risposta di tracciamento sul lato client.

Esempio HLS:

Nell'esempio seguente, la MediaTailor sessione è iniziata e il seguente manifesto è 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. Nota 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