Nachverfolgen von Anzeigen auf iOS
Erstellt für:
- Benutzende
- Admin
- Entwickler
Mit den folgenden Anweisungen können Sie die Implementierung unter Verwendung der 2.x-SDKs vornehmen.
Anzeigen-Tracking-Konstanten
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 |
Implementierungsschritte
-
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()
mitAdBreakStart
in derMediaHeartbeat
-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:VariablennameBeschreibungerforderlichname
Der Anzeigename der Werbeanzeige.JaadId
Eindeutige Kennung für die Anzeige.Japosition
Positionsnummer der Anzeige in der Werbeunterbrechung, beginnend bei 1.Jalength
AnzeigenlängeJaErstellung 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 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:
- (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 demAdComplete
-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.