Documentazione Analytics Guida ai servizi Streaming Media

Configurare Mobile SDK v3.x per Chromecast set-up-chromecast

Last update: Fri Oct 10 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Argomenti:

Creato per:

Utente
Amministratore
Sviluppatore

Questa sezione descrive i prerequisiti per configurare un’installazione Chromecast per Adobe streaming media services.

Prerequisiti

Ottenere parametri di configurazione validi

Questi parametri possono essere ottenuti da un rappresentante di Adobe dopo la configurazione dell’account di Media Analytics.
Includi le seguenti API nel lettore multimediale
- API per abbonarsi agli eventi del lettore: Media SDK richiede di chiamare un set di API semplici quando si verificano eventi nel lettore.
- API che fornisce informazioni sul lettore - Queste informazioni includono dettagli quali il nome del supporto e la posizione della testina di riproduzione.

Adobe Mobile Services fornisce una nuova interfaccia utente che riunisce le capacità mobile marketing per applicazioni per dispositivi mobili da Adobe Experience Cloud. Inizialmente, Mobile Services fornisce un’integrazione diretta delle funzionalità per analisi delle app e targeting per le soluzioni Adobe Analytics e Adobe Target. Maggiori informazioni nella documentazione di Adobe Mobile Services.

La libreria mobile di Adobe per Chromecast v3.x per soluzioni Experience Cloud consente di misurare le applicazioni Chromecast scritte in JavaScript, sfruttare e raccogliere i dati sul pubblico tramite Gestione dell’audience e misurare l’interazione video.

Implementazione della libreria mobile/SDK

Aggiungi la libreria Chromecast scaricata al progetto.

Il file zip AdobeMobileLibrary-Chromecast-[version] è costituito dai seguenti componenti software:
- adbmobile-chromecast.min.js:
  
  Questo file della libreria verrà incluso nella cartella di origine dell’app Chromecast.
- File di configurazione ADBMobileConfig
  
  Questo file di configurazione dell’SDK è personalizzato per la tua app. Un esempio dell’implementazione ADBMobileConfig viene fornita con l’SDK (in samples/). Ottieni le impostazioni corrette da un rappresentante di Adobe.

Aggiungi il file della libreria al tuo file index.html e crea la variabile globale ADBMobileConfig come segue (la variabile globale utilizzata per configurare Adobe Mobile per Media Analytics ha una chiave esclusiva denominata 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
se `mediaHeartbeat` non è configurato correttamente, il modulo multimediale entra in uno stato di errore e interrompe l’invio delle chiamate di tracciamento.

Parametri di configurazione ADBMobile per la chiave 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
Parametro di configurazione	Descrizione
`server`	Stringa che rappresenta l’URL dell’endpoint di tracciamento sul backend.
`publisher`	Stringa che rappresenta l’identificatore univoco dell’editore del contenuto.
`channel`	Stringa che rappresenta il nome del canale di distribuzione del contenuto.
`ssl`	Valore booleano che indica se SSL deve essere utilizzato per il tracciamento delle chiamate.
`ovp`	Stringa che rappresenta il nome del provider del lettore video.
`sdkversion`	Stringa che rappresenta la versione corrente dell’app/SDK.
`playerName`	Stringa che rappresenta il nome del lettore.

ID visitatore di Experience Cloud.

Il servizio ID visitatore Experience Cloud fornisce un ID visitatore universale per le soluzioni Experience Cloud. Il servizio ID visitatore è richiesto da Media Analytics e altre integrazioni di Marketing Cloud.

Verifica che la configurazione ADBMobileConfig contenga il tuo ID organizzazione marketingCloud.

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

Gli ID organizzazione di Experience Cloud identificano in modo univoco ogni società cliente in Adobe Experience Cloud e hanno un valore simile al seguente: 016D5C175213CCA80A490D05@AdobeOrg.

note important
IMPORTANT
Assicurati di includere `@AdobeOrg`.

Quando la configurazione è completa, viene generato un ID visitatore Experience Cloud che viene incluso in tutti gli hit. Altri ID visitatori, come custom e automatically-generated, continuano a essere inviati con ciascun hit.

Metodi del servizio ID visitatore Experience Cloud

note tip
TIP
I metodi ID visitatore di Experience Cloud hanno il prefisso `visitor`.

table 0-row-2 1-row-2 2-row-2
Metodo	Descrizione
`getMarketingCloudID()`	Recupera l’ID visitatore di Experience Cloud dal servizio ID visitatore. `ADBMobile.visitor.getMarketingCloudID();`
`syncIdentifiers()`	Insieme all’ID visitatore di Experience Cloud, puoi impostare altri ID cliente da associare a ogni visitatore. L’API visitatore accetta più ID cliente per lo stesso visitatore, con un identificatore del tipo di cliente che consente di distinguere l’ambito dei diversi ID cliente. Questo metodo corrisponde a `setCustomerIDs()` nella libreria JavaScript. Ad esempio: `var identifiers = {};` `identifiers["idType"] = "idValue";` `ADBMobile.visitor.syncIdentifiers(identifiers);`

Per il tracciamento dei contenuti multimediali, implementa il protocollo MediaDelegate

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