Adobe Target Single Profile Update API
Adobe Target Single Profile Update API允许您为单个用户发送配置文件更新。 Single Profile Update API几乎与Bulk Profile Update API相同,但一次更新一个访客资料,与API调用内联,而不是.cvs文件。
Single Profile Update API和通常用于必须发生与未实现Target的渠道中发生的事务相关的更新时。 例如,要更新执行某些离线操作的单个访客的配置文件。 操作包括联系呼叫中心、资助贷款、在商店中使用会员卡、访问自助服务亭等。
Single Profile Update API的优点包括:
- 配置文件属性的数量没有限制。
- 通过网站发送的用户档案属性可以通过API更新,反之亦然。
注意事项
-
Single Profile Update API被限制为在任何滚动的24小时内执行100万次更新。
-
更新通常在一小时内发生,但可能需要24小时才能反映出来。
如果必须发送更多更新,或需要在较短的时间范围内处理更新,请考虑通过客户端更新(首选)或通过Adobe Target服务器端投放API发送事务性用户档案更新。
-
Single Profile Update API是服务器到服务器API,设计为在网页中工作。 若要从您的网页中更新访客资料,您可以使用trackEvent()函数或交付API。
格式
以profile.paramName=value
格式指定配置文件参数。
要更新pcId
的配置文件,请使用:
\ https\://\<your-client-code>.tt.omtrdc.net/m2/client/profile/update?mboxPC=1368007744041-575948.01\_00\&profile.attr=0\&profile.attr2=1…\
要更新mbox3rdPartyId
的配置文件,请使用:
\ shell http\://\<your-client-code>.tt.omtrdc.net/m2/client/profile/update?mbox3rdPartyId=123456\&profile.attr=0\&profile.attr2=1…\
Single Profile Update API仅供更新。 如果未找到任何内容,则不会创建配置文件。
注释
- 参数和值必须使用UTF-8进行URL编码。
- 参数格式为
profile.paramName
。 - 并非所有pcIds和mbox3rdPartyIds都必须存在所有参数值。
- 参数和值区分大小写。
- 同时支持GET和POST。
- 当前的大小限制为:GET为8 KB,POST为60 KB。
响应
上述请求的示例响应如下所示:
trueRequest successfully submitted
此响应表示响应已提交,将很快处理。