DokumentationAnalyticsHandbuch zu Streaming-Mediendiensten

Nachverfolgen von Anzeigen mit JavaScript 3.x track-ads-on-javascript

Last update: Fri Feb 06 2026 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Themen:

Erstellt für:

  • Benutzende
  • Admin
  • Entwickler

Mit den folgenden Anweisungen können Sie die Implementierung unter Verwendung der 3.x-SDKs vornehmen.

IMPORTANT
Wenn Sie vorherige Versionen des SDK implementieren möchten, können Sie hier die Entwicklerhandbücher herunterladen: SDKs herunterladen.

Anzeigen-Tracking-Konstanten

Konstantenname
Beschreibung
AdBreakStart
Konstante für die Verfolgung des AdBreak Start-Ereignisses
AdBreakComplete
Konstante für die Verfolgung des AdBreak Complete-Ereignisses
AdStart
Konstante für die Verfolgung des Ad Start-Ereignisses
AdComplete
Konstante für die Verfolgung des Ad Complete-Ereignisses
AdSkip
Konstante für die Verfolgung des Ad Skip-Ereignisses

Implementierungsschritte

  1. Ermitteln Sie, wann die Werbeunterbrechung beginnt, einschließlich Pre-Roll, und erstellen Sie ein AdBreakObject mithilfe dieser Pauseninformationen.

    AdBreakObject-Referenz:

    table 0-row-3 1-row-3 2-row-3 3-row-3
    Variablenname Typ Beschreibung
    name string Nicht leere Zeichenfolge, die den Namen der Werbeunterbrechung angibt (Pre-Roll, Mid-Roll und Post-Roll).
    position number Positionsnummer der Werbeunterbrechung, beginnend bei 1.
    startTime number Abspielpositionswert bei Start der Werbeunterbrechung.

    Erstellung von Werbeunterbrechungsobjekten:

    code language-js 
    var adBreakObject =
  ADB.Media.createAdBreakObject(<ADBREAK_NAME>,
                                   <POSITION>,
                                   <START_TIME>);

  2. Rufen Sie trackEvent() mit AdBreakStart in der MediaHeartbeat-Instanz auf, um das Tracking der Werbeunterbrechung zu starten:

    code language-js 
    tracker.trackEvent(ADB.Media.Event.AdBreakStart, adBreakObject);

  3. Ermitteln Sie, wann die Anzeige startet und erstellen Sie die AdObject-Instanz mithilfe dieser Anzeigeninformationen.

    AdObject-Referenz:

    table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3
    Variablenname Typ Beschreibung
    name string Nicht leere Zeichenfolge, die den Anzeigennamen angibt.
    adId string Nicht leere Zeichenfolge mit Anzeigenkennung.
    position number Positionsnummer der Anzeige in der Werbeunterbrechung, beginnend bei 1.
    length number Positive Zahl, die die Länge der Anzeige angibt.

    Erstellung von Anzeigenobjekten:

    code language-js 
    var adObject =
  ADB.Media.createAdObject.createAdObject(<AD_NAME>,
                                <AD_ID>,
                                <POSITION>,
                                <LENGTH>);

  4. (Optional) Fügen Sie Standard- und/oder Anzeigenmetadaten mithilfe von Kontextdatenvariablen an die Medien-Tracking-Sitzung an.

    • Standard-Anzeigenmetadaten in JavaScript implementieren

    • Anwenderspezifische Anzeigenmetadaten: Erstellen Sie für anwenderdefinierte Metadaten ein variables Objekt für die anwenderspezifischen Datenvariablen und füllen Sie es mit den Daten für aktuelle Anzeigen:

      code language-js 
      /* Set context data */
// Standard metadata keys provided by adobe.
adMetadata[ADB.Media.AdMetadataKeys]  ="Sample Advertiser";
adMetadata[ADB.Media.AdMetadataKeys] = "Sample Campaign";

// Custom metadata keys
adMetadata["affiliate"] = "Sample affiliate";
adMetadata["campaign"] = "Sample ad campaign";
adMetadata["creative"] = "Sample creative";

  5. Rufen Sie trackEvent() mit dem AdStart-Ereignis in der MediaHeartbeat-Instanz auf, um das Tracking der Anzeigenwiedergabe zu starten.

    Fügen Sie als dritten Parameter im Ereignisaufruf eine Referenz auf Ihre anwenderdefinierte Metadatenvariable (oder ein leeres Objekt) ein:

    code language-js 
    _onAdStart = function() {
    tracker.trackEvent(ADB.Media.Event.AdStart, adObject, adMetadata);
};

  6. Wenn die Wiedergabe der Anzeige das Ende der Anzeige erreicht, rufen Sie trackEvent() mit dem AdComplete-Ereignis auf:

    code language-js 
    _onAdComplete = function() {
    tracker.trackEvent(ADB.Media.Event.AdComplete);
};

  7. Wenn die Anzeigenwiedergabe nicht abgeschlossen wurde, weil der Benutzer die Anzeige überspringt, verfolgen Sie das AdSkip-Ereignis:

    code language-js 
    _onAdSkip = function() {
    tracker.trackEvent(ADB.Media.Event.AdSkip);
};

  8. Wiederholen Sie die Schritte 3 bis 7, wenn dieselbe AdBreak weitere Anzeigen enthält.

  9. Wenn die Werbeunterbrechung abgeschlossen ist, verwenden Sie zum Tracking das AdBreakComplete-Ereignis:

    code language-js 
    _onAdBreakComplete = function() {
    tracker.trackEvent(ADB.Media.Event.AdBreakComplete);
};

Weitere Informationen finden Sie im Tracking-Szenario VOD-Wiedergabe mit Pre-roll-Anzeigen.

Granulares Anzeigen-Tracking

Das Standard-Ping-Intervall für Anzeigen ist 10 seconds.

Sie können ein granulares Anzeigen-Tracking einrichten, um das Anzeigen-Tracking 1 second aktivieren.

IMPORTANT
Diese Informationen müssen beim Starten einer Tracking-Sitzung angegeben werden.

Syntax

ADB.Media.MediaObjectKey = {
   GranularAdTracking: "media.granularadtracking"
   }

Beispiel

var mediaObject = ADB.Media.createMediaObject("media-name", "media-id", 60, ADB.Media.StreamType.VOD, ADB.Media.MediaType.Video);

// Enable granular ad tracking
mediaObject[ADB.Media.MediaObjectKey.GranularAdTracking] = true;

tracker.trackSessionStart(mediaObject);
recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb