Show Menu
主题×

通过 API 触发数据摄取

Adobe Experience Platform数据连接器目前处于测试阶段,可能会在不通知的情况下频繁进行更新。 客户必须托管在Azure上(目前仅限北美的beta版),才能访问这些功能。 如果您想要访问,请联系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映射请求状态及其相关作业的详细信息,请在Campaign Standard界面中的菜单中查 Status of data export to platform 看(请参阅 映射激活 )。
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"
    }