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
ADBMediaHeartbeatEventAdBreakStartADBMediaHeartbeatEventAdBreakCompleteADBMediaHeartbeatEventAdStartADBMediaHeartbeatEventAdCompleteADBMediaHeartbeatEventAdSkipImplementierungsschritte
-
Ermitteln Sie, wann die Werbeunterbrechung beginnt, einschließlich Pre-Roll, und erstellen Sie ein
AdBreakObjectmithilfe 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 nameName der Anzeigenunterbrechung, z. B. Pre-roll, Mid-roll und Post-roll. Ja positionDie Position der Anzeigenunterbrechung im Inhalt, beginnend mit 1. Ja startTimeAbspielpositionswert 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()mitAdBreakStartin 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 nameDer Anzeigename der Werbeanzeige. Ja adIdEindeutige Kennung für die Anzeige. Ja positionDie Positionsnummer der Anzeige innerhalb der Werbeunterbrechung, beginnend mit 1. Ja lengthAnzeigenlä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
AdBreakweitere 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.