Show Menu
TOPICS×

Chromecast einrichten

FAQs

Sollte ich das Chromecast JavaScript SDK verwenden oder kann ich das standardmäßige JavaScript SDK verwenden?
Die richtige Antwort lautet „Chromecast“, und zwar aus den folgenden Gründen:
  • Die AppMeasurement- und VisitorAPI-Bibliotheken im standardmäßigen JavaScript SDK sind nicht für die Arbeit auf OTT-Plattformen zertifiziert. Im Chromecast JavaScript SDK sind die Video Heartbeats-Bibliothek (VHL), Analytics und VisitorAPI in das einzige, einheitliche und für Chromecast zertifizierte SDK integriert.
  • Das Chromecast SDK ist viel leichter als das standardmäßige JS SDK. Das ist sehr wichtig für die Low-End-Hardware, die von OTT-Plattformen verwendet wird.

Voraussetzungen

  • Gültige Konfigurationsparameter für Heartbeats festlegen:
    Diese Parameter erhalten Sie nach der Einrichtung Ihres Media Analytics-Kontos von einem Adobe-Support-Mitarbeiter.
  • Stellen Sie in Ihrem Medienplayer folgende Funktionen bereit:
    • Eine API, um Player-Ereignisse zu abonnieren:
      Die Medien-SDK erfordert, dass Sie einige einfache APIs aufrufen, wenn Ereignisse in Ihrem Player auftreten.
    • Eine API, die Playerinformationen bereitstellt:
      Diese Informationen enthalten Details wie z. B. Medienname und 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. Mobile Services ermöglicht die nahtlose Integration der App-Analyse- und Targeting-Funktionen der Adobe Analytics- und Adobe Target-Lösungen. Weitere Informationen finden Sie in der Dokumentation zu Adobe Mobile Services.
Mit Chromecast-SDK 2.x für Experience Cloud-Lösungen können Sie in JavaScript geschriebene Chromecast-Anwendungen messen, Zielgruppendaten über das Zielgruppen-Management nutzen und erfassen und Videointeraktionen über Video-Heartbeats messen.

SDK-Implementierung

  1. Fügen Sie Ihre heruntergeladene Chromecast-Bibliothek zu Ihrem Projekt hinzu.
    1. 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.
    2. 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 for Heartbeats konfiguriert wird, hat einen exklusiven Schlüssel namens
      mediaHeartbeat
      ):
      <script> var ADBMobileConfig = { "marketingCloud": { "org": "972C898555E9F7BC7F000101@AdobeOrg" }, "target": { "clientCode": "", "timeout": 5 }, "audienceManager": { "server": "obumobile5.demdex.net" }, "analytics": { "rsids": "mobile5vhl.sample.player", "server": "obumobile5.sc.omtrdc.net", "ssl": false, "offlineEnabled": false, "charset": "UTF-8", "lifecycleTimeout": 300, "privacyDefault": "optedin", "batchLimit": 0, "timezone": "MDT", "timezoneOffset": -360, "referrerTimeout": 0, "poi": [] }, "mediaHeartbeat": { "server": "obumobile5.hb.omtrdc.net", "publisher": "972C898555E9F7BC7F000101@AdobeOrg", "channel": "test-channel-chromecast", "ssl": false, "ovp": "chromecast-player", "sdkVersion": "chromecast-sdk", "playerName": "Chromecast" } }; </script> <script type="text/javascript" src="script/lib/adbmobile-chromecast.min.js"></script>
      Wenn
      mediaHeartbeat
      nicht richtig konfiguriert ist, wechselt das Medienmodul (VHL) zu einem Fehlerstatus und sendet keine Tracking-Aufrufe mehr.
      ADBMobile-Konfigurationsparameter für mediaHeartbeat-Schlüssel: | 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. |
  2. Konfigurieren der Experience Cloud-Besucher-ID.
    Der Experience Cloud-Besucher-ID-Dienst stellt eine universale Besucher-ID für alle Experience Cloud-Lösungen bereit. Der Besucher-ID-Dienst ist für Video Heartbeat- und andere Experience Cloud-Integrationen erforderlich.
    Stellen Sie sicher, dass Ihre
    ADBMobileConfig
    -Konfiguration Ihre
    marketingCloud
    -Organisations-ID enthält.
    "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
    .
    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
    Experience Cloud-Besucher-ID-Methoden wird
    visitor
    vorangestellt.
    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);