Intégration analytique
Si vous utilisez le lecteur Brightcove et catalog inclus dans le SDK pour récupérer et lire des vidéos, les données d'analyse seront automatiquement collectées et apparaîtront dans le module Video Cloud Analytics.
Si vous remplacez le BCOVVideo cours ou si vous n'utilisez pas le lecteur Brightcove catalog, vous devez envoyer votre identifiant de compte à Video Cloud Analytics.
Personnaliser les propriétés
Depuis la version 4.1.8 du Brightcove Mobile SDK pour iOS, vous pouvez envoyer des valeurs personnalisées à Brightcove Analytics depuis votre application pour l'ID de compte, l'URI de destination et l'URI source.
Votre identifiant de compte est requis, mais est automatiquement défini lorsque vous utilisez le lecteur Brightcove et le catalog.
Vous pouvez définir les URI de destination et de source si vous le souhaitez. Les valeurs par défaut sont basées sur le nom du package d'application.
Ces propriétés peuvent être définies dans votre ViewController dossier de mise en oeuvre. Cela se fait généralement après l'appel pour créer PlaybackController:
id<BCOVPlaybackController> controller =
[[BCOVPlayerSDKManager sharedManager] createPlaybackController];
controller.analytics.account = your accountId;
controller.analytics.destination = valid URI;
controller.analytics.source = valid URI;
Compte
Utilisez le account pour définir la valeur de l'ID de compte dans Brightcove Analytics. Cette propriété ne sera utile que dans les cas où il n'y a pas accountId valeur dans les métadonnées de la vidéo (par exemple, si votre application utilise un mélange de vidéos Video Cloud, qui contiennent les accountId propriété, et les vidéos non-Video Cloud, qui ne contiendront pas le accountId biens).
controller.analytics.account = @"your accountId";
Lorsque vous définissez la propriété du compte, la valeur de cette propriété sera utilisée pour toutes vos vidéos qui n'ont pas encore de accountId biens. La valeur la plus utile pour cette propriété est votre propre identifiant de compte. Ces vidéos seront signalées dans le module Analytics comme Autre/Tiers étant donné que Brightcove Analytics ne prend actuellement pas en charge les rapports détaillés pour les vidéos qui ne sont pas récupérées via le service de catalogue Brightcove.
Pour les vidéos Video Cloud, la définition de ce remplacement de compte n'a aucun effet sur les rapports, car le accountId la valeur des métadonnées reste inchangée. Cette valeur ne peut pas être remplacée en définissant cette valeur de compte.
Destination
Utilisez le destination pour définir la valeur de l'emplacement à l'origine de l'événement. La valeur de la propriété de destination DOIT être au format URI approprié, comme dans cet exemple :
bcsdk://com.mhogben.source
La valeur par défaut de la propriété de destination est bcsdk:// suivi de l'identifiant de l'ensemble de l'application tel qu'indiqué dans le info.plist déposer.
Par exemple, dans un exemple d'application iOS, la valeur de destination par défaut serait bcsdk://com.brightcove.sampleAppMainScreen.Destination et elle pourrait être remplacée comme suit :
controller.analytics.destination =
@"myapp://com.mycompany.homescreen.destination";
Tout écran de votre application qui instancie un BCOVPlaybackController pouvez définir ce remplacement de destination sur une valeur distincte, afin de mieux suivre les vues vidéo dans l'application elle-même.
La source
Utilisez le source pour définir l'URI qui a envoyé l'utilisateur final à l'URI de destination. Comme pour la valeur de destination, la valeur de la propriété source DOIT être au format URI approprié, comme dans cet exemple :
bcsdk://com.mhogben.source
La valeur par défaut de la propriété source est nil. Lorsque la valeur est nulle, la propriété source n'est pas envoyée au serveur Analytics.
Voici un exemple de définition de la propriété source :
controller.analytics.source =
@"myapp://com.mycompany.homescreen.destination.source";
Afficher les analyses
Dans le module Video Cloud Analytics, vous pouvez afficher les données métriques au niveau du compte ou à un niveau détaillé, par exemple par vidéo. Pour savoir comment procéder, consultez les documents suivants :