要求參數 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
使用以下索引鍵將 Experience Cloud 使用者 ID (亦稱為 MID
或 MCID
) 加入 params
對應,再透過 sessionStart
呼叫予以傳遞:visitor.marketingCloudUserId。如果您已經與 Experience Cloud 產品整合,而且已取得 MCID,這項功能將會非常實用。
appInstallationId
-
如果您 未 傳遞
appInstallationId
值 - MA 後端將不再產生 MCID,而是會仰賴 Adobe Analytics 來產生。Adobe 建議您盡可能傳送 MCID 或appInstallationId
(連同目前仍為必要項目的marketingCloudOrgId
),讓媒體收集 API 在每次呼叫時產生 MCID 並予以傳送。 -
如果您 會 傳遞
appInstallationId
值 - 如果您會傳遞appInstallationId
的值和 (必要的)marketingCloudOrgId
參數,則 MA 後端 能 產生 MCID。如果您自行傳遞appInstallationId
,必須將其值保留在用戶端上。該值必須供裝置上的應用程式專用,而且只要您未重新安裝應用程式,該值就必須存在。
appInstallationId
。每部裝置上的每個應用程式都必須有專屬的值。也就是說,假設有兩位使用者在兩部相異裝置上使用同一款應用程式的相同版本,他們必須分別傳送不同 (唯一) 的 appInstallationId
。visitor.marketingCloudOrgId
除了是在未提供 MCID 時用來產生 MCID 的必要項目之外,這個參數還能當做發行者 ID 的值 (Media Analytics 會根據該 ID 執行同盟規則比對)。
Analytics 舊版使用者 ID (aid) 和宣告使用者 ID (customerID)
-
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。如果未輸入值,則為空值。當使用者傾向於在偏遠位置使用裝置 (如美國東部、美國西部、歐洲、亞洲) 時,這個參數尤其重要。否則,使用者資料將散佈到多個 AAM Edge。
media.resume
如果應用程式判斷工作階段先前曾關閉,並在稍後恢復 (例如,使用者離開視訊,但後來繼續播放),而且播放器從停止的播放點恢復視訊播放,您可以在 呼叫的參數儲存貯體中傳送選用的布林值 media.resumesessionStart
參數。