DocumentatieAnalyticsHandleiding voor Streaming Media-services

Advertenties bijhouden op iOS track-ads-on-ios

Last update: Tue Oct 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Onderwerpen:

Gemaakt voor:

  • Gebruiker
  • Beheerder
  • Ontwikkelaar

De volgende instructies bieden richtlijnen voor implementatie met behulp van de 2.x SDK's.

IMPORTANT
Als u een 1.x versie van SDK uitvoert, kunt u 1.x de Gidsen van Ontwikkelaars hier downloaden: ​ Download SDKs.

Constanten voor bijhouden van advertenties

Naam van constante
Beschrijving
ADBMediaHeartbeatEventAdBreakStart
Constante voor het bijhouden van de gebeurtenis AdBreak Start
ADBMediaHeartbeatEventAdBreakComplete
Constante voor het bijhouden van de gebeurtenis AdBreak Complete
ADBMediaHeartbeatEventAdStart
Constante voor het bijhouden van de gebeurtenis Ad Start
ADBMediaHeartbeatEventAdComplete
Constante voor het bijhouden van de gebeurtenis Advertentie voltooid
ADBMediaHeartbeatEventAdSkip
Constante voor het bijhouden van de gebeurtenis Advertentie overslaan

Implementatiestappen

  1. Bepaal wanneer de grens van de advertentieruimte begint, met inbegrip van pre-rol, en creeer AdBreakObject door de informatie van de advertentierak te gebruiken.

    AdBreakObject reference:

    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
    Naam variabele Beschrijving Vereist
    name De naam van het invoegpunt, zoals pre-roll, mid-roll en post-roll. Ja
    position De getalpositie van het advertentierak binnen de inhoud, beginnend met 1. Ja
    startTime Waarde van afspeelkop aan het begin van het advertentieeinde. Ja

    Object maken van advertentie-einde:

    code language-none 
    id adBreakObject = [ADBMediaHeartbeat createAdBreakObjectWithName:[ADBREAK_NAME]
                            position:[POSITION]
                            startTime:[START_TIME]];

  2. Roep trackEvent() aan met AdBreakStart in de MediaHeartbeat -instantie om het ad-einde te volgen:

    code language-none 
    - (void)onAdBreakStart:(NSNotification *)notification {
    [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdBreakStart
                     mediaObject:adBreakObject
                     data:nil];
}

  3. Bepaal wanneer de advertentie begint en creeer een AdObject instantie gebruikend de advertentieinformatie.

    AdObject reference:

    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
    Naam variabele Beschrijving Vereist
    name Vriendelijke naam van de advertentie. Ja
    adId De unieke id voor de advertentie. Ja
    position De numerieke positie van de advertentie binnen het advertentiespoor, beginnend met 1. Ja
    length Ad-lengte Ja

    Object maken toevoegen:

    code language-none 
    id adObject = [ADBMediaHeartbeat createAdObjectWithName:[AD_NAME]
                                 adId:[AD_ID]
                                 position:[POSITION]
                                 length:[LENGTH]];

  4. Voeg desgewenst standaard- en/of advertentiemetagegevens toe aan de mediatraceringssessie via de variabelen van de contextgegevens.

    • Standaard en metagegevens implementeren op iOS

    • Douane en meta-gegevens - voor douanemetagegevens, creeer een veranderlijk voorwerp voor de variabelen van douanegegevens en bevolk met de gegevens voor de huidige advertentie:

      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. Roep trackEvent() aan met de gebeurtenis AdStart in de instantie MediaHeartbeat om het afspelen van de advertentie te volgen.

    Neem een verwijzing naar de aangepaste metagegevensvariabele (of een leeg object) op als de derde parameter in de gebeurtenisaanroep:

    code language-none 
    - (void)onAdStart:(NSNotification *)notification {
    [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdStart
                     mediaObject:adObject
                     data:adDictionary];
}

  6. Wanneer het afspelen van de advertentie het einde van de advertentie heeft bereikt, roept u trackEvent() aan met de gebeurtenis AdComplete .

    code language-none 
    - (void)onAdComplete:(NSNotification *)notification {
    [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdComplete
                     mediaObject:nil
                     data:nil];
}

  7. Als het afspelen van de advertentie niet is voltooid omdat de gebruiker de advertentie heeft overgeslagen, houdt u de gebeurtenis AdSkip bij.

    code language-none 
    - (void)onAdSkip:(NSNotification *)notification {
    [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdSkip
                     mediaObject:nil
                     data:nil];
}

  8. Herhaal stap 3 tot en met 7 opnieuw als er extra advertenties binnen dezelfde AdBreak zijn.

  9. Wanneer het ad-einde is voltooid, gebruikt u de gebeurtenis AdBreakComplete om bij te houden:

    code language-none 
    - (void)onAdBreakComplete:(NSNotification *)notification {
    [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdBreakComplete
                     mediaObject:nil
                     data:nil];
}

Zie het volgende scenario ​ de playback van VOD met pre-roladvertenties ​ voor meer informatie.

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