DocumentatieAnalyticsHandleiding voor streaming-mediaservices

XDM-rapportschema

Laatst bijgewerkt: 4 juni 2026

Gemaakt voor:

  • {"id":"b69b2659-1057-424e-8fc5-ed9e016dc554"},{"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"},{"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

Als u gebeurtenissen voor mediatracering verzendt met de Adobe Experience Platform Edge Network, verwerkt de Media Analytics-back-end deze gebeurtenissen en schrijft deze de berekende Experience Events naar de gegevenssets van het Platform. Als u begrijpt welke gebeurtenissen Platform bereiken en wat de back-end voor u berekent, kunt u uw implementatie valideren en nauwkeurige rapporten maken in Customer Journey Analytics of Adobe Analytics.

Twee verschillende schema’s XDM worden gebruikt in verschillende delen van de inzameling en rapporteringspijpleiding:

Schema
Naamruimte
Richting
Doel
Media-verzameling
xdm.mediaCollection
Client → Adobe
Wat uw speler voor elke volgende gebeurtenis verzendt. Gebruikt door ​ variabelen ​.
Mediarapportage
xdm.mediaReporting
Adobe → Platform
Wat de backend aan datasets na verwerking schrijft. Gebruikt door ​ afmetingen ​ en ​ metriek ​.

Velden in mediaReporting maar niet in de mediaCollection -payload worden afgeleid van de volledige reeks gebeurtenissen in een sessie. U verzendt deze velden nooit. Adobe genereert ze.

Gebeurtenissen die naar de datasets van het Platform schrijven

Van de 12 trackable gebeurtenistypen, produceren slechts vijf individuele Gebeurtenis van de Ervaring schrijft aan datasets:

Het type Event
Opgenomen in gegevenssets
Notities
​ Begin van de Zitting ​
Ja
Geschreven wanneer de zitting wordt geïnitialiseerd
​ Advertentiebegin ​
Ja
Wordt geschreven wanneer een afzonderlijke advertentie begint
​ toevoegde volledig ​
Ja
Geschreven wanneer een advertentie naar voltooiing wordt afgespeeld
​ Volledige Hoofdstuk ​
Ja
Geschreven wanneer een hoofdstuk aan voltooiing speelt
​ Volledige Zitting ​
Ja
Geschreven wanneer de zitting eindigt; rijkste berekende veldset
​ Spel ​
Nee
Wordt gebruikt om te berekenen timePlayed
​ Begin van de Pauze ​
Nee
Wordt gebruikt om pauseCount en pauseTime te berekenen
​ pingelen ​
Nee
hartslag; gebruikt om inactiviteit van sessie te detecteren
​ Begin van de Buffer ​
Nee
Wordt gebruikt om QoE-buffermeetgegevens te berekenen
​ Bitsnelheidsverandering ​
Nee
Wordt gebruikt om QoE-bitsnelheidmetingen te berekenen
​ Begin van de Staat ​
Nee
Wordt gebruikt om maatgegevens van spelerstatussen te berekenen
​ Fout ​
Nee
Wordt gebruikt om errorCount in QoE te berekenen

Achteruit berekende velden

De volgende velden worden weergegeven in mediaReporting -ladingen, maar maken nooit deel uit van de inningslading. De backend leidt hen van de volledige gebeurtenisopeenvolging af.

zitting-niveau (verschijnen op sessionComplete):

Veld
Beschrijving
xdm.mediaReporting.sessionDetails.timePlayed
Totaal aantal seconden aan hoofdinhoud die wordt afgespeeld, exclusief advertenties
xdm.mediaReporting.sessionDetails.totalTimePlayed
Totaal aantal verstreken seconden, inclusief advertenties
xdm.mediaReporting.sessionDetails.uniqueTimePlayed
Gedupliceerde seconden — intervallen die meer dan één keer worden bekeken, worden slechts één keer geteld
xdm.mediaReporting.sessionDetails.averageMinuteAudience
timePlayed gedeeld door lengte van inhoud
xdm.mediaReporting.sessionDetails.estimatedStreams
Geschatte gelijktijdige stromen
xdm.mediaReporting.sessionDetails.adCount
Aantal begonnen advertenties
xdm.mediaReporting.sessionDetails.chapterCount
Aantal begonnen hoofdstukken
xdm.mediaReporting.sessionDetails.pauseCount / xdm.mediaReporting.sessionDetails.pauseTime
Pauze frequentie en totale pauze
xdm.mediaReporting.sessionDetails.hasProgress10 … xdm.mediaReporting.sessionDetails.hasProgress95
Vlaggen van mijlpalen voor vooruitgang (10%, 25%, 50%, 75%, 95%)
xdm.mediaReporting.sessionDetails.hasSegmentView
Of ten minste één inhoudsframe is bekeken
xdm.mediaReporting.sessionDetails.isCompleted / xdm.mediaReporting.sessionDetails.isPlayed
Vlaggen voltooien en starten
xdm.mediaReporting.sessionDetails.secondsSinceLastCall
Tijd tussen laatste pingelen en zittingsdichte
xdm.mediaReporting.sessionDetails.segment
Vierkante haken voor inhoudssegmenten (bijvoorbeeld [0-1])

Advertentieniveau (verschijnen op adComplete):

Veld
Beschrijving
xdm.mediaReporting.advertisingDetails.timePlayed
Seconden van afgespeelde advertentie-inhoud
xdm.mediaReporting.advertisingDetails.isCompleted
Of de advertentie tot voltooiing is afgespeeld

Hoofdstuk-niveau (verschijnen op chapterComplete):

Veld
Beschrijving
xdm.mediaReporting.chapterDetails.timePlayed
Seconden van inhoud van hoofdstuk afgespeeld
xdm.mediaReporting.chapterDetails.isCompleted
Of het hoofdstuk naar voltooiing is afgespeeld
xdm.mediaReporting.chapterDetails.isStarted
Of het hoofdstuk is gestart

QoE (samengevoegd op sessionComplete):

Veld
Beschrijving
xdm.mediaReporting.qoeDataDetails.bitrateAverage
Gemiddelde bitsnelheid voor de sessie
xdm.mediaReporting.qoeDataDetails.bitrateAverageBucket
Toegestane gemiddelde bitsnelheidbereik
xdm.mediaReporting.qoeDataDetails.bitrateChangeCount
Aantal wijzigingen in bitsnelheid
xdm.mediaReporting.qoeDataDetails.errorCount
Aantal fouten
xdm.mediaReporting.qoeDataDetails.droppedFrames
Totaal aantal gedropte frames
xdm.mediaReporting.qoeDataDetails.playerSdkErrors
Array met foutcodes van speler
xdm.mediaReporting.qoeDataDetails.hasErrorImpactedStreams
Of er een fout is opgetreden
xdm.mediaReporting.qoeDataDetails.hasDroppedFrameImpactedStreams
Of gedropte frames zijn opgetreden
xdm.mediaReporting.qoeDataDetails.hasBitrateChangeImpactedStreams
Of er wijzigingen in bitsnelheid zijn opgetreden

Gedownloade inhoud

Voor zittingen die gebruikend het ​ gedownloade eindpunt ​ worden gevolgd, plaatst het achtereind automatisch xdm.mediaReporting.sessionDetails.isDownloaded aan true op sessionStart rapporterend gebeurtenis. Alle andere rapportgebeurtenissen voor gedownloade sessies volgen hetzelfde schema als live sessies. Met dit veld in CJA of Adobe Analytics kunt u gedownloade afspelen filteren of segmenteren.

Zie ​ Gedownload eindpunt ​ in de verwijzing van Edge API van Media voor details van de inzamelingsimplementatie.

Uw implementatie valideren

Nadat u gebeurtenissen hebt verzonden via de Media Edge API, controleert u of de gegevens correct zijn geladen met een van de volgende methoden:

de datasetvoorproef van Adobe Experience Platform

  1. In ​ Onderneming CX ​, navigeer aan Datasets en selecteer uw het stromen media dataset.
  2. Selecteer Preview dataset om de meest recente gebeurtenissen van de Ervaring te zien.
  3. Controleer of eventType -waarden zoals media.sessionStart en media.sessionComplete worden weergegeven met gevulde mediaReporting -velden.

de datasetinspectie van Customer Journey Analytics

  1. Open in CJA de verbinding die aan uw streaming-mediaset is gekoppeld.
  2. Selecteer datasets toevoegen en inspecteer het schema om te bevestigen de mediaReporting gebieden aan de verwachte afmetingen en metriek in kaart worden gebracht.

Adobe Analytics verwerkingsregels (als het gebruiken van de bestemming van Analytics)

Voor Adobe Analytics-rapportreeksen die gegevens ontvangen via de bronconnector Analytics, kunt u de verwerkingsregels gebruiken om mediaReporting -contextgegevensvariabelen toe te wijzen aan aangepaste props of eVars. De markering isDownloaded is beschikbaar als a.media.downloaded .

Voorbeelden van XDM-laadbewerkingen

De volgende voorbeelden tonen de volledige mediaReporting XDM-structuur voor elke rapportgebeurtenis zoals geschreven naar de datasets van het Platform. De eigenschap _{tenantName} vertegenwoordigt de huurdersnaamruimte van uw organisatie voor aangepaste velden.

media.sessionStart
code language-json 
{
  "xdm": {
    "_{tenantName}": {
      "customField1": "c1",
      "customField2": "c2"
    },
    "mediaReporting": {
      "sessionDetails": {
        "adLoad": "adLoadType",
        "appVersion": "sdk-1.0",
        "artist": "test-artist",
        "channel": "broadcastChannel",
        "rating": "4.8/5",
        "show": "test-name Series",
        "genreList": ["Comedy"],
        "episode": "4933",
        "originator": "Tokala Clementine",
        "isViewed": true,
        "network": "test-network",
        "firstAirDate": "firstAirDate",
        "streamType": "video",
        "authorized": "true",
        "streamFormat": "streamFormat",
        "genre": "Comedy",
        "station": "test-station",
        "hasResume": false,
        "season": "1521",
        "showType": "sitcom",
        "ID": "cd7b[...]6f",
        "contentType": "VOD",
        "friendlyName": "test-friendly-name",
        "playerName": "HTML5 player",
        "album": "test-album",
        "author": "test-author",
        "length": 100,
        "dayPart": "dayPart",
        "label": "test-label",
        "mvpd": "test-mvpd",
        "feed": "sourceFeed",
        "assetID": "/uri-reference",
        "name": "test-name",
        "publisher": "test-media-publisher",
        "firstDigitalDate": "releaseDate"
      }
    },
    "implementationDetails": {
      "environment": "server",
      "name": "https://ns.adobe.com/experience/edge",
      "version": "0.0.0"
    },
    "identityMap": {
      "ECID": [
        {
          "id": "5191[...]21",
          "authenticatedState": "ambiguous",
          "primary": true
        }
      ]
    },
    "eventType": "media.sessionStart",
    "_id": "0[...]0",
    "timestamp": "YYYY-11-20T12:43:35Z"
  }
}
media.adStart
code language-json 
{
  "xdm": {
    "_{tenantName}": {
      "customField1": "c1",
      "customField2": "c2"
    },
    "environment": {
      "browserDetails": {},
      "ipV4": "130.248.81.10"
    },
    "mediaReporting": {
      "advertisingDetails": {
        "advertiser": "Adobe Marketing",
        "podPosition": 1,
        "placementID": "placementID",
        "example": "https://example.com",
        "playerName": "HTML5 player",
        "campaignID": "Adobe Analytics",
        "name": "/uri-reference/001",
        "length": 10,
        "siteID": "siteID",
        "isStarted": true,
        "creativeID": "creativeID",
        "friendlyName": "Ad 1"
      },
      "sessionDetails": {
        "adLoad": "adLoadType",
        "appVersion": "sdk-1.0",
        "artist": "test-artist",
        "pev3": "videoAd",
        "channel": "broadcastChannel",
        "rating": "4.8/5",
        "show": "test-name Series",
        "genreList": ["Comedy"],
        "episode": "4933",
        "originator": "Tokala Clementine",
        "network": "test-network",
        "firstAirDate": "firstAirDate",
        "streamType": "video",
        "pccr": true,
        "authorized": "true",
        "streamFormat": "streamFormat",
        "genre": "Comedy",
        "station": "test-station",
        "season": "1521",
        "showType": "sitcom",
        "ID": "cd7b[...]6f",
        "contentType": "VOD",
        "friendlyName": "test-friendly-name",
        "playerName": "HTML5 player",
        "album": "test-album",
        "author": "test-author",
        "length": 100,
        "dayPart": "dayPart",
        "label": "test-label",
        "mvpd": "test-mvpd",
        "feed": "sourceFeed",
        "assetID": "/uri-reference",
        "name": "test-name",
        "publisher": "test-media-publisher",
        "firstDigitalDate": "releaseDate"
      },
      "advertisingPodDetails": {
        "offset": 0,
        "ID": "3d594614f445f6b00014e9b77730b833_1",
        "friendlyName": "Mid-ad"
      }
    },
    "implementationDetails": {
      "environment": "server",
      "name": "https://ns.adobe.com/experience/edge",
      "version": "0.0.0"
    },
    "identityMap": {
      "ECID": [
        {
          "id": "5191[...]21",
          "authenticatedState": "ambiguous",
          "primary": true
        }
      ]
    },
    "eventType": "media.adStart",
    "_id": "d[...]0",
    "timestamp": "YYYY-11-20T12:43:56Z"
  }
}
media.adComplete
code language-json 
{
  "xdm": {
    "_{tenantName}": {
      "customField1": "c1",
      "customField2": "c2"
    },
    "mediaReporting": {
      "advertisingDetails": {
        "advertiser": "Adobe Marketing",
        "podPosition": 1,
        "placementID": "placementID",
        "example": "https://example.com",
        "playerName": "HTML5 player",
        "campaignID": "Adobe Analytics",
        "length": 10,
        "creativeID": "creativeID",
        "timePlayed": 7,
        "name": "/uri-reference/001",
        "siteID": "siteID",
        "friendlyName": "Ad 1",
        "isCompleted": true
      },
      "sessionDetails": {
        "adLoad": "adLoadType",
        "appVersion": "sdk-1.0",
        "artist": "test-artist",
        "pev3": "videoAd",
        "channel": "broadcastChannel",
        "rating": "4.8/5",
        "show": "test-name Series",
        "genreList": ["Comedy"],
        "episode": "4933",
        "originator": "Tokala Clementine",
        "network": "test-network",
        "firstAirDate": "firstAirDate",
        "streamType": "video",
        "pccr": true,
        "authorized": "true",
        "streamFormat": "streamFormat",
        "genre": "Comedy",
        "station": "test-station",
        "season": "1521",
        "showType": "sitcom",
        "ID": "cd7b[...]6f",
        "contentType": "VOD",
        "friendlyName": "test-friendly-name",
        "playerName": "HTML5 player",
        "album": "test-album",
        "author": "test-author",
        "length": 100,
        "dayPart": "dayPart",
        "label": "test-label",
        "mvpd": "test-mvpd",
        "feed": "sourceFeed",
        "assetID": "/uri-reference",
        "name": "test-name",
        "publisher": "test-media-publisher",
        "firstDigitalDate": "releaseDate"
      },
      "advertisingPodDetails": {
        "offset": 0,
        "ID": "3d594614f445f6b00014e9b77730b833_1",
        "friendlyName": "Mid-ad"
      }
    },
    "implementationDetails": {
      "environment": "server",
      "name": "https://ns.adobe.com/experience/edge",
      "version": "0.0.0"
    },
    "identityMap": {
      "ECID": [
        {
          "id": "5191[...]21",
          "authenticatedState": "ambiguous",
          "primary": true
        }
      ]
    },
    "eventType": "media.adComplete",
    "_id": "f[...]0",
    "timestamp": "YYYY-11-20T12:44:03Z"
  }
}
media.chapterComplete
code language-json 
{
  "xdm": {
    "_{tenantName}": {
      "customField1": "c1",
      "customField2": "c2",
      "customTest": "myCustomValue1"
    },
    "environment": {
      "browserDetails": {},
      "ipV4": "130.248.81.10"
    },
    "mediaReporting": {
      "sessionDetails": {
        "adLoad": "adLoadType",
        "appVersion": "sdk-1.0",
        "artist": "test-artist",
        "pev3": "video",
        "channel": "broadcastChannel",
        "rating": "4.8/5",
        "show": "test-name Series",
        "genreList": ["Comedy"],
        "episode": "4933",
        "originator": "Tokala Clementine",
        "network": "test-network",
        "firstAirDate": "firstAirDate",
        "streamType": "video",
        "pccr": true,
        "authorized": "true",
        "streamFormat": "streamFormat",
        "genre": "Comedy",
        "station": "test-station",
        "season": "1521",
        "showType": "sitcom",
        "ID": "cd7b[...]6f",
        "contentType": "VOD",
        "friendlyName": "test-friendly-name",
        "playerName": "HTML5 player",
        "album": "test-album",
        "author": "test-author",
        "length": 100,
        "dayPart": "dayPart",
        "label": "test-label",
        "mvpd": "test-mvpd",
        "feed": "sourceFeed",
        "assetID": "/uri-reference",
        "name": "test-name",
        "publisher": "test-media-publisher",
        "firstDigitalDate": "releaseDate"
      },
      "chapterDetails": {
        "timePlayed": 10,
        "offset": 0,
        "length": 10,
        "index": 1,
        "ID": "3d594614f445f6b00014e9b77730b833_1",
        "isStarted": true,
        "friendlyName": "Chapter 1",
        "isCompleted": true
      }
    },
    "implementationDetails": {
      "environment": "server",
      "name": "https://ns.adobe.com/experience/edge",
      "version": "0.0.0"
    },
    "identityMap": {
      "ECID": [
        {
          "id": "5191[...]21",
          "authenticatedState": "ambiguous",
          "primary": true
        }
      ]
    },
    "eventType": "media.chapterComplete",
    "_id": "a[...]0",
    "timestamp": "YYYY-11-20T12:44:24Z"
  }
}
media.sessionComplete
code language-json 
{
  "xdm": {
    "_{tenantName}": {
      "customField1": "c1",
      "customField2": "c2"
    },
    "environment": {
      "browserDetails": {},
      "ipV4": "130.248.81.10"
    },
    "mediaReporting": {
      "qoeDataDetails": {
        "playerSdkErrors": ["test-buffer-start"],
        "bitrateAverageBucket": "0-99",
        "bitrateChangeCount": 1,
        "droppedFrames": 30,
        "hasErrorImpactedStreams": true,
        "hasBitrateChangeImpactedStreams": true,
        "hasDroppedFrameImpactedStreams": true,
        "bitrateAverage": 35,
        "timeToStart": 1,
        "errorCount": 1
      },
      "sessionDetails": {
        "adLoad": "adLoadType",
        "appVersion": "sdk-1.0",
        "hasProgress10": true,
        "pev3": "video",
        "channel": "broadcastChannel",
        "rating": "4.8/5",
        "episode": "4933",
        "pauseTime": 3,
        "streamType": "video",
        "pccr": true,
        "authorized": "true",
        "segment": "[0-1]",
        "season": "1521",
        "showType": "sitcom",
        "pauseCount": 1,
        "ID": "cd7b[...]6f",
        "contentType": "VOD",
        "uniqueTimePlayed": 47,
        "totalTimePlayed": 55,
        "author": "test-author",
        "hasProgress25": true,
        "feed": "sourceFeed",
        "timePlayed": 48,
        "name": "test-name",
        "publisher": "test-media-publisher",
        "hasPauseImpactedStreams": true,
        "averageMinuteAudience": 0.48,
        "artist": "test-artist",
        "show": "test-name Series",
        "genreList": ["Comedy"],
        "originator": "Tokala Clementine",
        "network": "test-network",
        "firstAirDate": "firstAirDate",
        "hasSegmentView": true,
        "streamFormat": "streamFormat",
        "genre": "Comedy",
        "station": "test-station",
        "friendlyName": "test-friendly-name",
        "isCompleted": true,
        "playerName": "HTML5 player",
        "album": "test-album",
        "chapterCount": 1,
        "length": 100,
        "adCount": 1,
        "dayPart": "dayPart",
        "label": "test-label",
        "mvpd": "test-mvpd",
        "secondsSinceLastCall": 51,
        "assetID": "/uri-reference",
        "isPlayed": true,
        "estimatedStreams": 1,
        "firstDigitalDate": "releaseDate"
      },
      "states": [
        {
          "isSet": true,
          "name": "mute",
          "count": 1,
          "time": 3
        },
        {
          "isSet": true,
          "name": "pictureInPicture",
          "count": 1,
          "time": 3
        }
      ]
    },
    "implementationDetails": {
      "environment": "server",
      "name": "https://ns.adobe.com/experience/edge",
      "version": "0.0.0"
    },
    "identityMap": {
      "ECID": [
        {
          "id": "5191[...]21",
          "authenticatedState": "ambiguous",
          "primary": true
        }
      ]
    },
    "eventType": "media.sessionComplete",
    "_id": "a[...]0",
    "timestamp": "YYYY-11-20T12:44:40Z"
  }
}
media.sessionStart (gedownloade inhoud)

De zittingen volgden gebruikend het ​ gedownloade eindpunt ​ volgen het zelfde rapporteringsschema met één zeer belangrijk verschil: xdm.mediaReporting.sessionDetails.isDownloaded wordt ingesteld op true on the sessionStart reporting event. Alle andere gebeurtenistypen zijn gelijk aan de bovenstaande voorbeelden van live-inhoud.

code language-json 
{
  "xdm": {
    "mediaReporting": {
      "customMetadata": [
        {
          "name": "customData",
          "value": "example"
        }
      ],
      "playhead": 0,
      "sessionDetails": {
        "ID": "d8a25708a6b0be83975e32e2f422105ed62f51ff67e6d82d898657534ab9244f",
        "channel": "channel",
        "contentType": "VOD",
        "length": 100,
        "name": "123456789",
        "playerName": "playerName",
        "isDownloaded": true
      }
    },
    "eventType": "media.sessionStart",
    "timestamp": "YYYY-09-26T15:52:24Z",
    "identityMap": {
      "ECID": [
        {
          "id": "51910389753901685456014889838591030721"
        }
      ]
    },
    "implementationDetails": {
      "version": "0.0.1",
      "environment": "browser",
      "name": "https://ns.adobe.com/experience/edge"
    }
  }
}
recommendation-more-help
media-analytics-help