Adobe Target Bulk Profile Update API

最終更新日： 2025年5月5日

作成対象：

  • 開発者

Adobe Target Bulk Profile Update API では、Web サイトへの複数の訪問者のユーザープロファイルをバッチファイルで一括更新できます。

Bulk Profile Update API を使用すると、多くのユーザーが任意の外部ソースから Target 信できるように、プロファイルパラメーターの形式で詳細な訪問者プロファイルデータを簡単に送信できます。 外部ソースには顧客関係管理（CRM）システムや販売時点（POS）システムを含めますが、これらのシステムは通常、web ページでは使用できません。

バージョンURL の例機能
v1http://CLIENTCODE.tt.omtrdc.net/m2/CLIENTCODE/profile/batchUpdateプロファイルの一括更新のみをサポートします。
v2http://CLIENTCODE.tt.omtrdc.net/m2/CLIENTCODE/v2/profile/batchUpdate
  • 見つからない場合はプロファイルを作成
  • 行ごとのステータスの更新。
NOTE
Bulk Profile Update API のバージョン 2 （v2）は現在のバージョンです。 ただし、Target はバージョン 1 （v1）を引き続きサポートします。

Bulk Profile Update API の利点

  • プロファイル属性の数に上限がありません。
  • サイトを介して送信されたプロファイル属性は、API を使用して更新できます。その逆も可能です。

注意事項

  • バッチファイルの容量は 50 MB 未満にする必要があります。また、1 回にアップロードできる行数は 50 万行までです。
  • 更新は通常 1 時間以内に行われますが、反映されるまでに 24 時間かかる場合があります。
  • 後続のバッチで 24 時間にわたってアップロードできるアップロード行数に制限はありません。 ただし、他のプロセスを効率的に実行するために、営業時間中は取り込みプロセスが調整される場合があります。
  • 同じ thirdPartyIds の間に mbox 呼び出しを含まない v2 バッチ更新呼び出しが連続して発生すると、最初のバッチ更新呼び出しで更新されたプロパティが上書きされます。
  • 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 で生成された visitorID です。 thirdPartyId は、クライアントアプリケーションによって指定された ID で、mbox3rdPartyId として mbox 呼び出しを通じて Target に渡されます。 ここでは、thirdPartyId と呼ぶ必要があります。
  • セキュリティ上の理由から、バッチファイルで指定するパラメーターと値は、UTF-8 を使用して URL エンコードする必要があります。 パラメーターと値は、HTTP リクエストを通じて処理するために他のエッジノードに転送できます。
  • パラメーターは、paramName の形式のみにする必要があります。 パラメーターは、profile.paramName のように Target に表示されます。
  • Bulk Profile Update API v2 を使用している場合は、各 pcId に対してすべてのパラメーター値を指定する必要はありません。 プロファイルは、Target に見つからない pcId または mbox3rdPartyId に対して作成されます。 v1 を使用している場合、pcId または mbox3rdPartyIds が見つからないプロファイルは作成されません。
  • バッチファイルの容量は 50 MB 未満にする必要があります。また、合計行数は 500,000 を超えないようにする必要があります。 この制限により、サーバーに大量のリクエストが送られないようにすることができます。
  • 複数のファイルを送信できます。 ただし、1 日に送信するすべてのファイルの行の合計は、各クライアントで 100 万行を超えないようにしてください。
  • アップロードできる属性の数に制限はありません。 ただし、顧客属性、プロファイル API、In-Mbox プロファイルパラメーター、プロファイルスクリプト出力を含む外部プロファイルデータの合計サイズは、64 KB を超えないようにする必要があります。
  • パラメーターと値は、大文字と小文字を区別します。

HTTP POSTリクエスト

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 セクションに表示されます。