通过 API 触发数据摄取

Adobe Campaign Standard允许您通过API触发数据映射的即时摄取，并检索摄取请求的状态。

本页介绍如何触发和检索数据映射的摄取状态。 有关Campaign Standard API的全局信息，请参阅本节。

先决条件

在使用API之前，必须首先在Campaign Standard界面中配置和发布数据映射。 有关详细信息，请参阅以下部分：

• 映射定义
• 映射激活

创建数据映射后，必须停止它的运行，以便您可以随时从API触发它。 为此，请执行以下步骤：

1. 在Campaign Standard中，转到​Administration > Development > Platform > Status of data export to platform​菜单。

2. 多次单击数据映射以将其打开，然后单击​Stop​按钮。

   

3. 保存更改

数据映射执行现已停止。 您可以使用Campaign Standard API手动触发它。

开始立即获取数据映射

通过POST操作触发XDM映射到Adobe Experience Platform的即时引入：

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

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>"}

GET操作返回以下信息：

• batchId:仅当批准备和上传后出现故障时，才填充此字段，
• 信息:XDM映射ID，
• numRecords:已摄取的记录数（仅限成功状态），
• 状态:收录请求状态(success/failed/in progress)

对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"
  }