快速入門

1. 收集必要的標準 Adobe Analytics 和訪客資料；您必須提供這些資料才能執行任何 Experience Cloud 應用程式：

   • 訪客 Experience Cloud 組織 ID
   • 訪客 Experience Cloud 使用者 ID
   • Analytics 報表套裝 ID
   • Analytics 追蹤伺服器 URL

2. 為 sessions 要求內文建立 JSON 物件，其中包含發出成功呼叫所需的最少資料。例如：

   {
       "playerTime": {
           "playhead": 0,
           "ts": 1234560890123
       },
       "eventType": "sessionStart",
       "params": {
           "media.playerName": "sample-html5-api-player",
           "analytics.trackingServer": "[YOUR_TS]",
           "analytics.reportSuite": "[YOUR_RSID]",
           "media.contentType": "VOD",
           "media.length": 60.39333333333333,
           "media.id": "MA Collection API Sample Player",
           "visitor.marketingCloudOrgId": "[YOUR_ORG_ID]",
           "visitor.marketingCloudUserId": "[YOUR_ECID]",
           "media.name": "ClickMe",
           "media.channel": "sample-channel",
           "media.sdkVersion": "va-api-0.0.0",
           "analytics.enableSSL": false
       }
   }
   

   注意

   您必須在 JSON 要求內文中使用正確的資料類型。例如，analytics.enableSSL 須有布林值、media.length 是數值等。您可以參閱 JSON 驗證結構，查閱參數類型和強制與選用需求。

3. 將工作階段要求傳送到 MA Collection API 端點。如果您的要求裝載無效，請找出問題並再次嘗試，直到獲得 201 Created 回應為止。在以下 curl 範例中，JSON 要求內文位於名為 sample_data_session 的檔案中：

   $ curl -i -d \
     @sample_data_session https://{uri}/api/v1/sessions \
     > curl.sessions.out
   
   $ cat curl.sessions.out
   HTTP/1.1 201 Created
   Server: nginx/1.13.5
   Date: Mon, 18 Dec 2017 22:34:12 GMT
   Content-Type: application/octet-stream
   Content-Length: 0
   Connection: keep-alive
   Location: /api/v1/sessions/a39c037641f[...]  # <== Session ID
   Access-Control-Allow-Origin: *
   Access-Control-Allow-Methods: OPTIONS,POST,PUT
   Access-Control-Allow-Headers: Content-Type
   Access-Control-Expose-Headers: Location
   

如果工作階段要求成功，您會獲得與前述內容相似的 201 Created 回應。回應的 Location 標題含有工作階段 ID。工作階段 ID 是回應中的重要資訊，因為它是所有後續追蹤呼叫的必要元件。成功傳回工作階段要求後，您就可以放心地在視訊播放器中使用 MA API 實作視訊追蹤。