Adobe Target Bulk Profile Update API

Last update: Wed Sep 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：
APIs/SDKs

创建对象：

开发人员

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

Bulk Profile Update API的版本2 (v2)是当前版本。但是，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=参数是必需的，必须在文件开头指定。

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

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

HTTPPOST请求

向Target边缘服务器发出HTTPPOST请求以处理该文件。以下是使用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