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. Gelieve te verwijzen naar het volgende documentvoor een geconsolideerde verwijzing van de terminologieveranderingen.

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 extensie Media Analytics (MA) voegt de core JavaScript Media SDK (Media 2.x SDK) toe. Deze extensie biedt de functionaliteit voor het toevoegen van de MediaHeartbeat tracker-instantie aan 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:

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

De extensie MA installeren en configureren

  • installeer - om de uitbreiding van MA te installeren, open uw uitbreidingsbezit, uitgezochte Extensions > Catalog, beweegt over de Adobe Media Analytics for Audio and Video uitbreiding, en selecteert Install.

  • vormt - om de uitbreiding van MA te vormen, open het Extensions lusje, over de uitbreiding te bewegen, en dan te selecteren Configure:

de Configuratie van de Uitbreiding van MA

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 het window -object

Herinnering: de uitbreiding van MA vereist de Analyticsen identiteitskaart van het Experience Clouduitbreidingen. 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 op de pagina Configuration . Het exporteert de API's onder de naam van de geconfigureerde variabele. Als de variabelenaam bijvoorbeeld is ingesteld op ADB , kan MediaHeartbeat worden benaderd door window.ADB.MediaHeartbeat .

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

    Params: Een geldig afgevaardigde voorwerp dat deze functies blootstelt.

    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 de huidige QoS-informatie 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.

    Waarde van de Terugkeer: Een belofte die of met a MediaHeartbeat instantie of verwerpt met een foutenmelding lost.

  2. De Constanten van MediaHeartbeat van de Toegang: window["CONFIGURED_VARIABLE_NAME"].MediaHeartbeat

    Dit stelt alle constanten en statische methodes van de MediaHeartbeatklasse bloot.

    U kunt de steekproefspeler hier verkrijgen: Speler van de Steekproef 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 gedeelde get-instance en media-heartbeat modules beschikbaar voor andere extensies. (Voor extra informatie over Gedeelde Modules, zie Gedeelde documentatie van Modules.)

IMPORTANT
Gedeelde modules zijn alleen toegankelijk via andere extensies. Een webpagina/JS-toepassing heeft dus geen toegang tot de gedeelde modules of kan turbine (zie het codevoorbeeld hieronder) buiten een extensie gebruiken.
  1. creeer de Instantie MediaHeartbeat: get-instance Gedeelde Module

    Params:

    • 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 de MediaObject -instantie die de huidige QoS-informatie 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.

    Waarde van de Terugkeer: Een belofte die of met a MediaHeartbeat instantie of verwerpt met een foutenmelding lost.

  2. De Constanten van MediaHeartbeat van de Toegang: media-heartbeat Gedeelde Module

    Deze module stelt alle constanten en statische methodes van deze klasse bloot: 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. Gebruikend de instantie van de Hartslag van Media, volg de documentatie van SDK van Media JSen JS API documentatieom media het volgen uit te voeren.

NOTE
het Testen: voor deze versie, om uw uitbreiding te testen moet u het aan Platformuploaden, waar u toegang tot alle afhankelijke uitbreidingen hebt.
recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743