Dokumentation Analytics Användarhandbok för insamling av direktuppspelade medier

Konfigurera Mobile SDK v3.x för Chromecast set-up-chromecast

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Ämnen:

Skapat för:

Användare
Administratör
Utvecklare

I det här avsnittet beskrivs förutsättningarna för att konfigurera en Chromecast-installation för tillägget Direktuppspelad mediasamling.

Förutsättningar

Hämta giltiga konfigurationsparametrar

Dessa parametrar kan hämtas från en Adobe-representant när du har konfigurerat ditt medieanalyskonto.
Ta med följande API:er i mediespelaren
- Ett API för att prenumerera på spelarhändelser - Media SDK kräver att du anropar en uppsättning enkla API:er när händelser inträffar i spelaren.
- Ett API som tillhandahåller spelarinformation - Den här informationen innehåller information som medienamnet och spelhuvudets position.

Adobe Mobile-tjänster har ett nytt användargränssnitt som samlar funktioner för mobilmarknadsföring för mobilappar från hela Adobe Marketing Cloud. Från början erbjuder mobiltjänsten smidig integrering av funktioner för appanalys och målinriktning för Adobe Analytics- och Adobe Target-lösningarna. Läs mer på Adobe Mobile Services-dokumentationen.

Med Adobe Mobile Library for Chromecast v3.x for Experience Cloud Solutions kan ni mäta Chromecast-applikationer som skrivits i JavaScript, utnyttja och samla in målgruppsdata via målgruppshantering och mäta videoengagemang.

Implementering av mobilbibliotek/SDK

Lägg till ditt hämtade Chromecast-bibliotek i ditt projekt.

ZIP-filen AdobeMobileLibrary-Chromecast-[version] består av följande programvarukomponenter:
- adbmobile-chromecast.min.js:
  
  Den här biblioteksfilen inkluderas i din Chromecast-appkällmapp.
- ADBMobileConfig config
  
  Den här SDK-konfigurationsfilen är anpassad för ditt program. Ett exempel på ADBMobileConfig-implementering anges med SDK (under samples/). Hämta rätt inställningar från en Adobe-representant.

Lägg till biblioteksfilen i din index.html-fil och skapa den globala variabeln ADBMobileConfig enligt följande (den globala variabeln som används för att konfigurera Adobe Mobile för Media Analytics har en exklusiv nyckel med namnet 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
Om `mediaHeartbeat` är felaktigt konfigurerad försätts mediemodulen i ett feltillstånd och skickar inga spårningsanrop.

ADBMoble Config-parametrar för nyckeln mediaHeartbeat:

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	Beskrivning
`server`	Sträng som representerar URL:en för spårningsslutpunkten på backend-objektet.
`publisher`	En sträng som representerar den unika identifieraren för innehållsutgivaren.
`channel`	En sträng som representerar namnet på innehållsdistributionskanalen.
`ssl`	Boolean som representerar om SSL ska användas för att spåra anrop.
`ovp`	Sträng som representerar namnet på videospelarleverantören.
`sdkversion`	Sträng som representerar den aktuella versionen av programmet/SDK.
`playerName`	Sträng som representerar spelarens namn.

Konfigurera Experience Cloud Visitor-ID.

Experience Cloud Visitor ID-tjänsten tillhandahåller ett universellt besökar-ID för olika Experience Cloud-lösningar. Tjänsten för besökar-ID krävs av Media Analytics och andra Marketing Cloud-integreringar.

Kontrollera att din ADBMobileConfig-konfiguration innehåller ditt organisations-ID för marketingCloud.

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

Experience Cloud organisations-ID:n identifierar unikt varje klientföretag i Adobe Marketing Cloud och ser ut ungefär som följande värde: 016D5C175213CCA80A490D05@AdobeOrg.

note important
IMPORTANT
Se till att du inkluderar `@AdobeOrg`.

När konfigurationen är klar skapas ett Experience Cloud Visitor-ID som ingår i alla träffar. Andra besökar-ID:n, som custom och automatically-generated, fortsätter att skickas med varje träff.

Tjänstmetoder för Experience Cloud Visitor ID

note tip
TIP
Experience Cloud Visitor-ID-metoder har prefixet `visitor`.

table 0-row-2 1-row-2 2-row-2
Metod	Beskrivning
`getMarketingCloudID()`	Hämtar Experience Cloud Visitor-ID:t från Visitor-ID-tjänsten. `ADBMobile.visitor.getMarketingCloudID();`
`syncIdentifiers()`	Med besökar-ID:t för Experience Cloud kan du ange ytterligare kund-ID:n som kan kopplas till varje besökare. Besökar-API:t godkänner flera kund-ID:n för samma besökare och en kundtypsidentifierare för att skilja omfattningen för olika kund-ID:n åt. Den här metoden motsvarar `setCustomerIDs()` i JavaScript bibliotek. Till exempel: `var identifiers = {};` `identifiers["idType"] = "idValue";` `ADBMobile.visitor.syncIdentifiers(identifiers);`

Implementera MediaDelegate-protokollet för spårning av media

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