DocumentationAnalyticsGuide des services des médias en streaming

Prise en charge des métadonnées personnalisées - Format XDM

Dernière mise à jour : 6 juillet 2026

Créé pour :

  • User
  • Admin
  • Developer

L’API Experience Edge vous permet d’envoyer des métadonnées personnalisées de média avec des champs XDM standard dans des événements d’API sessionStart, adStart et chapterStart. Les métadonnées personnalisées de média envoyées via le format XDM peuvent être transférées vers ​​et Adobe Experience Platform.

Pour les implémentations de l’API Media Collection, voir Prise en charge des métadonnées personnalisées.

Vue d’ensemble

Les métadonnées personnalisées de média peuvent être envoyées à deux emplacements dans une requête Experience Edge, chacun avec un comportement de routage différent :

Emplacement
Envoyé à Adobe Analytics
Envoyé à Adobe Experience Platform
Exemple d’utilisation
xdm.mediaCollection.customMetadata
✅ Oui
✅ Oui
Données métiers nécessaires dans les deux systèmes
_data
✅ Oui
❌ No
Indicateurs spécifiques à Analytics ou indications de traitement

Les métadonnées personnalisées s’appliquent à trois types d’événements :

Événement
Les Métadonnées S’Appliquent À
sessionStart
Contenu principal (session entière)
adStart
Publicité individuelle
chapterStart
Chapitre ou segment de contenu

Structure

xdm.mediaCollection.customMetadata (Analytics + AEP)

Les métadonnées personnalisées sont un tableau d’objets nom-valeur à l’intérieur de l’objet mediaCollection :

{
  "xdm": {
    "mediaCollection": {
      "customMetadata": [
        {
          "name": "_tenant.fieldName",
          "value": "fieldValue"
        }
      ]
    }
  }
}

customMetadata doit être un tableau à l’intérieur du mediaCollection, et non au niveau racine xdm.

Incorrect:

{
  "xdm": {
    "eventType": "media.sessionStart",
    "customMetadata": [...]  // ❌ Wrong location
  }
}

Correct :

{
  "xdm": {
    "eventType": "media.sessionStart",
    "mediaCollection": {
      "customMetadata": [...]  // ✅ Inside mediaCollection
    }
  }
}

_data (Analytics uniquement)

L’objet _data est un concept d’Experience Edge spécial qui envoie des données exclusivement à Adobe Analytics, en contournant les jeux de données AEP. Les métadonnées personnalisées doivent être placées sous __adobe.analytics.contextData.

Contrairement à xdm.mediaCollection.customMetadata qui utilise un tableau d’objets nom-valeur, le mappage _data utilise un objet clé-valeur plat directement sous contextData :

Approche

Structure

Destination

xdm.mediaCollection.customMetadata

Tableau d’objets {"name": "...", "value": "..."}

Analytics + AEP

_data.__adobe.analytics.contextData

{"key": "value"} d’objet clé-valeur plate

Analytics uniquement

{
  "xdm": { ... },
  "_data": {
    "__adobe": {
      "analytics": {
        "contextData": {
          "debugMode": "true",
          "internalTestFlag": "QA-Session"
        }
      }
    }
  }
}

Conventions de dénomination

Métadonnées personnalisées du contenu principal

Envoyé avec sessionStart. S’applique au média principal faisant l’objet d’un suivi et reste disponible tout au long des appels de publicité et de chapitre. Toutes les métadonnées personnalisées définies ici seront automatiquement fusionnées par le serveur principal du média lors des appels de fermeture correspondants. Elle est incluse avec toute métadonnée personnalisée spécifique définie pour les annonces publicitaires et les chapitres.

Requête

curl -X POST "https://edge.adobedc.net/ee/va/v1/sessionStart?configId={datastreamId}" \
--header 'Content-Type: application/json' \
--data '{
  "events": [
    {
      "xdm": {
        "eventType": "media.sessionStart",
        "mediaCollection": {
          "sessionDetails": {
            "name": "Sample Video",
            "playerName": "HTML5 Player",
            "contentType": "VOD",
            "length": 3600,
            "channel": "Sports"
          },
          "playhead": 0,
          "customMetadata": [
            {
              "name": "_mycompany.contentCategory",
              "value": "Live Sports"
            },
            {
              "name": "_mycompany.leagueType",
              "value": "Professional"
            }
          ]
        },
        "timestamp": "2026-03-10T18:00:00Z"
      }
    }
  ]
}'

