Recommendations とメールの統合

Adobe Target は、メールでのレコメンデーションの送信時パーソナライゼーションをサポートします。

Target Recommendations をメールサービスプロバイダー（ESP）統合するには、3 つの方法があります。ESP の機能によって、どの方法を使用するかが決まります。アカウントマネージャーまたはコンサルタントが、お客様が最適なオプションを選択できるよう支援します。

メソッド 1 またはメソッド 2 を使用する場合は、ESP が顧客ごと／メールごとに外部 API を呼び出し、コンテンツが返されるのを待つ必要があります。これらのメソッドは、すべての ESP でサポートされているわけではありません。ESP に問い合わせて、この統合パターンと互換性があるかどうかを確認してください。

メソッド 3 を使用する場合は、ESP が製品 ID またはカテゴリ ID ごとのレコメンデーションのリストをメールのリストに結合する必要があります。このメソッドは、顧客が最後に閲覧した製品、最後に購入した製品、最も多く閲覧したカテゴリなどの属性に基づくことができます。 ただし、結合を行うためには、ESP が顧客プロファイルのこのデータにアクセスできる必要があります。ESP に問い合わせて、このデータへのアクセス権があり、この統合パターンと互換性があるかどうかを確認します。

オープンタイムでのレコメンデーションのパーソナライゼーションは、Adobe Target ではサポートされていません。

メソッド 1：配信 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

詳しくは 、配信 API ドキュメント を参照してください。

オプション 2：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

必須パラメーター：

オプションのパラメーター：

考えられるTarget サーバーの応答

メソッド 3：Recommendations Download API の使用

通常どおりにレコメンデーションを設定しますが、テンプレートと mbox の組み合わせの代わりに「ダウンロードのみ」を「プレゼンテーション」セクションで選択します。次に、作成したレコメンデーション ID を ESP に伝えます。ESP が、API を介してレコメンデーションデータにアクセスします。このデータには、特定のカテゴリまたはキー品目としてレコメンデーションすべき品目（放棄された買い物かごに含まれる品目など）が示されます。ESP はこのデータを保存して、独自の外観と操作性に結び付け、品目ごとの情報を表示してから電子メールで配信します。

このオプションを使用する場合、recommendations サーバーでレコメンデーションのパフォーマンスを直接追跡したり、複数のアルゴリズム／テンプレートの組み合わせ全体でトラフィックを分割したりできません。また、レコメンデーションは、訪問者プロファイルとは結び付けられません。

ダウンロード API について詳しくは、従来の API／ダウンロードを参照してください。