Mit den folgenden Anweisungen können Sie die Implementierung unter Verwendung der 2.x-SDKs vornehmen.
Wenn Sie Version 1.x des SDK implementieren möchten, können Sie sich hier die Entwicklerhandbücher herunterladen: SDKs herunterladen.
Konstantenname | Beschreibung |
---|---|
ADBMediaHeartbeatEventAdBreakStart |
Konstante für die Verfolgung des AdBreak Start-Ereignisses |
ADBMediaHeartbeatEventAdBreakComplete |
Konstante für die Verfolgung des AdBreak Complete-Ereignisses |
ADBMediaHeartbeatEventAdStart |
Konstante für die Verfolgung des Ad Start-Ereignisses |
ADBMediaHeartbeatEventAdComplete |
Konstante für die Verfolgung des Ad Complete-Ereignisses |
ADBMediaHeartbeatEventAdSkip |
Konstante für die Verfolgung des Ad Skip-Ereignisses |
Ermitteln Sie, wann die Werbeunterbrechung beginnt, einschließlich Pre-Roll, und erstellen Sie ein AdBreakObject
mithilfe dieser Pauseninformationen.
AdBreakObject
-Referenz:
Variablenname | Beschreibung | erforderlich |
---|---|---|
name |
Name der Werbeunterbrechung, z. B. Pre-Roll, Mid-Roll oder Post-Roll. | Ja |
position |
Positionsnummer der Werbeunterbrechung innerhalb des Inhalts, beginnend bei 1. | Ja |
startTime |
Abspielpositionswert bei Start der Werbeunterbrechung. | Ja |
Erstellung von Werbeunterbrechungsobjekten:
id adBreakObject = [ADBMediaHeartbeat createAdBreakObjectWithName:[ADBREAK_NAME]
position:[POSITION]
startTime:[START_TIME]];
Rufen Sie trackEvent()
mit AdBreakStart
in der MediaHeartbeat
-Instanz auf, um das Tracking der Werbeunterbrechung zu starten:
- (void)onAdBreakStart:(NSNotification *)notification {
[_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdBreakStart
mediaObject:adBreakObject
data:nil];
}
Ermitteln Sie, wann die Anzeige startet und erstellen Sie die AdObject
-Instanz mithilfe dieser Anzeigeninformationen.
AdObject
-Referenz:
Variablenname | Beschreibung | erforderlich |
---|---|---|
name |
Der Anzeigename der Werbeanzeige. | Ja |
adId |
Eindeutige Kennung für die Anzeige. | Ja |
position |
Positionsnummer der Anzeige in der Werbeunterbrechung, beginnend bei 1. | Ja |
length |
Anzeigenlänge | Ja |
Erstellung von Anzeigenobjekten:
id adObject = [ADBMediaHeartbeat createAdObjectWithName:[AD_NAME]
adId:[AD_ID]
position:[POSITION]
length:[LENGTH]];
Optional können Standard- und/oder Anzeigenmetadaten über Kontextdatenvariablen an die Medien-Tracking-Sitzung angehängt werden.
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:
NSMutableDictionary *adDictionary = [[NSMutableDictionary alloc] init];
[adDictionary setObject:@"Sample affiliate" forKey:@"affiliate"];
[adDictionary setObject:@"Sample campaign" forKey:@"campaign"];
[adDictionary setObject:@"Sample creative" forKey:@"creative"];
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:
- (void)onAdStart:(NSNotification *)notification {
[_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdStart
mediaObject:adObject
data:adDictionary];
}
Wenn die Wiedergabe der Anzeige das Ende der Anzeige erreicht, rufen Sie trackEvent()
mit dem AdComplete
-Ereignis auf.
- (void)onAdComplete:(NSNotification *)notification {
[_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdComplete
mediaObject:nil
data:nil];
}
Wenn die Anzeigenwiedergabe nicht abgeschlossen wurde, weil der Benutzer die Anzeige überspringt, verfolgen Sie das AdSkip
-Ereignis.
- (void)onAdSkip:(NSNotification *)notification {
[_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdSkip
mediaObject:nil
data:nil];
}
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:
- (void)onAdBreakComplete:(NSNotification *)notification {
[_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdBreakComplete
mediaObject:nil
data:nil];
}
Weitere Informationen finden Sie im Tracking-Szenario VOD-Wiedergabe mit Pre-roll-Anzeigen.