Nachverfolgen von Anzeigen mit JavaScript 3.x
Erstellt für:
- Benutzende
- Admin
- Entwickler
Mit den folgenden Anweisungen können Sie die Implementierung unter Verwendung der 3.x-SDKs vornehmen.
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
-
Ermitteln Sie, wann die Werbeunterbrechung beginnt, einschließlich Pre-Roll, und erstellen Sie ein
AdBreakObject
mithilfe dieser Pauseninformationen.AdBreakObject
-Referenz: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:
var adBreakObject = ADB.Media.createAdBreakObject(<ADBREAK_NAME>, <POSITION>, <START_TIME>);
-
Rufen Sie
trackEvent()
mitAdBreakStart
in derMediaHeartbeat
-Instanz auf, um das Tracking der Werbeunterbrechung zu starten:tracker.trackEvent(ADB.Media.Event.AdBreakStart, adBreakObject);
-
Ermitteln Sie, wann die Anzeige startet und erstellen Sie die
AdObject
-Instanz mithilfe dieser Anzeigeninformationen.AdObject
-Referenz:VariablennameTypBeschreibungname
stringNicht leere Zeichenfolge, die den Anzeigennamen angibt.adId
stringNicht leere Zeichenfolge mit Anzeigenkennung.position
numberPositionsnummer der Anzeige in der Werbeunterbrechung, beginnend bei 1.length
numberPositive Zahl, die die Länge der Anzeige angibt.Erstellung von Anzeigenobjekten:
var adObject = ADB.Media.createAdObject.createAdObject(<AD_NAME>, <AD_ID>, <POSITION>, <LENGTH>);
-
(Optional) Fügen Sie Standard- und/oder Anzeigenmetadaten mithilfe von Kontextdatenvariablen an die Medien-Tracking-Sitzung an.
-
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:
/* 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";
-
Rufen Sie
trackEvent()
mit demAdStart
-Ereignis in derMediaHeartbeat
-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:
_onAdStart = function() { tracker.trackEvent(ADB.Media.Event.AdStart, adObject, adMetadata); };
-
Wenn die Wiedergabe der Anzeige das Ende der Anzeige erreicht, rufen Sie
trackEvent()
mit demAdComplete
-Ereignis auf:_onAdComplete = function() { tracker.trackEvent(ADB.Media.Event.AdComplete); };
-
Wenn die Anzeigenwiedergabe nicht abgeschlossen wurde, weil der Benutzer die Anzeige überspringt, verfolgen Sie das
AdSkip
-Ereignis:_onAdSkip = function() { tracker.trackEvent(ADB.Media.Event.AdSkip); };
-
Wiederholen Sie die Schritte 3 bis 7, wenn dieselbe
AdBreak
weitere Anzeigen enthält. -
Wenn die Werbeunterbrechung abgeschlossen ist, verwenden Sie zum Tracking das
AdBreakComplete
-Ereignis:_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.
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);