Show Menu
TOPICS×

Configurazione Roku

Prerequisiti

  • Ottenete parametri di configurazione validi per Heartbeats
    Questi parametri possono essere ottenuti da un rappresentante Adobe dopo che avete configurato il vostro account di analisi dei supporti.
  • Fornite le seguenti funzionalità nel lettore multimediale:
    • Un'API per iscriversi agli eventi
      del lettore - L'SDK di Media richiede che venga chiamato 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 mobile da Adobe Marketing Cloud. Inizialmente, Mobile Services fornisce un'integrazione perfetta delle funzionalità di analisi e targeting delle app per le soluzioni Adobe Analytics e Adobe Target.
L’SDK 2.x Roku per le soluzioni 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 il coinvolgimento video attraverso heartbeat video.

Implementazione SDK

  1. Aggiungi la libreria Roku scaricata al tuo progetto.
    1. Il file di
      AdobeMobileLibrary-2.*-Roku.zip
      download è costituito dai seguenti componenti software:
      • adbmobile.brs
        : Questo file libreria verrà incluso nella cartella di origine dell'app Roku.
      • ADBMobileConfig.json
        : Questo file di configurazione SDK è personalizzato per la tua app.
    2. Aggiungete il file di libreria e il file di configurazione JSON alla sorgente del progetto.
      Il JSON utilizzato per configurare Adobe Mobile dispone di una chiave esclusiva per i heartbeat multimediali denominati
      mediaHeartbeat
      . Qui appartengono i parametri di configurazione per i heartbeat multimediali.
      Un file
      ADBMobileConfig
      JSON di esempio viene fornito con il pacchetto. Contattate i rappresentanti Adobe per le impostazioni.
      Ad esempio:
      { "version":"1.0", "analytics":{ "rsids":"", "server":"", "charset":"UTF-8", "ssl":false, "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":false, "ovp":"sample-ovp", "sdkVersion":"sample-sdk", "playerName":"roku" } }
      Parametro di configurazione
      Descrizione    
      server
      Stringa che rappresenta l'URL dell'endpoint di tracciamento sul backend.
      publisher
      Stringa che rappresenta l'identificatore univoco dell'autore del contenuto.
      channel
      Stringa che rappresenta il nome del canale di distribuzione del contenuto.
      ssl
      Valore booleano che rappresenta se SSL deve essere utilizzato per il tracciamento delle chiamate.
      ovp
      Stringa che rappresenta il nome del fornitore del lettore video.
      sdkversion
      Stringa che rappresenta la versione corrente dell'app/SDK.
      playerName
      Stringa che rappresenta il nome del lettore.
      Se
      mediaHeartbeat
      è configurata in modo errato, il modulo multimediale (VHL) immette uno stato di errore e interrompe l'invio di chiamate di tracciamento.
  2. Configura ID visitatore Experience Cloud.
    Il servizio ID visitatori di Experience Cloud fornisce un ID visitatore universale nelle soluzioni Experience Cloud. Il servizio Visitor ID è richiesto da Video Heartbeat e da altre integrazioni Marketing Cloud.
    Verifica che la tua
    ADBMobileConfig
    configurazione contenga il tuo ID
    marketingCloud
    organizzazione.
    "marketingCloud": { "org": YOUR-MCORG-ID" }
    Experience Cloud organization IDs uniquely identify each client company in the Adobe Marketing Cloud and appear similar to the following value:
    016D5C175213CCA80A490D05@AdobeOrg
    .
    Accertatevi di includere
    @AdobeOrg
    .
    Al termine della configurazione, viene generato un ID visitatore Experience Cloud che viene incluso in tutti gli hit. Other Visitor IDs, such as
    custom
    and
    automatically-generated
    , continue to be sent with each hit.
    Metodi del servizio ID visitatori di Experience Cloud
    Experience Cloud Visitor ID methods are prefixed with
    visitor
    .
     Metodo  
    Descrizione
    visitorMarketingCloudID
    Retrieves the Experience Cloud visitor ID from the visitor ID service.
    ADBMobile().visitorMarketingCloudID()
    visitorSyncIdentifiers
    Con l’ID visitatore di Experience Cloud, puoi impostare altri ID cliente da associare a ogni visitatore. L'API Visitor accetta più ID cliente per lo stesso visitatore e un identificatore del tipo di cliente per separare 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>")
    Ottenete l'ID Roku per la pubblicità (RIDA) tramite l'API Roku SDK getRIDA() .