Première date numérique

Cette page traite de la collecte de données pour la variable Première date numérique. Voir Première date numérique pour la dimension de reporting correspondante.

La première variable de date numérique correspond à la date à laquelle le contenu a été diffusé pour la première fois sur une plateforme numérique. Tout format de date est accepté, mais Adobe recommande de YYYY-MM-DD par souci de cohérence. Utilisez parallèlement à Date de première diffusion pour comparer la date de publication numérique à celle de la diffusion originale.

Propriété
Valeur
Variable de données contextuelles
a.media.digitalDate
champ de collection XDM
xdm.mediaCollection.sessionDetails.firstDigitalDate
Caractéristique
c_contextdata.a.media.digitalDate
Obligatoire
Non
Envoyé avec
Début de session, fermeture de session

Types d’implémentation recommandés

SDK Web

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

code language-javascript
alloy("sendEvent", {
  xdm: {
    eventType: "media.sessionStart",
    mediaCollection: {
      sessionDetails: {
        firstDigitalDate: "2016-01-25"
      },
      playhead: 0
    }
  }
});
iOS

Transmettez la première date numérique en tant que clé de métadonnées dans l’argument HashMap à trackSessionStart. Utilisez MediaConstants.VideoMetadataKeys.FIRST_DIGITAL_DATE.

code language-swift
var metadata: [String: String] = [:]
metadata[MediaConstants.VideoMetadataKeys.FIRST_DIGITAL_DATE] = "2016-01-25"

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

Transmettez la première date numérique en tant que clé de métadonnées dans l’argument HashMap à trackSessionStart. Utilisez MediaConstants.VideoMetadataKeys.FIRST_DIGITAL_DATE.

code language-kotlin
val metadata = HashMap<String, String>()
metadata[MediaConstants.VideoMetadataKeys.FIRST_DIGITAL_DATE] = "2016-01-25"

tracker.trackSessionStart(mediaInfo, metadata)
Roku

Utilisez createMediaSession pour définir des firstDigitalDate dans sessionDetails :

code language-brightscript
m.aepSdk.createMediaSession({
    "xdm": {
        "eventType": "media.sessionStart",
        "mediaCollection": {
            "sessionDetails": {
                "firstDigitalDate": "2016-01-25"
            },
            "playhead": 0
        }
    }
})
API Media Edge

Appelez le point d’entrée sessionStart avec firstDigitalDate à 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",
          "firstDigitalDate": "2016-01-25"
        },
        "playhead": 0
      }
    }
  }]
}

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

Media SDK JS 3.x

Transmettez la première date numérique dans l’objet contextData à l’aide de ADB.Media.VideoMetadataKeys.FirstDigitalDate :

code language-javascript
var contextData = {};
contextData[ADB.Media.VideoMetadataKeys.FirstDigitalDate] = "2016-01-25";

tracker.trackSessionStart(mediaInfo, contextData);
Chromecast

Utilisez ADBMobile.media.VideoMetadataKeys.FIRST_DIGITAL_DATE pour définir la première date numérique 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.FIRST_DIGITAL_DATE] = "2016-01-25";
mediaInfo[ADBMobile.media.MediaObjectKey.StandardMediaMetadata] = standardMetadata;
ADBMobile.media.trackSessionStart(mediaInfo, null);
API Media Collection

Incluez media.firstDigitalDate dans l’objet params :

code language-json
{
  "playerTime": { "playhead": 0, "ts": 1699523820000 },
  "eventType": "sessionStart",
  "params": {
    "media.firstDigitalDate": "2016-01-25"
  }
}

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