Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Server-side Tracking mit servergesteuerter Anzeigeneinfügung (SGAI)
<a name="ad-reporting-server-side-sgai"></a>

Wenn Sie die serverseitige Anzeigeneinfügung (SGAI) verwenden, verwendet das serverseitige Tracking einen Beaconing-Mechanismus ohne *Sitzung*, der sich von dem oben beschriebenen Ansatz im gestickten Modus unterscheidet. Anstatt Anzeigensegmente in das Inhaltsmanifest MediaTailor einzufügen (wo `/v1/segment` Anfragen nachverfolgt werden), gibt SGAI Anzeigenverweise als separate Playlisten in einer Asset-Listen-Antwort zurück, wobei Beacon-Metadaten in die Anzeigen-URIs eingebettet sind.

## So funktioniert serverseitiges Beaconing ohne Sitzung
<a name="ad-reporting-server-side-sgai-how-it-works"></a>

In den folgenden Schritten wird beschrieben, wie serverseitiges Beaconing für SGAI-Sitzungen funktioniert:

1. **Sitzungsinitialisierung**: Der Player fordert die multivariante HLS-Wiedergabeliste mit an. `aws.insertionMode=GUIDED` Server-side Berichterstattung ist die Standardeinstellung (kein `aws.reportingMode` Parameter erforderlich). Im Gegensatz zum Modus „Zusammenfügen“ enthält die Antwort auf die Sitzungsinitialisierung *kein*. `trackingUrl`

1. **Zwischenspeicherbares Manifest**: MediaTailor Gibt ein zwischenspeicherbares Manifest zurück, das `EXT-X-DATERANGE` Tags `CLASS="com.apple.hls.interstitial"` und `X-ASSET-LIST` Attribute enthält, die auf den Endpunkt der MediaTailor interstitiellen Asset-Liste verweisen.

1. **Asset-Liste mit Beacon-Metadaten: Wenn der Player auf** eine Werbeunterbrechung stößt, ruft er die Asset-Liste ab. MediaTailorgibt eine JSON-Antwort zurück, in der jede Anzeigen-URI verschlüsselte Beacon-Metadaten enthält:

   ```
   {
     "ASSETS": [
       {
         "DURATION": 30.0,
         "URI": "https://cdn.example.com/ad/master.m3u8?awsBeaconData=<encrypted>&awsBeaconDomain=<MediaTailor-endpoint>&awsConfigurationName=<config-name>"
       }
     ]
   }
   ```

   Wenn die serverseitige Berichterstattung aktiv ist, enthält die Antwort *keinen* `TRACKING` Abschnitt. Die Anzeigen-URIs enthalten alle Beacon-Daten.

1. **HLS-Variablenersetzung**: Der Player ruft die multivariante Anzeigen-Playlist ab. Das Anzeigenmanifest verwendet `#EXT-X-DEFINE:QUERYPARAM` Direktiven, um die Beacon-Parameter aus der URI-Abfragezeichenfolge per HLS-Variablenersetzung an Segment-URLs zu übergeben:

   ```
   #EXTM3U
   #EXT-X-DEFINE:QUERYPARAM="awsBeaconData"
   #EXT-X-DEFINE:QUERYPARAM="awsBeaconDomain"
   #EXT-X-DEFINE:QUERYPARAM="awsConfigurationName"
   #EXTINF:5.0,
   {$awsBeaconDomain}/segment/hash/{$awsConfigurationName}/{$awsBeaconData}/0/0?aws.segmentRelativePath=asset_00001.ts
   ```

   Der Player löst die `{$awsConfigurationName}` Variablen `{$awsBeaconData}``{$awsBeaconDomain}`, und anhand der Werte aus der URI-Abfragezeichenfolge für das Anzeigenmanifest auf und fordert dann jedes Anzeigensegment an. MediaTailor

1. **Auslösung eines Beacons bei Segmentanforderung**: Wenn der Player jedes Anzeigensegment anfordert, wird die Anfrage weitergeleitet. MediaTailor Der Dienst entschlüsselt die Beacon-Daten, bestimmt die Position des Segments innerhalb der Anzeige (Impression, erstes Quartil, Mittelpunkt, drittes Quartil oder vollständig) und sendet das entsprechende VAST-Tracking-Beacon an den Anzeigenserver. MediaTailor leitet den Player dann zum eigentlichen Anzeigeninhaltssegment weiter.

## Spieleranforderungen für serverseitiges SGAI-Beaconing
<a name="ad-reporting-server-side-sgai-requirements"></a>

Um serverseitiges Beaconing mit SGAI verwenden zu können, muss Ihr Player die folgenden Anforderungen erfüllen:
+ HLS Version 11 oder höher
+ Support für `EXT-X-DATERANGE` mit `CLASS` Attribut für HLS Interstitials
+ Support für `#EXT-X-DEFINE:QUERYPARAM` Variablensubstitution (RFC 8216bis). Der Spieler muss die Werte der Abfrageparameter prozentual dekodieren, bevor er sie durch Segment-URLs ersetzt.

**Anmerkung**  
Serverseitiges SGAI-Beaconing wird derzeit nur für HLS unterstützt. DASH wird für serverseitiges SGAI-Beaconing noch nicht unterstützt.

## Vergleich mit serverseitigem Tracking im Stitched-Modus
<a name="ad-reporting-server-side-sgai-comparison"></a>

In der folgenden Tabelle wird zusammengefasst, wie sich serverseitiges Tracking zwischen gestickter und serverseitiger Anzeigeneinfügung unterscheidet:


| Aspekt | Gestickt (SSAI) | Server-guided (SGAI) | 
| --- | --- | --- | 
| Offensichtliche Cachefähigkeit | Per-session, nicht zwischenspeicherbar | Cachefähig, von allen Zuschauern gemeinsam genutzt | 
| Routing von Anzeigensegmenten | Durch die /v1/segment/ Verwendung der Sitzungs-ID | Durch die /v1/segment/ Verwendung eines verschlüsselten Beacon-Datenblobs | 
| Sitzungsstatus für Beacons | Gespeichert pro Sitzung in MediaTailor | Sitzungslos — der gesamte Status wird im verschlüsselten Parameter übernommen awsBeaconData | 
| Tracking-URL beim Start der Sitzung | Wurde in der Antwort auf die Initialisierung der Sitzung zurückgegeben | Nicht angegeben — Beacon-Daten sind in Werbe-URIs in jeder Antwort auf die Asset-Liste eingebettet | 
| DASH-Unterstützung | Unterstützt | Noch nicht unterstützt | 

**Anmerkung**  
Für Live-SGAI-Sitzungen können Sie das manifestbasierte Vorabrufen von Anzeigen mithilfe von aktivieren. `aws.guidedPrefetchMode=MANIFEST` Dies unterscheidet sich von der zeitplanbasierten Prefetch-API, die bei zusammengestellten Sitzungen (SSAI) verwendet wird. Details hierzu finden Sie unter [Geführter Prefetch mit offensichtlichem Herzschlag](sgai-guided-prefetch.md).