Documentation Analytics Guide de collection des médias en streaming

Configurer le SDK mobile v3.x pour Chromecast set-up-chromecast

Last update: Wed Jun 26 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Rubriques :

Créé pour :

Utilisateur ou utilisatrice
Administration
Développeur

Cette section décrit les conditions préalables à la configuration d’une installation Chromecast pour le module complémentaire Collection de médias en flux continu.

Conditions préalables

Obtenir des paramètres de configuration valides

Vous pouvez obtenir ces paramètres auprès d’un représentant Adobe une fois votre compte Media Analytics configuré.
Inclure les API suivantes dans 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.

La bibliothèque mobile Adobe pour Chromecast v3.x pour les solutions Experience Cloud vous permet de mesurer les applications Chromecast écrites en JavaScript, d’exploiter et de collecter les données d’audience grâce à la gestion de l’audience et de mesurer l’engagement vidéo.

Mise en œuvre de la bibliothèque/du SDK mobile

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

Le fichier AdobeMobileLibrary-Chromecast-[version].zip est constitué des composants logiciels suivants :
- adbmobile-chromecast.min.js :
  
  Ce fichier de bibliothèque sera inclus dans le dossier source de votre application Chromecast.
- Fichier de configuration ADBMobileConfig
  
  Ce fichier de configuration SDK est personnalisé pour votre application. Un exemple de mise en œuvre ADBMobileConfig est fourni avec le SDK (sous samples/). Obtenez les paramètres appropriés auprès d’un représentant Adobe.

Ajoutez le fichier de bibliothèque à votre fichier index.html et créez la variable globale ADBMobileConfig comme suit (la variable globale utilisée pour configurer Adobe Mobile pour Media Analytics comporte une clé exclusive appelée 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
Si `mediaHeartbeat` n’est pas correctement configuré, le module multimédia passe en état d’erreur et arrête l’envoi des appels de suivi.

Paramètres de configuration ADBMobile pour la clé 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
Paramètre de configuration	Description
`server`	Chaîne représentant l’URL du point d’entrée 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.

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’identifiant visiteur est requis par Media Analytics et d’autres intégrations Marketing Cloud.

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

code language-none
`"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.

note important
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

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

table 0-row-2 1-row-2 2-row-2
Méthode	Description
`getMarketingCloudID()`	Récupère l’identifiant visiteur Experience Cloud auprès du service d’identification des visiteurs. `ADBMobile.visitor.getMarketingCloudID();`
`syncIdentifiers()`	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 aux identifiants `setCustomerIDs()` dans la bibliothèque JavaScript. Par exemple : `var identifiers = {};` `identifiers["idType"] = "idValue";` `ADBMobile.visitor.syncIdentifiers(identifiers);`

Pour le suivi des médias, mettez en œuvre le protocole 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