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.

IMPORTANT
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:

    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]];
    
  2. Rufen Sie trackEvent() mit AdBreakStart in der MediaHeartbeat-Instanz auf, um das Tracking der Werbeunterbrechung zu starten:

    code language-none
    - (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:

    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]];
    
  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:

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

    code language-none
    - (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.

    code language-none
    - (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.

    code language-none
    - (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:

    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.

recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb