View a markdown version of this page

Client-side Integrationen zur Anzeigenverfolgung - AWS Elemental MediaTailor
Öffnen Sie das Mess-SDKKostenlose Player-SDKs 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 Integrationen zur Anzeigenverfolgung

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 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-SDKs anzubieten, die für Open Measurement konfiguriert und verifiziert sind. Weitere Informationen finden Sie unter Kostenlose Player-SDKs von Datazoom.

Anmerkung

MediaTailor unterstützt derzeit nur VAST Version 3.

Beispiel: Bestätigungsknoten 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.

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

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 auf der Website des IAB Tech Lab.

Kostenlose Player-SDKs von Datazoom

Um die Einführung der Player-SDKs zu erleichtern, MediaTailor hat sich das Unternehmen mit Datazoom zusammengetan, um kostenlose Player-SDKs anzubieten, 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-Wiedergabelisten

  • 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 für ausgewählte Geräte verfügbar

  • Click-through Behandlung von Ereignissen

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

  • Client-side und Beaconing

  • SDK für die Google Programmatic Access Library (PAL) als optionale Konfigurationseinstellung

Datazoom bietet auch einen kostenpflichtigen Analyse- und Telemetriedienst, den die Player-SDKs unterstützen. Kunden können die Player-SDK-Telemetrie über die Datazoom-Managementkonsole aktivieren und steuern. Um auf die Datazoom Player SDKs zuzugreifen und mehr über den Telemetrie- und Analysedienst mit Mehrwert zu erfahren, verwenden Sie die Kontaktinformationen auf der Datazoom-Website.

Roku Advertising Framework (RAF)

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 playURLAdURL, und Anzeigen-Metadaten.

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

  • Beobachtung von Stream-Ereignissen und zeitgesteuerten Metadaten

  • Rechtzeitiger Abgleich von Stream-Ereignissen, Anzeigen-Metadaten und Pixeln für das Auslöseereignis

  • Pinging/polling dieAdURL, wie vom MediaTailor SSAI-Manifestserver gefordert, anschließend Analyse und Neukonfiguration 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 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 der Web- TheoPlayer, Android-, iOS- und tvOS-SDKs finden Sie MediaTailorauf 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 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 die clientseitige Anzeigenverfolgung und Berichterstattung für Spieler. HTML5-based 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

  • Click-through Behandlung von Ereignissen

  • Ad-event Dispatcher

  • Benutzerdefinierte Event-Hooks

  • Client-side und Beaconing. Weitere Informationen zum Senden von Werbebeacons finden Sie unter. Client-side Beaconing

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.