Overzicht van Adobe Media Analytics voor audio- en video-extensie

NOTE
Adobe Experience Platform Launch is omgedoopt tot een reeks technologieën voor gegevensverzameling in Adobe Experience Platform. Diverse terminologische wijzigingen zijn als gevolg hiervan in de productdocumentatie doorgevoerd. Raadpleeg het volgende document voor een geconsolideerde referentie van de terminologische wijzigingen.

Gebruik deze documentatie voor informatie over het installeren, het vormen, en het uitvoeren van de Adobe Media Analytics voor Audio en Video uitbreiding (de uitbreiding van de Analyse van Media). Omvat zijn de opties beschikbaar wanneer het gebruiken van deze uitbreiding om een regel, samen met voorbeelden en verbindingen aan steekproeven te bouwen.

De uitbreiding Media Analytics (MA) voegt de kernJavaScript Media SDK (Media 2.x SDK) toe. Deze extensie biedt de functionaliteit voor het toevoegen van de MediaHeartbeat tracker-instantie naar een tagsite of -project. De extensie MA vereist twee extra extensies:

IMPORTANT
Voor audiotracering is Analytics Extension v1.6 of hoger vereist.

Nadat u alle drie bovengenoemde uitbreidingen in uw markeringsproject hebt omvat, kunt u op één van twee manieren te werk gaan:

  • Gebruiken MediaHeartbeat API's van uw webtoepassing
  • Neem een spelerspecifieke extensie op of maak een extensie die specifieke media Player-gebeurtenissen toewijst aan de API's op het tabblad MediaHeartbeat tracker. Deze instantie wordt blootgesteld door de uitbreiding van MA.

De extensie MA installeren en configureren

  • Installeren - Als u de extensie MA wilt installeren, opent u de eigenschap voor extensie Extensions > Catalog, boven de Adobe Media Analytics for Audio and Video en selecteert u Install.

  • Configureren - Om de uitbreiding van MA te vormen, open Extensions , plaatst u de cursor boven de extensie en selecteert u vervolgens Configure:

Configuratie MA-extensie

Configuratieopties:

Optie
Beschrijving
Trackingserver
Definieert de server voor het bijhouden van mediakoppen (dit is niet dezelfde server als de analytische trackingserver).
Toepassingsversie
De versie van de mediaspeler-app/SDK
Naam speler
Naam van de mediaspeler in gebruik (bijvoorbeeld "AVPlayer", "HTML5 Player", "My Custom VideoPlayer")
Kanaal
Channel name, eigenschap
Onlinevideoprovider
Naam van het onlinevideoplatform waarmee inhoud wordt gedistribueerd
Foutopsporingsregistratie
Logboekregistratie in- of uitschakelen
SSL inschakelen
Enable or Disable sending pings over HTTPS
API's exporteren naar vensterobject
Het exporteren van media-API's voor analyse naar een algemeen bereik in- of uitschakelen
Naam variabele
Een variabele die u gebruikt om media Analytics API's te exporteren onder de window object

Herinnering: De extensie MA vereist de Analyse en Experience Cloud-id extensies. U moet deze uitbreidingen aan uw uitbreidingsbezit ook toevoegen en hen vormen.

De extensie MA gebruiken

Werken via een webpagina/JS-app

De extensie MA exporteert de MediaHeartbone-API's in het algemene vensterobject door de instelling "API's exporteren naar vensterobject" in te schakelen in het dialoogvenster Configuration pagina. Het exporteert de API's onder de naam van de geconfigureerde variabele. Bijvoorbeeld, als de veranderlijke naam wordt gevormd om te zijn ADB dan kan MediaHeartbone door worden betreden window.ADB.MediaHeartbeat.

IMPORTANT
De extensie MA exporteert de API's alleen wanneer window["CONFIGURED_VARIABLE_NAME"] is ongedefinieerd en overschrijft bestaande variabelen niet.
  1. MediaHeartbone-instantie maken:  window["CONFIGURED_VARIABLE_NAME"].MediaHeartbeat.getInstance

    Param: Een geldig gedelegeerd object dat deze functies toegankelijk maakt.

    table 0-row-2 1-row-2 2-row-2 1-align-left 2-align-left 4-align-left 5-align-left 7-align-left 8-align-left
    Methode Beschrijving
    getQoSObject() Retourneert theMediaObject instantie die huidige informatie QoS bevat. Deze methode wordt meerdere keren aangeroepen tijdens een afspeelsessie. De implementatie van de speler moet altijd de recentst beschikbare gegevens terugkeren QoS.
    getCurrentPlaybackTime() Retourneert de huidige positie van de afspeelkop. Voor het bijhouden van VOD wordt de waarde opgegeven in seconden vanaf het begin van het media-item. Voor het bijhouden van LIVE-/LIVE-waarden wordt de waarde opgegeven in seconden vanaf het begin van het programma.

    Retourwaarde: Een belofte die ofwel met een MediaHeartbeat -instantie of wordt door een foutbericht geweigerd.

  2. Toegang tot MediaHeartbone-constanten:  window["CONFIGURED_VARIABLE_NAME"].MediaHeartbeat

    Hiermee worden alle constanten en statische methoden van de MediaHeartbeat klasse.

    U kunt de voorbeeldspeler hier verkrijgen: Voorbeeldspeler van MA. De voorbeeldspeler fungeert als een referentie waarmee u kunt laten zien hoe u de extensie MA kunt gebruiken om Media Analytics rechtstreeks vanuit een webapp te ondersteunen.

  3. Maak als volgt de instantie van MediaHeartbone tracker:

    code language-javascript
    var MediaHeartbeat = window["CONFIGURED_VARIABLE_NAME"].MediaHeartbeat;
    
    var delegate = {
        getCurrentPlaybackTime: this._getCurrentPlaybackTime.bind(this),
        getQoSObject: this._getQoSObject.bind(this),
    };
    
    var config = {
        playerName: "Custom Player",
        ovp: "Custom OVP",
        channel: "Custom Channel"
    };
    
    var self = this;
    MediaHeartbeat.getInstance(delegate, config).then(function(instance) {
        self._mediaHeartbeat = instance;
        // Do Tracking using the MediaHeartbeat instance.
    }).catch(function(err){
        // Getting MediaHeartbeat instance failed.
    });
    

