Adobe Target Single Profile Update API
Adobe Target Single Profile Update APIでは、1人のユーザーに対してプロファイル更新を送信できます。 Single Profile Update APIはBulk Profile Update APIとほぼ同じですが、1人の訪問者プロファイルが一度に更新され、.cvs ファイルではなくAPI呼び出しでインライン化されます。
Single Profile Update APIとは、Targetを実装していないチャネルで発生しているトランザクションに関連して更新を行う必要がある場合に一般的に使用されます。 例えば、オフラインアクションを実行する1人の訪問者のプロファイルを更新するとします。 アクションには、コールセンターへの連絡、ローンの資金調達、店舗でのロイヤルティカードの利用、キオスクへのアクセスなどが含まれます。
Single Profile Update APIの利点は次のとおりです。
- プロファイル属性の数に上限がありません。
- サイト経由で送信されたプロファイル属性は、APIやその逆の方法で更新できます。
注意事項
-
Single Profile Update APIは、任意のローリング 24時間で100万件の更新を実行することに制限されています。
-
更新は通常1時間以内に行われますが、反映されるまでに24時間かかる場合があります。
さらに更新を送信する必要がある場合、または更新を短い時間枠で処理する必要がある場合は、クライアントサイドの更新（推奨）またはAdobe Target サーバーサイド 配信APIを介してトランザクションプロファイルの更新を送信することを検討してください。
-
Single Profile Update APIはサーバー間APIであり、web ページ内で動作するように設計されていません。 Web ページ内から訪問者プロファイルを更新するには、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です。 - すべてのpcIdおよびmbox3rdPartyIdに対して、すべてのパラメーター値が存在する必要はありません。
- パラメーターと値は、大文字と小文字を区別します。
- GETとPOSTの両方がサポートされています。
- 制限の現在のサイズ制限は、GETの場合は8 KB、POSTの場合は60 KBです。
応答
上記のリクエストのサンプル応答は次のようになります。
trueRequest successfully submitted
この応答は、応答が送信され、まもなく処理されることを示します。