DokumentationExperience PlatformTags

Adobe Media Analytics (3.x SDK) for Audio and Video-Erweiterung – Übersicht

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Themen:

Erstellt für:

  • Entwickler
NOTE
Adobe Experience Platform Launch wurde als eine Suite von Datenerfassungstechnologien in Adobe Experience Platform umbenannt. Infolgedessen wurden in der gesamten Produktdokumentation mehrere terminologische Änderungen eingeführt. Eine konsolidierte Übersicht der terminologischen Änderungen finden Sie im folgenden Dokument.

In dieser Dokumentation finden Sie Informationen zum Installieren, Konfigurieren und Implementieren der „Adobe Media Analytics (3.x SDK) for Audio and Video“-Erweiterung (Media Analytics-Erweiterung). Darin enthalten sind neben Beispielen und Links zu Mustern die verfügbaren Optionen bei Verwendung dieser Erweiterung zum Erstellen einer Regel.

Durch die Media Analytics (MA)-Erweiterung wird das JavaScript-Media-SDK (Media 3.x-SDK) hinzugefügt. Diese Erweiterung bietet die Funktionalität zum Hinzufügen der Media-Tracker-Instanz zu einer Site oder einem Projekt mit Tag-Aktivierung. Für die MA-Erweiterung sind zwei weitere Erweiterungen erforderlich:

IMPORTANT
Diese Erweiterung wird mit dem Media 3.x SDK bereitgestellt, das nicht abwärtskompatibel mit dem Media 2.x SDK ist. Da 2.x veraltet ist, aktualisieren Sie bitte auf 3.x.

Nachdem Sie alle drei der zuvor erwähnten Erweiterungen in Ihr Projekt mit Tag-Aktivierung eingefügt haben, haben Sie zwei Möglichkeiten, den Vorgang fortzusetzen:

  • Verwenden Sie Media-APIs aus Ihrer Web-Anwendungserweiterung
  • Integrieren oder erstellen Sie eine Player-spezifische Erweiterung, die bestimmte Medienplayer-Ereignisse den APIs der Media-Tracker-Instanz zuordnet. Diese Instanz wird über die MA-Erweiterung offengelegt.

Installieren und Konfigurieren der MA-Erweiterung

  • Installieren: Um die MA-Erweiterung zu installieren, öffnen Sie die Erweiterungseigenschaft, wählen Sie Erweiterungen > Katalog aus, bewegen Sie den Mauszeiger über die Erweiterung Adobe Medien Analytics (3.x SDK) für Audio und Video und wählen Sie Installieren aus.

  • Konfigurieren: Um die MA-Erweiterung zu konfigurieren, öffnen Sie die Registerkarte Erweiterungen, bewegen Sie den Mauszeiger über die Erweiterung und klicken Sie dann auf Konfigurieren:

Konfigurieren der MA-Erweiterung

Konfigurationsoptionen:

Option
Beschreibung
Collection API Server
Definiert den Media Collection-API-Server (wenden Sie sich an Ihren Adobe-Support-Mitarbeiter, um diesen Server zu erhalten)
Application Version
Medienplayer-App-/Medienplayer-SDK-Version
Player Name
Name des verwendeten Medienplayers, z. B. „AVPlayer“, „HTML5-Player“, „Mein anwenderspezifischer Player“.
Kanal
Kanalnamen-Eigenschaft
Debug Logging
Aktivieren oder Deaktivieren der Protokollierung
Enable SSL
Aktivieren oder Deaktivieren des Sendens von Pings über HTTPS
Export APIs to Window Object
Aktivieren oder Deaktivieren des Exports von Media Analytics-APIs für einen globalen Umfang
Variable Name
Eine Variable, die Sie zum Exportieren von Media Analytics-APIs unter dem window-Objekt verwenden

Erinnerung: Für die MA-Erweiterung sind die Analytics- und Experience Cloud ID-Erweiterungen erforderlich. Sie müssen diese Erweiterungen auch Ihrer Erweiterungseigenschaft hinzufügen und konfigurieren.

Verwenden der MA-Erweiterung

Verwendung auf einer Webseite/JS-App

Die MA-Erweiterung exportiert die Media-APIs im globalen Fensterobjekt, indem sie die Einstellung „Export APIs to Window Object“ auf der Seite Konfiguration aktiviert. Die APIs werden unter dem konfigurierten Variablennamen exportiert. Wenn der Variablenname beispielsweise als ADB konfiguriert ist, ist der Media-API-Zugriff über window.ADB.Media möglich.

IMPORTANT
Die MA-Erweiterung exportiert die APIs nur, wenn window["CONFIGURED_VARIABLE_NAME"] nicht definiert ist, und vorhandene Variablen werden nicht überschrieben.

  1. Media-APIs:  window["CONFIGURED_VARIABLE_NAME"].Media

    Dadurch werden alle APIs und Konstanten aus dem Media-SDK verfügbar gemacht: https://adobe-marketing-cloud.github.io/media-sdks/reference/javascript_3x/APIReference.html

  2. Media-Tracker-Instanz erstellen:  window["CONFIGURED_VARIABLE_NAME"].Media.getInstance

    Rückgabewert: Eine Media-Tracker-Instanz zur Verfolgung einer Mediensitzung.

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

var tracker = Media.getInstance();

  3. Verwenden Sie die Media-Tracker-Instanz und befolgen Sie die JS-API-Dokumentation, um die Medienverfolgung zu implementieren.

Sie können den Beispielplayer hier abrufen: MA Sample Player. Der Beispiel-Player dient als Referenz zur Verwendung der MA-Erweiterung zur Unterstützung von Media Analytics direkt über eine Webapp.

Verwendung in anderen Erweiterungen

Die MA-Erweiterung stellt media als freigegebenes Modul anderen Erweiterungen zur Verfügung. (Weitere Informationen zu freigegebenen Modulen finden Sie in der Dokumentation zu freigegebenen Modulen.)

IMPORTANT
Der Zugriff auf freigegebene Module ist nur über andere Erweiterungen möglich. Das heißt, eine Website/JavaScript-App kann nicht außerhalb einer Erweiterung auf die freigegebenen Module zugreifen oder turbine verwenden (siehe Code-Beispiel unten).

  1. Media-APIs: media Freigegebenes Modul

    Dadurch werden alle APIs und Konstanten aus dem Media SDK verfügbar gemacht: https://adobe-marketing-cloud.github.io/media-sdks/reference/javascript_3x/APIReference.html

  2. Erstellen Sie die Media-Tracker-Instanz wie folgt:

    Rückgabewert: Eine Media-Tracker-Instanz zur Verfolgung einer Mediensitzung.

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

var tracker = Media.getInstance();

  3. Verwenden Sie die Media-Tracker-Instanz und befolgen Sie die JS-API-Dokumentation, um die Medienverfolgung zu implementieren.

NOTE
Testen:  Um Ihre Erweiterung zu testen, müssen Sie sie in Platform hochladen, wo Sie Zugriff auf alle abhängigen Erweiterungen haben.
recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743