Advertenties bijhouden met JavaScript 2.x track-ads-on-javascript

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
AdBreakStart
Constante voor het bijhouden van de gebeurtenis AdBreak Start
AdBreakComplete
Constante voor het bijhouden van de gebeurtenis AdBreak Complete
AdStart
Constante voor het bijhouden van de gebeurtenis Ad Start
AdComplete
Constante voor het bijhouden van de gebeurtenis Advertentie voltooid
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 advertentiespoor dat met 1 begint. Ja
    startTime Waarde van afspeelkop aan het begin van het advertentieeinde. Ja

    Object maken van advertentie-einde:

    code language-js
    var adBreakObject =
      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-js
    mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdBreakStart, adBreakObject);
    
  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-js
    var adObject =
      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.

    • Standaard en metagegevens implementeren op JavaScript

    • 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-js
      /* Set custom context data */
      var adCustomMetadata = {
          affiliate: "Sample affiliate",
          campaign: "Sample ad campaign",
          creative: "Sample 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-js
    _onAdStart = function() {
        this._mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdStart,
                                        adObject,
                                        adCustomMetadata);
    };
    
  6. Wanneer het afspelen van de advertentie het einde van de advertentie heeft bereikt, roept u trackEvent() aan met de gebeurtenis AdComplete :

    code language-js
    _onAdComplete = function() {
        this._mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdComplete);
    };
    
  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-js
    _onAdSkip = function() {
        this._mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdSkip);
    };
    
  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-js
    _onAdBreakComplete = function() {
        this._mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdBreakComplete);
    };
    

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

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