DocumentatieExperience PlatformTags

Overzicht van Adobe Media Analytics (3.x SDK) voor audio- en video-extensie

Last update: Tue Jan 10 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Gemaakt voor:

  • Developer
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, configureren en implementeren van Adobe Media Analytics (3.x SDK) voor audio- en video-extensie (extensie Media Analytics). 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 3.x SDK) toe. Deze extensie biedt de functionaliteit voor het toevoegen van de Media tracker-instantie naar een locatie of project waarvoor tags zijn ingeschakeld. De extensie MA vereist twee extra extensies:

IMPORTANT
Deze uitbreiding stelt met Media 3.x SDK op, die niet achterwaarts compatibel met Media 2.x SDK is. Aangezien 2.x is afgekeurd, moet u een update naar 3.x uitvoeren.

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

  • Gebruiken Media 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 Media tracker-instantie. 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 (3.x SDK) 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
Verzameling-API Server
Definieert de API-server voor mediagroep (neem contact op met uw Adobe-vertegenwoordiger om deze server op te halen)
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
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 media-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 kunnen media-API's worden geopend door window.ADB.Media.

IMPORTANT
De extensie MA exporteert de API's alleen wanneer window["CONFIGURED_VARIABLE_NAME"] is ongedefinieerd en overschrijft bestaande variabelen niet.

  1. Media-API's:  window["CONFIGURED_VARIABLE_NAME"].Media

    Hiermee worden alle API's en constanten van de Media SDK weergegeven: https://adobe-marketing-cloud.github.io/media-sdks/reference/javascript_3x/APIReference.html

  2. Instantie van mediabeheer maken:  window["CONFIGURED_VARIABLE_NAME"].Media.getInstance

    Retourwaarde: A Media tracker-instantie voor het bijhouden van een mediasessie.

    code language-javascript 
    var Media = window["CONFIGURED_VARIABLE_NAME"].Media;

var tracker = Media.getInstance();

  3. Volg met behulp van de instantie Media tracker de JS API-documentatie om mediatracering te implementeren.

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.

Werken met andere extensies

De extensie MA wordt beschikbaar gemaakt media als een gedeelde module naar andere extensies. (Voor extra informatie over Gedeelde Modules, zie Documentatie van gedeelde modules.)

IMPORTANT
Gedeelde modules zijn alleen toegankelijk via andere extensies. Met andere woorden, een webpagina/JavaScript-toepassing heeft geen toegang tot de gedeelde modules of kan geen gebruik maken van turbine (zie codevoorbeeld hieronder) buiten een extensie.

  1. Media-API's:  media Gedeelde module

    Hiermee worden alle API's en constanten van de Media SDK weergegeven: https://adobe-marketing-cloud.github.io/media-sdks/reference/javascript_3x/APIReference.html

  2. Maak de instantie van Media tracker als volgt:

    Retourwaarde: A Media tracker-instantie voor het bijhouden van een mediasessie.

    code language-javascript 
    var Media =
  turbine.getSharedModule('adobe-media-analytics', 'media');

var tracker = Media.getInstance();

  3. Volg met behulp van de instantie Media tracker de 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