Request parameters request-parameters
Analytics Data
analytics.trackingServer
sessionStart
analytics.reportSuite
sessionStart
analytics.enableSSL
sessionStart
analytics.visitorId
sessionStart
visitorId
equals the Analytics VID.
Visitor Data
visitor.marketingCloudOrgId
sessionStart
visitor.marketingCloudUserId
sessionStart
marketingCloudUserId
equals the MID
in Adobe Analytics. While not technically required, this parameter is necessary for accessing the Experience Cloud family of apps.visitor.aamLocationHint
sessionStart
appInstallationId
sessionStart
Content Data
media.id
sessionStart
media.name
sessionStart
media.length
sessionStart
media.contentType
sessionStart
media.playerName
sessionStart
media.channel
sessionStart
media.resume
sessionStart
media.sdkVersion
sessionStart
Content Standard Metadata
media.streamFormat
sessionStart
media.show
sessionStart
media.season
sessionStart
media.episode
sessionStart
media.assetId
sessionStart
media.genre
sessionStart
media.firstAirDate
sessionStart
media.firstDigitalDate
sessionStart
media.rating
sessionStart
media.originator
sessionStart
media.network
sessionStart
media.showType
sessionStart
The type of content, expressed as an integer between 0 and 3:
- 0 - Full episode
- 1 - Preview
- 2 - Clip
- 3 - Other
media.adLoad
sessionStart
media.pass.mvpd
sessionStart
media.pass.auth
sessionStart
media.dayPart
sessionStart
media.feed
sessionStart
Ad Data
media.ad.podFriendlyName
adBreakStart
media.ad.podIndex
adBreakStart
media.ad.podSecond
adBreakStart
media.ad.podPosition
adStart
media.ad.name
adStart
media.ad.id
adStart
media.ad.length
adStart
media.ad.playerName
adStart
Ad Standard Metadata
media.ad.advertiser
adStart
media.ad.campaignId
adStart
media.ad.creativeId
adStart
media.ad.siteId
adStart
media.ad.creativeURL
adStart
media.ad.placementId
adStart
Chapter Data
media.chapter.index
chapterStart
media.chapter.offset
chapterStart
media.chapter.length
chapterStart
media.chapter.friendlyName
chapterStart
Quality Data
media.qoe.bitrate
media.qoe.droppedFrames
media.qoe.framesPerSecond
media.qoe.timeToStart
California Consumer Privacy Act (CCPA) Parameters ccpa-params
analytics.optOutServerSideForwarding
sessionStart
analytics.optOutShare
sessionStart
Additional Details additional-details
visitor.marketingCloudUserId
Pass the Experience Cloud User ID (also known as the MID
or MCID
) on the sessionStart
call by including it inside the params
map using the following key: visitor.marketingCloudUserId. This is a useful feature if you already integrate with other Experience Cloud products and have already obtained the MCID.
appInstallationId
-
If you do not pass an
appInstallationId
value - The MA back-end will no longer generate a MCID, but instead will rely on Adobe Analytics to do this. Adobe’s recommendation is to either send a MCID if available, or anappInstallationId
(along with the still mandatorymarketingCloudOrgId
) so that the Media Collection API generates the MCID and sends it on all calls. -
If you do pass
appInstallationId
value - The MCID can be generated by the MA back-end, if you pass values forappInstallationId
and the (required)marketingCloudOrgId
parameters. If you do passappInstallationId
yourself, you must persist its value on the client side. It must be unique to the app on a device, and must be persistent for as long as the app is not re-installed.
appInstallationId
uniquely identifies the app and the device. It needs to be unique for each app on each device, i.e., two users using the same version of the same app on different devices must each send a different (unique) appInstallationId
.visitor.marketingCloudOrgId
In addition to being necessary for MCID generation when that is not provided, this parameter is also used as the value for the publisher ID (based on which Media Analytics performs federation rule matching.)
Analytics Legacy User ID (aid) and Declared User IDs (customerIDs)
-
analytics.aid:
The value of this key must be a string that represents the Analytics Legacy User ID
-
visitor.customerIDs:
The value of this key must be an object of the following format:
code language-js "<<insert your ID name here>>": { "id": " <<insert your id here>>", "authState": <<insert one of 0, 1, 2>> }
Note that the visitor.customerIDs
value can have any number of objects in the presented format.
visitor.aamLocationHint
This parameter indicates which Adobe Audience Manager (AAM) Edge would be hit when Adobe Analytics sends the customer data to Audience Manager. If a value is not entered, the value is null. This is particularly important when end users tend to use their devices in geographically distant locations (e.g., US-East, US-West, Europe, Asia). Otherwise, user data will be spread across multiple AAM Edges.
media.resume
If the app determines that a session was closed and then resumed at a later time, e.g., the user left the video but eventually came back, and the player resumed the video from the playhead where it was stopped, you can send an optional boolean media.resume parameter inside the params bucket of the sessionStart
call.