AWS mediatailor documentation change

Service: mediatailor · 2026-03-22 · Documentation low

File: mediatailor/latest/ug/ad-reporting-client-side.md

Summary

Added detailed documentation about client-side tracking for server-guided ad insertion (SGAI), including response structure and clarification that TRACKING section is only included when aws.reportingMode=CLIENT is set

Security assessment

This change provides technical documentation about ad tracking implementation details and response formats. There is no evidence of security vulnerabilities being addressed or security features being documented. The changes are purely functional documentation updates.

Diff

diff --git a/mediatailor/latest/ug/ad-reporting-client-side.md b/mediatailor/latest/ug/ad-reporting-client-side.md
index 83e531707..a70f003fc 100644
--- a//mediatailor/latest/ug/ad-reporting-client-side.md
+++ b//mediatailor/latest/ug/ad-reporting-client-side.md
@@ -227 +227,14 @@ Following a successful session initialization, and after MediaTailor receives th
-Server-guided ad insertion (SGAI) sessions do not use the `GetTracking` API. Instead, tracking information is provided in the `TRACKING` section of each asset list response when players request ad content.
+Server-guided ad insertion (SGAI) sessions do not use the `GetTracking` API. Instead, when you use `aws.reportingMode=CLIENT`, MediaTailor provides tracking information in the `TRACKING` section of each asset list response when players request ad content. The session initialization response does not include a `trackingUrl`.
+
+The asset list response for client-side tracked SGAI sessions has the following structure:
+    
+    
+    {
+      "ASSETS": [
+        { "DURATION": 20.0, "URI": "https://cdn.example.com/ad1/master.m3u8" },
+        { "DURATION": 10.0, "URI": "https://cdn.example.com/ad2/master.m3u8" }
+      ],
+      "TRACKING": {
+        ...VAST tracking events and beacon URLs for each ad...
+      }
+    }
@@ -241,0 +255,4 @@ When implementing client-side tracking for SGAI methods:
+###### Important
+
+The `TRACKING` section is only included in the asset list when `aws.reportingMode=CLIENT` is set. When server-side reporting is used (the default for SGAI), MediaTailor omits the `TRACKING` section and embeds beacon data in the ad URIs instead. For details, see [Server-side tracking with server-guided ad insertion (SGAI)](./ad-reporting-server-side-sgai.html).
+