[Premium]{class="badge positive" title="Target Premium に含まれる機能を確認してください。"}
Recommendations とメールの統合
Adobe Target は、メールでのレコメンデーションの送信時パーソナライゼーションをサポートします。
Target Recommendations をメールサービスプロバイダー（ESP）統合するには、3 つの方法があります。ESP の機能によって、どの方法を使用するかが決まります。アカウントマネージャーまたはコンサルタントが、お客様が最適なオプションを選択できるよう支援します。
メソッド 1 またはメソッド 2 を使用する場合は、ESP が顧客ごと／メールごとに外部 API を呼び出し、コンテンツが返されるのを待つ必要があります。これらのメソッドは、すべての ESP でサポートされているわけではありません。ESP に問い合わせて、この統合パターンと互換性があるかどうかを確認してください。
メソッド 3 を使用する場合は、ESP が製品 ID またはカテゴリ ID ごとのレコメンデーションのリストをメールのリストに結合する必要があります。このメソッドは、顧客が最後に閲覧した製品、最後に購入した製品、最も多く閲覧したカテゴリなどの属性に基づくことができます。 ただし、結合を行うためには、ESP が顧客プロファイルのこのデータにアクセスできる必要があります。ESP に問い合わせて、このデータへのアクセス権があり、この統合パターンと互換性があるかどうかを確認します。
オープンタイムでのレコメンデーションのパーソナライゼーションは、Adobe Target ではサポートされていません。
- リクエストのレートは、1 秒あたり 1,000 リクエスト、または 1 日のピークトラフィックの 25 倍のいずれか低い方に制限する必要があります。
- 毎分 200 リクエスト/秒のステップでトラフィックを傾斜させます。
メソッド 1：配信 API の使用（推奨） delivery-api
Delivery API は、ビルド時の電子メールを操作する POST リクエストです。このオプションは、ビルド時の電子メール用に推奨される方法です。
ほとんどの電子メールクライアントでは POST リクエストが許可されません。したがって、この API は、オープンタイムの使用例には推奨されません。 Gmail や Outlook などの一部の電子メールクライアントは、コンテンツをキャッシュしたり、画像をブロックしたりして、受信者に画像のレンダリングを事前に許可するように要求することができます。
Delivery API を使用してデフォルトのコンテンツを返すことはできません。
サンプル API 配信リクエストのコードを次に示します。
curl -X POST \
'https://clientcode.tt.omtrdc.net/rest/v1/mbox/?client=clientcode' \
-H 'authorization: Bearer 3423614b-4843-4664-83c4-c6c3f6c8869b' \
-H 'cache-control: no-cache' \
-H 'content-type: application/json' \
-d '{
"mbox" : "email-mbox",
"tntId" : "111499796294071-449025.28_44",
"requestLocation" : {
"host" : "prod"
},
"profileParameters" : {
},
"mboxParameters" : {
"at_property": "b468a242-64a4-32a0-ca0c-890bddd78789",
"entity.id": "article-123",
"entity.event.detailsOnly" : "true"
}
"contentAsJson": true
}'
ここで、clientcode は クライアントコードです。Target
sessionId と tntId（または thirdPartyId）の両方で一意の値を必ず指定してください。これらのフィールドに一意の値を指定しないと、単一のプロファイル内で多くのイベントが生成されるので、API 応答が遅くなったり失敗したりする可能性があります。詳しくは、 配信 API ドキュメントを参照してください。
オプション 2：rawbox メールテンプレートの使用 rawbox
rawbox は、mbox リクエストに似ていますが、メールサービスプロバイダー（ESP）などの非 web 環境用です。rawbox リクエストで使用する Adobe Experience Platform Web SDK または at.js がないため、リクエストを手動で作成する必要があります。以下の例では、メールで rawbox リクエストを処理する方法を説明しています。
この方法を使用すれば、電子メールでのレコメンデーションのパフォーマンスを追跡し、それをレコメンデーションを使用した通常の方法でテストして、さらにサイトでの追跡を継続することが可能になります。
フォームベースの Experience Composer オプションを使用して、Recommendations アクティビティを Target で設定します。場所には、ESP から来る rawbox リクエストで使用することにした mbox の名前を選択します。電子メールに使用したいルックアンドフィールを持つデザインを選択します。電子メールの構築時に、ESP は、生成中の各電子メールの各 rawbox に対して、Target サーバーを呼び出します。ESP には、メールを送信する際に、返された HTML を電子メールに含める手段が必要です。
使用するメールシステムは、次のシナリオに対応できる必要があります。
有効な応答を受信したが、レコメンデーションが存在しない
- この場合、応答は
mboxDefaultパラメーター値として設定されたものになります。 このパラメーターに関する後述の説明を参照してください。 - この場合、電子メールプロバイダーは、レコメンデーションのデフォルト HTML ブロックを使用する必要があります。
Target サーバーがタイムアウトし、返されるデータがない
-
この場合、Target サーバーは次のコンテンツを返します。
//ERROR: application server timeout -
メールアプリケーションは、そのテキストを検索し、エラーを処理できる必要があります。電子メールプロバイダーには、この事例に対処する複数のオプションがあります。
- 即座に別のサーバー呼び出しを試す（推奨、試行をカウントする必要がある可能性があります）。
- 該当する電子メールを捨てて、次の電子メールに移る。
- 該当する電子メールをキューに入れて、最初の実行の最後に、失敗した電子メールをバッチとして再実行します。
リクエスト URL の例
https://client_code.tt.omtrdc.net/m2/client_code/ubox/raw?mbox=mbox_name&mboxSession=1396032094853-955654&mboxPC=1396032094853-955654&mboxXDomain=disabled&entity.event.detailsOnly=true&mboxDefault=nocontent&mboxNoRedirect=1&entity.id=2A229&entity.categoryId=5674
必須パラメーター： reqparams
entity.id または entity.categoryId、あるいはその両方を含める必要があります。 前述の呼び出しの例では、両方が含まれています。client_codembox上限 250 文字.
次の文字を含めることはできません：
', ", %22, %27, <, >, %3C, %3EmboxXDomainentity.id（特定のタイプの条件が必要：view/view、view/bought、bought/bought）
条件で必須の場合、rawbox 呼び出しには
entity.id を含める必要があります。entity.event.detailsOnlyentity.id を渡す場合、リクエストがその商品に関して集計されたページビュー数を増加させることを防ぎ、製品表示ベースのアルゴリズムを歪曲しないように、このパラメーターも渡すことを強くお勧めします。entity.categoryId（特定のタイプの条件が必要：カテゴリ別で最も多く閲覧されたものおよびカテゴリ別のトップセラー）
条件で必須の場合、rawbox 呼び出しには
entity.categoryId を含める必要があります。mboxDefaulthttps://www.default.commboxNoRedirect パラメーターがない場合、mboxDefault は、レコメンデーションが使用できない場合にデフォルトコンテンツを返す絶対 URL である必要があります。 この URL は、画像またはその他の静的コンテンツにすることができます。mboxNoRedirect パラメーターがある場合、mboxDefault には、no_content など、レコメンデーションがないことを示す任意のテキストを指定できます。メールプロバイダーは、この値が返された場合に対処し、メールにデフォルトの HTML を挿入する必要があります。
セキュリティのベストプラクティス：
mboxDefault URL で使用されるドメインが許可リストに含まれていない場合は、オープンリダイレクトの脆弱性のリスクにさらされる可能性があります。 サードパーティによるリダイレクターリンクまたは mboxDefault の不正使用を回避するために、アドビは「承認済みホスト」を使用してデフォルトのリダイレクト URL ドメインを許可リストに加えるすることをお勧めします。 Target は、ホストを使用して、リダイレクトを許可するドメインを許可リストに登録します。詳しくは、ホスト Targetの に mbox 呼び出しを送信する権限のあるホストを指定する許可リストの作成 を参照してください。mboxHostmboxPC「thirdPartyId」が指定されていない場合、新しい tntId が生成され、応答の一部として返されます。 それ以外の場合は、空です。
注意：電子メール受信者（API 呼び出し）ごとに、
mboxSession および mboxPC の一意の値を必ず指定してください。これらのフィールドに一意の値を指定しないと、単一のプロファイル内で多くのイベントが生成されるため、API の応答が遅くなったり失敗したりする可能性があります。「.」（ドット）を複数含めることはできません。
プロファイルのロケーションサフィックスにのみ、ドットを使用できます。
オプションのパラメーター：
mboxPC（オプション）
この値は、ユーザーの実際の Adobe Target PCID である必要があります。この値は、Web サイトから CRM に書き出されます。 メールプロバイダーは、この ID を CRM または Data Warehouse から取得し、このパラメーターの値に使用します。
mboxPC 値も、レコメンデーションが A/B アクティビティの一部である場合の指標追跡で、複数の訪問での訪問者のサイトでの行動を追跡するのに便利です。注意：電子メール受信者（API 呼び出し）ごとに、
mboxSession および mboxPC の一意の値を必ず指定してください。これらのフィールドに一意の値を指定しないと、単一のプロファイル内で多くのイベントが生成されるため、API の応答が遅くなったり失敗したりする可能性があります。「.」（ドット）を複数含めることはできません。
プロファイルのロケーションサフィックスにのみ、ドットを使用できます。
mboxNoRedirect（オプション）
mbox3rdPartyId考えられるTarget サーバーの応答
mboxNoRedirect パラメーターが「true」に設定され、サーバーはレコメンデーションを返しません（つまり、mbox に合致しないか、サーバーキャッシュが初期化されません）。mbox パラメーターがありません。
mboxDefaultまたはmboxNoRedirectパラメーターが指定されていません。mboxTraceリクエストパラメーターは指定されていますが、mboxNoRedirectは指定されていません。mboxTargetmbox 名が-clickedサフィックスで終わる場合、パラメーターは指定されません。
Cannot redirect to default content, please specify mboxDefault parametermboxDefault が指定されておらず、mboxNoRedirect パラメーターが指定されていません。Invalid mbox name:= MBOX_NAMEmbox パラメーターに無効な文字が含まれていることを示します。Mbox name [MBOX_NAME] is too longmbox パラメーターが 250 文字より長いことを示します。メソッド 3：Recommendations Download API の使用 download-api
通常どおりにレコメンデーションを設定しますが、テンプレートと mbox の組み合わせの代わりに「ダウンロードのみ」を「プレゼンテーション」セクションで選択します。次に、作成したレコメンデーション ID を ESP に伝えます。ESP が、API を介してレコメンデーションデータにアクセスします。このデータには、特定のカテゴリまたはキー品目としてレコメンデーションすべき品目（放棄された買い物かごに含まれる品目など）が示されます。ESP はこのデータを保存して、独自の外観と操作性に結び付け、品目ごとの情報を表示してから電子メールで配信します。
このオプションを使用する場合、recommendations サーバーでレコメンデーションのパフォーマンスを直接追跡したり、複数のアルゴリズム／テンプレートの組み合わせ全体でトラフィックを分割したりできません。また、レコメンデーションは、訪問者プロファイルとは結び付けられません。
ダウンロード API について詳しくは、従来の API／ダウンロードを参照してください。