Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Ad-tracking waktu aktivitas
<a name="ad-reporting-client-side-ad-tracking-schema-activity-timing"></a>

Dengan pelaporan sisi klien, pemain harus memancarkan peristiwa pelacakan (beacon) dengan tingkat presisi. Dengan menggunakan skema pelacakan MediaTailor sisi klien, Anda dapat memastikan bahwa, untuk setiap keuntungan, iklan, pendamping, hamparan, dan peristiwa pelacakan, informasi waktu dan durasi hadir, dan dalam berbagai bentuk.

Gunakan MediaTailor key/value pasangan berikut agar pemain dapat secara akurat merekonsiliasi aktivitas acara iklan, seperti melacak peristiwa, dengan posisi pemutaran:
+ [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 dan DASH menerapkan nilai `startTime` dan `startTimeInSeconds` berbeda:
+ HLS - `startTime` Nilainya relatif terhadap awal sesi pemutaran. Awal sesi pemutaran didefinisikan sebagai waktu nol. Iklan `startTime` adalah jumlah nilai kumulatif dari semua durasi `EXT-INF` segmen yang mengarah ke pemanfaatan. Nomor urutan media segmen tempat iklan atau peristiwa pelacakan jatuh juga sesuai dengan `adId` atau `eventId` dalam respons pelacakan sisi klien.
+ TANDA HUBUNG:
  + Live/dynamic manifes - `startTime` Nilai-nilai relatif `MPD@availabilityStartTime` terhadap manifes DASH. `MPD@avaibilityStartTime`Ini adalah jangkar waktu untuk semua MediaTailor sesi yang menggunakan aliran.
  + VOD/static manifes - `startTime` Nilai-nilai relatif terhadap awal sesi pemutaran. Awal sesi pemutaran didefinisikan sebagai waktu nol. Setiap iklan di dalam avail terkandung di dalam `Period` elemennya sendiri. `Period`Elemen memiliki `@start` atribut dengan nilai yang sama dengan `startTime` nilai di payload pelacakan sisi klien. `PeriodId`Juga sesuai dengan `adId` atau `eventId` dalam respons pelacakan sisi klien.

**Example : HLS**  
Dalam contoh berikut, MediaTailor sesi dimulai, dan manifes berikut adalah yang pertama disajikan kepada klien:  

```
#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
```
Pada payload JSON pelacakan sisi klien, nilai berikut berlaku:  
+  `startTime`: `"PT18.581355S"` 
+  `startTimeInSeconds`: `18.581` 
+  `availProgramDateTime`: `"2023-05-03T21:24:41.453Z"` 
+  `adId`: `4603269` 

**Example : DASBOR**  
Dalam contoh berikut, MediaTailor sesi mendapat midroll dalam manifes. Perhatikan bahwa nilai `@start` atribut periode kedua, yang merupakan periode iklan, memiliki nilai yang relatif terhadap `MPD@availabilityStartTime` nilai. Nilai ini adalah nilai yang MediaTailor menulis ke `startTime` bidang respons pelacakan sisi klien, untuk semua sesi.  

```
<?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>
```
Pada payload JSON pelacakan sisi klien, nilai berikut berlaku:  
+  `startTime`: `"PT5042H27M59.931S"` 
+  `startTimeInSeconds`: `18152879.931` 
+  `availProgramDateTime`: {{null}} 
+  `adId`: `1683151599194_1_1`