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.

# Kundenseitiges Anzeigen-Tracking
<a name="ad-reporting-client-side"></a>

Mithilfe der AWS Elemental MediaTailor clientseitigen Tracking-API können Sie Player-Steuerelemente während Werbepausen in Streaming-Workflows integrieren. Beim clientseitigen Tracking sendet der Player oder Client Tracking-Ereignisse wie Impressionen und Quartil-Ad-Beaconing an den Ad Decision Server (ADS) und andere Einheiten zur Anzeigenverifizierung. Bei diesen Ereignissen wird sowohl der Gesamtstatus der Werbeunterbrechung als auch die Anzahl der einzelnen Werbezeiträume innerhalb der einzelnen Werbeunterbrechungen erfasst. Hier finden Sie weitere Informationen zu Impression and Quartile (ADS) und anderen Einheiten zur Anzeigenverifizierung. Weitere Informationen zu Impression und Quartil-Ad-Beaconing finden Sie unter. [Clientseitiges Beaconing](ad-reporting-client-side-beaconing.md) Weitere Informationen zu ADS und anderen Entitäten zur Anzeigenverifizierung finden Sie unter. [Kundenseitige Ad-Tracking-Integrationen](ad-reporting-client-side-ad-tracking-integrations.md)

Informationen zur Weitergabe von Spielerparametern und Sitzungsdaten an das ADS für die clientseitige Nachverfolgung finden Sie unter und. [MediaTailor Player-Variablen für ADS-Anfragen](variables-player.md) [MediaTailor Sitzungsvariablen für ADS-Anfragen](variables-session.md)

