

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à.

# Tempistica delle attività di tracciamento degli annunci
<a name="ad-reporting-client-side-ad-tracking-schema-activity-timing"></a>

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](ad-reporting-client-side-ad-tracking-schema.md#property-starttime) 
+  [startTimeInSeconds](ad-reporting-client-side-ad-tracking-schema.md#property-starttimeinseconds) 
+  [adProgramDateTime](ad-reporting-client-side-ad-tracking-schema.md#property-adprogramdatetime) 
+  [adID](ad-reporting-client-side-ad-tracking-schema.md#property-adid)/[eventId](ad-reporting-client-side-ad-tracking-schema.md#property-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'`Period`elemento 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.

**Example 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` 

**Example DASH:**  
Nell'esempio seguente, la MediaTailor sessione ottiene un midroll nel manifest. Tieni presente che il valore dell'`@start`attributo 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` 