Documentazione Analytics Guida ai servizi Streaming Media

Configurare Mobile SDK v2.x per Roku set-up-roku

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

Argomenti:

Creato per:

Utente
Amministratore
Sviluppatore

Prerequisiti roku-prerequisites

Ottieni parametri di configurazione validi per Adobe Streaming Media Services

Questi parametri possono essere ottenuti da un rappresentante di Adobe dopo la configurazione dell’account per il componente aggiuntivo Adobe Streaming Media Collection o Adobe Analytics for Streaming Media.
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.

L’SDK 2.x per Roku per le soluzioni di Experience Cloud consente di misurare le applicazioni Roku scritte in BrightScript, sfruttare e raccogliere i dati sul pubblico tramite la gestione dell’audience e misurare l’interazione video attraverso gli eventi video.

Implementazione della libreria mobile/SDK

Aggiungi la Libreria Roku scaricata al tuo progetto.

Il file di download AdobeMobileLibrary-2.*-Roku.zip è costituito dai seguenti componenti software:
- adbmobile.brs: questo file libreria verrà incluso nella cartella di origine dell’app Roku.
- ADBMobileConfig.json: file di configurazione dell’SDK personalizzato per la tua app.

Aggiungi il file di libreria e il file di configurazione JSON alla tua origine del progetto.

Il JSON utilizzato per configurare Adobe Mobile ha una chiave esclusiva per Media Analytics denominata mediaHeartbeat. Qui appartengono i parametri di configurazione per Media Analytics.

note tip
TIP
Un campione del file JSON `ADBMobileConfig` viene fornito con il pacchetto. Contatta i rappresentanti di Adobe per le impostazioni.

Ad esempio:

code language-none

code language-none
{ "version":"1.0", "analytics":{ "rsids":"", "server":"", "charset":"UTF-8", "ssl":true, "offlineEnabled":false, "lifecycleTimeout":30, "batchLimit":50, "privacyDefault":"optedin", "poi":[ ] }, "marketingCloud":{ "org":"" }, "target":{ "clientCode":"", "timeout":5 }, "audienceManager":{ "server":"" }, "acquisition":{ "server":"example.com", "appid":"sample-app-id" }, "mediaHeartbeat":{ "server":"example.com", "publisher":"sample-publisher", "channel":"sample-channel", "ssl":true, "ovp":"sample-ovp", "sdkVersion":"sample-sdk", "playerName":"roku" } }

{
  "version":"1.0",
  "analytics":{
    "rsids":"",
    "server":"",
    "charset":"UTF-8",
    "ssl":true,
    "offlineEnabled":false,
    "lifecycleTimeout":30,
    "batchLimit":50,
    "privacyDefault":"optedin",
    "poi":[ ]
},
"marketingCloud":{
  "org":""
},
"target":{
  "clientCode":"",
  "timeout":5
},
"audienceManager":{
  "server":""
},
"acquisition":{
  "server":"example.com",
  "appid":"sample-app-id"
},

"mediaHeartbeat":{
   "server":"example.com",
   "publisher":"sample-publisher",
   "channel":"sample-channel",
   "ssl":true,
   "ovp":"sample-ovp",
   "sdkVersion":"sample-sdk",
   "playerName":"roku"
   }
}

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.

note important
IMPORTANT
Se `mediaHeartbeat` non è configurato correttamente, il modulo multimediale (VHL) immette uno stato di errore e interrompe l’invio di chiamate di tracciamento.

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 eventi video 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 3-row-2 4-row-2
Metodo	Descrizione
`visitorMarketingCloudID`	Recupera l’ID visitatore di Experience Cloud dal servizio ID visitatore. `ADBMobile().visitorMarketingCloudID()`
`visitorSyncIdentifiers`	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`. Ad esempio: `identifiers={}` `identifiers["idType"]="idValue"` `ADBMobile().visitorSyncIdentifiers(identifiers)`
`setAdvertisingIdentifier`	Utilizzato per impostare l’ID Roku per la pubblicità (RIDA) sull’SDK. Ad esempio: `ADBMobile().setAdvertisingIdentifier(` `"<sample_roku_identifier_for_advertising>")` Ottenere l’ID Roku per la pubblicità (RIDA) utilizzando l’API getRIDA() dell’SDK Roku.
`getAllIdentifiers`	Restituisce un elenco di tutti gli identificatori memorizzati dall’SDK, inclusi Analytics, visitatore, Audience Manager e identificatori personalizzati. `identifiers = ADBMobile().getAllIdentifiers()`

API pubbliche aggiuntive

DebugLogging

table 0-row-2 1-row-2 2-row-2
Metodo	Descrizione
`setDebugLogging`	Utilizzato per abilitare o disabilitare la registrazione di debug per l’SDK. `ADBMobile().setDebugLogging(true)`
`getDebugLogging`	Restituisce true se la registrazione di debug è abilitata. `isDebugLoggingEnabled = ADBMobile().getDebugLogging()`

PrivacyStatus

table 0-row-2 1-row-2 2-row-2
Costante	Descrizione
`PRIVACY_STATUS_OPT_IN`	Costante da passare con la chiamata setPrivacyStatus per il consenso. `optInString = ADBMobile().PRIVACY_STATUS_OPT_IN`
`PRIVACY_STATUS_OPT_OUT`	Costante da passare durante la chiamata setPrivacyStatus per la rinuncia. `optOutString = ADBMobile().PRIVACY_STATUS_OPT_OUT`

table 0-row-2 1-row-2 2-row-2
Metodo	Descrizione
`setPrivacyStatus`	Imposta lo stato di privacy sull’SDK. `ADBMobile().setPrivacyStatus(ADBMobile().PRIVACY_STATUS_OPT_IN)`
`getPrivacyStatus`	Ottiene lo stato di privacy corrente impostato nell’SDK. `privacyStatus = ADBMobile().getPrivacyStatus()`

note important
IMPORTANT
Assicurati di chiamare le funzioni `processMessages` e `processMediaMessages` nel ciclo dell’evento principale ogni 250 ms per garantire che l’SDK invii correttamente i ping.

table 0-row-2 1-row-2 2-row-2
Metodo	Descrizione
`processMessages`	Responsabile del passaggio degli eventi di Analytics all’SDK da gestire. `ADBMobile().processMessages()`
`processMediaMessages`	Responsabile del passaggio degli eventi multimediali all’SDK da gestire. `ADBMobile().processMediaMessages()`

recommendation-more-help

c8eee520-cef5-4f8c-a38a-d4952cfae4eb