Dokumentation Analytics Streaming Media Collection-Handbuch

Einrichten des Mobile SDK v3.x für Chromecast set-up-chromecast

Last update: Wed Jun 26 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Themen:

Erstellt für:

Benutzende
Admin
Entwickler

In diesem Abschnitt werden die Voraussetzungen für die Einrichtung einer Chromecast-Installation für das Streaming-Mediensammlungs-Add-on beschrieben.

Voraussetzungen

Abrufen gültiger Konfigurationsparameter

Sie können diese Parameter von einem Adobe-Support-Mitarbeiter erhalten, wenn Sie Ihr Media Analytics-Konto eingerichtet haben.
Integrieren der folgenden APIs in Ihren Media Player
- Eine API zum Abonnieren von Player-Ereignissen: Das Media SDK erfordert den Aufruf einer Reihe einfacher APIs, wenn im Player Ereignisse auftreten.
- Eine API, die Player-Informationen bereitstellt: Diese Informationen enthalten Details wie den Mediennamen und die Abspielposition.

Adobe Mobile Services bietet eine neue Anwenderoberfläche, auf der mobile Marketingfunktionen für mobile Anwendungen aus der gesamten Adobe Experience Cloud kombiniert werden. Zunächst bietet der Mobile Service eine nahtlose Integration von App-Analyse- und Targeting-Funktionen für die Lösungen Adobe Analytics und Adobe Target. Weitere Informationen finden Sie in der Dokumentation zu Adobe Mobile Services.

Mit der Adobe Mobile Library für Chromecast v3.x für Experience Cloud-Lösungen können Sie in JavaScript geschriebene Chromecast-Anwendungen messen, Zielgruppendaten durch Zielgruppen-Management nutzen und erfassen sowie Videointeraktionen messen.

Mobile Library-/SDK-Implementierung

Fügen Sie Ihre heruntergeladene Chromecast-Bibliothek zu Ihrem Projekt hinzu.

Die Datei AdobeMobileLibrary-Chromecast-[version] zip enthält folgende Softwarekomponenten:
- adbmobile-chromecast.min.js:
  
  Diese Bibliothek ist im Quellordner Ihrer Chromecast-App enthalten.
- ADBMobileConfig-Konfigurationsdatei
  
  Hierbei handelt es sich um die SDK-Konfigurationsdatei, die für Ihre App angepasst wird. Eine exemplarische ADBMobileConfig-Implementierung wird mit dem SDK mitgeliefert (unter samples/). Die richtigen Einstellungen erhalten Sie von einem Adobe-Support-Mitarbeiter.

Fügen Sie die Bibliotheksdatei zu Ihrer index.html-Datei hinzu und erstellen Sie die globale Variable der ADBMobileConfig wie folgt (die globale Variable, mit der Adobe Mobile für Media Analytics konfiguriert wird, hat einen exklusiven Schlüssel namens mediaHeartbeat):

code language-js

code language-js
<script> var ADBMobileConfig = { "marketingCloud": { "org": "972C898555E9F7BC7F000101@AdobeOrg" }, "target": { "clientCode": "", "timeout": 5 }, "audienceManager": { "server": "obumobile5.demdex.net" }, "analytics": { "rsids": "example.sample.player", "server": "example.sc.omtrc.net", "ssl": true, "offlineEnabled": false, "charset": "UTF-8", "lifecycleTimeout": 300, "privacyDefault": "optedin", "batchLimit": 0, "timezone": "MDT", "timezoneOffset": -360, "referrerTimeout": 0, "poi": [] }, "mediaHeartbeat": { "server": "example.hb-api.omtrdc.net", "publisher": "972C898555E9F7BC7F000101@AdobeOrg", "channel": "test-channel-chromecast", "ssl": true, "ovp": "chromecast-player", "sdkVersion": "chromecast-sdk", "playerName": "Chromecast" } }; </script> <script type="text/javascript" src="script/lib/adbmobile-chromecast.min.js"></script>

<script>
    var ADBMobileConfig = {
      "marketingCloud": {
        "org": "972C898555E9F7BC7F000101@AdobeOrg"
      },
      "target": {
        "clientCode": "",
        "timeout": 5
      },
      "audienceManager": {
        "server": "obumobile5.demdex.net"
      },
      "analytics": {
        "rsids": "example.sample.player",
        "server": "example.sc.omtrc.net",
        "ssl": true,
        "offlineEnabled": false,
        "charset": "UTF-8",
        "lifecycleTimeout": 300,
        "privacyDefault": "optedin",
        "batchLimit": 0,
        "timezone": "MDT",
        "timezoneOffset": -360,
        "referrerTimeout": 0,
        "poi": []
      },
      "mediaHeartbeat": {
        "server": "example.hb-api.omtrdc.net",
        "publisher": "972C898555E9F7BC7F000101@AdobeOrg",
        "channel": "test-channel-chromecast",
        "ssl": true,
        "ovp": "chromecast-player",
        "sdkVersion": "chromecast-sdk",
        "playerName": "Chromecast"
      }
    };
  </script>
