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.

Learn more at Adobe Mobile Services documentation.

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.

      SUGGERIMENTO

      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.

      IMPORTANTE

      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.

   IMPORTANTE

   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

   SUGGERIMENTO

   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() .