Das clientseitige Tracking ermöglicht Funktionen wie die folgenden: 
+ Countdown-Timer für Werbeunterbrechungen — Weitere Informationen finden Sie unter. [Countdown-Timer hinzufügen](ad-reporting-client-side-ad-tracking-schema-player-controls.md#ad-reporting-client-side-ad-tracking-schema-player-controls-ad-countdown-timer)
+ Durchklicken von Werbeanzeigen — Weitere Informationen finden Sie unter. [Und Click-through](ad-reporting-client-side-ad-tracking-schema-player-controls.md#ad-reporting-client-side-ad-tracking-schema-player-controls-ad-clickthrough)
+ Anzeige von Begleitanzeigen — Weitere Informationen finden Sie unter. [Begleitende Anzeigen](ad-reporting-client-side-ad-tracking-schema-player-controls.md#ad-reporting-client-side-ad-tracking-schema-player-controls-companion-ads)
+ Überspringbare Anzeigen — Weitere Informationen finden Sie unter. [Überspringbare Anzeigen](ad-reporting-client-side-ad-tracking-schema-player-controls.md#ad-reporting-client-side-ad-tracking-schema-player-controls-skippable-ads)
+ Anzeige von VAST-Symbolen zur Einhaltung der Datenschutzbestimmungen — Weitere Informationen finden Sie unter. [Symbole für Google Warum diese Anzeige (WTA)](ad-reporting-client-side-ad-tracking-schema-player-controls.md#ad-reporting-client-side-ad-tracking-schema-player-controls-google-wta)
+ Steuerung des Spieler-Scrubbings bei Werbeanzeigen — Weitere Informationen finden Sie unter[Schrubben](ad-reporting-client-side-ad-tracking-schema-player-controls.md#ad-reporting-client-side-ad-tracking-schema-player-controls-scrubbing).

Mithilfe der MediaTailor clientseitigen Tracking-API können Sie Metadaten an das Wiedergabegerät senden, die zusätzlich zum clientseitigen Tracking weitere Funktionen ermöglichen:

## Workflow für die clientseitige Berichterstattung
<a name="ad-reporting-client-side-workflow"></a>

Das folgende Diagramm zeigt den gesamten Workflow für die clientseitige Berichterstattung von der Sitzungsinitialisierung über die Anzeigenwiedergabe bis hin zum Beaconing:

![\[MediaTailor Sequenzdiagramm für die clientseitige Berichterstattung, das die Interaktion zwischen dem Videoplayer, dem Ad Decision Server MediaTailor, dem Inhaltsursprung und den Anzeigenverifizierungsdiensten während des gesamten Workflows von der Sitzungsinitialisierung über die Anzeigenwiedergabe bis hin zum Beaconing zeigt.\]](http://docs.aws.amazon.com/de_de/mediatailor/latest/ug/images/tracking_flow.png)


Der clientseitige Berichtsworkflow umfasst die folgenden Schritte:

1. **Sitzungsinitialisierung** — Der Videoplayer sendet eine POST-Anfrage mit JSON-Metadaten`adsParams`, einschließlich Ursprungs-Tokens und MediaTailor Sitzungsfunktionen, an den Sitzungsendpunkt. MediaTailor reagiert mit `manifestUrl` und `trackingUrl` für die Sitzung.

1. **Manifestanfrage und Anzeigenentscheidung** — Der Spieler fordert das personalisierte Manifest von an MediaTailor. MediaTailor fordert das ursprüngliche Inhaltsmanifest vom Absender an, sendet mithilfe von Player-Parametern eine Anzeigenanfrage an den Ad Decision Server (ADS), erhält eine VAST-Antwort mit Anzeigenmetadaten und übermittelt dem Player ein personalisiertes Manifest mit Werbemarkierungen.

1. **Abruf von Tracking-Daten** — Der Player fragt die Tracking-URL in regelmäßigen Abständen ab (entspricht der Zieldauer für HLS oder dem Mindestaktualisierungszeitraum für DASH). MediaTailor gibt JSON-Tracking-Metadaten zurück, die Verfügbarkeiten, Anzeigen, Tracking-Ereignisse, Beacon URLs - und Anzeigenverifizierungsdaten enthalten.

1. **Anzeigenwiedergabe und Beaconing** — Während Werbeunterbrechungen analysiert der Player die Tracking-Metadaten, feuert Impression-Beacons ab, wenn die Werbung gerendert wird, löst zum richtigen Zeitpunkt Quartil-Beacons (Start, FirstQuartile, Midpoint, ThirdQuartile, complete) aus, lädt und führt bei Bedarf eine Anzeigenüberprüfung durch und sendet Ereignisse an Bestätigungsdienste von Drittanbietern. JavaScript viewability/verification 

1. **Kontinuierliche Abfrage** — Der Player fragt die Tracking-URL während der gesamten Sitzung weiter ab, um aktualisierte Metadaten für bevorstehende Werbeunterbrechungen und dynamische Inhalte zu erhalten.

Dieser Workflow ermöglicht erweiterte Funktionen wie Countdown-Timer für Werbeanzeigen, Click-Through-Funktionen, Begleitanzeigen, überspringbare Anzeigen und die Anzeige von VAST-Symbolen zur Einhaltung der Datenschutzbestimmungen.

**Topics**
+ [Workflow für die clientseitige Berichterstattung](#ad-reporting-client-side-workflow)
+ [Aktivierung von clientseitigem Tracking](#ad-reporting-client-side-enabling)
+ [Serverparameter hinzufügen](#ad-reporting-client-side-ad-server-parameters)
+ [Abfrageparameter für Origin-Interaktionen](#ad-reporting-client-side-origin-interaction-query-parameters)
+ [Für die Sitzung konfigurierte Funktionen](#ad-reporting-client-side-session-configured-features)
+ [Bewährte Methoden für die clientseitige Nachverfolgung](#ad-reporting-client-side-best-practices)
+ [Schema und Eigenschaften für das clientseitige Ad-Tracking](ad-reporting-client-side-ad-tracking-schema.md)
+ [Zeitlicher Ablauf der Aktivitäten bei der Anzeigenverfolgung](ad-reporting-client-side-ad-tracking-schema-activity-timing.md)
+ [Player-Bedienelemente und Funktionen für das clientseitige Ad-Tracking](ad-reporting-client-side-ad-tracking-schema-player-controls.md)
+ [Clientseitiges Beaconing](ad-reporting-client-side-beaconing.md)
+ [Hybridmodus mit serverseitigen Ad Beacons](ad-reporting-hybrid-mode.md)
+ [Kundenseitige Ad-Tracking-Integrationen](ad-reporting-client-side-ad-tracking-integrations.md)
+ [Durch Werbe-Beacons blättern mit GetTracking](#gettracking)

## Aktivierung von clientseitigem Tracking
<a name="ad-reporting-client-side-enabling"></a>

Sie aktivieren das clientseitige Tracking für jede Sitzung. Der Player sendet ein HTTP `POST` an den Endpunkt des MediaTailor Sitzungsinitialisierungspräfixes der Konfiguration. Optional kann der Player zusätzliche Metadaten senden, die dann verwendet werden können, wenn er Werbeaufrufe tätigt, den Ursprung für ein Manifest aufruft und MediaTailor Funktionen auf Sitzungsebene aufruft oder deaktiviert. MediaTailor 

Das folgende Beispiel zeigt die Struktur der JSON-Metadaten:

```
{
  "adsParams": {                  # 'adsParams' is case sensitive
    "param1": "value1",           # key is not case sensitive
    "param2": "value2",           # Values can contain spaces. For example, 'value 2' is an allowed value. 
    },
  "origin_access_token":"abc123", # this is an example of a query parameter designated for the origin
  "overlayAvails":"on"            # 'overlayAvails' is case sensitive. This is an example of a feature that is enabled at the session level.
}
```

Verwenden Sie die MediaTailor Konsole oder API, um die URL der ADS-Anforderungsvorlage so zu konfigurieren, dass sie auf diese Parameter verweist. Im folgenden Beispiel `player_params.param1` sind die Player-Parameter für `param1` und `player_params.param2` die Player-Parameter für`param2`.

```
https://my.ads.com/path?param1=[player_params.param1]&param2=[player_params.param2]
```

## Serverparameter hinzufügen
<a name="ad-reporting-client-side-ad-server-parameters"></a>

Auf der obersten Ebene der JSON-Struktur befindet sich ein JSON-Objekt. `adsParams` In diesem Objekt befinden sich key/value Paare, die in allen Sitzungsanfragen lesen und an den Ad-Server senden MediaTailor können. MediaTailor unterstützt die folgenden Anzeigenserver:
+ Google Ad Manager 
+ SpringServe 
+ FreeWheel 
+ Öffentlich 

## Abfrageparameter für Origin-Interaktionen
<a name="ad-reporting-client-side-origin-interaction-query-parameters"></a>

Alle reservierten key/value Paare innerhalb der obersten Ebene der JSON-Struktur, wie, und `adsParams` `availSuppression``overlayAvails`, werden der ursprünglichen Anforderungs-URL nicht in Form von Abfrageparametern hinzugefügt. Jede Sitzungsmanifestanforderung, die an MediaTailor den Ursprung gerichtet wird, enthält diese Abfrageparameter. Der Ursprung ignoriert überflüssige Abfrageparameter. MediaTailor Kann die key/value Paare beispielsweise verwenden, um Zugriffstoken an den Ursprung zu senden.

## Für die Sitzung konfigurierte Funktionen
<a name="ad-reporting-client-side-session-configured-features"></a>

Verwenden Sie die JSON-Struktur für die Sitzungsinitialisierung, um Funktionen wie, und zu aktivieren, zu deaktivieren oder zu überschreiben MediaTailor. `overlayAvails` `availSuppression` `adSignaling` Alle während der Sitzungsinitialisierung übergebenen Funktionskonfigurationen überschreiben die Einstellung auf der Konfigurationsebene. MediaTailor 

**Anmerkung**  
Die MediaTailor bei der Sitzungsinitialisierung übermittelten Metadaten sind unveränderlich, und zusätzliche Metadaten können für die Dauer der Sitzung nicht hinzugefügt werden. Verwenden Sie SCTE-35-Markierungen, um Daten zu übertragen, die sich während der Sitzung ändern. Weitere Informationen finden Sie unter [MediaTailor Sitzungsvariablen für ADS-Anfragen](variables-session.md).

**Example : Durchführung von kundenseitigem Ad-Tracking für HLS**  

```
POST mediatailorURL/v1/session/hashed-account-id/origin-id/asset-id.m3u8

        {
            "adsParams": {
               "deviceType": "ipad"   # This value does not change during the session.
               "uid": "abdgfdyei-2283004-ueu"                     
           }
        }
```

**Example : Durchführung von kundenseitigem Ad-Tracking für DASH**  

```
POST mediatailorURL/v1/session/hashed-account-id/origin-id/asset-id.mpd

        {
            "adsParams": {
               "deviceType": "androidmobile",
               "uid": "xjhhddli-9189901-uic" 
           }
        }
```

### Parameter für den Berichtsmodus
<a name="session-initialization-reporting-mode"></a>

Sie können den Berichtsmodus bei der Initialisierung einer Sitzung angeben, indem Sie den `reportingMode` Parameter in den Anfragetext aufnehmen. Dieser Parameter steuert, ob für die MediaTailor Sitzung clientseitiges oder serverseitiges Ad-Tracking durchgeführt wird.
+ `client`- Der Player führt Ad-Tracking durch und sendet Beacons an den Anzeigenserver. Dies ist der Standardmodus, wenn kein Modus angegeben `reportingMode` ist.
+ `server`- MediaTailor führt serverseitiges Ad-Tracking durch und sendet Beacons direkt an den Anzeigenserver.

**Example Sitzungsinitialisierung mit serverseitigem Berichtsmodus**  

```
POST mediatailorURL/v1/session/hashed-account-id/origin-id/asset-id.m3u8

        {
            "adsParams": {
               "deviceType": "ipad",
               "uid": "abdgfdyei-2283004-ueu"                     
           },
           "reportingMode": "server"
        }
```

**Example Sitzungsinitialisierung mit clientseitigem Berichtsmodus (explizit)**  

```
POST mediatailorURL/v1/session/hashed-account-id/origin-id/asset-id.mpd

        {
            "adsParams": {
               "deviceType": "androidmobile",
               "uid": "xjhhddli-9189901-uic" 
           },
           "reportingMode": "client"
        }
```

**Anmerkung**  
Der `reportingMode` Parameter wird bei der Sitzungsinitialisierung festgelegt und kann während der Sitzung nicht geändert werden. Wenn kein Wert angegeben `reportingMode` ist, wird MediaTailor standardmäßig die clientseitige Berichterstattung verwendet, um die Abwärtskompatibilität zu gewährleisten.

Eine erfolgreiche Antwort ist ein HTTP `200` mit einem Antworttext. Der Hauptteil enthält ein JSON-Objekt mit einem `manifestUrl` und einem `trackingUrl` Schlüssel. Bei den Werten handelt es sich um relative Werte URLs , die der Player sowohl für die Wiedergabe als auch für die Nachverfolgung von Werbeereignissen verwenden kann.

```
{
  "manifestUrl": "/v1/dashmaster/hashed-account-id/origin-id/asset-id.m3u8?aws.sessionId=session-id",
  "trackingUrl": "/v1/tracking/hashed-account-id/origin-id/session-id"
}
```

Weitere Informationen zum clientseitigen Tracking-Schema finden Sie unter. [Schema und Eigenschaften für das clientseitige Ad-Tracking](ad-reporting-client-side-ad-tracking-schema.md)

## Bewährte Methoden für die clientseitige Nachverfolgung
<a name="ad-reporting-client-side-best-practices"></a>

In diesem Abschnitt werden die bewährten Methoden für das clientseitige Tracking sowohl für Live- als auch MediaTailor für VOD-Workflows beschrieben.

### Live-Workflows
<a name="ad-reporting-client-side-best-practices-live"></a>

Fragen Sie den Tracking-Endpunkt in einem Intervall ab, das jeder Zieldauer für HLS oder dem minimalen Aktualisierungszeitraum für DASH entspricht, um immer über die aktuellsten Ad-Tracking-Metadaten zu verfügen. Die Anpassung dieses Intervalls ist besonders wichtig in Workflows, bei denen die Kreativen möglicherweise über eine interaktive Komponente oder eine Overlay-Komponente verfügen. 

**Anmerkung**  
Einige Player unterstützen Event-Listener, die als Alternative zu Umfragen verwendet werden könnten. Beispielsweise müsste die Funktion zur Dekoration von MediaTailor Werbe-IDs für jede Sitzung aktiviert werden. Weitere Informationen finden Sie unter [Werbe-ID-Dekoration](ad-id-decoration.md). Wenn Sie diese Funktion verwenden, wird für jede verfügbare Anzeige ein Datumsbereich (HLS) oder ein Eventelement (DASH) -Identifier verwendet. Spieler können diese Manifest-Tags als Aufforderung verwenden, um den MediaTailor Tracking-Endpunkt für die Sitzung aufzurufen.

### VOD-Workflows
<a name="ad-reporting-client-side-best-practices-vod"></a>

Nach einer erfolgreichen Sitzungsinitialisierung und nach Erhalt des ersten MediaTailor Manifests, das Medien enthält, müssen Sie den Tracking-Endpunkt nur einmal aufrufen.

![\[Anruffluss für VOD-Workflows. Rufen Sie den clientseitigen Tracking-Endpunkt auf, nachdem die Sitzung initialisiert wurde und das erste Manifest, das Medien enthält, MediaTailor empfangen wurde.\]](http://docs.aws.amazon.com/de_de/mediatailor/latest/ug/images/vod-workflow-best-practice.png)


### Servergesteuerte Anzeigeneinfügung
<a name="ad-reporting-client-side-best-practices-sgai"></a>

Servergesteuerte Ad-Insertion-Sitzungen (SGAI) verwenden die API nicht. `GetTracking` MediaTailorStellt stattdessen bei der Verwendung `aws.reportingMode=CLIENT` von Tracking-Informationen im `TRACKING` Abschnitt jeder Antwort auf die Asset-Liste bereit, wenn Spieler Werbeinhalte anfordern. Die Antwort auf die Initialisierung der Sitzung enthält kein`trackingUrl`.

Die Antwort auf die Assetliste für clientseitig verfolgte SGAI-Sitzungen hat die folgende Struktur:

```
{
  "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...
  }
}
```

Bei der Implementierung von clientseitigem Tracking für SGAI-Methoden:
+ Analysieren Sie den `TRACKING` Abschnitt anhand der Antworten auf die Asset-Liste, anstatt ihn aufzurufen `GetTracking`
+ Verwenden Sie das in der Asset-Liste URLs bereitgestellte Tracking für die Berichterstattung über Anzeigenereignisse
+ Feuern Sie Tracking-Beacons ab, die auf tatsächlichen Ereignissen bei der Anzeigenwiedergabe im Player basieren
+ Verwalte das Tracking für jede Werbeunterbrechung unabhängig, wenn die Asset-Listen abgerufen werden

**Wichtig**  
Der `TRACKING` Abschnitt ist nur dann in der Asset-Liste enthalten, wenn er festgelegt `aws.reportingMode=CLIENT` ist. Wenn serverseitiges Reporting verwendet wird (Standard für SGAI), wird der `TRACKING` Abschnitt MediaTailor weggelassen und stattdessen Beacon-Daten in die Anzeige eingebettet. URIs Details hierzu finden Sie unter [Serverseitiges Tracking mit serverseitiger Anzeigeneinfügung (SGAI)](ad-reporting-server-side-sgai.md).

# Schema und Eigenschaften für das clientseitige Ad-Tracking
<a name="ad-reporting-client-side-ad-tracking-schema"></a>

Mit der MediaTailor clientseitigen Ad-Tracking-Funktion können Sie detaillierte clientseitige Ad-Tracking-Daten in Ihre Player-Umgebung integrieren. In den folgenden Abschnitten werden das allgemeine Ad-Tracking-Schema sowie die spezifischen Eigenschaften und Werte behandelt, aus denen sich das Schema zusammensetzt.

## Schema
<a name="ad-reporting-client-side-ad-tracking-schema-table"></a>

Die folgende JSON-Struktur zeigt das MediaTailor clientseitige Ad-Tracking-Schema. Diese Darstellung veranschaulicht die Verschachtelungsstruktur des Schemas, um Ihnen das Verständnis der Beziehungen zwischen den verschiedenen Teilen zu erleichtern.

Ausführliche Informationen zu den einzelnen Eigenschaften finden Sie unter[Eigenschaften](#ad-reporting-client-side-ad-tracking-schema-properties).

```
{
  "avails": [
    {
      "ads": [
        {
          "adID": "string",
          "adParameters": "string",
          "adSystem": "string",
          "adTitle": "string",
          "adVerifications": [
            {
              "executableResource": [
                {
                  "apiFramework": "string",
                  "type": "string",
                  "uri": "string",
                  "language": "string"
                }
              ],
              "javaScriptResource": [
                {
                  "apiFramework": "string",
                  "browserOptional": "string",
                  "uri": "string"
                }
              ],
              "trackingEvents": [
                {
                  "event": "string",
                  "uri": "string"
                }
              ],
              "vendor": "string",
              "verificationParameters": "string"
            }
          ],
          "companionAds": [
            {
              "adParameters": "string",
              "altText": "string",
              "attributes": {
                "adSlotId": "string",
                "apiFramework": "string",
                "assetHeight": "string",
                "assetWidth": "string",
                "expandedHeight": "string",
                "expandedWidth": "string",
                "height": "string",
                "id": "string",
                "pxratio": "string",
                "renderingMode": "string",
                "width": "string"
              },
              "companionClickThrough": "string",
              "companionClickTracking": "string",
              "htmlResource": "string",
              "iFrameResource": "string",
              "sequence": "string",
              "staticResource": "string",
              "trackingEvents": [
                {
                  "event": "string",
                  "uri": "string"
                }
              ]
            }
          ],
          "creativeId": "string",
          "creativeSequence": "string",
          "duration": "string",
          "durationInSeconds": number,
          "extensions": [
            {
              "type": "string",
              "content": "string"
            }
          ],
          "icons": [
            {
              "attributes": {
                "apiFramework": "string",
                "duration": "string",
                "height": "string",
                "offset": "string",
                "program": "string",
                "pxratio": "string",
                "width": "string",
                "xPosition": "string",
                "yPosition": "string"
              },
              "htmlResource": "string",
              "iconClicks": {
                "iconClickThrough": "string",
                "iconClickTracking": {
                  "id": "string"
                },
                "iconClickFallbackImages": [
                  {
                    "altText": "string",
                    "height": "string",
                    "width": "string",
                    "staticResource": {
                      "creativeType": "string",
                      "uri": "string"
                    }
                  }
                ]
              },
              "iconViewTracking": "string",
              "iFrameResource": "string",
              "staticResource": {
                "creativeType": "string",
                "uri": "string"
              }
            }
          ],
          "mediaFiles": {
            "adParameters": "string",
            "duration": "string",
            "durationInSeconds": number,
            "mediaFilesList": [
              {
                "apiFramework": "string",
                "delivery": "string",
                "height": "string",
                "maintainAspectRatio": "string",
                "mediaFileUri": "string",
                "mediaType": "string",
                "scalable": "string",
                "width": "string",
                "bitrate": "string"
              }
            ],
            "mezzanine": "string",
            "startTime": "string",
            "startTimeInSeconds": number,
            "trackingEvents": [
              {
                "beaconUrls": ["string"],
                "duration": "string",
                "durationInSeconds": number,
                "dateTime": "string",
                "eventId": "string",
                "eventType": "string",
                "startTime": "string",
                "startTimeInSeconds": number
              }
            ]
          },
          "startTime": "string",
          "startTimeInSeconds": number,
          "dateTime": "string",
          "adBreakTrackingEvents": [...],
          "vastAdId": "string"
        }
      ],
      "adType": "string",
      "availID": "string",
      "duration": "string",
      "durationInSeconds": number,
      "startTime": "string",
      "startTimeInSeconds": number,
      "dateTime": "string",
      "adMarkerDuration": "string",
      "adProgramDateTime": "string",
      "dashAvailabilityStartTime": "string",
      "hlsAnchorMediaSequenceNumber": "string"
    }
  ],
  "nonLinearAvails": [
    {
      "nonLinearAds": [...],
      "nonLinearAdsList": [...]
    }
  ],
  "nextToken": "string",
  "meta": {}
}
```

## Eigenschaften
<a name="ad-reporting-client-side-ad-tracking-schema-properties"></a>

In der folgenden Tabelle sind die Eigenschaften in der clientseitigen Tracking-API, ihre Definitionen, Wertetypen und Beispiele aufgeführt.


****  

| Eigenschaft | Definition | Werttyp | Beispiel | 
| --- | --- | --- | --- | 
|   adID  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/mediatailor/latest/ug/ad-reporting-client-side-ad-tracking-schema.html) Pfad: `/avails/ads/adId` VAST-Zuordnung: Keine  | Zeichenfolge | 10 | 
|   adBreakTrackingEvents  |  Ein Array, das VMAP-Tracking-Ereignisse aus der VAST-Antwort enthält. Weitere Informationen finden Sie in Abschnitt 2.3.3 der [VMAP](https://www.iab.com/guidelines/vmap/) 1.0-Spezifikation. Pfad: `/avails/ads/adBreakTrackingEvents`  | Array |  []  | 
|   adMarkerDuration  |  Die anhand der Anzeigenmarkierung im Manifest beobachtete Nutzungsdauer.  | Zeichenfolge |  30  | 
|   adParameters  |  Eine Reihe von Anzeigenparametern aus dem VAST VPAID, die an den MediaTailor Player weitergegeben wird. Pfad: `/avails/ads/adParameters` VAST-Zuordnung: `VAST/Ad/InLine/Creatives/Creative/Linear/AdParameters`  | Zeichenfolge |  | 
|   adProgramDateTime  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/mediatailor/latest/ug/ad-reporting-client-side-ad-tracking-schema.html)  | Zeichenfolge |  | 
|   ads  |  Ein Array, das die Werbeobjekte enthält, aus denen sich der Avail zusammensetzt. Die Anzeigen werden in der Reihenfolge aufgeführt, in der sie im Manifest erscheinen. Pfad: `/avails/ads`  | Array |  []  | 
|   adSystem  |  Der Name des Systems, das die Anzeige bereitstellt.  Stellen Sie sicher, dass Sie einen Wert angeben. Wenn Sie keinen Wert angeben, können Probleme auftreten.   | Zeichenfolge |  myADS  | 
|   adTitle  |  Der Titel der Anzeige.  | Zeichenfolge |  ad1  | 
|   adVerifications  |  Enthält die Ressourcen und Metadaten, die für die Ausführung von Messcode von Drittanbietern erforderlich sind, um die kreative Wiedergabe zu überprüfen. Weitere Informationen zu dieser Eigenschaft finden Sie in Abschnitt 3.16 der [VAST 4.2-Spezifikation](https://iabtechlab.com/standards/vast/). MediaTailor unterstützt `adVerifications` als VAST 3 Erweiterungsknoten. Pfad: `/avails/ads/adVerifications` VAST-Zuordnung: `VAST/Ad/InLine/AdVerifications`  | Array |  []  | 
|   altText  |  Der alternative Text für ein Bild einer Begleitanzeige. Dieser Text ermöglicht es Spielern mit beschreibender Audiounterstützung für sehbehinderte Personen, eine Beschreibung des Bildes vorzulesen. Pfad: `/avails/ads/companionAds/altText`  | Zeichenfolge |  video sequence advertising sneakers  | 
|   apiFramework  |  Stellen Sie auf ein`VPAID`, um dem Player mitzuteilen, dass es sich bei dieser Anzeige um eine VPAID-Anzeige handelt. Kann an mehreren Stellen im Schema erscheinen.  | Zeichenfolge |  VPAID  | 
|   availID  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/mediatailor/latest/ug/ad-reporting-client-side-ad-tracking-schema.html) Pfad: `/avails/availID`  | Zeichenfolge |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/mediatailor/latest/ug/ad-reporting-client-side-ad-tracking-schema.html)  | 
|   avails  |  Ein Array, das Ad-Break-Objekte oder *Avails* enthält, die im aktiven Manifestfenster angezeigt werden. Die Avails werden in der Reihenfolge aufgeführt, in der sie im Manifest erscheinen. Pfad: `/avails`  | Array |  []  | 
|   adType  |  Der Typ der Anzeige. Pfad: `/avails/adType` und `/avails/ads/adType`  | Zeichenfolge |  | 
|   dateTime  |  Programmdatum und Uhrzeit im Format ISO 8601 Sekunden für den Start der Anzeige Avail oder Anzeige. Pfad: und `/avails/dateTime` `/avails/ads/dateTime`  | Zeichenfolge |  | 
|   duration  |  Länge im ISO-8601-Sekunden-Format. Die Antwort umfasst die Dauer für die gesamte Anzeigenverfügbarkeit sowie für jede Anzeige und jedes Beacon, obwohl die Dauer der Beacons immer Null ist. Pfad: und `/avails/duration` `/avails/ads/duration`  | Zeichenfolge | 15.015 | 
|   durationInSeconds  |  Länge im Sekundenformat. Pfad: `/avails/durationInSeconds` und `/avails/ads/durationInSeconds`  | Zahl |  | 
|   extensions  |  Benutzerdefinierte Erweiterungen von VAST, die Werbeserver verwenden. Weitere Informationen zu Erweiterungen finden Sie in Abschnitt 3.18 der [VAST 4.2-Spezifikation](https://iabtechlab.com/standards/vast/). Pfad: `/avails/ads/extensions` VAST-Zuordnung: `VAST/Ad/InLine/Extensions`  | Array | [] | 
|   icons  |  Symbolelemente für die Anzeige. Pfad: `/avails/ads/icons` VAST-Zuordnung: `VAST/Ad/InLine/Creatives/Creative/Linear/Icons`  | Array |  | 
|   mediaFiles  |  Video und andere Inhalte, die der Spieler für die Anzeige benötigt, stehen zur Verfügung. Pfad: `/avails/ads/mediaFiles`  | Objekt |  | 
|   nonLinearAvails  |  Eine Reihe nichtlinearer und verfügbarer Objekte. Pfad: `/nonLinearAvails`  | Array |  | 
|   executableResource  |  Ausführbare Ressourcen zur Überprüfung. Pfad: `/avails/ads/adVerifications/executableResource` VAST-Zuordnung: `VAST/Ad/InLine/AdVerifications/Verification/ExecutableResource`  | Array |  | 
|   javaScriptResource  |  JavaScript Ressourcen zur Überprüfung. Pfad: `/avails/ads/adVerifications/javaScriptResource` VAST-Zuordnung: `VAST/Ad/InLine/AdVerifications/Verification/JavaScriptResource`  | Array |  | 
|   trackingEvents  |  Erfassung von Ereignissen zur Verifizierung oder als Begleitwerbung Pfad: `/avails/ads/adVerifications/trackingEvents` oder `/avails/ads/companionAds/trackingEvents`  | Array |  | 
|   vendor  |  Anbieter der Verifizierung. Pfad: `/avails/ads/adVerifications/vendor` VAST-Zuordnung: `VAST/Ad/InLine/AdVerifications/Verification/@vendor`  | Zeichenfolge |  | 
|   uri  |  URI, die entweder auf ein ausführbares Asset, ein Video-Asset oder einen Tracking-Endpunkt verweist. Pfad: Verschiedene Speicherorte im Schema VAST-Zuordnung: Verschiedene CDATA-Elemente in VAST  | Zeichenfolge | https://tracking.example.com/impression | 
|   verificationParameters  |  Überprüfungsparameter. Pfad: `/avails/ads/adVerifications/verificationParameters` VAST-Zuordnung: `VAST/Ad/InLine/AdVerifications/Verification/VerificationParameters`  | Zeichenfolge |  | 
|   attributes  |  Begleitende Anzeigenattribute wie Abmessungen und Rendermodus. Pfad: `/avails/ads/companionAds/attributes`  | Objekt |  | 
|   companionClickThrough  |  Eine URL zur Seite des Werbetreibenden, die der Media Player öffnet, wenn der Zuschauer auf die Begleitanzeige klickt. Pfad: `/avails/ads/companionAds/companionClickThrough` VAST-Zuordnung: `VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/CompanionClickThrough`  | Zeichenfolge | https://aws.amazon.com/ | 
|   companionClickTracking  |  Die Tracking-URL für die `companionClickThrough` Immobilie. Pfad: `/avails/ads/companionAds/companionClickTracking` VAST-Zuordnung: `VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/CompanionClickTracking`  | Zeichenfolge | https://myads.com/beaconing/event=clicktracking | 
|   htmlResource  |  Der CDATA-kodierte HTML-Code, der direkt in die HTML-Seite des Streaming-Anbieters eingefügt wird. Pfad: `/avails/ads/companionAds/htmlResource` VAST-Zuordnung: `VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/HTMLResource`  | Zeichenfolge | <\$1[CDATA[<\$1doctype html><html><head><meta name=\$1"viewport\$1" content=\$1"width=1, initial-scale=1.0, minimum-scale=1.0,...]]> | 
|   iFrameResource  |  Die URL zu einer HTML-Ressourcendatei, die der Streaming-Anbieter in einen Iframe lädt. Pfad: `/avails/ads/companionAds/iFrameResource` VAST-Zuordnung: `VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/iFrameResource`  | Zeichenfolge |  | 
|   sequence  |  Der Sequenzwert, der für das Creative in der VAST-Antwort angegeben wurde. Pfad: `/avails/ads/companionAds/sequence`  | Zeichenfolge | 1 | 
|   startTime  |  Die Zeitposition im ISO-8601-Sekundenformat. Bei HLS bezieht sich dies auf den Beginn der Wiedergabesitzung. Für DASH ist dies relativ zur AST (Availability Start Time) des Manifests. Die Antwort enthält Startzeiten für den gesamten Ad-Avail und für jede Werbung und jedes Beacon. Pfad: `/avails/startTime` und `/avails/ads/startTime`  | Zeichenfolge | PT18.581355S | 
|   startTimeInSeconds  |  Die Zeitposition im Sekundenformat. Bei HLS bezieht sich dies auf den Beginn der Wiedergabesitzung. Für DASH ist dies relativ zur AST (Availability Start Time) des Manifests. Die Antwort enthält Startzeiten für den gesamten Ad-Avail und für jede Werbung und jedes Beacon. Pfad: `/avails/startTimeInSeconds` und `/avails/ads/startTimeInSeconds`  | Zahl | 18.581 | 
|   eventId  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/mediatailor/latest/ug/ad-reporting-client-side-ad-tracking-schema.html)  | Zeichenfolge |  | 
|   event  |  Der Name des Tracking-Ereignisses. Pfad: `/avails/ads/adVerifications/trackingEvents/event` oder `/avails/ads/companionAds/trackingEvents/event`  | Zeichenfolge | impression, start, firstQuartile, midpoint, thirdQuartile, complete | 
|   beaconUrls  |  Die URL, an die der Ad Beacon MediaTailor gesendet wird. Pfad: `/avails/ads/mediaFiles/trackingEvents/beaconUrls`  | Array |  | 
|   bitrate  |  Die Bitrate des Video-Assets. Diese Eigenschaft ist in der Regel nicht für ein ausführbares Asset enthalten.  | Zeichenfolge | 2048 | 
|   companionAds  |  Eine oder mehrere Spezifikationen für begleitende Anzeigeninhalte, von denen jede eine zu verwendende Ressourcendatei spezifiziert. Begleitanzeigen begleiten die Werbeanzeige und bieten Inhalte, wie z. B. einen Rahmen um die Anzeige oder ein Banner, der in der Nähe des Videos eingeblendet wird. Pfad: `/avails/ads/companionAds`  | Array | [] | 
|   creativeId  |  Der `Id` Attributwert des `Creative` Tags für die Anzeige.  | Zeichenfolge | creative-1 | 
|   creativeSequence  |  Die Reihenfolge, in der eine Anzeige abgespielt werden soll, entsprechend dem `Ad@id` Wert in der VAST-Antwort.  | Zeichenfolge | 1 | 
|   dashAvailabilityStartTime  |  Bei live/dynamic DASH ist es das `MPD@availabilityStartTime` Ursprungs-Manifest.  | Zeichenfolge | 2022-10-05T19:38:39.263Z | 
|   delivery  |  Gibt an, ob ein `progressive` `streaming` OR-Protokoll verwendet wird.  | Zeichenfolge | progressive | 
|   eventType  |  Der Typ des Beacons. Pfad: `/avails/ads/mediaFiles/trackingEvents/eventType`  | Zeichenfolge | impression | 
|   height  |  Die Höhe des Video-Assets in Pixeln.  | Zeichenfolge | 360 | 
|   hlsAnchorMediaSequenceNumber  |  Die Mediensequenznummer der first/oldest Mediensequenz, die im HLS-Ursprungsmanifest zu sehen ist.  | Zeichenfolge | 77 | 
|   maintainAspectRatio  |  Gibt an, ob das Seitenverhältnis des Videos bei der Skalierung beibehalten werden soll.  | Boolesch | true | 
|   mediaFilesList  |  Gibt das Video und andere Elemente an, die der Player für die Anzeigenbereitstellung benötigt. Pfad: `/avails/ads/mediaFiles/mediaFilesList`  | Array | [] | 
|   mediaFileUri  |  URI, die entweder auf ein ausführbares Asset oder ein Video-Asset verweist.  | Zeichenfolge | https://myad.com/ad/ad134/vpaid.js | 
|   mediaType  |  Der MIME-Typ des kreativen Elements oder des Begleitelements.  | Zeichenfolge | video/mp4 | 
|   meta  |  Zusätzliche Metadaten für die Anzeige.  | Objekt |  | 
|   mezzanine  |  Die URL des MP4 Mezzanine-Assets, angegeben, falls die VPAID-Anzeige eines enthält. Pfad: `/avails/ads/mediaFiles/mezzanine`  | Zeichenfolge | https://gcdn.2mdn.net/videoplayback/id/itag/ck2/file/file.mp4 | 
|   nextToken  |  Der Wert des Tokens, das auf die nächste Ergebnisseite verweist, sofern ein solcher Wert vorhanden ist.  | Zeichenfolge | UFQzOS44NzNTXzIwMjMtMDctMzFUMTY6NTA6MDYuMzUwNjI2ODQ1Wl8x | 
|   nonLinearAds  |  Nichtlineare Anzeigen, die neben dem Videoinhalt erscheinen.  | Array | [] | 
|   nonLinearAdsList  |  Liste der nichtlinearen Anzeigen.  | Array | [] | 
|   scalable  |  Gibt an, ob das Video auf andere Dimensionen skaliert werden soll.  | Boolesch | true | 
|   skipOffset  |  Der Zeitwert, der angibt, wann der Player dem Benutzer Steuerelemente zum Überspringen zur Verfügung stellt.  | Zeichenfolge | 00:00:05 | 
|   staticResource  |  Die URL zu einer statischen kreativen Datei, die für die Anzeigenkomponente verwendet wird. Pfad: `/avails/ads/companionAds/staticResource`  | Zeichenfolge | https://very-interactive-ads.com/campaign1/file.json?c=1019113602 | 
|   vastAdId  |  Der `Id` Attributwert des `Ad` Tags.  | Zeichenfolge | ad1 | 
|   width  |  Die Breite des Video-Assets in Pixeln.  | Zeichenfolge | 640 | 
|   xPosition  |  Die horizontale Position eines Symbols im Videoplayer. Dies kann ein bestimmter Pixelwert oder eine Position wie „links“ oder „rechts“ sein. Pfad: `/avails/ads/icons/attributes/xPosition`  | Zeichenfolge | left oder 10 | 
|   yPosition  |  Die vertikale Position eines Symbols im Videoplayer. Dies kann ein bestimmter Pixelwert oder eine Position wie „oben“ oder „unten“ sein. Pfad: `/avails/ads/icons/attributes/yPosition`  | Zeichenfolge | top oder 10 | 
|   iconClicks  |  Enthält Informationen zum Durchklicken und zur Nachverfolgung eines Symbols. Pfad: `/avails/ads/icons/iconClicks`  | Objekt |  | 
|   iconClickThrough  |  Eine URL zur Seite des Werbetreibenden, die der Media Player öffnet, wenn der Zuschauer auf das Symbol klickt. Pfad: `/avails/ads/icons/iconClicks/iconClickThrough`  | Zeichenfolge | https://advertiser.com/landing-page | 
|   iconClickTracking  |  Die Tracking-URL für die `iconClickThrough` Immobilie. Pfad: `/avails/ads/icons/iconClicks/iconClickTracking`  | Objekt |  | 
|   iconClickFallbackImages  |  Eine Reihe von Ersatzbildern, die angezeigt werden sollen, falls das Symbol nicht angezeigt werden kann. Pfad: `/avails/ads/icons/iconClicks/iconClickFallbackImages`  | Array |  | 
|   iconViewTracking  |  Die URL für die Nachverfolgung, wenn ein Symbol angezeigt wird. Pfad: `/avails/ads/icons/iconViewTracking`  | Zeichenfolge | https://tracking.example.com/icon-view | 
|   offset  |  Der Zeitversatz, zu dem ein Symbol während der Anzeigenwiedergabe erscheinen soll. Pfad: `/avails/ads/icons/attributes/offset`  | Zeichenfolge | 00:00:05 | 
|   program  |  Das Programm oder die Initiative, die mit dem Symbol verknüpft ist, z. B. "AdChoices“. Pfad: `/avails/ads/icons/attributes/program`  | Zeichenfolge | AdChoices | 
|   pxratio  |  Das Pixelverhältnis für das Symbol oder die Begleitanzeige, das für Displays mit hohem DPI-Wert verwendet wird. Pfad: oder `/avails/ads/icons/attributes/pxratio` `/avails/ads/companionAds/attributes/pxratio`  | Zeichenfolge | 1 oder 2 | 
|   type  |  Der Typ der Ressource oder Erweiterung. Pfad: `/avails/ads/extensions/type` oder `/avails/ads/adVerifications/executableResource/type`  | Zeichenfolge | text/javascript | 
|   content  |  Der Inhalt einer Erweiterung. Pfad: `/avails/ads/extensions/content`  | Zeichenfolge |  | 
|   language  |  Die Programmiersprache einer ausführbaren Ressource. Pfad: `/avails/ads/adVerifications/executableResource/language`  | Zeichenfolge | javascript | 
|   browserOptional  |  Gibt an, ob Browserunterstützung für die JavaScript Ressource erforderlich ist. Pfad: `/avails/ads/adVerifications/javaScriptResource/browserOptional`  | Zeichenfolge | true oder false | 
|   id  |  Ein Bezeichner für verschiedene Elemente im Schema. Pfad: `/avails/ads/companionAds/attributes/id` oder `/avails/ads/icons/iconClicks/iconClickTracking/id`  | Zeichenfolge | companion-1 | 
|   assetHeight  |  Die Höhe der Begleitperson und des Assets. Pfad: `/avails/ads/companionAds/attributes/assetHeight`  | Zeichenfolge | 250 | 
|   assetWidth  |  Die Breite des Begleit-Assets. Pfad: `/avails/ads/companionAds/attributes/assetWidth`  | Zeichenfolge | 300 | 
|   expandedHeight  |  Die Höhe der Begleitanzeige im erweiterten Zustand. Pfad: `/avails/ads/companionAds/attributes/expandedHeight`  | Zeichenfolge | 600 | 
|   expandedWidth  |  Die Breite der Begleitanzeige, wenn sie erweitert wird. Pfad: `/avails/ads/companionAds/attributes/expandedWidth`  | Zeichenfolge | 600 | 
|   renderingMode  |  Der Rendermodus für die Begleitanzeige. Pfad: `/avails/ads/companionAds/attributes/renderingMode`  | Zeichenfolge | default oder transparent | 
|   adSlotId  |  Die ID der Werbefläche, in der die Begleitanzeige angezeigt werden soll. Pfad: `/avails/ads/companionAds/attributes/adSlotId`  | Zeichenfolge | banner-1 | 
|   creativeType  |  Der MIME-Typ des kreativen Assets. Pfad: `/avails/ads/icons/staticResource/creativeType`  | Zeichenfolge | image/png | 

# Zeitlicher Ablauf der Aktivitäten bei der Anzeigenverfolgung
<a name="ad-reporting-client-side-ad-tracking-schema-activity-timing"></a>

Bei der clientseitigen Berichterstattung muss der Spieler Tracking-Ereignisse (Beacons) mit einer gewissen Genauigkeit aussenden. Mithilfe des MediaTailor clientseitigen Tracking-Schemas können Sie sicherstellen, dass für alle Verfügbarkeits-, Anzeige-, Begleitungs-, Overlay- und Tracking-Ereignisse Informationen zum Zeitpunkt und zur Dauer vorliegen, und zwar in unterschiedlicher Form.

Verwenden Sie die folgenden MediaTailor Schlüssel/Wert-Paare für den Player, um Werbeereignisse, wie z. B. das Verfolgen von Ereignissen, genau mit der Wiedergabeposition in Einklang zu bringen:
+ [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 und DASH implementieren den Wert von und unterschiedlich: `startTime` `startTimeInSeconds`
+ HLS — Die `startTime` Werte beziehen sich auf den Beginn der Wiedergabe-Sitzung. Der Beginn der Wiedergabe-Sitzung ist als Zeit Null definiert. Bei der Anzeige `startTime` handelt es sich um die Summe der kumulierten Werte aller `EXT-INF` Segmentdauern, die bis zur Veröffentlichung geführt haben. Die Mediensequenznummer des Segments, auf das sich die Anzeige oder das Tracking-Ereignis bezieht, entspricht auch dem `adId` oder `eventId` in der clientseitigen Tracking-Antwort.
+ DASH:
  + Live/dynamische Manifeste — Die `startTime` Werte beziehen sich auf die Werte des DASH-Manifests`MPD@availabilityStartTime`. Der `MPD@avaibilityStartTime` ist ein Timing-Anker für alle MediaTailor Sessions, die den Stream nutzen.
  + VOD/statische Manifeste — Die `startTime` Werte beziehen sich auf den Beginn der Wiedergabe-Sitzung. Der Beginn der Wiedergabesitzung ist als Zeitpunkt Null definiert. Jede Anzeige im Avail ist in einem eigenen `Period` Element enthalten. Das `Period` Element hat ein `@start` Attribut mit einem Wert, der den `startTime` Werten in der clientseitigen Tracking-Payload entspricht. Das entspricht `PeriodId` auch dem `adId` oder `eventId` in der clientseitigen Tracking-Antwort.

**Example HLS:**  
Im folgenden Beispiel wurde die MediaTailor Sitzung gestartet, und das folgende Manifest ist das erste, das dem Client zugestellt wird:  

```
#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
```
In der JSON-Nutzlast für die clientseitige Nachverfolgung gelten die folgenden Werte:  
+  `startTime`: `"PT18.581355S"` 
+  `startTimeInSeconds`: `18.581` 
+  `availProgramDateTime`: `"2023-05-03T21:24:41.453Z"` 
+  `adId`: `4603269` 

**Example DASH:**  
Im folgenden Beispiel erhält die MediaTailor Sitzung eine Midroll im Manifest. Beachten Sie, dass der `@start` Attributwert der zweiten Periode, bei der es sich um den Anzeigenzeitraum handelt, einen Wert hat, der `MPD@availabilityStartTime` relativ zum Wert ist. Dieser Wert wird für alle Sitzungen in die clientseitigen `startTime` Tracking-Antwortfelder MediaTailor geschrieben.  

```
<?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>
```
In der JSON-Nutzlast für clientseitiges Tracking gelten die folgenden Werte:  
+  `startTime`: `"PT5042H27M59.931S"` 
+  `startTimeInSeconds`: `18152879.931` 
+  `availProgramDateTime`: *null* 
+  `adId`: `1683151599194_1_1` 

# Player-Bedienelemente und Funktionen für das clientseitige Ad-Tracking
<a name="ad-reporting-client-side-ad-tracking-schema-player-controls"></a>

MediaTailor Die clientseitigen Tracking-Metadaten unterstützen verschiedene Player-Steuerelemente und Funktionen. In der folgenden Liste werden beliebte Player-Steuerelemente beschrieben.

**Topics**
+ [Schrubben](#ad-reporting-client-side-ad-tracking-schema-player-controls-scrubbing)
+ [Countdown-Timer hinzufügen](#ad-reporting-client-side-ad-tracking-schema-player-controls-ad-countdown-timer)
+ [Überspringbare Anzeigen](#ad-reporting-client-side-ad-tracking-schema-player-controls-skippable-ads)
+ [Und Click-through](#ad-reporting-client-side-ad-tracking-schema-player-controls-ad-clickthrough)
+ [Begleitende Anzeigen](#ad-reporting-client-side-ad-tracking-schema-player-controls-companion-ads)
+ [Interaktive Anzeigen (SIMID)](#ad-reporting-client-side-ad-tracking-schema-player-controls-simid-ads)
+ [Interaktive Werbung (VPAID)](#ad-reporting-client-side-ad-tracking-schema-player-controls-vpaid-ads)
+ [Symbole für Google Warum diese Anzeige (WTA)](#ad-reporting-client-side-ad-tracking-schema-player-controls-google-wta)

## Schrubben
<a name="ad-reporting-client-side-ad-tracking-schema-player-controls-scrubbing"></a>

Um das Wiedergabeerlebnis zu verbessern, kann der Player Anzeigenpositionen in der Wiedergabe-Timeline anzeigen. MediaTailor stellt diese Anzeigenpositionen in Form von `startTimeInSeconds` Werten in der clientseitigen Tracking-Antwort zur Verfügung.

**Anmerkung**  
Einige Streaming-Anbieter verhindern, dass Sie über eine Anzeigenposition hinausgehen.

![\[Screenshot, der die MediaTailor Markierungspositionen in der Video-Timeline zeigt, an denen Werbung abgespielt wird.\]](http://docs.aws.amazon.com/de_de/mediatailor/latest/ug/images/scrubbing.png)


Die folgende JSON-Antwort auf die clientseitige Tracking-Nutzlast zeigt die Startzeit der Verfügbarkeit (Werbeunterbrechung) innerhalb des JSON-Stammobjekts des Avails-Arrays. Der Player verwendet diese Daten, um den Ort der Werbeunterbrechung in der Player-Zeitleiste anzuzeigen, und zwar nach 28 Sekunden.

```
{
  "avails": [
    {
      "adBreakTrackingEvents": [],
      "adMarkerDuration": null,
      "ads": [...],
      "availId": "7",
      "availProgramDateTime": null,
      "duration": "PT30S",
      "durationInSeconds": 30,
      "meta": null,
      "nonLinearAdsList": [],
      "startTime": "PT28S",
      "startTimeInSeconds": 28
    }
  ],
  "dashAvailabilityStartTime": null,
  "hlsAnchorMediaSequenceNumber": null,
  "nextToken": "UFQxMk0zNC44NjhTXzIwMjMtMDctMjFUMjA6MjM6MDcuNzc1NzE2MzAyWl8x",
  "nonLinearAvails": []
}
```

## Countdown-Timer hinzufügen
<a name="ad-reporting-client-side-ad-tracking-schema-player-controls-ad-countdown-timer"></a>

Mithilfe eines Countdown-Timers für Werbeanzeigen können MediaTailor Sie dafür sorgen, dass Ihr Publikum während der Werbepause bei der Stange bleibt. Anhand des Timers kann die Zielgruppe nachvollziehen, wann die Werbepause endet und ihr Programm wieder aufgenommen wird.

![\[Screenshot, auf dem ein Countdown-Timer für die Anzeige angezeigt MediaTailor wird, der der Zielgruppe die verbleibende Zeit bis zur Wiederaufnahme des Programms mitteilt.\]](http://docs.aws.amazon.com/de_de/mediatailor/latest/ug/images/ad-countdown-timer.png)


Die Elemente in den clientseitigen Tracking-Metadaten, die für den Countdown-Timer der Anzeige eine Rolle spielen, sind`startTime`, und. `startTimeInSeconds` `duration` `durationInSeconds` Der Player verwendet diese Metadaten zusammen mit der verstrichenen Sitzungszeit, die er separat verfolgt, um zu bestimmen, wann der Timer angezeigt werden soll und ab welchem Wert er herunterzählen soll.

Die folgende JSON-Antwort auf die clientseitige Tracking-Payload zeigt die Informationen, die für die Anzeige eines Countdown-Timers für Anzeigen erforderlich sind.

```
{
  "avails": [
    {
      "adBreakTrackingEvents": [],
      "adMarkerDuration": null,
      "ads": [...],
      "availId": "7",
      "availProgramDateTime": null,
      "duration": "PT30S",
      "durationInSeconds": 30,
      "meta": null,
      "nonLinearAdsList": [],
      "startTime": "PT28S",
      "startTimeInSeconds": 28
    }
  ],
  "dashAvailabilityStartTime": null,
  "hlsAnchorMediaSequenceNumber": null,
  "nextToken": "UFQxMk0zNC44NjhTXzIwMjMtMDctMjFUMjA6MjM6MDcuNzc1NzE2MzAyWl8x",
  "nonLinearAvails": []
}
```

Wenn die verstrichene Zeit der Sitzung die Startzeit des Avails erreicht, zeigt der Player einen Countdown-Timer mit einem Wert an, der der Dauer der Verfügbarkeit entspricht. Der Wert des Countdown-Timers nimmt ab, wenn die verstrichene Zeit die Startzeit des Avails überschreitet.

**Example Formel: Countdown-Timer für HLS (Live und VOD) und DASH (VOD)**  
+ `session_start_time`= die Summe aller `EXT-INF` Dauerwerte - der Dauerwert der drei neuesten Mediensequenzen `EXT-INF`
+ Timer-Wert = `duration` - (`session_elapsed_time`-`startTime`)

![\[Diagramm, das die Berechnung des Countdown-Timers für Anzeigen auf der Grundlage der Startzeit der Sitzung und der Startzeit der Verfügbarkeit für HLS- (Live- und VOD) - und DASH-Manifeste (VOD) zeigt.\]](http://docs.aws.amazon.com/de_de/mediatailor/latest/ug/images/ad-countdown-timer-hls-dash-vod.png)


**Example Formel: Countdown-Timer für DASH (live)**  
+ `session_start_time`= (neuestes Segment `startTime` \$1`duration`)/`timescale`- `MPD@suggestedPresentationDelay`
+ Timer-Wert = `duration` - (`session_elapsed_time`-`startTime`)

![\[Diagramm, das die Berechnung des Countdown-Timers für Anzeigen auf der Grundlage der Startzeit der Sitzung und der Startzeit der Verfügbarkeit für Live-DASH-Manifeste zeigt.\]](http://docs.aws.amazon.com/de_de/mediatailor/latest/ug/images/ad-countdown-timer-dash-live.png)


## Überspringbare Anzeigen
<a name="ad-reporting-client-side-ad-tracking-schema-player-controls-skippable-ads"></a>

*Überspringbare Anzeigen sind Werbespots*, die es dem Zuschauer ermöglichen, einen Teil der Anzeige zu überspringen, um das Programm wieder anzusehen. In VAST identifiziert das `Linear@skipOffset` Attribut eine Anzeige, die übersprungen werden kann. 

Die folgende VAST-Antwort zeigt, wie eine überspringbare Anzeige verwendet wird:

```
<?xml version="1.0" encoding="UTF-8"?>
<VAST xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="vast.xsd" version="3.0">
  <Ad>
    <InLine>
      ...
      <Creatives>
        <Creative id="1" sequence="1">
          <Linear skipoffset="00:00:05">
            <Duration>00:00:15</Duration>
            <MediaFiles>
              <MediaFile id="EMT" delivery="progressive" width="640" height="360" type="video/mp4" bitrate="143" scalable="true" maintainAspectRatio="true"><![CDATA[https://ads.com/file.mp4]]></MediaFile>
            </MediaFiles>
          </Linear>
        </Creative>
      </Creatives>
      ...
    </InLine>
  </Ad>
</VAST>
```

Die folgende JSON-Antwort für die clientseitige Tracking-Nutzlast zeigt die Anzeigenmetadaten innerhalb des Arrays. `ads` Das Array enthält den `skipOffset` Wert, der aus der MediaTailor VAST-Antwort abgerufen wurde.

```
{
  "avails": [
    {
      "adBreakTrackingEvents": [],
      "adMarkerDuration": null,
      "ads": [
        {
          "adId": "1",
          "adParameters": "",
          "adProgramDateTime": "2023-07-31T16:11:40.693Z",
          "adSystem": "2.0",
          "adTitle": "AD-skiing-15",
          "adVerifications": [],
          "companionAds": [...],
          "creativeId": "1",
          "creativeSequence": "1",
          "duration": "PT15.015S",
          "durationInSeconds": 15.015,
          "extensions": [],
          "mediaFiles": {
            "mediaFilesList": [],
            "mezzanine": ""
          },
          "skipOffset": "00:00:05",
          "startTime": "PT9.943S",
          "startTimeInSeconds": 9.943,
          "trackingEvents": [
            {
              "beaconUrls": [
                "https://adserverbeaconing.com/v1/impression"
              ],
              "duration": "PT15.015S",
              "durationInSeconds": 15.015,
              "eventId": "2697726",
              "eventProgramDateTime": null,
              "eventType": "impression",
              "startTime": "PT9.943S",
              "startTimeInSeconds": 9.943
            }
          ],
          "vastAdId": ""
        }
      ],
      "availId": "2697726",
      "availProgramDateTime": "2023-07-31T16:11:40.693Z",
      "duration": "PT15.015S",
      "durationInSeconds": 15.015,
      "meta": null,
      "nonLinearAdsList": [],
      "startTime": "PT9.943S",
      "startTimeInSeconds": 9.943
    }
  ],
  "dashAvailabilityStartTime": null,
  "hlsAnchorMediaSequenceNumber": null,
  "nextToken": "",
  "nonLinearAvails": []
}
```

## Und Click-through
<a name="ad-reporting-client-side-ad-tracking-schema-player-controls-ad-clickthrough"></a>

Mithilfe von Click-Through URIs können Werbetreibende messen, wie erfolgreich eine Anzeige die Aufmerksamkeit der Zuschauer auf sich zieht. Nachdem ein Zuschauer auf den aktiven Videoframe einer laufenden Anzeige geklickt hat, öffnet ein Webbrowser den URI für die Startseite oder Kampagnen-Landingpage des Werbetreibenden. Der Player-Entwickler bestimmt das Klickverhalten, z. B. das Überlagern einer Schaltfläche oder eines Labels auf dem Werbevideo mit einer Meldung, auf die Sie klicken müssen, um mehr zu erfahren. Player-Entwickler pausieren das Video der Anzeige häufig, nachdem Zuschauer auf den aktiven Videoframe geklickt haben.

![\[Screenshot eines Klicks auf eine Anzeige in einem Videoplayer. Zuschauer klicken auf den Videoframe. Der Player pausiert das Video und öffnet dann einen Webbrowser, um den Zuschauer zur Startseite oder Kampagnen-Landingpage des Werbetreibenden zu leiten.\]](http://docs.aws.amazon.com/de_de/mediatailor/latest/ug/images/ad-clickthrough.png)


MediaTailor kann jedes lineare Video-Klick-Through-Ereignis, das in der VAST-Antwort URLs zurückgegeben wurde, analysieren und verfügbar machen. Die folgende VAST-Antwort zeigt ein Beispiel für einen Klick auf eine Anzeige.

```
<?xml version="1.0" encoding="UTF-8"?>
<VAST xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="vast.xsd" version="3.0">
  <Ad>
    <InLine>
      ...
      <Creatives>
        <Creative id="1" sequence="1">
          <Linear>
            <Duration>00:00:15</Duration>
            <MediaFiles>
              <MediaFile id="EMT" delivery="progressive" width="1280" height="720" type="video/mp4" bitrate="143" scalable="true" maintainAspectRatio="true"><![CDATA[https://ads.com/file.mp4]]></MediaFile>
            </MediaFiles>
            <VideoClicks>
              <ClickThrough id="EMT"><![CDATA[https://aws.amazon.com]]></ClickThrough>
              <ClickTracking id="EMT"><![CDATA[https://myads.com/beaconing/event=clicktracking]]></ClickTracking>
            </VideoClicks>
          </Linear>
        </Creative>
      </Creatives>
      ...
    </InLine>
  </Ad>
</VAST>
```

Die folgende JSON-Antwort für die clientseitige Tracking-Payload zeigt, wie Click-Through und Click-Tracking MediaTailor innerhalb des Arrays dargestellt werden. URLs `trackingEvents` Der `clickThrough` Ereignistyp steht für die Click-Through-Anzeige, und der Ereignistyp steht für die Click-Tracking-URL. `clickTracking`

```
{
  "avails": [
    {
      "adBreakTrackingEvents": [],
      "adMarkerDuration": null,
      "ads": [
        {
          "adId": "1",
          "adParameters": "",
          "adProgramDateTime": "2023-07-31T16:53:40.577Z",
          "adSystem": "2.0",
          "adTitle": "1",
          "adVerifications": [],
          "companionAds": [],
          "creativeId": "00006",
          "creativeSequence": "1",
          "duration": "PT14.982S",
          "durationInSeconds": 14.982,
          "extensions": [],
          "mediaFiles": {
            "mediaFilesList": [],
            "mezzanine": ""
          },
          "skipOffset": null,
          "startTime": "PT39.339S",
          "startTimeInSeconds": 39.339,
          "trackingEvents": [
            {
              "beaconUrls": [
                "https://myads.com/beaconing/event=impression"
              ],
              "duration": "PT14.982S",
              "durationInSeconds": 14.982,
              "eventId": "2698188",
              "eventProgramDateTime": null,
              "eventType": "impression",
              "startTime": "PT39.339S",
              "startTimeInSeconds": 39.339
            },
            {
              "beaconUrls": [
                "https://aws.amazon.com"
              ],
              "duration": "PT14.982S",
              "durationInSeconds": 14.982,
              "eventId": "2698188",
              "eventProgramDateTime": null,
              "eventType": "clickThrough",
              "startTime": "PT39.339S",
              "startTimeInSeconds": 39.339
            },
            {
              "beaconUrls": [
                "https://myads.com/beaconing/event=clicktracking"
              ],
              "duration": "PT14.982S",
              "durationInSeconds": 14.982,
              "eventId": "2698795",
              "eventProgramDateTime": null,
              "eventType": "clickTracking",
              "startTime": "PT39.339S",
              "startTimeInSeconds": 39.339
            }
          ],
          "vastAdId": ""
        }
      ],
      "availId": "2698188",
      "availProgramDateTime": "2023-07-31T16:53:40.577Z",
      "duration": "PT14.982S",
      "durationInSeconds": 14.982,
      "meta": null,
      "nonLinearAdsList": [],
      "startTime": "PT39.339S",
      "startTimeInSeconds": 39.339
    }
  ],
  "dashAvailabilityStartTime": null,
  "hlsAnchorMediaSequenceNumber": null,
  "nextToken": "UFQzOS4zMzlTXzIwMjMtMDctMzFUMTY6NTQ6MDQuODA1Mzk2NTI5Wl8x",
  "nonLinearAvails": []
}
```

## Begleitende Anzeigen
<a name="ad-reporting-client-side-ad-tracking-schema-player-controls-companion-ads"></a>

Eine *Begleitanzeige* erscheint zusammen mit einem linearen Werbemittel. Verwenden Sie Begleitanzeigen, um die Effektivität eines Werbespots zu erhöhen, indem Sie Produkt-, Logo- und Markeninformationen anzeigen. Die Display-Anzeige kann QR-Codes (Quick Response) und anklickbare Bereiche enthalten, um das Engagement der Zuschauer zu fördern.

MediaTailor unterstützt Begleitanzeigen in der VAST-Antwort. Es kann Metadaten von `StaticResource``iFrameResource`, bzw. `HTMLResource` Knoten übertragen.

Die folgende VAST-Antwort zeigt ein Beispiel für Position und Format der linearen Anzeige und der Begleitanzeige.

```
<?xml version="1.0" encoding="UTF-8"?>
<VAST xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="vast.xsd" version="3.0">
  <Ad>
    <InLine>
      ...
      <Creatives>
        <Creative id="1" sequence="1">
          <Linear>
            <Duration>00:00:10</Duration>
            <MediaFiles>
              <MediaFile id="EMT" delivery="progressive" width="640" height="360" type="video/mp4" bitrate="143" scalable="true" maintainAspectRatio="true"><![CDATA[https://ads.com/file.mp4]]></MediaFile>
            </MediaFiles>
          </Linear>
        </Creative>
        <Creative id="2" sequence="1">
          <CompanionAds>
            <Companion id="2" width="300" height="250">
              <StaticResource creativeType="image/png"><![CDATA[https://emt.com/companion/9973499273]]></StaticResource>
              <TrackingEvents>
                <Tracking event="creativeView"><![CDATA[https://beacon.com/1]]></Tracking>
              </TrackingEvents>
              <CompanionClickThrough><![CDATA[https://beacon.com/2]]></CompanionClickThrough>
            </Companion>
            <Companion id="3" width="728" height="90">
              <StaticResource creativeType="image/png"><![CDATA[https://emt.com/companion/1238901823]]></StaticResource>
              <TrackingEvents>
                <Tracking event="creativeView"><![CDATA[https://beacon.com/3]]></Tracking>
              </TrackingEvents>
              <CompanionClickThrough><![CDATA[https://beacon.com/4]]></CompanionClickThrough>
            </Companion>
          </CompanionAds>
        </Creative>
      </Creatives>
      ...
    </InLine>
  </Ad>
</VAST>
```

Die Daten werden in der clientseitigen Tracking-Antwort in der `/avail/x/ads/y/companionAds` Liste angezeigt. Jedes lineare Werbemittel kann bis zu 6 Begleitanzeigen enthalten. Wie im Beispiel unten gezeigt, werden die Begleitanzeigen in einer Liste angezeigt

**Anmerkung**  
Als bewährte Methode sollten Anwendungsentwickler eine Logik implementieren, mit der die Begleitanzeige am Ende der Werbeaktion explizit entfernt oder entfernt wird.

```
{
  "avails": [
    {
      "adBreakTrackingEvents": [],
      "adMarkerDuration": null,
      "ads": [
        {
          "adId": "0",
          "adParameters": "",
          "adProgramDateTime": null,
          "adSystem": "EMT",
          "adTitle": "sample",
          "adVerifications": [],
          "companionAds": [
            {
              "adParameters": null,
              "altText": null,
              "attributes": {
                "adSlotId": null,
                "apiFramework": null,
                "assetHeight": null,
                "assetWidth": null,
                "expandedHeight": null,
                "expandedWidth": null,
                "height": "250",
                "id": "2",
                "pxratio": null,
                "renderingMode": null,
                "width": "300"
              },
              "companionClickThrough": "https://beacon.com/2",  
              "companionClickTracking": null,
              "htmlResource": null,
              "iFrameResource": null,
              "sequence": "1",
              "staticResource": "https://emt.com/companion/9973499273",
              "trackingEvents": [
                {
                  "beaconUrls": [
                    "https://beacon.com/1"
                  ],
                  "eventType": "creativeView"
                }
              ]
            },
            {
              "adParameters": null,
              "altText": null,
              "attributes": {
                "adSlotId": null,
                "apiFramework": null,
                "assetHeight": null,
                "assetWidth": null,
                "expandedHeight": null,
                "expandedWidth": null,
                "height": "90",
                "id": "3",
                "pxratio": null,
                "renderingMode": null,
                "width": "728"
              },
              "companionClickThrough": "https://beacon.com/4",
              "companionClickTracking": null,
              "htmlResource": null,
              "iFrameResource": null,
              "sequence": "1",
              "staticResource": "https://emt.com/companion/1238901823",
              "trackingEvents": [
                {
                  "beaconUrls": [
                    "https://beacon.com/3"
                  ],
                  "eventType": "creativeView"
                }
              ]
            }
          ],
          "creativeId": "1",
          "creativeSequence": "1",
          "duration": "PT10S",
          "durationInSeconds": 10,
          "extensions": [],
          "mediaFiles": {
            "mediaFilesList": [],
            "mezzanine": ""
          },
          "skipOffset": null,
          "startTime": "PT0S",
          "startTimeInSeconds": 0,
          "trackingEvents": [
            {
              "beaconUrls": [
                "https://beacon.com/impression/1"
              ],
              "duration": "PT10S",
              "durationInSeconds": 10,
              "eventId": "0",
              "eventProgramDateTime": null,
              "eventType": "impression",
              "startTime": "PT0S",
              "startTimeInSeconds": 0
            }
          ],
          "vastAdId": ""
        }
      ],
      "availId": "0",
      "availProgramDateTime": null,
      "duration": "PT10S",
      "durationInSeconds": 10,
      "meta": null,
      "nonLinearAdsList": [],
      "startTime": "PT0S",
      "startTimeInSeconds": 0
    }
  ],
  "dashAvailabilityStartTime": null,
  "hlsAnchorMediaSequenceNumber": null,
  "nextToken": "UFQxMFNfMjAyMy0wNy0wNlQyMToxMDowOC42NzQ4NDA1NjJaXzE%3D",
  "nonLinearAvails": []
}
```

## Interaktive Anzeigen (SIMID)
<a name="ad-reporting-client-side-ad-tracking-schema-player-controls-simid-ads"></a>

*SecureInteractive Media Interface Definition* (SIMID) ist ein Standard für interaktive Werbung, der im VAST 4.x-Standard des Interactive Advertising Bureau (IAB) eingeführt wurde. SIMID entkoppelt das Laden interaktiver Elemente vom primären linearen Werbematerial auf dem Player und bezieht sich in der VAST-Antwort auf beide. MediaTailor fügt das primäre Creative hinzu, um das Wiedergabeerlebnis aufrechtzuerhalten, und platziert Metadaten für die interaktiven Komponenten in der clientseitigen Tracking-Antwort.

In der folgenden VAST-4-Beispielantwort befindet sich die SIMID-Nutzlast innerhalb des Knotens. `InteractiveCreativeFile`

```
<?xml version="1.0"?>
<VAST xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="vast.xsd" version="3.0">
  <Ad id="1234567">
    <InLine>
      <AdSystem>SampleAdSystem</AdSystem>
      <AdTitle>Linear SIMID Example</AdTitle>
      <Description>SIMID example</Description>
      <Error>https://www.beacons.com/error</Error>
      <Impression>https://www.beacons.com/impression</Impression>
      <Creatives>
        <Creative sequence="1">
          <Linear>
            <Duration>00:00:15</Duration>
            <TrackingEvents>
                ...
            </TrackingEvents>
            <VideoClicks>
              <ClickThrough id="123">https://aws.amazon.com</ClickThrough>
              <ClickTracking id="123">https://www.beacons.com/click</ClickTracking>
            </VideoClicks>
            <MediaFiles>
              <MediaFile delivery="progressive" type="video/mp4">
                                https://interactive-ads.com/interactive-media-ad-sample/media/file.mp4
                            </MediaFile>
              <InteractiveCreativeFile type="text/html" apiFramework="SIMID" variableDuration="true">
                                https://interactive-ads.com/interactive-media-ad-sample/sample_simid.html
                            </InteractiveCreativeFile>
            </MediaFiles>
          </Linear>
        </Creative>
      </Creatives>
    </InLine>
  </Ad>
</VAST>
```

In der folgenden VAST-3-Antwort befindet sich die SIMID-Nutzlast innerhalb des Knotens. `Extensions`

```
<?xml version="1.0"?>
<VAST xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="vast.xsd" version="3.0">
  <Ad id="1234567">
    <InLine>
      <AdSystem>SampleAdSystem</AdSystem>
      <AdTitle>Linear SIMID Example</AdTitle>
      <Description>SIMID example</Description>
      <Impression>https://www.beacons.com/impression</Impression>
      <Creatives>
        <Creative id="1" sequence="1">
          <Linear>
            <Duration>00:00:15</Duration>
            <TrackingEvents>
                ...
            </TrackingEvents>
            <VideoClicks>
              <ClickThrough id="123">https://aws.amazon.com</ClickThrough>
              <ClickTracking id="123">https://myads.com/beaconing/event=clicktracking</ClickTracking>
            </VideoClicks>
            <MediaFiles>
              <MediaFile delivery="progressive" type="video/mp4">
                                https://interactive-ads.com/interactive-media-ad-sample/media/file.mp4
                            </MediaFile>
            </MediaFiles>
          </Linear>
        </Creative>
      </Creatives>
      <Extensions>
        <Extension type="InteractiveCreativeFile">
          <InteractiveCreativeFile type="text/html" apiFramework="SIMID" variableDuration="true">
            https://interactive-ads.com/interactive-media-ad-sample/sample_simid.html
          </InteractiveCreativeFile>
        </Extension>
      </Extensions>
    </InLine>
  </Ad>
</VAST>
```

In der folgenden clientseitigen Tracking-Antwort werden die SIMID-Daten in der Liste angezeigt. `/avails/x/ads/y/extensions`

```
{
  "avails": [
    {
      "adBreakTrackingEvents": [],
      "adMarkerDuration": null,
      "ads": [
        {
          "adId": "1",
          "adParameters": "",
          "adProgramDateTime": "2023-07-31T16:53:40.577Z",
          "adSystem": "2.0",
          "adTitle": "Linear SIMID Example",
          "adVerifications": [],
          "companionAds": [],
          "creativeId": "1",
          "creativeSequence": "1",
          "duration": "PT14.982S",
          "durationInSeconds": 14.982,
          "extensions": [
            {
              "content": "<InteractiveCreativeFile type=\"text/html\" apiFramework=\"SIMID\" variableDuration=\"true\">\nhttps://interactive-ads.com/interactive-media-ad-sample/sample_simid.html</InteractiveCreativeFile>",
              "type": "InteractiveCreativeFile"
            }
          ],
          "mediaFiles": {
            "mediaFilesList": [],
            "mezzanine": ""
          },
          "skipOffset": null,
          "startTime": "PT39.339S",
          "startTimeInSeconds": 39.339,
          "trackingEvents": [
            {
              "beaconUrls": [
                "https://myads.com/beaconing/event=impression"
              ],
              "duration": "PT14.982S",
              "durationInSeconds": 14.982,
              "eventId": "2698188",
              "eventProgramDateTime": null,
              "eventType": "impression",
              "startTime": "PT39.339S",
              "startTimeInSeconds": 39.339
            },
            {
              "beaconUrls": [
                "https://aws.amazon.com"
              ],
              "duration": "PT14.982S",
              "durationInSeconds": 14.982,
              "eventId": "2698188",
              "eventProgramDateTime": null,
              "eventType": "clickThrough",
              "startTime": "PT39.339S",
              "startTimeInSeconds": 39.339
            },
            {
              "beaconUrls": [
                "https://myads.com/beaconing/event=clicktracking"
              ],
              "duration": "PT14.982S",
              "durationInSeconds": 14.982,
              "eventId": "2698795",
              "eventProgramDateTime": null,
              "eventType": "clickTracking",
              "startTime": "PT39.339S",
              "startTimeInSeconds": 39.339
            }
          ],
          "vastAdId": ""
        }
      ],
      "availId": "2698188",
      "availProgramDateTime": "2023-07-31T16:53:40.577Z",
      "duration": "PT14.982S",
      "durationInSeconds": 14.982,
      "meta": null,
      "nonLinearAdsList": [],
      "startTime": "PT39.339S",
      "startTimeInSeconds": 39.339
    }
  ],
  "dashAvailabilityStartTime": null,
  "hlsAnchorMediaSequenceNumber": null,
  "nextToken": "UFQzOS4zMzlTXzIwMjMtMDctMzFUMTY6NTQ6MDQuODA1Mzk2NTI5Wl8x",
  "nonLinearAvails": []
}
```

## Interaktive Werbung (VPAID)
<a name="ad-reporting-client-side-ad-tracking-schema-player-controls-vpaid-ads"></a>

Die *Video Player Ad Interface Definition* (VPAID) spezifiziert das Protokoll zwischen der Anzeige und dem Videoplayer, das Anzeigeninteraktivität und andere Funktionen ermöglicht. MediaTailor Unterstützt bei Live-Streams das VPAID-Format, indem Slate-Segmente für die Dauer des Angebots zusammengefügt und Metadaten für die VPAID-Kreativen in die clientseitige Tracking-Antwort eingefügt werden, die der Videoplayer verarbeitet. Der Player lädt die VPAID-Dateien herunter, spielt das lineare Creative ab und führt die Skripte des Kunden aus. Der Spieler sollte *niemals* die Slate-Segmente spielen.

**Anmerkung**  
VPAID ist ab VAST 4.1 veraltet.

![\[Diagramm der VPAID-Anzeigenwiedergabe. MediaTailor fügt in der Inhalts-Timeline Segmente für die Dauer der Verfügbarkeit zusammen. Der Spieler wechselt für die Dauer der Verfügbarkeit zum VPAID-Asset.\]](http://docs.aws.amazon.com/de_de/mediatailor/latest/ug/images/interactive-ads-vpaid.png)


Das folgende Beispiel zeigt den VPAID-Inhalt in der VAST-Antwort.

```
<?xml version="1.0"?>
<VAST xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="vast.xsd" version="3.0">
  <Ad id="1234567">
    <InLine>
      <AdSystem>GDFP</AdSystem>
      <AdTitle>VPAID</AdTitle>
      <Description>Vpaid Linear Video Ad</Description>
      <Error>http://www.example.com/error</Error>
      <Impression>http://www.example.com/impression</Impression>
      <Creatives>
        <Creative sequence="1">
          <Linear>
            <Duration>00:00:00</Duration>
            <TrackingEvents>
              <Tracking event="start">http://www.example.com/start</Tracking>
              <Tracking event="firstQuartile">http://www.example.com/firstQuartile</Tracking>
              <Tracking event="midpoint">http://www.example.com/midpoint</Tracking>
              <Tracking event="thirdQuartile">http://www.example.com/thirdQuartile</Tracking>
              <Tracking event="complete">http://www.example.com/complete</Tracking>
              <Tracking event="mute">http://www.example.com/mute</Tracking>
              <Tracking event="unmute">http://www.example.com/unmute</Tracking>
              <Tracking event="rewind">http://www.example.com/rewind</Tracking>
              <Tracking event="pause">http://www.example.com/pause</Tracking>
              <Tracking event="resume">http://www.example.com/resume</Tracking>
              <Tracking event="fullscreen">http://www.example.com/fullscreen</Tracking>
              <Tracking event="creativeView">http://www.example.com/creativeView</Tracking>
              <Tracking event="acceptInvitation">http://www.example.com/acceptInvitation</Tracking>
            </TrackingEvents>
            <AdParameters><![CDATA[ {"videos":[ {"url":"https://my-ads.com/interactive-media-ads/media/media_linear_VPAID.mp4","mimetype":"video/mp4"}]} ]]></AdParameters>
            <VideoClicks>
              <ClickThrough id="123">http://google.com</ClickThrough>
              <ClickTracking id="123">http://www.example.com/click</ClickTracking>
            </VideoClicks>
            <MediaFiles>
              <MediaFile delivery="progressive" apiFramework="VPAID" type="application/javascript" width="640" height="480"> https://googleads.github.io/googleads-ima-html5/vpaid/linear/VpaidVideoAd.js </MediaFile>
            </MediaFiles>
          </Linear>
        </Creative>
      </Creatives>
    </InLine>
  </Ad>
</VAST>
```

Das folgende Beispiel zeigt die Tracking-Informationen.

```
{
  "avails": [
    {
      "adBreakTrackingEvents": [],
      "adMarkerDuration": null,
      "ads": [
        {
          "adId": "1",
          "adParameters": "",
          "adProgramDateTime": "2023-07-31T16:53:40.577Z",
          "adSystem": "2.0",
          "adTitle": "1",
          "adVerifications": [],
          "companionAds": [],
          "creativeId": "00006",
          "creativeSequence": "1",
          "duration": "PT14.982S",
          "durationInSeconds": 14.982,
          "extensions": [],
          "mediaFiles": {
            "mediaFilesList": [],
            "mezzanine": ""
          },
          "skipOffset": null,
          "startTime": "PT39.339S",
          "startTimeInSeconds": 39.339,
          "trackingEvents": [
            {
              "beaconUrls": [
                "https://myads.com/beaconing/event=impression"
              ],
              "duration": "PT14.982S",
              "durationInSeconds": 14.982,
              "eventId": "2698188",
              "eventProgramDateTime": null,
              "eventType": "impression",
              "startTime": "PT39.339S",
              "startTimeInSeconds": 39.339
            },
            {
              "beaconUrls": [
                "https://aws.amazon.com"
              ],
              "duration": "PT14.982S",
              "durationInSeconds": 14.982,
              "eventId": "2698188",
              "eventProgramDateTime": null,
              "eventType": "clickThrough",
              "startTime": "PT39.339S",
              "startTimeInSeconds": 39.339
            },
            {
              "beaconUrls": [
                "https://myads.com/beaconing/event=clicktracking"
              ],
              "duration": "PT14.982S",
              "durationInSeconds": 14.982,
              "eventId": "2698795",
              "eventProgramDateTime": null,
              "eventType": "clickTracking",
              "startTime": "PT39.339S",
              "startTimeInSeconds": 39.339
            }
          ],
          "vastAdId": ""
        }
      ],
      "availId": "2698188",
      "availProgramDateTime": "2023-07-31T16:53:40.577Z",
      "duration": "PT14.982S",
      "durationInSeconds": 14.982,
      "meta": null,
      "nonLinearAdsList": [],
      "startTime": "PT39.339S",
      "startTimeInSeconds": 39.339
    }
  ],
  "dashAvailabilityStartTime": null,
  "hlsAnchorMediaSequenceNumber": null,
  "nextToken": "UFQzOS4zMzlTXzIwMjMtMDctMzFUMTY6NTQ6MDQuODA1Mzk2NTI5Wl8x",
  "nonLinearAvails": []
}{
  "avails": [
    {
      "adBreakTrackingEvents": [],
      "adMarkerDuration": null,
      "ads": [
        {
          "adId": "2922274",
          "adParameters": "",
          "adProgramDateTime": "2023-08-14T19:49:53.998Z",
          "adSystem": "Innovid Ads",
          "adTitle": "VPAID",
          "adVerifications": [],
          "companionAds": [],
          "creativeId": "",
          "creativeSequence": "",
          "duration": "PT16.016S",
          "durationInSeconds": 16.016,
          "extensions": [],
          "mediaFiles": {
            "mediaFilesList": [
              {
                "apiFramework": "VPAID",
                "bitrate": 0,
                "codec": null,
                "delivery": "progressive",
                "height": 9,
                "id": "",
                "maintainAspectRatio": false,
                "maxBitrate": 0,
                "mediaFileUri": "http://my-ads.com/mobileapps/js/vpaid/1h41kg?cb=178344c0-8e67-281a-58ca-962e4987cd60&deviceid=&ivc=",
                "mediaType": "application/javascript",
                "minBitrate": 0,
                "scalable": false,
                "width": 16
              }
            ],
            "mezzanine": "http://my-ads.com/mobileapps/js/vpaid/1h41kg?cb=178344c0-8e67-281a-58ca-962e4987cd60&deviceid=&ivc="
          },
          "skipOffset": null,
          "startTime": "PT8M42.289S",
          "startTimeInSeconds": 522.289,
          "trackingEvents": [
            {
              "beaconUrls": [
                "about:blank"
              ],
              "duration": "PT16.016S",
              "durationInSeconds": 16.016,
              "eventId": "2922274",
              "eventProgramDateTime": null,
              "eventType": "impression",
              "startTime": "PT8M42.289S",
              "startTimeInSeconds": 522.289
            }
          ],
          "vastAdId": "1h41kg"
        }
      ],
      "availId": "2922274",
      "availProgramDateTime": "2023-08-14T19:49:53.998Z",
      "duration": "PT16.016S",
      "durationInSeconds": 16.016,
      "meta": null,
      "nonLinearAdsList": [],
      "startTime": "PT8M42.289S",
      "startTimeInSeconds": 522.289
    }
  ],
  "dashAvailabilityStartTime": null,
  "hlsAnchorMediaSequenceNumber": null,
  "nextToken": "UFQ4TTQyLjI4OVNfMjAyMy0wOC0xNFQxOTo1MDo0MS4zOTc5MjAzODVaXzE%3D",
  "nonLinearAvails": []
}
```

## Symbole für Google Warum diese Anzeige (WTA)
<a name="ad-reporting-client-side-ad-tracking-schema-player-controls-google-wta"></a>

*AdChoices*ist ein Industriestandard, der Zuschauern Informationen über die Anzeigen bietet, die sie sehen, einschließlich der Art und Weise, wie diese Anzeigen auf sie ausgerichtet wurden.

![\[Das Logo von Google Why This Ad (WTA). WTA informiert die Zuschauer über die Anzeigen, die sie sehen, einschließlich der Art und Weise, wie diese Anzeigen auf sie ausgerichtet wurden.\]](http://docs.aws.amazon.com/de_de/mediatailor/latest/ug/images/google-wta.png)


Die MediaTailor clientseitige Tracking-API unterstützt Symbolmetadaten, die im VAST-Erweiterungsknoten der VAST-Antwort gespeichert sind. Weitere Informationen zu WTA in der VAST-Antwort finden Sie in [dieser VAST-XML-Beispielantwort](https://storage.googleapis.com/interactive-media-ads/ad-tags/ima_wta_sample_vast_3.xml).

**Anmerkung**  
MediaTailor unterstützt derzeit nur VAST Version 3.

```
<VAST>
    <Ad>  
    <InLine>  
       ...
      <Extensions>
        <Extension type="IconClickFallbackImages">
          <IconClickFallbackImages program="GoogleWhyThisAd">
            <IconClickFallbackImage width="400" height="150">
              <AltText>Alt icon fallback</AltText>
              <StaticResource creativeType="image/png"><![CDATA[https://storage.googleapis.com/interactive-media-ads/images/wta_dialog.png]]></StaticResource>
            </IconClickFallbackImage>
          </IconClickFallbackImages>
          <IconClickFallbackImages program="AdChoices">
            <IconClickFallbackImage width="400" height="150">
              <AltText>Alt icon fallback</AltText>
              <StaticResource creativeType="image/png"><![CDATA[https://storage.googleapis.com/interactive-media-ads/images/wta_dialog.png?size=1x]]></StaticResource>
            </IconClickFallbackImage>
            <IconClickFallbackImage width="800" height="300">
              <AltText>Alt icon fallback</AltText>
              <StaticResource creativeType="image/png"><![CDATA[https://storage.googleapis.com/interactive-media-ads/images/wta_dialog.png?size=2x]]></StaticResource>
            </IconClickFallbackImage>
          </IconClickFallbackImages>
        </Extension>
      </Extensions>
    </InLine>
  </Ad>
</VAST>
```

Das folgende Beispiel zeigt die clientseitige Tracking-Antwort in der `/avails/x/ads/y/extensions` Liste.

```
{
  "avails": [
    {
      "adBreakTrackingEvents": [],
      "adMarkerDuration": null,
      "ads": [
        {
          "adId": "0",
          "adParameters": "",
          "adProgramDateTime": null,
          "adSystem": "GDFP",
          "adTitle": "Google Why This Ad VAST 3 Sample",
          "adVerifications": [],
          "companionAds": [],
          "creativeId": "7891011",
          "creativeSequence": "1",
          "duration": "PT10S",
          "durationInSeconds": 10,
          "extensions": [
            {
              "content": "<IconClickFallbackImages program=\"GoogleWhyThisAd\">      
                          <IconClickFallbackImage height=\"150\" width=\"400\">      
                          <AltText>Alt icon fallback</AltText>      
                          <StaticResource creativeType=\"image/png\"><![CDATA[https://storage.googleapis.com/interactive-media-ads/images/wta_dialog.png]]>
                          </StaticResource>     
                          </IconClickFallbackImage>    
                          </IconClickFallbackImages>     
                          <IconClickFallbackImages program=\"AdChoices\">     
                          <IconClickFallbackImage height=\"150\" width=\"400\">     
                          <AltText>Alt icon fallback</AltText>       
                          <StaticResource creativeType=\"image/png\"><![CDATA[https://storage.googleapis.com/interactive-media-ads/images/wta_dialog.png?size=1x]]>
                          </StaticResource>      
                          </IconClickFallbackImage>      
                          <IconClickFallbackImage height=\"300\" width=\"800\">       
                          <AltText>Alt icon fallback</AltText>       
                          <StaticResource creativeType=\"image/png\"><![CDATA[https://storage.googleapis.com/interactive-media-ads/images/wta_dialog.png?size=2x]]>
                          </StaticResource>      
                          </IconClickFallbackImage>     
                          </IconClickFallbackImages>",
              "type": "IconClickFallbackImages"
            }
          ],
          "mediaFiles": {
            "mediaFilesList": [],
            "mezzanine": ""
          },
          "skipOffset": "00:00:03",
          "startTime": "PT0S",
          "startTimeInSeconds": 0,
          "trackingEvents": [
            {
              "beaconUrls": [
                "https://example.com/view"
              ],
              "duration": "PT10S",
              "durationInSeconds": 10,
              "eventId": "0",
              "eventProgramDateTime": null,
              "eventType": "impression",
              "startTime": "PT0S",
              "startTimeInSeconds": 0
            }
          ],
          "vastAdId": "123456"
        }
      ],
      "availId": "0",
      "availProgramDateTime": null,
      "duration": "PT10S",
      "durationInSeconds": 10,
      "meta": null,
      "nonLinearAdsList": [],
      "startTime": "PT0S",
      "startTimeInSeconds": 0
    }
  ],
  "dashAvailabilityStartTime": null,
  "hlsAnchorMediaSequenceNumber": null,
  "nextToken": "UFQxMFNfMjAyMy0wNy0wNlQyMDo0MToxNy45NDE4MDM0NDhaXzE%3D",
  "nonLinearAvails": []
}
```

# Clientseitiges Beaconing
<a name="ad-reporting-client-side-beaconing"></a>

Mit dem clientseitigen `startTimeInSeconds` Tracking-Element können Sie MediaTailor das Timing von Beacons unterstützen.

Die folgende JSON-Antwort zeigt die wichtigsten Beacon-Typen: Impressionen, Start, Quartile und Abschluss.

**Anmerkung**  
In den Richtlinien des Interactive Advertising Bureau (IAB) zur Messung von Videoimpressionen heißt es, dass für eine Impression der Anzeigeninhalt clientseitig geladen werden muss und mindestens die Startzeit für das Rendern im Player erreicht werden muss. Weitere Informationen finden Sie unter [Digital Video Ad Serving Template (VAST)](https://www.iab.com/guidelines/vast/) auf der IAB-Website.

```
{
  "avails": [
    {
      "ads": [
        {
          "adId": "8104385",
          "duration": "PT15.100000078S",
          "durationInSeconds": 15.1,
          "startTime": "PT17.817798612S",
          "startTimeInSeconds": 17.817,
          "trackingEvents": [
          {
              "beaconUrls": [
                "http://exampleadserver.com/tracking?event=impression"
              ],
              "duration": "PT15.100000078S",
              "durationInSeconds": 15.1,
              "eventId": "8104385",
              "eventType": "impression",
              "startTime": "PT17.817798612S",
              "startTimeInSeconds": 17.817
            },
            {
              "beaconUrls": [
                "http://exampleadserver.com/tracking?event=start"
              ],
              "duration": "PT0S",
              "durationInSeconds": 0.0,
              "eventId": "8104385",
              "eventType": "start",
              "startTime": "PT17.817798612S",
              "startTimeInSeconds": 17.817
            },
            {
              "beaconUrls": [
                "http://exampleadserver.com/tracking?event=firstQuartile"
              ],
              "duration": "PT0S",
              "durationInSeconds": 0.0,
              "eventId": "8104386",
              "eventType": "firstQuartile",
              "startTime": "PT21.592798631S",
              "startTimeInSeconds": 21.592
            },
             {
              "beaconUrls": [
                "http://exampleadserver.com/tracking?event=midpoint"
              ],
              "duration": "PT0S",
              "durationInSeconds": 0.0,
              "eventId": "8104387",
              "eventType": "midpoint",
              "startTime": "PT25.367798651S",
              "startTimeInSeconds": 25.367
            },
            {
              "beaconUrls": [
                "http://exampleadserver.com/tracking?event=thirdQuartile"
              ],
              "duration": "PT0S",
              "durationInSeconds": 0.0,
              "eventId": "8104388",
              "eventType": "thirdQuartile",
              "startTime": "PT29.14279867S",
              "startTimeInSeconds": 29.142
            },
            {
              "beaconUrls": [
                "http://exampleadserver.com/tracking?event=complete"
              ],
              "duration": "PT0S",
              "durationInSeconds": 0.0,
              "eventId": "8104390",
              "eventType": "complete",
              "startTime": "PT32.91779869S",
              "startTimeInSeconds": 32.917
            }
          ]
        }
      ],
      "availId": "8104385",
      "duration": "PT15.100000078S",
      "durationInSeconds": 15.1,
      "startTime": "PT17.817798612S",
      "startTimeInSeconds": 17.817
    }
  ]
}
```

# Hybridmodus mit serverseitigen Ad Beacons
<a name="ad-reporting-hybrid-mode"></a>

MediaTailor unterstützt einen Hybridmodus für die Sitzungsverfolgung. In diesem Modus sendet der Dienst Werbeverfolgungsereignisse im Zusammenhang mit der Wiedergabe aus, stellt aber die gesamte clientseitige Tracking-Nutzlast für die Sitzung zur Verfügung

Um Hybrid-Tracking mithilfe von Wiedergabepräfixen zu aktivieren, initialisieren Sie vom Player aus eine neue MediaTailor Wiedergabe-Sitzung mit einer Anfrage in einem der folgenden Formate gemäß Ihrem Protokoll:

**Example : HLS-Format**  

```
POST master.m3u8
    {
        "adsParams": {
           "deviceType": "ipad"
       },
       "reportingMode":"server"
    }
```

**Example : DASH-Format**  

```
POST manifest.mpd
    {
        "adsParams": {
           "deviceType": "ipad"
       },
       "reportingMode":"server"
    }
```

MediaTailor verwaltet die folgenden Tracking-Ereignisse im Hybridmodus:
+ Eindruck
+ Starten
+ Erstes Quartil
+ Mittelpunkt
+ Drittes Quartil
+ Complete
+ `breakStart`(vmap)
+ `breakEnd`(vmap)

# Kundenseitige Ad-Tracking-Integrationen
<a name="ad-reporting-client-side-ad-tracking-integrations"></a>

In diesem Abschnitt werden Integrationen zwischen MediaTailor und verschiedenen clientseitigen Ad-Tracking-Servern beschrieben.

**Topics**
+ [Öffnen Sie Measurement SDK](#ad-reporting-client-side-ad-tracking-integrations-open-measurement-sdk)
+ [Kostenloser Datazoom-Player SDKs](#ad-reporting-client-side-ad-tracking-integrations-dz)
+ [Roku Advertising Framework (RAF)](#ad-reporting-client-side-ad-tracking-integrations-raf)
+ [TheoPlayer](#ad-reporting-client-side-ad-tracking-integrations-theoplayer)
+ [MediaTailor SDK](#ad-reporting-client-side-ad-tracking-integrations-mediatailor-sdk)

## Öffnen Sie Measurement SDK
<a name="ad-reporting-client-side-ad-tracking-integrations-open-measurement-sdk"></a>

Das Open Measurement SDK (OM SDK) des Interactive Advertising Bureau (IAB) ermöglicht die Messung der Sichtbarkeit und Überprüfung von Anzeigen, die in Web-Video- und nativen App-Umgebungen geschaltet werden.

Bei älteren VAST-Dokumenten der Version 3 sollte der Bestätigungscode mit dem Erweiterungstyp zusammen mit dem Erweiterungsknoten geladen werden. `AdVerifications` Die Wurzel des Erweiterungsknotens ist ein `AdVerifications` Knoten mit demselben Schema wie das VAST 4.1-Element.

Um die Einführung des OM SDK zu erleichtern, MediaTailor hat sich das Unternehmen mit Datazoom zusammengetan, um kostenlose Player zur Verfügung zu stellen SDKs , die für Open Measurement konfiguriert und verifiziert sind. Weitere Informationen finden Sie unter [Kostenloser Datazoom-Player SDKs](#ad-reporting-client-side-ad-tracking-integrations-dz).

**Anmerkung**  
MediaTailor unterstützt derzeit nur VAST Version 3.

**Example : Verifizierungsknoten in VAST 3, vor Version 4.1**  

```
...
<Extensions>
    <Extension type="AdVerifications">
        <AdVerifications>
            <Verification vendor="company.com-omid">
                <JavaScriptResource apiFramework="omid" browserOptional="true">
                    <![CDATA[https://verification.com/omid_verification.js]]>
                </JavaScriptResource>
                <TrackingEvents>
                    <Tracking event="verificationNotExecuted">
                        <![CDATA[https://verification.com/trackingurl]]>
                    </Tracking>
                </TrackingEvents>
                <VerificationParameters>
                    <![CDATA[verification params key/value pairs]]>
                </VerificationParameters>
            </Verification>
        </AdVerifications>
    </Extension>
</Extensions>
```

MediaTailor extrahiert die `AdVerifications` Daten aus dem `<Extensions>` Knoten und platziert sie in dem `adVerifications` Array in der clientseitigen Tracking-Antwort.

**Example : ADVerifications-Array in der clientseitigen Tracking-Antwort**  

```
{
  "avails": [
    {
      "adBreakTrackingEvents": [],
      "adMarkerDuration": null,
      "ads": [
        {
          "adId": "3062770",
          "adParameters": "",
          "adProgramDateTime": "2023-08-23T16:25:40.914Z",
          "adSystem": "2.0",
          "adTitle": "AD-polarbear-15",
          "adVerifications": [
            {
              "executableResource": [],
              "javaScriptResource": [
                {
                  "apiFramework": "omid",
                  "browserOptional": "true",
                  "uri": "https://verification.com/omid_verification.js"
                }
              ],
              "trackingEvents": [
                {
                  "event": "verificationNotExecuted",
                  "uri": "https://verification.com/trackingurl"
                }
              ],
              "vendor": "company.com-omid",
              "verificationParameters": "verification params key value pairs"
            }
          ],
          "companionAds": [],
          "creativeId": "00006",
          "creativeSequence": "1",
          "duration": "PT14.982S",
          "durationInSeconds": 14.982,
          "extensions": [
            {
              "content": "<AdVerifications>\n\t\t\t\t\t\t<Verification vendor=\"company.com-omid\">\n\t\t\t\t\t\t\t<JavaScriptResource apiFramework=\"omid\" browserOptional=\"true\"><![CDATA[https://verification.com/omid_verification.js;]]></JavaScriptResource>\n\t\t\t\t\t\t\t<TrackingEvents>\n\t\t\t\t\t\t\t\t<Tracking event=\"verificationNotExecuted\"><![CDATA[;https://verification.com/trackingurl;]]></Tracking>\n\t\t\t\t\t\t\t</TrackingEvents>\n\t\t\t\t\t\t\t<VerificationParameters><![CDATA[verification params key/value pairs;]]></VerificationParameters>\n\t\t\t\t\t\t</Verification>\n\t\t\t\t\t</AdVerifications>",
              "type": "AdVerifications"
            }
          ],
          "mediaFiles": {
            "mediaFilesList": [],
            "mezzanine": ""
          },
          "skipOffset": null,
          "startTime": "PT10.11S",
          "startTimeInSeconds": 10.11,
          "trackingEvents": [
            {
              "beaconUrls": [
                "https://n8ljfs0h09.execute-api.us-west-2.amazonaws.com/v1/impression"
              ],
              "duration": "PT14.982S",
              "durationInSeconds": 14.982,
              "eventId": "3062770",
              "eventProgramDateTime": null,
              "eventType": "impression",
              "startTime": "PT10.11S",
              "startTimeInSeconds": 10.11
            }
          ],
          "vastAdId": ""
        }
      ],
      "availId": "3062770",
      "availProgramDateTime": "2023-08-23T16:25:40.914Z",
      "duration": "PT14.982S",
      "durationInSeconds": 14.982,
      "meta": null,
      "nonLinearAdsList": [],
      "startTime": "PT10.11S",
      "startTimeInSeconds": 10.11
    }
  ],
  "dashAvailabilityStartTime": null,
  "hlsAnchorMediaSequenceNumber": null,
  "nextToken": "UFQxMC4xMVNfMjAyMy0wOC0yM1QxNjoyNjoyNC4yNDYxMDIxOTBaXzE%3D",
  "nonLinearAvails": []
}
```

**Anmerkung**  
Wenden Sie sich an das IAB Tech Lab, um sicherzustellen, dass die Anwendungen jährlich zertifiziert werden, um die Einhaltung der Vorschriften sicherzustellen.

Weitere Informationen zum OM SDK finden Sie unter [Open Measurement SDK](https://iabtechlab.com/standards/open-measurement-sdk/) auf der Website des IAB Tech Lab.

## Kostenloser Datazoom-Player SDKs
<a name="ad-reporting-client-side-ad-tracking-integrations-dz"></a>

Um die Einführung des Players zu erleichtern SDKs, MediaTailor hat es sich mit Datazoom zusammengetan, um kostenlose Player anzubieten SDKs , die mit dem und dem IAB Tech konfiguriert und getestet wurden. [Kundenseitige AWS Elemental MediaTailor Integration mit Google Ad Manager](gam-integration-pal.md) [Öffnen Sie Measurement SDK](#ad-reporting-client-side-ad-tracking-integrations-open-measurement-sdk)

Das Datazoom Player SDK unterstützt die folgenden Funktionen:
+ Live- und VOD-Wiedergabelisten
+ DASH- und HLS-Spezifikationen
+ Unterstützung von Player-Anbietern für Bitmovin, Exoplayer, Android Media Player, Apple AVPlayer, Brightcove, Chromecast Receiver, Dash.js, hls.js,, Shaka Player, THEO Player, Video.js JWPlayer, Roku und mehr
+ IAB Tech Lab Open Measurement-Zertifizierung, sofern für ausgewählte Geräte verfügbar
+ Behandlung von Ereignissen per Mausklick
+ Dispatcher für Werbeereignisse, z. B. Countdown-Timer für Werbeanzeigen, Anzeigenüberlagerungen und nichtlineare Ereignisse, Beginn und Ende von Werbeunterbrechungen
+ Kundenseitiges Werbe-Beaconing
+ SDK für die Google Programmatic Access Library (PAL) als optionale Konfigurationseinstellung

Datazoom bietet auch einen kostenpflichtigen Analyse- und Telemetriedienst, den der Spieler unterstützt. SDKs Kunden können die Player-SDK-Telemetrie über die Datazoom-Managementkonsole aktivieren und steuern. [Um auf den Datazoom Player zuzugreifen SDKs und mehr über den Telemetrie- und Analysedienst mit Mehrwert zu erfahren, verwenden Sie die Kontaktinformationen auf der Datazoom-Website.](https://www.datazoom.io/partner-aws) 

## Roku Advertising Framework (RAF)
<a name="ad-reporting-client-side-ad-tracking-integrations-raf"></a>

Das Roku Ad Framework (RAF) sorgt für ein einheitliches Werberlebnis auf der gesamten Roku-Plattform. Alle Kanäle, einschließlich Videowerbung, müssen die Zertifizierungsanforderungen von Roku für RAF erfüllen. Insbesondere muss die App immer die clientseitige Ereignisauslösung über RAF verwenden. MediaTailorunterstützt als Anbieter für serverseitige Anzeigeneinfügung (SSAI) die clientseitige Auslösung von Ereignissen. Die RAFX SSAI-Adapter bieten Schnittstellen sowohl zu SSAI-Manifestservern oder Stitchern als auch zu RAF. Zu diesen Schnittstellen gehören:
+ Analysieren der `masterURL` Antwort und Extrahieren von `playURL``AdURL`, und Anzeigenmetadaten.
+ Umwandlung von MediaTailor SSAI-Anzeigenmetadaten in RAF-verwendbare Anzeigenmetadaten und Konfiguration von RAF für die Wiedergabe.
+ Beobachtung von Stream-Ereignissen und zeitgesteuerten Metadaten.
+ Rechtzeitiger Abgleich der Stream-Ereignisse, der Anzeigen-Metadaten und der Pixel für das Auslöseereignis.
+ Pingen/Abfragen von RAF`AdURL`, wie vom MediaTailor SSAI-Manifestserver gefordert, anschließendes Parsen und Neukonfigurieren von RAF.

Weitere Informationen zu SSAI-Adaptern für RAF finden Sie unter [Implementieren der serverseitigen Anzeigeneinfügung](https://developer.roku.com/docs/developer-program/advertising/ssai-adapters.md) mithilfe von Roku-Adaptern auf der Roku-Website.

## TheoPlayer
<a name="ad-reporting-client-side-ad-tracking-integrations-theoplayer"></a>

TheoPlayer Die Integration mit MediaTailor macht Folgendes:
+ Bietet Funktionen zur Unterstützung der MediaTailor clientseitigen Ereignisverfolgung für HLS und DASH sowohl für VOD- als auch für Live-Workflows.
+ Unterstützt das Senden von Tracking-Beacons nur für lineare Anzeigen.
+ Deaktiviert die Suche während einer Anzeige. Es gibt jedoch keine Logik für das Abspielen einer Anzeige, wenn der Nutzer nach Ablauf der Werbeunterbrechung sucht.

Weitere Informationen zu SSAI und zur Überprüfung im TheoPlayer Internet, Android, iOS und tvOS SDKs für MediaTailor finden Sie [MediaTailor](https://docs.theoplayer.com/how-to-guides/01-ads/12-mediatailor.md)auf der TheoPlayer Website.

## MediaTailor SDK
<a name="ad-reporting-client-side-ad-tracking-integrations-mediatailor-sdk"></a>

AWS Elemental unterhält ein JavaScript basiertes Softwareentwicklungskit (SDK). AWS Elemental stellt das SDK so zur Verfügung, wie es ist, ohne stillschweigende Garantie. Verwenden Sie das SDK als Referenz-Demo, um Ihr Onboarding auf die Nutzung zu optimieren. MediaTailor Das SDK zeigt, wie Sie mit der MediaTailor clientseitigen Tracking-API interagieren. Das SDK implementiert clientseitiges Ad-Tracking und Reporting für aktive Spieler. HTML5 Das SDK initialisiert eine MediaTailor clientseitige Berichtssitzung und fordert dann regelmäßig Informationen zur Anzeigenverfolgung an. Während der Wiedergabe gibt das SDK Anzeigen-Tracking-Ereignisse aus, wenn neue Werbeereignisse erkannt werden.

Das MediaTailor SDK unterstützt die folgenden Funktionen:
+ Live- und VOD-Playlisten
+ DASH- und HLS-Spezifikationen
+ Behandlung von Ereignissen per Mausklick
+ Dispatcher für Werbeereignisse
+ Benutzerdefinierte Event-Hooks
+ Client-seitiges Werbe-Beaconing. Weitere Informationen zum Senden von Ad Beacons finden Sie unter. [Clientseitiges Beaconing](ad-reporting-client-side-beaconing.md)

**Anmerkung**  
Reichen Sie ein AWS Support-Ticket ein, um ein JavaScript Beispiel-SDK für zu erhalten MediaTailor. Sie erhalten einen Download-Link für das Paket und seine Dateien.

## Durch Werbe-Beacons blättern mit GetTracking
<a name="gettracking"></a>

Verwenden Sie den `GetTracking` Endpunkt, um die Anzahl der an einen Player zurückgegebenen Anzeigen einzuschränken. Wenn ein Manifestfenster beispielsweise groß ist und sich über einen langen Zeitraum erstreckt, kann sich die Anzahl der zurückgegebenen Werbe-Beacons auf die Leistung des Players auswirken. 

`GetTracking`gibt einen `NextToken` Wert zurück, mit dem Sie die Anzahl der zurückgegebenen Beacons einschränken können, indem Sie die Liste der zurückgegebenen Beacons durchblättern. Sie können die `NextToken` Werte nacheinander durchgehen, um den gewünschten Wert im Feld eines Werbe-Beacons zu finden. `StartTimeInSeconds` 
+ Beim ersten Aufruf von werden alle möglichen Anzeigen zurückgegeben`GetTracking`, die in das Manifestfenster fallen, einschließlich jeweils eines Werts `NextToken` und. 
+ Wenn eine `GetTracking` Anfrage *kein* A enthält`NextToken`, werden alle Anzeigen im Manifestfenster zurückgegeben.
+ Wenn eine `GetTracking` Anfrage ein enthält, es `NextToken` aber keine neuen Beacons gibt, die MediaTailor zurückgegeben werden können, wird derselbe Wert zurückgegeben`NextToken`, den Sie in der ursprünglichen Anfrage gesendet haben.
+ Wenn einer Anzeige keine Beacons mehr entsprechen, `GetTracking` wird die Anzeige aus der Antwort entfernt.
+ Tokens von `GetTracking` laufen nach 24 Stunden ab. Wenn ein `NextToken` Wert älter als 24 Stunden ist, gibt der nächste Aufruf von einen `GetTracking` `NextToken` Nullwert zurück.

### Generalisierte Aufrufsequenz von vom Spieler GetTracking
<a name="gettracking.generalsequence"></a>

Eine `GetTracking` Anfrage vom Client-Spieler ist ein POST mit einem Anforderungstext, der die Werbung `NextToken` und Beacons im Zusammenhang mit dem Token enthält.

```
https://YouMediaTailorUrl/v1/tracking
{

     "NextToken": "value"
     .
     .
     .
}
```

Die allgemeine Reihenfolge für die Verwendung von `GetTracking` with `NextToken` lautet wie folgt:

1. Rufen Sie zum ersten Mal an`GetTracking`.

   Alle Anzeigen und Beacons sowie die ersten `NextToken` für nachfolgende Aufrufe werden zurückgegeben. 

1. Wenn der Wert Null `NextToken` ist, werden alle Ad Beacons MediaTailor zurückgegeben.

1. Wenn der abgelaufen `NextToken` ist, MediaTailor wird eine HTTP-Rückgabecode 400-Fehlermeldung zurückgegeben.

   Rufen Sie erneut auf, `GetTracking` um gültige `NextToken` s abzurufen.

1. Scannen Sie die gesamte Antwort, um herauszufinden, `StartTimeInSeconds` ob sich ein Werbeanzeigen-Beacon im gewünschten Bereich befindet.

1. Rufen Sie erneut `GetTracking` mit dem Wert von auf, der dem gewünschten `StartTimeInSeconds` Wert `NextToken` zugeordnet ist. 

1. Schauen Sie sich bei Bedarf die zurückgegebenen Anzeigen erneut an, bis Sie genau die Anzeigen gefunden haben, die Sie abspielen möchten.

#### Erweitertes Beispiel
<a name="gettracking.extendedexample"></a>

Dieses Beispiel zeigt, wie Sie mithilfe `GetTracking` von s die Anzahl der `NextToken` an einen Player zurückgegebenen Werbe-Beacons einschränken können.

MediaTailor erhält eine `GetTracking` Anfrage. Die Antwort enthält eine Anzeige mit der ID 9935407 und zwei Beacons mit den `StartTimeInSeconds` Werten 52,286 und 48,332 Sekunden. 

MediaTailor sendet die JSON-Antwort wie folgt: `NextToken`

```
  {
  "NextToken": JF57ITe48t1441mv7TmLKuZLroxDzfIslp6BiSNL1IJmzPVMDN0lqrBYycgMbKEb
  "avails": [
    {
      "ads": [
        {
          "adId": "9935407",
          "adVerifications": [],
          "companionAds": [],
          "creativeId": "",
          "creativeSequence": "",
          "duration": "PT15S",
          "durationInSeconds": 15,
          "extensions": [],
          "mediaFiles": {
            "mediaFilesList": [],
            "mezzanine": ""
          },
          "startTime": "PT30S",
          "StartTimeInSeconds": 45,
          "trackingEvents": [
            {
              "beaconUrls": [
                "http://adserver.com/tracking?event=Impression "
              ],
              "duration": "PT0S",
              "durationInSeconds": 0,
              "eventId": "9935414",
              "eventType": "secondQuartile",
              "startTime": "PT52.286S",
              "StartTimeInSeconds": 52.286
            },
            {
              "beaconUrls": [
                "http://adserver.com/tracking?event=firstQuartile"
              ],
              "duration": "PT0S",
              "durationInSeconds": 0,
              "eventId": "9935412",
              "eventType": "firstQuartile",
              "startTime": "PT48.332S",
              "StartTimeInSeconds": 48.332
            }
          ],
          "vastAdId": ""
        }
      ],
      "startTime": "PT46.47S",
      "StartTimeInSeconds": 46.47
    }
  ]
}
```

 MediaTailor Antwortet bei der nächsten `GetTracking` Anfrage mit dem `NextToken` Wert: JF57 ITe48t1441mv7 Tm LKu ZLrox DzfIslp 6Bi SNL1 IJmz PVMDN0lqr BYycg MbKEb.

MediaTailor antwortet mit Anzeigen und Beacons, die `StartTimeInSeconds` denen entsprechen, die `NextToken` beim vorherigen Anruf eingestellt wurden.

Gehen Sie davon aus, dass die Antwort jetzt zusätzlich zur vorherigen Anzeige mit der ID 9935407 eine weitere Anzeige mit der ID 9235407 enthält. Die Beacons der Anzeigen-ID 9235407 haben die Werte 132,41 und 70.339. `StartTimeInSeconds`

MediaTailor durchläuft alle Beacons in der Sitzung, um die Beacons mit `StartTimeInSeconds` mehr als 52,286 Sekunden auszuwählen, bei denen es sich um Beacon 3 und Beacon 4 aus der Anzeige mit der ID 9235407 handelt:

```
{
  "NextToken": ZkfknvbfsdgfbsDFRdffg12EdffecFRvhjyjfhdfhnjtsg5SDGN
  "avails": [
    {
      "ads": [
        {
          "adId": "9235407",
          "adVerifications": [],
          "companionAds": [],
          "creativeId": "",
          "creativeSequence": "",
          "duration": "PT15.816S",
          "durationInSeconds": 19.716,
          "extensions": [],
          "mediaFiles": {
            "mediaFilesList": [],
            "mezzanine": ""
          },
          "startTime": "PT2M0S",
          "StartTimeInSeconds": 120.0,
          "trackingEvents": [
            {
              "beaconUrls": [
                "http://adserver.com/tracking?event=complete"
              ],
              "duration": "PT0S",
              "durationInSeconds": 0,
              "eventId": "8935414",
              "eventType": "firstQuartile",
              "startTime": "PT1M10.330S",
              "StartTimeInSeconds": 70.339
            },
            {
              "beaconUrls": [
                "http://adserver.com/tracking?event=thirdQuartile"
              ],
              "duration": "PT0S",
              "durationInSeconds": 0,
              "eventId": "8935412",
              "eventType": "secondQuartile",
              "startTime": "PT2M12.41S",
              "StartTimeInSeconds": 132.41
            }
          ],
          "vastAdId": ""
        },   
      ],
      "startTime": "PT36.47S",
      "StartTimeInSeconds": 36.47
    }
  ]
}
```