Advertenties bijhouden op Android track-ads-on-android

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
MediaHeartbeat.Event.AdBreakStart
Constante voor het bijhouden van de gebeurtenis AdBreak Start
MediaHeartbeat.Event.AdBreakComplete
Constante voor het bijhouden van de gebeurtenis AdBreak Complete
MediaHeartbeat.Event.AdStart
Constante voor het bijhouden van de gebeurtenis Ad Start
MediaHeartbeat.Event.AdComplete
Constante voor het bijhouden van de gebeurtenis Advertentie voltooid
MediaHeartbeat.Event.AdSkip
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-java
    MediaObject adBreakInfo =
      MediaHeartbeat.createAdBreakObject(<ADBREAK_NAME>,
                                         <POSITION>,
                                         <START_TIME>);
    
  2. Roep trackEvent() aan met AdBreakStart in de MediaHeartbeat -instantie om het ad-einde te volgen:

    code language-java
    public void onAdBreakStart(Observable observable, Object data) {
        _heartbeat.trackEvent(MediaHeartbeat.Event.AdBreakStart,
                              adBreakInfo,
                              null);
    }
    
  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-java
    MediaObject adInfo =
      MediaHeartbeat.createAdObject(<AD_NAME>
                                    <AD_ID>,
                                    <POSITION>,
                                    <LENGTH>);
    
  4. Voeg desgewenst standaard- en/of advertentiemetagegevens toe aan de mediatraceringssessie via de variabelen van de contextgegevens.

    help/use-cases/track-ads/impl-std-ad-metadata/impl-std-ad-metadata-android.md

    • 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-java
      // Setting Ad Metadata
      HashMap<String, String> adMetadata = new HashMap<String, String>();
      adMetadata.put("affiliate", "Sample affiliate");
      adMetadata.put("campaign", "Sample ad campaign");
      
  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-java
    public void onAdStart(Observable observable, Object data) {
        _heartbeat.trackEvent(MediaHeartbeat.Event.AdStart,
                              adInfo,
                              adMetadata);
    }
    
  6. Wanneer het afspelen van de advertentie het einde van de advertentie heeft bereikt, roept u trackEvent() aan met de gebeurtenis AdComplete :

    code language-java
    public void onAdComplete(Observable observable, Object data) {
        _heartbeat.trackEvent(MediaHeartbeat.Event.AdComplete, null, null);
    }
    
  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-java
    public void onAdSkip(Observable observable, Object data) {
        _heartbeat.trackEvent(MediaHeartbeat.Event.AdSkip, null, null);
    }
    
  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-java
    public void onAdBreakComplete(Observable observable, Object data) {
        _heartbeat.trackEvent(MediaHeartbeat.Event.AdBreakComplete, null, null);
    }
    

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

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