Genre

Cette page traite de la collecte de données pour la variable Genre. Voir Genre pour la dimension de reporting correspondante.

La variable genre correspond au genre de contenu tel que défini par le producteur (par exemple, "Drama", "Comedy" ou "Drama,Action"). Délimitez plusieurs valeurs par des virgules lorsque le contenu correspond à plusieurs genres. Dans les rapports, la variable de liste divise chaque valeur en un élément de ligne distinct, chaque élément de ligne recevant un poids métrique égal.

NOTE
Dans le pipeline de création de rapports, la valeur de genre est exposée sous la forme xdm.mediaReporting.sessionDetails.genreList (un champ de liste). L’ancien chemin de xdm.mediaReporting.sessionDetails.genre reste fonctionnel, mais genreList est recommandé.
Propriété
Valeur
Variable de données contextuelles
a.media.genre
champ de collection XDM
xdm.mediaCollection.sessionDetails.genre
Caractéristique
c_contextdata.a.media.genre
Obligatoire
Non
Envoyé avec
Début de session, fermeture de session

Types d’implémentation recommandés

SDK Web

genre à l’intérieur des xdm.mediaCollection.sessionDetails lors de l’appel de sendEvent :

code language-javascript
alloy("sendEvent", {
  xdm: {
    eventType: "media.sessionStart",
    mediaCollection: {
      sessionDetails: {
        genre: "Drama,Action"
      },
      playhead: 0
    }
  }
});
iOS

Transmettez la chaîne de genre en tant que clé de métadonnées dans l’argument HashMap à trackSessionStart. Utilisez MediaConstants.VideoMetadataKeys.GENRE.

code language-swift
var metadata: [String: String] = [:]
metadata[MediaConstants.VideoMetadataKeys.GENRE] = "Drama,Action"

tracker.trackSessionStart(info: mediaObject, metadata: metadata)
Android

Transmettez la chaîne de genre en tant que clé de métadonnées dans l’argument HashMap à trackSessionStart. Utilisez MediaConstants.VideoMetadataKeys.GENRE.

code language-kotlin
val metadata = HashMap<String, String>()
metadata[MediaConstants.VideoMetadataKeys.GENRE] = "Drama,Action"

tracker.trackSessionStart(mediaInfo, metadata)
Roku

Utilisez createMediaSession pour définir des genre dans sessionDetails :

code language-brightscript
m.aepSdk.createMediaSession({
    "xdm": {
        "eventType": "media.sessionStart",
        "mediaCollection": {
            "sessionDetails": {
                "genre": "Drama,Action"
            },
            "playhead": 0
        }
    }
})
API Media Edge

Appelez le point d’entrée sessionStart avec genre à l’intérieur du xdm.mediaCollection.sessionDetails :

code language-json
{
  "events": [{
    "xdm": {
      "eventType": "media.sessionStart",
      "mediaCollection": {
        "sessionDetails": {
          "name": "video-123",
          "length": 128,
          "contentType": "vod",
          "playerName": "HTML5 Player",
          "channel": "Sports",
          "genre": "Drama,Action"
        },
        "playhead": 0
      }
    }
  }]
}

Types d’implémentation hérités (Analytics uniquement)

Media SDK JS 3.x

Transmettez le genre dans l’objet contextData à l’aide de ADB.Media.VideoMetadataKeys.Genre :

code language-javascript
var contextData = {};
contextData[ADB.Media.VideoMetadataKeys.Genre] = "Drama,Action";

tracker.trackSessionStart(mediaInfo, contextData);
Chromecast

Utilisez ADBMobile.media.VideoMetadataKeys.GENRE pour définir le genre dans la propriété StandardMediaMetadata de l’objet média avant d’appeler trackSessionStart :

code language-javascript
var mediaInfo = ADBMobile.media.createMediaObject("My Video", "video-123", 128,
  ADBMobile.media.StreamType.VOD, ADBMobile.media.MediaType.Video);
var standardMetadata = {};
standardMetadata[ADBMobile.media.VideoMetadataKeys.GENRE] = "Drama,Action";
mediaInfo[ADBMobile.media.MediaObjectKey.StandardMediaMetadata] = standardMetadata;
ADBMobile.media.trackSessionStart(mediaInfo, null);
API Media Collection

Incluez media.genre dans l’objet params :

code language-json
{
  "playerTime": { "playhead": 0, "ts": 1699523820000 },
  "eventType": "sessionStart",
  "params": {
    "media.genre": "Drama,Action"
  }
}

Consultez la référence des sessions de l’API Media Collection pour obtenir la structure complète des requêtes.

recommendation-more-help
media-analytics-help