Adobe Target Bulk Profile Update API

Last update: Wed May 29 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：

创建对象：

undefined

此 Adobe Target Bulk Profile Update API 允许您使用批处理文件批量更新网站多个访客的用户配置文件。

使用 Bulk Profile Update API，您可以方便地以多个用户的配置文件参数的形式将详细的访客配置文件数据发送至 Target 来自任何外部源。外部来源可能包括客户关系管理(CRM)或销售点(POS)系统，这些系统通常无法在网页上使用。

版本

URL示例

功能

http://CLIENTCODE.tt.omtrdc.net/m2/CLIENTCODE/profile/batchUpdate

仅支持批量配置文件更新。

http://CLIENTCODE.tt.omtrdc.net/m2/CLIENTCODE/v2/profile/batchUpdate

如果未找到，则创建配置文件。
每行状态更新。

NOTE

的版本2 (v2) Bulk Profile Update API 是当前版本。但是， Target 仍支持版本1 (v1)。

批量配置文件更新API的优势

配置文件属性的数量没有限制。
通过网站发送的用户档案属性可以通过API更新，反之亦然。

注意事项

批处理文件必须小于 50 MB。另外，每次上传的总行数不应超过 500,000 行。
更新通常在一小时内发生，但可能需要24小时才能反映出来。
对于在后续批次中可以在24小时内上传的一个或多个行数没有限制。但是，为了确保其他进程能够高效运行，这些数据的吸收过程在工作时间可能会受到节流限制。
对于相同thirdPartyId，如果连续的v2批量更新调用之间没有mbox调用，则会覆盖在第一次批量更新调用中更新的属性。
Adobe 不保证100%的批量配置文件数据将载入并保留在Target中，因此可用于定位。在当前设计中，有可能不会载入或保留一小部分数据（最多占大批量生产的0.1%）。

批处理文件

要批量更新用户档案数据，请创建批处理文件。批处理文件是一个文本文件，其值由逗号分隔，类似于以下示例文件。

\ batch=pcId,param1,param2,param3,param4\ 123,value1\ 124,value1,value4\ 125,value2\ 126,value1,value2,value3,value4\

NOTE

此 batch= 参数是必需的，必须在文件开头指定。

您在POST调用中引用此文件 Target 服务器处理文件。创建批处理文件时，请考虑以下事项：

文件的第一行必须指定列标题。
第一个标头应为 pcId 或 thirdPartyId. 此 Marketing Cloud visitor ID 不受支持。 pcId 是 Target — 生成的visitorID。 thirdPartyId 是由客户端应用程序指定的ID，传递给 Target 通过mbox调用，作为 mbox3rdPartyId. 必须在此将其引用为 thirdPartyId.
出于安全原因，您在批处理文件中指定的参数和值必须使用UTF-8进行URL编码。参数和值可以转发到其他边缘节点以供通过HTTP请求进行处理。
参数必须采用格式 paramName 仅限。参数显示在中 Target 作为 profile.paramName.
如果您使用 Bulk Profile Update API v2，您无需为每个参数指定所有参数值 pcId. 已为任何对象创建配置文件 pcId 或 mbox3rdPartyId 在中未找到的 Target. 如果您使用的是v1，则不会为缺少的pcIds或mbox3rdPartyIds创建配置文件。
批处理文件必须小于 50 MB。此外，总行数不应超过500,000。此限制可确保服务器不会因请求过多而泛滥。
您可以发送多个文件。但是，您一天内发送的所有文件的行总数不应超过每个客户端的100万。
您上传的属性数量没有限制。但是，配置文件的整体大小（包括系统数据）不应超过2000 KB。 Adobe 建议为配置文件属性使用的存储空间小于1000 KB。
参数和值区分大小写。

HTTPPOST请求

向发出HTTPPOST请求 Target 用于处理文件的边缘服务器。以下是使用curl命令获取文件batch.txt的示例HTTPPOST请求：

\ curl -X POST --data-binary @BATCH.TXT http\://CLIENTCODE.tt.omtrdc.net/m2/CLIENTCODE/v2/profile/batchUpdate\

其中：

BATCH.TXT是文件名。 CLIENTCODE Target 客户端代码。

如果您不知道自己的客户端代码，请在 Target 用户界面点击 Administration > Implementation. 客户端代码显示在 Account Details 部分。

Inspect响应

配置文件API可返回批处理的提交状态，以及“batchStatus”下的链接以指向显示特定批处理作业整体状态的其他URL。

示例API响应

以下代码片段是Profiles API响应的示例：

<response>
    <success>true</success>
    <batchStatus>http://mboxedge45.tt.omtrdc.net/m2/demo/profile/batchStatus?batchId=demo-1701473848678-13029383</batchStatus>
    <message>Batch submitted for processing</message>
</response>

如果出现错误，响应将包含 success=false 以及错误的详细消息。

默认批次状态响应

成功默认响应（如果满足上述条件） batchStatus 单击URL链接时如下所示：

<response><batchId>demo4-1701473848678-13029383</batchId><status>complete</status><batchSize>1</batchSize></response>

状态字段的预期值包括：

状态

详细信息

complete

配置文件批量更新请求已成功完成。

incomplete

用户档案批量更新请求仍在处理中，尚未完成。

stuck

配置文件批次更新请求卡住，无法完成。

详细的批次状态URL响应

可以通过传递参数获取更详细的响应 showDetails=true 到 batchStatus 上面的url。

例如：

http://mboxedge45.tt.omtrdc.net/m2/demo/profile/batchStatus?batchId=demo-1701473848678-13029383&showDetails=true

详细响应

<response>
    <batchId>demo4-1701473848678-13029383</batchId>
    <status>complete</status>
    <batchSize>1</batchSize>
    <consumedCount>1</consumedCount>
    <successfulUpdates>1</successfulUpdates>
    <profilesNotFound>0</profilesNotFound>
    <failedUpdates>0</failedUpdates>
</response>

recommendation-more-help

6906415f-169c-422b-89d3-7118e147c4e3