透過 API 觸發資料引入

重要

Adobe Experience Platform Data Connector目前為測試版,可能會經常更新,恕不另行通知。 客戶必須在Azure上托管(目前測試版僅供北美使用),才能存取這些功能。 如果您想要存取權限,請聯絡Adobe客戶服務。

Adobe Campaign Standard可讓您透過API觸發立即擷取資料對應,並擷取擷取請求的狀態。

本頁面說明如何觸發和擷取資料對應的擷取狀態。 如需Campaign StandardAPI的全域資訊,請參閱此區段

先決條件

使用API之前,必須先在Campaign Standard介面中設定並發佈資料對應。 如需詳細資訊,請參閱下列區段。

建立資料對應後,您必須停止該資料對應的執行,以便隨時從API觸發。 要執行此操作,請依照下列步驟執行:

  1. 在「Campaign Standard」中,前往「Administration > Development > Platform > Status of data export to platform」功能表。

  2. 按兩下資料映射以開啟它,然後按一下​Stop​按鈕。

  3. 儲存您的變更

資料對應執行現已停止。 您可以使用Campaign StandardAPI來手動觸發。

開始立即擷取資料對應

系統會透過POST操作觸發立即擷取XDM對應至Adobe Experience Platform:

POST https://mc.adobe.io/<ORGANIZATION>/campaign/dataIngestion/xdmIngestion/<XDM Mapping ID>/ingest

注意

若要執行內嵌POSTAPI呼叫,使用者必須具有​SQL函式執行​角色,可由Campaign Standard管理員透過執行下列JS指令碼來提供:

var sqlRoleObj = REST.head.roleBase.sql.get();
REST.head.securityGroup.Administrators.roles.post(sqlRoleObj);

POST操作返回有關已建立請求狀態的資訊:

  • 已成功提交XDM對應的請求:
{
"requestId": <value>,
"info": "Ingestion request submitted successfully for the Mapping ID: <value>",
"status":"Success"
}
  • XDM對應的請求已在進行中:
{
"requestId": <value>,
"info": "Ingestion request already in progress for the Mapping ID: <value>",
"status":"In Progress"
}
  • 請求失敗,因為XDM對應未發佈或已停止:
{
"info": "Unable to submit data ingestion request, XDM Mapping ID: <value> is not stopped",
"status": "Failed"
}
{
"info": "Unable to submit data ingestion request, XDM Mapping ID: <value> is not published",
"status": "Failed"
}

擷取擷取請求的狀態

擷取請求的狀態可透過GET操作和參數中所需的請求ID來擷取:

GET https://mc.adobe.io/<ORGANIZATION>/campaign/dataIngestion/xdmIngestion/<XDM Mapping ID>/ingest
{"requestId"="<value>"}
注意

有關XDM對應請求狀態及其相關作業的詳細資訊,請參閱​Status of data export to platform​功能表的Campaign Standard介面(請參閱對應啟動)。

GET操作返回以下資訊:

  • batchId:只有在批次準備和上傳後發生失敗時,才會填入此欄位,
  • 資訊:XDM對應ID,
  • numRecords:已擷取的記錄數(僅限成功狀態),
  • 狀態:擷取請求狀態(成功/失敗/進行中)

對GET操作的可能響應為:

  • 成功擷取請求:

    {
    "batchId": "",
    "info": "Mapping Id: <value>. ",
    "numRecords": 15,
    "requestId": 3520,
    "status": "Success"
    }
    
  • 內嵌請求失敗,內嵌0個記錄:

    {
    "batchId": "",
    "info": "Mapping Id: <value>. ACP-880056 Failed to fetch the record from the database.",
    "numRecords": 0,
    "requestId": 3520,
    "status": "Failed"
    }
    
  • 內嵌請求失敗,部分記錄在批次下上載:

    {
    "batchId": "<value>",
    "info": "Mapping Id: <value>. ACP-880096 Sync Job failed to upload. Please check the error in the Platform UI.",
    "numRecords": 0,
    "requestId": <value>,
    "status": "Failed"
    }
    
  • 擷取某些記錄後擷取請求已中止(可能會在當機情況下發生):

    {
    "batchId": "",
    "info": "Mapping Id: <value>. Ingestion request aborted due to some issue with data ingestion service. Please submit a new request",
    "numRecords": 0,
    "requestId": <value>,
    "status": "Aborted"
    }
    
  • 正在內嵌請求(當請求以批次上傳資料,或正在為請求準備批次時):

    {
    "batchId": "",
    "info": "Mapping Id: <value>.",
    "numRecords": 0,
    "requestId": <value>,
    "status": "In Progress"
    }
    

本頁內容