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.
Constanten voor bijhouden van advertenties
AdBreakStartAdBreakCompleteAdStartAdCompleteAdSkipImplementatiestappen
-
Bepaal wanneer de grens van de advertentieruimte begint, met inbegrip van pre-rol, en creeer
AdBreakObjectdoor de informatie van de advertentierak te gebruiken.AdBreakObjectreference: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 nameDe naam van het invoegpunt, zoals pre-roll, mid-roll en post-roll. Ja positionDe getalpositie van het advertentiespoor dat met 1 begint. Ja startTimeWaarde 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>); -
Roep
trackEvent()aan metAdBreakStartin deMediaHeartbeat-instantie om het ad-einde te volgen:code language-js mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdBreakStart, adBreakObject); -
Bepaal wanneer de advertentie begint en creeer een
AdObjectinstantie gebruikend de advertentieinformatie.AdObjectreference: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 nameVriendelijke naam van de advertentie. Ja adIdDe unieke id voor de advertentie. Ja positionDe numerieke positie van de advertentie binnen het advertentiespoor, beginnend met 1. Ja lengthAd-lengte Ja Object maken toevoegen:
code language-js var adObject = MediaHeartbeat.createAdObject(<AD_NAME>, <AD_ID>, <POSITION>, <LENGTH>); -
Voeg desgewenst standaard- en/of advertentiemetagegevens toe aan de mediatraceringssessie via de variabelen van de contextgegevens.
-
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" };
-
Roep
trackEvent()aan met de gebeurtenisAdStartin de instantieMediaHeartbeatom 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); }; -
Wanneer het afspelen van de advertentie het einde van de advertentie heeft bereikt, roept u
trackEvent()aan met de gebeurtenisAdComplete:code language-js _onAdComplete = function() { this._mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdComplete); }; -
Als het afspelen van de advertentie niet is voltooid omdat de gebruiker de advertentie heeft overgeslagen, houdt u de gebeurtenis
AdSkipbij:code language-js _onAdSkip = function() { this._mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdSkip); }; -
Herhaal stap 3 tot en met 7 opnieuw als er extra advertenties binnen dezelfde
AdBreakzijn. -
Wanneer het ad-einde is voltooid, gebruikt u de gebeurtenis
AdBreakCompleteom 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.