Översikt över tillägget YouTube Video Tracking
Förhandskrav
För varje taggegenskap i Adobe Experience Platform krävs att följande tillägg installeras och konfigureras från skärmen Tillägg:
- Adobe Analytics
- Experience Cloud Visitor ID-tjänst
- Kärntillägg
Använd "Bädda in en spelare med ett <iframe>-kodfragment" från Google utvecklardokument HTML på varje webbsida där en videospelare ska återges.
Det här tillägget, version 2.0.1, stöder inbäddning av en eller flera YouTube-videofilmer på en enda webbsida genom att infoga ett id-attribut med ett unikt värde i skripttaggen iframe och lägga till enablejsapi=1 och rel=0 i slutet av attributvärdet src, om det inte redan finns. Exempel:
<iframe id="player1" width="560" height="315" src="https://www.youtube.com/embed/xpatB77BzYE?enablejsapi=1" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
Tillägget är även utformat för att dynamiskt kontrollera om det finns ett unikt ID-attributvärde, som player1, oavsett om frågesträngsparametrarna enablejsapi och rel finns och om deras förväntade värden är korrekta. Därför kan YouTube-skripttaggen läggas till på en webbsida med eller utan attributet id och om frågesträngsparametrarna enablejsapi och rel inkluderas eller inte.
Tillägget använder följande logik för att skriva om iFrames:
document.onreadystatechange = function () {
if (document.readyState === 'complete') {
Det innebär att det blir ett lätt flimmer när sidan har lästs in. Detta beteende förväntas.
Dataelement
Det finns sex tillgängliga dataelement i tillägget, varav inget kräver konfiguration.
- Spelhuvudsposition: Spelar in platsen, i sekunder, för spelhuvudets position på tidslinjen när den anropas inom en taggregel.
- Video-ID: Anger det YouTube-ID som är associerat med videon.
- Videonamn: Anger videons beskrivande eller egna namn.
- Video-URL: Returnerar YouTube.com för den video som är inläst/spelas upp.
- Videovaraktighet: Registrerar den totala längden, i sekunder, för videoinnehållet.
- Tilläggsversion: Det här dataelementet registrerar YouTube Tracking Extension-versionen, till exempel "Video Tracking_YouTube_2.0.0".
Händelser
Det finns åtta tillgängliga händelser i tillägget. Endast anpassad punktspårning kräver konfiguration.
- Videoklar: Utlöses när videon är klar för uppspelning och när den är klar för uppspelning.
- Videostart: Utlöses när videon startas för första gången och när
player.getCurrentTime() === 0 - Videouppspelning: utlöses när videon spelas upp och spelas upp efter den första starten. Den här utlösaren aktiveras vid varje uppspelning.
- Videopaus: Utlöses när videon pausas.
- Återuppta video: Utlöses när videon återupptas och när
player.getCurrentTime() !== 0 - Custom Cue Tracking: utlöses när videon når det angivna tröskelvärdet i procent. Om en video till exempel är 60 sekunder och den angivna referenspunkten är 50 %, utlöses händelsen när spelhuvudets position är 30 sekunder. Referenspunktsspårning gäller både för inledande uppspelning och uppspelning. Observera att händelsen inte utlöses om användaren söker över en referenspunkt. Referenspunktshändelser utlöses bara när spelhuvudet korsar den beräknade referenspunktspositionen på tidslinjen och videospelaren spelas upp.
- Videobuffert: utlöses när spelaren hämtar en viss mängd data innan videon börjar spelas upp.
- Video avslutad: utlöses när en video är klar.
Användning
En taggregel kan anges för varje videohändelse (de sju händelserna ovan). Skapa en specifik taggregel för varje händelse som du vill spåra. Om du inte vill spåra en händelse utelämnar du helt enkelt att skapa en regel för den.
Regler har tre åtgärder:
- Ange variabler: Ange Adobe Analytics-variabler (mappa till alla eller vissa inkluderade dataelement).
- Skicka fyr: Skicka Adobe Analytics-fyren som ett anpassat länkspårningsanrop och ange ett länknamnsvärde.
- Rensa variabler: Rensa Adobe Analytics-variabler.
Exempelmärkordsregel för "Videostart"
Följande videotilläggsobjekt ska inkluderas.
-
Händelser: "Videostart" (Den här händelsen aktiverar regeln när besökaren börjar spela upp en YouTube-video.)
-
Villkor: Inget
-
Åtgärder: Använd Analytics-tillägget för att ange variabler för att mappa:
- Händelsen för videostart,
- Ett prop/eVar för videodataelementet Duration
- Ett prop/eVar för Video ID-dataelementet
- Ett prop/eVar för videoelementet Namn
- Ett prop/eVar för Video URL-dataelementet
Inkludera sedan åtgärden"Skicka signal" (
s.tl) med länknamnet"videostart" följt av åtgärden"Rensa variabler".
Om du vill sammanfoga videoinformationsvärden skapar du ett nytt dataelement som kallas"Videometadata" och programmerar det så att det hämtas in alla videodataelement (som listas ovan) och sammanställer dem. Exempel:
var r = [];
r.push('YouTube'); //Player Name
r.push(_satellite.getVar('Video ID'));
r.push(_satellite.getVar('Video Name'));
r.push(_satellite.getVar('Video Duration'));
r.push(_satellite.getVar('Extension Version'));
return r.join('|');
Mer information om hur du skapar och återanvänder dataelement effektivt i plattformen finns i dokumentationen för dataelement.