Configuration de Roku

Conditions préalables

Obtention de paramètres de configuration valides pour Heartbeats Vous pouvez vous procurer ces paramètres auprès d’un représentant Adobe après avoir configuré votre compte Media Analytics.
Fournissez les informations suivantes à votre lecteur multimédia :
- Une API pour vous abonner aux événements du lecteur - Le SDK Media exige d’appeler un ensemble d’API simples lorsque des événements se produisent dans votre lecteur.
- Une API qui fournit des informations au lecteur - Ces informations incluent des éléments tels que le nom du média et la position de la tête de lecture.

Adobe Mobile Services offre une nouvelle interface utilisateur qui réunit les fonctionnalités de marketing mobile pour les applications mobiles issues d’Adobe Experience Cloud. Au départ, le service Mobile intègre de manière transparente les fonctionnalités d’analyse et de ciblage des applications pour les solutions Adobe Analytics et Adobe Target.

Pour en savoir plus, consultez la Documentation d’Adobe Mobile Services.

Le kit SDK Roku 2.x pour les solutions Experience Cloud vous permet de mesurer les applications Roku écrites en BrightScript, d’exploiter et de collecter les données d’audience par le biais de la gestion de l’audience et de mesurer l’engagement vidéo grâce aux pulsations vidéo.

Implémentation du SDK

Ajoutez la bibliothèque Roku que vous avez téléchargée à votre projet.

Le fichier de téléchargement AdobeMobileLibrary-2.*-Roku.zip est constitué des composants logiciels suivants :
- adbmobile.brs : Ce fichier de bibliothèque sera inclus dans le dossier source de votre application Roku.
- ADBMobileConfig.json : Ce fichier de configuration SDK est personnalisé pour votre application.

Ajoutez le fichier de bibliothèque et le fichier de configuration JSON à la source de votre projet.

Le fichier JSON utilisé pour configurer Adobe Mobile comporte une clé exclusive pour les pulsations multimédia appelée mediaHeartbeat. C’est à cet endroit que se trouvent les paramètres de configuration des pulsations multimédia.

CONSEIL

Un exemple de fichier JSON ADBMobileConfig est fourni avec le module. Contactez vos représentants Adobe au sujet des paramètres.

Par exemple :

{
  "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"
   }    
}

Paramètre de configuration	Description
`server`	Chaîne représentant l’URL du point de terminaison de suivi sur le serveur principal.
`publisher`	Chaîne représentant l’identifiant unique de l’éditeur de contenu.
`channel`	Chaîne représentant le nom du canal de distribution du contenu.
`ssl`	Valeur booléenne qui indique si SSL doit être utilisé pour le suivi des appels.
`ovp`	Chaîne représentant le nom du fournisseur de lecteur vidéo.
`sdkversion`	Chaîne représentant la version actuelle de l’application/du kit SDK.
`playerName`	Chaîne représentant le nom du lecteur.

IMPORTANT

Si mediaHeartbeat n’est pas correctement configuré, le module multimédia (VHL) entre dans un état d’erreur et arrête l’envoi des appels de suivi.

Configurez l’identifiant visiteur Experience Cloud.

Le service d’identification des visiteurs Experience Cloud fournit un identifiant visiteur universel pour toutes les solutions Experience Cloud. Le service d’identification des visiteurs est requis par Video Heartbeat et d’autres intégrations Experience Cloud.

Vérifiez que votre configuration ADBMobileConfig contient votre ID d’organisation marketingCloud.

"marketingCloud": {
    "org": YOUR-MCORG-ID"
}

Les identifiants d’organisation d’Experience Cloud identifient de manière unique chaque entreprise cliente dans Adobe Experience Cloud et ressemblent à ceci : 016D5C175213CCA80A490D05@AdobeOrg.

IMPORTANT

Veillez à inclure @AdobeOrg.

Une fois la configuration terminée, un identifiant visiteur Experience Cloud est généré et inclus sur tous les accès. D’autres identifiants visiteur, tels que custom et automatically-generated, continuent à être envoyés avec chaque accès.

Méthodes du service d’identifiant visiteur Experience Cloud

CONSEIL

Les méthodes d’identification des visiteurs Experience Cloud sont précédées du préfixe visitor.

Méthode	Description
`visitorMarketingCloudID`	Récupère l’identifiant visiteur Experience Cloud auprès du service d’identification des visiteurs. `ADBMobile().visitorMarketingCloudID()`
`visitorSyncIdentifiers`	Avec l’identifiant visiteur d’Experience Cloud, vous pouvez définir d’autres identifiants de client qui peuvent être associés à chaque visiteur. L’API visiteur accepte plusieurs identifiants de client pour un même visiteur, ainsi qu’un identifiant de type client, afin de séparer la portée des différents identifiants de client. Cette méthode correspond à `setCustomerIDs`. Par exemple : `identifiers={}` `identifiers["idType"]="idValue"` `ADBMobile().visitorSyncIdentifiers(identifiers)`
`setAdvertisingIdentifier`	Utilisé pour définir l’ID de Roku pour la publicité (RIDA) sur le SDK. Par exemple : `ADBMobile().setAdvertisingIdentifier(` `"<sample_roku_identifier_for_advertising>")` Obtenez l’ID Roku pour la publicité (RIDA) à l’aide de l’API getRIDA() du SDK Roku.