Nachverfolgen von Anzeigen auf iOS

Mit den folgenden Anweisungen können Sie die Implementierung unter Verwendung der 2.x-SDKs vornehmen.

Anzeigen-Tracking-Konstanten

Implementierungsschritte

1. 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]];
   

2. 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];
   }
   

3. 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]];
   

4. Optional können Standard- und/oder Anzeigenmetadaten über Kontextdatenvariablen an die Medien-Tracking-Sitzung angehängt werden.

   • Standard-Anzeigenmetadaten in iOS implementieren

   • 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"];
     

5. 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];
   }
   

6. 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];
   }
   

7. 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];
   }
   

8. Wiederholen Sie die Schritte 3 bis 7, wenn dieselbe AdBreak weitere Anzeigen enthält.

9. 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.

Ressourcen für Business.Adobe.com