<script type="text/javascript" src="script/lib/adbmobile-chromecast.min.js"></script>

note important
IMPORTANT
Wenn `mediaHeartbeat` nicht richtig konfiguriert ist, wechselt das Medienmodul in einen Fehlerstatus und sendet keine Tracking-Aufrufe mehr.

ADBMobile-Konfigurationsparameter für mediaHeartbeat-Schlüssel:

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2
Konfigurationsparameter	Beschreibung
`server`	Zeichenfolge, die die URL des Tracking-Endpunkts am Backend angibt.
`publisher`	Zeichenfolge, die den Publisher des Inhalts eindeutig identifiziert.
`channel`	Zeichenfolge, die den Namen des Verbreitungskanals angibt.
`ssl`	Boolescher Wert, der angibt, ob für Tracking-Aufrufe SSL verwendet werden soll.
`ovp`	Zeichenfolge, die den Namen des Videoplayer-Anbieters angibt.
`sdkversion`	Zeichenfolge, die die Version der Anwendung/des SDK angibt.
`playerName`	Zeichenfolge, die den Namen des Players angibt.

Konfigurieren der Experience Cloud-Besucher-ID.

Der Besucher-ID-Dienst für Experience Platform stellt eine universale Besucher-ID für alle Experience Cloud-Lösungen bereit. Der Besucher-ID-Dienst ist für Media Analytics und andere Marketing Cloud-Integrationen erforderlich.

Stellen Sie sicher, dass Ihre ADBMobileConfig-Konfiguration Ihre marketingCloud-Organisations-ID enthält.

code language-none
`"marketingCloud": { "org": "YOUR-MCORG-ID" }`

Experience Cloud-Organisations-IDs identifizieren eindeutig jedes Client-Unternehmen in Adobe Experience Cloud. Sie ähneln dem folgenden Wert: 016D5C175213CCA80A490D05@AdobeOrg.

note important
IMPORTANT
Stellen Sie sicher, dass Sie `@AdobeOrg` angeben.

Nach Abschluss der Konfiguration wird eine Experience Cloud-Besucher-ID generiert und allen Hits hinzugefügt. Andere Besucher-IDs wie custom und automatically-generated werden weiterhin mit den Treffern gesendet.

Methoden des Experience Cloud-Besucher-ID-Dienstes

note tip
TIP
Experience Cloud-Besucher-ID-Methoden wird `visitor` vorangestellt.

table 0-row-2 1-row-2 2-row-2
Methode	Beschreibung
`getMarketingCloudID()`	Ruft die Experience Cloud-Besucher-ID vom Besucher-ID-Dienst ab. `ADBMobile.visitor.getMarketingCloudID();`
`syncIdentifiers()`	Mit der Experience Cloud-Besucher-ID können Sie zusätzliche Kunden-IDs festlegen, die jedem Besucher zugeordnet werden können. Die Besucher-API akzeptiert mehrere Kunden-IDs für denselben Besucher sowie eine Kundentypkennung, die den Umfang der einzelnen Kunden-IDs abgrenzt. Diese Methode entspricht `setCustomerIDs()` in der JavaScript-Bibliothek. Beispiel: `var identifiers = {};` `identifiers["idType"] = "idValue";` `ADBMobile.visitor.syncIdentifiers(identifiers);`

Implementieren Sie für Tracking-Medien das MediaDelegate-Protokoll

code language-js

code language-js
`var delegate = { // Replace <currentPlaybackTime> with the video player current playback time getCurrentPlaybackTime = function() { return <currentPlaybackTime>; }, // Replace <bitrate>, <startuptime>, <fps> and <droppeFrames> with the current playback QoS values. getQoSObject = function() { return ADBMobile.media.createQoSObject(<bitrate>, <startupTime>, <fps>, <droppedFrames>); } } ADBMobile.media.setDelegate(delegate); }`

 var delegate = {
   // Replace <currentPlaybackTime> with the video player current playback time
   getCurrentPlaybackTime = function() {
     return <currentPlaybackTime>;
   },
   // Replace <bitrate>, <startuptime>, <fps> and <droppeFrames> with the current playback QoS values.
   getQoSObject = function() {
      return ADBMobile.media.createQoSObject(<bitrate>, <startupTime>, <fps>, <droppedFrames>);
   }
 }

 ADBMobile.media.setDelegate(delegate);
}

recommendation-more-help

c8eee520-cef5-4f8c-a38a-d4952cfae4eb