Show Menu
TOPICS×

Tracking von Anzeigen in iOS

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.

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

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