Ajout de métadonnées personnalisées

Envoyé avec adStart. Spécifique à chaque publicité individuelle. Les métadonnées personnalisées d’sessionStart sont également automatiquement fusionnées par le serveur principal du média lors de l’appel de fermeture de l’annonce publicitaire avec toutes les métadonnées personnalisées spécifiques à l’annonce définies ici.

Requête

curl -X POST "https://edge.adobedc.net/ee/va/v1/adStart?configId={datastreamId}" \
--header 'Content-Type: application/json' \
--data '{
  "events": [
    {
      "xdm": {
        "eventType": "media.adStart",
        "mediaCollection": {
          "sessionID": "your-session-id",
          "playhead": 30,
          "advertisingDetails": {
            "name": "Summer Sale Ad",
            "playerName": "HTML5 Player",
            "length": 30,
            "podPosition": 1
          },
          "customMetadata": [
            {
              "name": "_mycompany.campaignId",
              "value": "SUMMER2026"
            },
            {
              "name": "_mycompany.targetAudience",
              "value": "18-34"
            },
            {
              "name": "_mycompany.adFormat",
              "value": "skippable"
            }
          ]
        },
        "timestamp": "2026-03-10T18:05:30Z"
      }
    }
  ]
}'

Métadonnées personnalisées de chapitre

Envoyé avec chapterStart. Spécifique à chaque chapitre ou segment de contenu. Les métadonnées personnalisées de sessionStart sont également automatiquement fusionnées par le serveur principal de médias lors de l’appel de fermeture du chapitre avec toutes les métadonnées personnalisées spécifiques au chapitre définies ici.

Requête

curl -X POST "https://edge.adobedc.net/ee/va/v1/chapterStart?configId={datastreamId}" \
--header 'Content-Type: application/json' \
--data '{
  "events": [
    {
      "xdm": {
        "eventType": "media.chapterStart",
        "mediaCollection": {
          "sessionID": "your-session-id",
          "playhead": 600,
          "chapterDetails": {
            "friendlyName": "Introduction",
            "length": 300,
            "index": 1,
            "offset": 600
          },
          "customMetadata": [
            {
              "name": "_mycompany.chapterType",
              "value": "tutorial"
            },
            {
              "name": "_mycompany.difficulty",
              "value": "beginner"
            }
          ]
        },
        "timestamp": "2026-03-10T18:10:00Z"
      }
    }
  ]
}'

Utilisation de l’objet _data (métadonnées Analytics uniquement)

Utilisez l’objet _data lorsque vous avez besoin de métadonnées dans Adobe Analytics qui ne doivent pas être stockées dans un jeu de données AEP. Par exemple, les indicateurs temporaires, les variables de débogage ou les indications de traitement spécifiques à Analytics.

Les données envoyées via _data ne sont pas stockées dans Adobe Experience Platform et ne sont pas disponibles pour Real-Time CDP, Journey Orchestration ou d’autres services AEP.

Requête

curl -X POST "https://edge.adobedc.net/ee/va/v1/sessionStart?configId={datastreamId}" \
--header 'Content-Type: application/json' \
--data '{
  "events": [
    {
      "xdm": {
        "eventType": "media.sessionStart",
        "mediaCollection": {
          "sessionDetails": {
            "name": "Sample Video",
            "playerName": "HTML5 Player",
            "contentType": "VOD",
            "length": 3600
          },
          "playhead": 0,
          "customMetadata": [
            {
              "name": "_mycompany.league",
              "value": "Action"
            }
          ]
        },
        "timestamp": "2026-03-10T18:00:00Z"
      },
      "_data": {
        "__adobe": {
          "analytics": {
            "contextData": {
              "debugMode": "true",
              "testFlag": "QA-Session"
            }
          }
        }
      }
    }
  ]
}'

Dans cet exemple :

Emplacement des données en aval

xdm.mediaCollection.customMetadata est le chemin d’API entrant utilisé pour envoyer des métadonnées personnalisées avec des événements. Après traitement, les données sont transférées vers Adobe Analytics en tant que variables de données contextuelles et stockées dans Adobe Experience Platform sous xdm.mediaReporting.customMetadata et en tant que champs aplatis de niveau supérieur.

Adobe Analytics :

Adobe Experience Platform:

Comportement

Related Articles

recommendation-more-help
media-analytics-help