Advertenties bijhouden op Android track-ads-on-android
De volgende instructies bieden richtlijnen voor implementatie met behulp van de 2.x SDK's.
Constanten voor bijhouden van advertenties
MediaHeartbeat.Event.AdBreakStartMediaHeartbeat.Event.AdBreakCompleteMediaHeartbeat.Event.AdStartMediaHeartbeat.Event.AdCompleteMediaHeartbeat.Event.AdSkipImplementatiestappen
-
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 advertentierak binnen de inhoud, beginnend met 1. Ja startTimeWaarde 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>); -
Roep
trackEvent()aan metAdBreakStartin deMediaHeartbeat-instantie om het ad-einde te volgen:code language-java public void onAdBreakStart(Observable observable, Object data) { _heartbeat.trackEvent(MediaHeartbeat.Event.AdBreakStart, adBreakInfo, null); } -
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-java MediaObject adInfo = MediaHeartbeat.createAdObject(<AD_NAME> <AD_ID>, <POSITION>, <LENGTH>); -
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");
-
-
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-java public void onAdStart(Observable observable, Object data) { _heartbeat.trackEvent(MediaHeartbeat.Event.AdStart, adInfo, adMetadata); } -
Wanneer het afspelen van de advertentie het einde van de advertentie heeft bereikt, roept u
trackEvent()aan met de gebeurtenisAdComplete:code language-java public void onAdComplete(Observable observable, Object data) { _heartbeat.trackEvent(MediaHeartbeat.Event.AdComplete, null, null); } -
Als het afspelen van de advertentie niet is voltooid omdat de gebruiker de advertentie heeft overgeslagen, houdt u de gebeurtenis
AdSkipbij:code language-java public void onAdSkip(Observable observable, Object data) { _heartbeat.trackEvent(MediaHeartbeat.Event.AdSkip, null, null); } -
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-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.