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

Usa le seguenti MediaTailor key/value coppie per consentire al giocatore di riconciliare accuratamente le attività pubblicitarie, 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:
  + Live/dynamic manifesti - I `startTime` valori sono relativi al manifesto DASH. `MPD@availabilityStartTime` `MPD@avaibilityStartTime`È un punto di riferimento temporale per tutte le MediaTailor sessioni che consumano lo streaming.
  + VOD/static manifest - 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`