Nachverfolgen von Anzeigen auf iOS track-ads-on-ios
Mit den folgenden Anweisungen können Sie die Implementierung unter Verwendung der 2.x-SDKs vornehmen.
Anzeigen-Tracking-Konstanten
ADBMediaHeartbeatEventAdBreakStart
ADBMediaHeartbeatEventAdBreakComplete
ADBMediaHeartbeatEventAdStart
ADBMediaHeartbeatEventAdComplete
ADBMediaHeartbeatEventAdSkip
Implementierungsschritte
-
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 3-align-center 7-align-center 11-align-center 15-align-center 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:
code language-none 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:code language-none - (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:table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 3-align-center 7-align-center 11-align-center 15-align-center 19-align-center 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:
code language-none 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:
code language-none 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:
code language-none - (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.code language-none - (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.code language-none - (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:code language-none - (void)onAdBreakComplete:(NSNotification *)notification { [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdBreakComplete mediaObject:nil data:nil]; }
Weitere Informationen finden Sie im Tracking-Szenario VOD-Wiedergabe mit Pre-roll-Anzeigen.