Video bijhouden configureren voor Adobe Analytics

Er zijn verschillende methoden beschikbaar voor het bijhouden van videogebeurtenissen, waarvan er twee oudere opties zijn voor oudere versies van Adobe Analytics. Deze oudere optie is: Verouderde mijlpalen en oude seconden.

OPMERKING

Voordat u verdergaat, moet u ervoor zorgen dat er een afspeelbare video is geüpload in AEM.

Als u wilt dat uw video's op de pagina worden afgespeeld, raadpleegt u deze zelfstudie voor informatie over het transcoderen van videobestanden in AEM.

Gebruik de volgende procedure om een framework voor het bijhouden van video's in te stellen met elke methode.

OPMERKING

Voor nieuwe implementaties, adviseert men dat u niet de erfenisopties voor video het volgen gebruikt. Gebruik in plaats hiervan de methode Mijlpalen.

Algemene stappen

  1. Een webpagina instellen door een video-component van het hulpwerkstation te slepen en een afspeelbare video als element voor de component toe te voegen

  2. Maak een Adobe Analytics-configuratie en -framework.

    • De voorbeelden in de volgende secties gebruiken de naam my-sc-configuration voor de configuratie en video voor het framework.
  3. Voor de kaderpagina, selecteer RSID en plaats het gebruik aan allen. (http://localhost:4502/cf#/etc/cloudservices/sitecatalyst/videoconf/videofw.html)

  4. Sleep de component Video van de categorie Algemeen in Sidetrap naar het framework.

  5. Selecteer een methode voor bijhouden:

  6. Wanneer u een methode voor bijhouden selecteert, wordt de lijst met CQ-variabelen dienovereenkomstig gewijzigd. Gebruik de secties die volgen voor informatie over hoe te om de component verder te vormen en de CQ variabelen met de eigenschappen van Adobe Analytics in kaart te brengen.

Mijlpalen

De methode van Mijlpalen volgt de meeste informatie over de video, is hoogst klantgericht, en gemakkelijk te vormen.

Als u de methode Mijlpalen wilt gebruiken, geeft u op tijd gebaseerde verschuivingen op om de mijlpalen te definiëren. Wanneer een videoplayback een mijlpaal overgaat, roept de pagina Adobe Analytics aan om de gebeurtenis te volgen. Voor elke mijlpaal die u definieert, maakt de component een CQ-variabele die u kunt toewijzen aan een Adobe Analytics-eigenschap. De naam van deze CQ-variabelen gebruikt de volgende indeling:

eventdata.events.milestoneXX

Het achtervoegsel XX is de spoorcompensatie die de mijlpaal bepaalt. Als u bijvoorbeeld verschuivingen van 4, 8, 16, 20 en 28 seconden opgeeft, worden de volgende CQ-variabelen gegenereerd:

  • eventdata.events.milestone4
  • eventdata.events.milestone8
  • eventdata.events.milestone16
  • eventdata.events.milestone20
  • eventdata.events.milestone28

In de volgende tabel worden de standaard CQ-variabelen beschreven die voor de methode Mijlpalen worden verschaft:

CQ-variabelen Adobe Analytics-eigenschappen
eventdata.videoName Variabelen die hieraan zijn toegewezen, bevatten de gebruiksvriendelijke-naam (Title) van de video indien deze in de DAM is ingesteld; als deze niet is ingesteld, wordt in plaats daarvan de bestandsnaam van de video verzonden. Slechts één keer verzonden, aan het begin van het afspelen van een video.
eventdata.videoFileName Variabelen die hieraan zijn toegewezen, bevatten de bestandsnaam. Alleen verzonden samen met eventData.events.a.media.view
eventdata.videoFilePath Variabelen die hieraan zijn toegewezen, bevatten het bestandspad op de server. Alleen verzonden samen met eventData.events.a.media.view
eventdata.events.a.media.segmentView Verzonden telkens wanneer een segmentmijlpaal wordt overgegaan
eventdata.events.a.media.timePlayed Verzonden telkens als een mijlpaal wordt teweeggebracht, wordt het aantal seconden de gebruiker besteedde het letten op het bepaalde segment ook verzonden samen met deze gebeurtenis. bijv. eventX=21
eventdata.events.a.media.view Verzonden bij initialisatie videoweergave
eventdata.events.a.media.complete Verzonden wanneer video klaar is met afspelen
eventdata.events.milestoneX Wordt verzonden wanneer de opgegeven mijlpaal is bereikt, dan staat X voor de seconde dat de mijlpaal wordt geactiveerd bij
eventdata.a.contentType Verzonden op elke mijlpaal; toont omhoog zoals pev3 in de vraag van Adobe Analytics, gewoonlijk verzonden als "video"
eventdata.a.media.name Komt exact overeen met eventdata.videoName
eventdata.a.media.segment Bevat informatie over het segment dat is weergegeven, bijvoorbeeld 2:O:4-8
OPMERKING

U kunt de gebruikersvriendelijke ​ naam van een video plaatsen door de video voor het uitgeven in DAM te openen, en Titel meta-gegevensgebied aan de gewenste naam te plaatsen.

  1. Nadat u Mijlpalen hebt geselecteerd als de methode voor bijhouden, voert u in het vak Verschuiving track een door komma's gescheiden lijst met verschuivingen in seconden in. De volgende waarde definieert bijvoorbeeld mijlpalen 4, 8, 16, 20 en 28 seconden na het begin van de video:

    4,8,16,20,24
    

    De verschuivingswaarden moeten gehele getallen zijn die groter zijn dan 0. De standaardwaarde is 10,25,50,75.

  2. Als u de CQ-variabelen wilt toewijzen aan Adobe Analytics-eigenschappen, sleept u de Adobe Analytics-eigenschappen van ContentFinder naast de CQ-variabele op de component.

    Zie de handleiding Video meten in Adobe Analytics voor informatie over het optimaliseren van de toewijzingen.

  3. Voeg het framework toe aan de pagina.

  4. Als u de installatie wilt testen in Voorvertoningsmodus, speelt u de video af om Adobe Analytics-aanroepen te activeren.

De volgende voorbeelden van Adobe Analytics-volggegevens zijn van toepassing op het bijhouden van mijlpaden met gebruik van trackverschuivingen van 4,8,16,20 en 24, en de volgende toewijzingen voor de CQ-variabelen:

Variabele CQ Adobe Analytics, eigenschap
eventdata.videoName prop2
eventdata.videoFileName prop3
eventdata.videoFilePath prop4
eventdata.events.a.media.segmentView event1
eventdata.events.a.media.timePlayed event2
eventdata.events.a.media.view event3
eventdata.events.a.media.complete event4
eventdata.events.milestone4 event10
eventdata.events.milestone8 event11
eventdata.events.milestone16 event12
eventdata.events.milestone20 event13
eventdata.events.milestone24 event14
eventdata.a.contentType eVar3
eventdata.a.media.name eVar1, prop1
eventdata.a.media.segment eVar2

In dit voorbeeld wordt de component Video als volgt weergegeven op de frameworkpagina:

video1

OPMERKING

Om de vraag te zien die aan Adobe Analytics wordt gemaakt gebruik een aangewezen hulpmiddel, zoals Debugger DigitalPulse of Fiddler.

De vraag aan Adobe Analytics die het verstrekte voorbeeld gebruikt zou als dit moeten kijken wanneer bekeken met Debugger DigitalPulse:

chlimage_1-156

Dit is de eerste​aanroep van Adobe Analytics met de volgende waarden:

  • prop1 en eVar1 voor eventdata.a.media.name,
  • props2-4, samen met eVar2 en eVar3 met contentType (video) en segment (1:O:1-4)
  • event3, die is toegewezen aan eventData.events.a.media.view.

chlimage_1-157

Dit is de derde​oproep aan Adobe Analytics:

  • prop1 en eVar1 bevattena.media.name;
  • event1 omdat een segment is weergegeven
  • gebeurtenis2 verzonden met afgespeelde tijd = 4
  • event11 verzonden omdat eventData.events.milestone8 is bereikt
  • prop2 tot en met 4 worden niet verzonden (omdat eventdata.events.a.media.view niet werd geactiveerd)

Niet-verouderde mijlpalen

De methode Niet-verouderde mijlpalen is vergelijkbaar met de methode Mijlpalen, behalve dat mijlpalen worden gedefinieerd met percentages van de lengte van de sporen. De gemeenschappelijke waarden zijn als volgt:

  • Wanneer een videoplayback een mijlpaal overgaat, roept de pagina Adobe Analytics aan om de gebeurtenis te volgen.
  • De statische set CQ-variabelen die zijn gedefinieerd voor toewijzing met Adobe Analytics-eigenschappen.
  • Voor elke mijlpaal die u definieert, maakt de component een CQ-variabele die u kunt toewijzen aan een Adobe Analytics-eigenschap.

De naam van deze CQ-variabelen gebruikt de volgende indeling:

Het achtervoegsel XX is het percentage van spoorlengte dat de mijlpaal bepaalt. Als u bijvoorbeeld percentages van 10, 25, 50 en 75 opgeeft, worden de volgende CQ-variabelen gegenereerd:

  • eventdata.events.milestone10
  • eventdata.events.milestone25
  • eventdata.events.milestone50
  • eventdata.events.milestone75
eventdata.events.milestoneXX
  1. Nadat u Niet-verouderde mijlpalen hebt geselecteerd als methode voor het bijhouden van wijzigingen, voert u in het vak Verschuiving track een door komma's gescheiden lijst met percentages van de lengte van de track in. De volgende standaardwaarde definieert bijvoorbeeld mijlpalen op 10, 25, 50 en 75 procent van de lengte van het spoor:

    10,25,50,75
    

    De verschuivingswaarden moeten gehele getallen zijn die groter zijn dan 0.

  2. Als u de CQ-variabelen wilt toewijzen aan Adobe Analytics-eigenschappen, sleept u de Adobe Analytics-eigenschappen van ContentFinder naast de CQ-variabele op de component.

    Zie de handleiding Video meten in Adobe Analytics voor informatie over het optimaliseren van de toewijzingen.

  3. Voeg het framework toe aan de pagina.

  4. Als u de installatie wilt testen in Voorvertoningsmodus, speelt u de video af om Adobe Analytics-aanroepen te activeren.

Legacy-mijlpalen

Deze methode is vergelijkbaar met de methode met mijlpalen, waarbij het verschil is dat de mijlpalen die in het veld Offset bijhouden zijn opgegeven percentages zijn in plaats van instelpunten in de video.

OPMERKING

Het veld Verschuiving voor reeksspatiëring accepteert alleen een door komma's gescheiden lijst met hele getallen tussen 1 en 100.

  1. Stel de verschuiving track in.

    • e.g.10,50,75,100

    Bovendien is de informatie die naar Adobe Analytics wordt verzonden minder aanpasbaar; er zijn slechts drie variabelen beschikbaar om in kaart te brengen :

eventdata.videoName
Variabelen die hieraan zijn toegewezen, bevatten de gebruiksvriendelijke-naam (Title) van de video indien deze in de DAM is ingesteld; als de titel niet is ingesteld, wordt in plaats daarvan de bestandsnaam van de video verzonden. Slechts één keer verzonden, aan het begin van het spelen van een video.
eventdata.videoFileName Variabelen die hieraan zijn toegewezen, bevatten de bestandsnaam. Slechts één keer verzonden, aan het begin van het afspelen van een video.
eventdata.videoFilePath De variabele die aan dit wordt toegewezen zal het weg van het dossier op de server bevatten. Slechts één keer verzonden, aan het begin van het afspelen van een video.
OPMERKING

U kunt de gebruiksvriendelijke ​ naam van een video instellen door de video te openen voor bewerking in de DAM en het veld Title ​ metadata in te stellen op de gewenste naam. U moet ook de aangebrachte wijzigingen opslaan wanneer u klaar bent.

  1. Deze variabelen toewijzen aan de profielen 1 tot en met 3

    De rest van de relevante informatie in de vraag zal in one variabele genoemd pev3 worden samengevoegd.

    Voorbeelden van aanroepen naar Adobe Analytics met behulp van het opgegeven voorbeeld moeten er als volgt uitzien bij weergave met DigitalPulse-foutopsporing:

    mijlpalen1

    De pev3​variabele die in de vraag wordt verzonden bevat de volgende informatie:

    • Naam - De naam van het videobestand (film.avi)
    • Lengte - De lengte van het videobestand, in seconden (100)
    • Naam speler - De videospeler die wordt gebruikt om het videobestand af te spelen (HTML5-video)
    • Totaal aantal seconden dat wordt afgespeeld - Het totale aantal seconden dat de video is afgespeeld (25)
    • Tijdstempel starten - Tijdstempel die aangeeft wanneer het afspelen van de video is gestart (1331035567)
    • Afspeelsessie - De details van de afspeelsessie. In dit veld wordt aangegeven hoe de gebruiker met de video heeft gewerkt. Dit kunnen gegevens zijn zoals waar de video is afgespeeld, of de videoschuifregelaar is gebruikt om de video te versnellen en waar het afspelen van de video is gestopt (L10E24S58L58 - video is even gestopt. 25 van sectie L10, overgeslagen tot sec. 48)

Verouderde seconden

Wanneer het gebruiken van de ​ erfenisseconden methode, worden de vraag van Adobe Analytics teweeggebracht om de n-de seconde, waar N op het Spoor compensatieveld wordt gespecificeerd.

  1. Stel de verschuiving van track in op een willekeurig aantal seconden,

    • bijv. 6
    OPMERKING

    Het veld Tracking-verschuiving accepteert alleen hele getallen die hoger zijn dan 0

    De gegevens die naar Adobe Analytics worden verzonden, kunnen minder worden aangepast. Er zijn slechts drie variabelen beschikbaar voor toewijzing:

eventdata.videoName
Variabelen die hieraan zijn toegewezen, bevatten de gebruiksvriendelijke-naam (Title) van de video indien deze in de DAM is ingesteld; als de titel niet is ingesteld, wordt in plaats daarvan de bestandsnaam van de video verzonden. Slechts één keer verzonden, aan het begin van het spelen van een video.
eventdata.videoFileName De variabele die hieraan is toegewezen, bevat de bestandsnaam. Slechts één keer verzonden, aan het begin van het afspelen van een video.
eventdata.videoFilePath De variabele die aan dit wordt toegewezen zal het weg van het dossier op de server bevatten. Slechts één keer verzonden, aan het begin van het afspelen van een video.
OPMERKING

U kunt de gebruikersvriendelijke ​ naam van een video plaatsen door de video voor het uitgeven in DAM te openen, en Titel meta-gegevensgebied aan de gewenste naam te plaatsen. U moet ook de aangebrachte wijzigingen opslaan wanneer u klaar bent.

  1. Deze variabelen toewijzen aan prop1, prop2 en prop3

    De rest van de relevante informatie in de vraag zal in one variabele genoemd pev3 worden samengevoegd.

    De vraag aan Adobe Analytics die het verstrekte voorbeeld gebruikt zou als dit moeten kijken wanneer bekeken met Debugger DigitalPulse:

    lseconds

    De vraag is gelijkaardig aan de Verouderde vraag van de Mijlpalen hierboven. Zie de informatie over pev3 die daar wordt verstrekt.

Referenties die in deze zelfstudie worden gebruikt:

[0] https://docs.adobe.com/content/help/nl-NL/media-analytics/using/sdk-implement/setup/setup-overview.html

Op deze pagina