Werken met andere extensies

De extensie MA stelt de get-instance en media-heartbeat gedeelde modules aan andere uitbreidingen. (Voor extra informatie over Gedeelde Modules, zie Documentatie van gedeelde modules.)

IMPORTANT
Gedeelde modules zijn alleen toegankelijk via andere extensies. Een webpagina/JS-toepassing heeft dus geen toegang tot de gedeelde modules of kan deze gebruiken turbine (zie codevoorbeeld hieronder) buiten een extensie.
  1. MediaHeartbone-instantie maken:  get-instance Gedeelde module

    Param:

    • Een geldig gedelegeerd object dat deze functies toegankelijk maakt:

      table 0-row-2 1-row-2 2-row-2 1-align-left 2-align-left 4-align-left 5-align-left 7-align-left 8-align-left
      Methode Beschrijving
      getQoSObject() Hiermee wordt het MediaObject instantie die de huidige informatie QoS bevat. Deze methode wordt meerdere keren aangeroepen tijdens een afspeelsessie. De spelerimplementatie moet altijd de laatst beschikbare gegevens terugkeren QoS.
      getCurrentPlaybackTime() Retourneert de huidige positie van de afspeelkop. Voor het bijhouden van VOD wordt de waarde opgegeven in seconden vanaf het begin van het media-item. Voor het bijhouden van LIVE-/LIVE-waarden wordt de waarde opgegeven in seconden vanaf het begin van het programma.
    • Een optioneel config-object dat deze eigenschappen toegankelijk maakt:

      table 0-row-3 1-row-3 2-row-3 3-row-3 1-align-left 2-align-left 3-align-left 5-align-left 6-align-left 7-align-left 9-align-left 10-align-left 11-align-left 13-align-left 14-align-left 15-align-left
      Eigenschap Beschrijving Vereist
      Onlinevideoprovider Naam van het online videoplatform waarmee inhoud wordt gedistribueerd. Nee. Indien aanwezig, treedt de waarde met voeten die tijdens uitbreidingsconfiguratie wordt bepaald.
      Naam speler Naam van de mediaspeler in gebruik (bijvoorbeeld "AVPlayer", "HTML5 Player", "My Custom VideoPlayer") Nee. Indien aanwezig, treedt de waarde met voeten die tijdens uitbreidingsconfiguratie wordt bepaald.
      Kanaal Channel name, eigenschap Nee. Indien aanwezig, treedt de waarde met voeten die tijdens uitbreidingsconfiguratie wordt bepaald.

    Retourwaarde: Een belofte die ofwel met een MediaHeartbeat -instantie of wordt door een foutbericht geweigerd.

  2. Toegang tot MediaHeartbone-constanten:  media-heartbeat Gedeelde module

    Deze module stelt alle constanten en statische methoden van deze klasse beschikbaar: https://adobe-marketing-cloud.github.io/media-sdks/reference/javascript/MediaHeartbeat.html.

  3. Maak als volgt de instantie van MediaHeartbone tracker:

    code language-javascript
    var getMediaHeartbeatInstance =
      turbine.getSharedModule('adobe-video-analytics', 'get-instance');
    
    var MediaHeartbeat =
      turbine.getSharedModule('adobe-video-analytics', 'media-heartbeat');
      ...
    
    var delegate = {
        getCurrentPlaybackTime: this._getCurrentPlaybackTime.bind(this),
        getQoSObject: this._getQoSObject.bind(this),
    }
    
    var config = {
        playerName: "Custom Player",
        ovp: "Custom OVP",
        channel: "Custom Channel"
    }
    ...
    
    var self = this;
    getMediaHeartbeatInstance(delegate, config).then(function(instance) {
        self._mediaHeartbeat = instance;
        ...
        // Do Tracking using the MediaHeartbeat instance.
    }).catch(function(err){
        // Getting MediaHeartbeat instance failed.
    });
    
    ...
    
  4. Gebruik de Media Heartboard-instantie om de JS-documentatie van Media SDK en JS API-documentatie om mediatracering te implementeren.

NOTE
Testen: Voor deze release moet u de extensie uploaden naar Platform, waar u toegang hebt tot alle afhankelijke extensies.
recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743