请求参数 request-parameters
Analytics 数据
analytics.trackingServer
sessionStart
analytics.reportSuite
sessionStart
analytics.enableSSL
sessionStart
analytics.visitorId
sessionStart
visitorId
等于 Analytics VID.
访客数据
visitor.marketingCloudOrgId
sessionStart
visitor.marketingCloudUserId
sessionStart
marketingCloudUserId
等于 Adobe Analytics 中的 MID
。虽然从技术上讲不是必需的,但访问 Experience Cloud 系列应用程序时需要此参数。visitor.aamLocationHint
sessionStart
appInstallationId
sessionStart
内容数据
media.id
sessionStart
media.name
sessionStart
media.length
sessionStart
media.contentType
sessionStart
media.playerName
sessionStart
media.channel
sessionStart
media.resume
sessionStart
media.sdkVersion
sessionStart
内容标准元数据
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
内容的类型,以 0 到 3 之间的整数表示。
- 0 - 整集
- 1 - 预览
- 2 - 剪辑
- 3 - 其它
media.adLoad
sessionStart
media.pass.mvpd
sessionStart
media.pass.auth
sessionStart
media.dayPart
sessionStart
media.feed
sessionStart
广告数据
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
广告标准元数据
media.ad.advertiser
adStart
media.ad.campaignId
adStart
media.ad.creativeId
adStart
media.ad.siteId
adStart
media.ad.creativeURL
adStart
media.ad.placementId
adStart
章节数据
media.chapter.index
chapterStart
media.chapter.offset
chapterStart
media.chapter.length
chapterStart
media.chapter.friendlyName
chapterStart
质量数据
media.qoe.bitrate
media.qoe.droppedFrames
media.qoe.framesPerSecond
media.qoe.timeToStart
加州消费者隐私法案 (CCPA) 参数 ccpa-params
analytics.optOutServerSideForwarding
sessionStart
analytics.optOutShare
sessionStart
其他详细信息 additional-details
visitor.marketingCloudUserId
在 sessionStart
调用中传递 Experience Cloud 用户 ID(也称为 MID
或 MCID
),方法是使用以下键将其包含在 params
映射中:visitor.marketingCloudUserId。如果您已经与其他 Experience Cloud 产品集成并且已经获取了 MCID,那么这将是一项非常有用的功能。
appInstallationId
-
如果您 没有 传递
appInstallationId
值 - MA 后端将不再生成 MCID,而是依赖 Adobe Analytics 来执行此操作。Adobe 的建议是发送 MCID(如果可用),或发送appInstallationId
(以及仍需强制使用的marketingCloudOrgId
参数),以便媒体收集 API 生成 MCID 并在所有调用中发送 MCID。 -
如果您 确有 传递
appInstallationId
值 - 如果您传递appInstallationId
值和(必需)marketingCloudOrgId
参数,则 MCID 可以 由 MA 后端生成。如果您自己确实传递了appInstallationId
,则必须在客户端保留其值。它必须为设备上的应用程序所特有的,并且只要不重新安装该应用程序,就必须持续保留该值。
appInstallationId
用于唯一标识应用程序 和设备。对于每个设备上的每个应用程序来说,它必须是唯一的,也就是说,对于在不同的设备上使用相同应用程序、相同版本的两个用户,每个人必须发送一个不同的(唯一的)appInstallationId
。visitor.marketingCloudOrgId
除了在未提供 MCID 的情况下需要使用此参数生成 MCID 之外,此参数也用作发布者 ID 的值(具体依据执行联合规则匹配的 Media Analytics)。
Analytics 旧版用户 ID (aid) 和已声明的用户 ID (customerIDs)
-
analytics.aid:
此键的值必须是表示 Analytics 旧版用户 ID 的字符串
-
visitor.customerIDs:
此键的值必须是以下格式的对象:
code language-js "<<insert your ID name here>>": { "id": " <<insert your id here>>", "authState": <<insert one of 0, 1, 2>> }
请注意,visitor.customerIDs
值可以包含所呈现格式的任意数量的对象。
visitor.aamLocationHint
此参数指示当 Adobe Analytics 将客户数据发送至 Audience Manager 时,将会点击哪个 Adobe Audience Manager (AAM) Edge。如果未输入值,则值为 null。当最终用户倾向于在地理上相距较远的位置(例如,美国东部、美国西部、欧洲、亚洲)使用其设备时,这一点尤其重要。否则,用户数据将散布在多个 AAM 边缘中。
media.resume
如果应用程序确定会话已关闭,稍后又恢复(例如用户离开视频但最终返回,并且播放器从停止的播放头处恢复视频),则可以在 调用的参数分段内发送一个可选的布尔型 media.resumesessionStart
参数。