View a markdown version of this page

Client-side Ad-Tracking-Integrationen - AWS Elemental MediaTailor
Öffnen Sie das Mess-SDKSDKs für kostenlose Player von DatazoomRAFTheoPlayerMediaTailor SDK

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.

Client-side Ad-Tracking-Integrationen

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

Öffnen Sie Measurement SDK

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 Dokumenten der VAST-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 mit Datazoom zusammengetan, um kostenlose Player-SDKs bereitzustellen, die für Open Measurement konfiguriert und verifiziert sind. Weitere Informationen finden Sie unter SDKs für kostenlose Player von Datazoom.

Anmerkung

MediaTailor unterstützt derzeit nur VAST Version 3.

Beispiel: 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 der clientseitigen Tracking-Antwort im adVerifications Array.

Beispiel: 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

Arbeiten Sie mit dem IAB Tech Lab zusammen, um sicherzustellen, dass Anwendungen jährlich zertifiziert werden, um die Einhaltung der Vorschriften sicherzustellen.

Weitere Informationen zum OM SDK finden Sie unter Open Measurement SDK auf der Website des IAB Tech Lab.

SDKs für kostenlose Player von Datazoom

Um die Einführung der Player-SDKs zu erleichtern, MediaTailor hat sich mit Datazoom zusammengetan, um kostenlose Player-SDKs bereitzustellen, die mit dem und dem IAB Tech konfiguriert und getestet wurden. Client-side AWS Elemental MediaTailor Integration mit Google Ad Manager Öffnen Sie Measurement SDK

Das Datazoom-Player-SDK unterstützt die folgenden Funktionen:

  • Live- und VOD-Playlisten

  • DASH- und HLS-Spezifikationen

  • Unterstützung von Player-Anbietern für Bitmovin, Exoplayer, Android Media Player, Apple AVPlayer, Brightcove, Chromecast Receiver, hls.js, JWPlayer, Shaka Player Dash.js, THEO Player, Roku und mehr Video.js

  • IAB Tech Lab Open Measurement-Zertifizierung, sofern auf ausgewählten Geräten verfügbar

  • Click-through Bearbeitung von Ereignissen

  • Ad-event Dispatcher, z. B. Countdown-Timer für Werbeanzeigen, überlagerte und nichtlineare Ereignisse, Beginn und Ende von Werbeunterbrechungen

  • Client-side und Beaconing

  • SDK der Google Programmatic Access Library (PAL) als optionale Konfigurationseinstellung

Datazoom bietet auch einen kostenpflichtigen Analyse- und Telemetriedienst an, den die Player-SDKs unterstützen. Kunden können sich über die Datazoom-Managementkonsole für die Player-SDK-Telemetrie anmelden und diese steuern. Verwenden Sie die Kontaktinformationen auf der Datazoom-Website, um auf die Datazoom-Player-SDKs zuzugreifen und mehr über den Telemetrie- und Analysedienst mit Mehrwert zu erfahren. https://www.datazoom.io/partner-aws

Roku Advertising Framework (RAF)

Das Roku Ad Framework (RAF) sorgt für ein konsistentes Werbeerlebnis 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 Event-Auslösung über RAF verwenden. MediaTailorunterstützt als Anbieter für serverseitige Anzeigeneinfügung (SSAI) das clientseitige Auslösen von Ereignissen. Die RAFX-SSAI-Adapter bieten Schnittstellen sowohl zu SSAI-Manifestservern (Stitchern) als auch zu RAF. Zu diesen Schnittstellen gehören:

  • Analysieren der masterURL Antwort und Extrahieren playURL sowie AdURL Anzeigenmetadaten.

  • Umwandlung von MediaTailor SSAI-Anzeigenmetadaten in RAF-usable Anzeigenmetadaten und Konfiguration von RAF für die Wiedergabe.

  • Beobachtung von Stream-Ereignissen und zeitgesteuerten Metadaten.

  • Pünktlicher Abgleich der Stream-Ereignisse, Anzeigenmetadaten und Pixel des auslösenden Ereignisses.

  • Pinging/polling dasAdURL, wie vom MediaTailor SSAI-Manifestserver benötigt, dann das Analysieren und Neukonfigurieren von RAF.

Weitere Informationen zu SSAI-Adaptern für RAF finden Sie unter Implementieren der Server-Side Anzeigeneinfügung mithilfe von Roku-Adaptern auf der Roku-Website.

TheoPlayer

TheoPlayer Die Integration mit MediaTailor bewirkt 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 die Wiedergabe einer Anzeige, wenn der Nutzer nach der Werbeunterbrechung sucht.

Weitere Informationen zu SSAI in den Web- TheoPlayer, Android-, iOS- und tvOS-SDKs finden Sie MediaTailor auf der Website. MediaTailor TheoPlayer

MediaTailor SDK

AWS Elemental unterhält ein JavaScript-based Software-Development-Kit (SDK). AWS Elemental stellt das SDK so zur Verfügung, wie es ist, ohne implizite Garantie. Verwenden Sie das SDK als Referenzdemonstration, um Ihr Onboarding zur Verwendung zu vereinfachen. MediaTailor Das SDK zeigt, wie Sie mit der MediaTailor clientseitigen Tracking-API interagieren. Das SDK implementiert clientseitiges Ad-Tracking und Reporting für Spieler. HTML5-based Das SDK initialisiert eine MediaTailor clientseitige Berichtssitzung und fordert dann in regelmäßigen Abständen Informationen zur Anzeigenverfolgung an. Während der Wiedergabe gibt das SDK Werbe-Tracking-Ereignisse aus, wenn neue Anzeigenereignisse erkannt werden.

Das MediaTailor SDK unterstützt die folgenden Funktionen:

  • Live- und VOD-Playlisten

  • DASH- und HLS-Spezifikationen

  • Click-through Behandlung von Ereignissen

  • Ad-event Dispatcher

  • Benutzerdefinierte Event-Hooks

  • Client-side Werbe-Beaconing. Weitere Informationen zum Senden von Ad-Beacons finden Sie unter. Client-side Beaconing

Anmerkung

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