配信 API を使用したレコメンデーションの取得
Adobe Target API およびAdobe Target Recommendations API を使用すると、web ページに対する応答を提供できますが、アプリ、画面、コンソール、メール、キオスクおよびその他のディスプレイデバイスなど、HTML以外のエクスペリエンスでも使用できます。 つまり、Target ライブラリとJavaScriptを使用できない場合でも、Target 配信 API を使用すれば、引き続き Target の全機能にアクセスして、パーソナライズされたエクスペリエンスを提供できます。
NOTEレコメンデーションを取得するには、適切なコンテキスト情報を含んだAdobe Target Delivery API POST 呼び出しを送信します。この情報には、ユーザー ID （最近閲覧したユーザーの項目などのプロファイル固有のレコメンデーションで使用する）、関連する mbox 名、mbox パラメーター、プロファイルパラメーター、その他の属性などが含まれます。 応答には、推奨される entity.ids （および他のエンティティデータを含む場合があります）が JSON 形式またはHTML形式で含まれ、デバイスに表示できます。
Adobe Target用 配信 API は、標準の Target リクエストが提供する既存の機能をすべて公開します。
配信 API:
- を使用すると、場所およびオーディエンスのエクスペリエンスやオファーを RESTful な方法で取得できます。
- 認証は必要ありません。
- POST のみ。
- は、Cookie の処理や呼び出しのリダイレクトを行いません。
- 「ユーザーの役割」を必要としない、または認識しない。 コンテンツを取得したり、イベントを Target エッジサーバーにレポートしたりするだけです。
配信 API を使用して、レコメンデーションを含む Target エクスペリエンスを配信するには、次の手順に従います。
- Visual Experience Composer ではなくフォームベースのコンポーザーを使用して、Target アクティビティ（A/B、XT、AP、Recommendations）を作成します。
- 配信 API を使用して、作成した Target アクティビティによって生成されたリクエストに対する応答を取得します。
<!— Q：この方法にはなぜ両方のステップが必要なのでしょうか。 mbox に対してフォームベースのレコメンデーションを定義した場合、の配信 API ステップを使用して結果を取得する利点は何ですか？ フォームベースの Rec を使用して宛先デバイスに結果を配信するだけでは、なぜできないのでしょうか…?? A：以下のユースケースを参照してください。結果を表示する前にさらに作業をおこなうために、保留中の結果を「インターセプト」する場合です。 在庫レベルに対するリアルタイム比較などがあります。 —>
フォームベースの Experience Composer を使用したレコメンデーションの作成
配信 API で使用できるレコメンデーションを作成するには、 フォームベースのコンポーザーを使用します。
-
まず、レコメンデーションで使用する JSON ベースのデザインを作成して保存します。 JSON のサンプルと、フォームベースのアクティビティを設定する際に JSON 応答を返す方法に関する背景情報については、 レコメンデーションデザインの作成に関するドキュメントを参照してください。 この例では、デザイン名は Simple JSON. です
-
Target で、Activities/Create Activity/Recommendations に移動し、「Form」を選択します。
-
プロパティを選択し、[Next] をクリックします。
-
レコメンデーションの応答をユーザーに受信させる場所を定義します。 次の例では、api_charter という名前の場所を使用しています。 以前に作成した「Simple JSON.」という名前の JSON ベースのデザインを選択します。
-
レコメンデーションを保存して有効化します。 結果が生成されます。 結果の準備が整ったら、配信 API を使用して結果を取得できます。
-
クライアントコードは必須であることに注意してください。 お使いのクライアントコードは、Recommendations/Settings に移動してAdobe Targetにある場合があります。 Recommendation API トークン セクションの クライアントコード 値に注意してください。
-
クライアントコードを取得したら、配信 API 呼び出しを作成します。 次の例は、Delivery API Postman コレクションで提供された Web Batched Mboxes Delivery API Call から始まり、適切な変更を行います。 次に例を示します。
-
browser および address オブジェクトは、HTML以外のユースケースでは必要ないので、Body から削除されました
-
この例では、api_charter を場所名としてリストしています
-
このレコメンデーションは、現在のアイテムキーを Target に渡す必要があるコンテンツの類似性に基づいているので、entity.id が指定されています。
クエリパラメーターを正しく設定することを忘れないでください。 例えば、必要に応じて{{CLIENT_CODE}}を指定します。 <!— Q：更新された呼び出し構文では、以前のバージョンのように、entity.id が mboxParameter ではなく profileParameter としてリストされています。 —> <!— Q：古い画像
-
-
リクエストを送信します。 これは、アクティブなレコメンデーションが実行されている api_charter の場所に対して実行されます。この場所は、推奨されるエンティティのリストを出力する JSON デザインで定義されています。
-
JSON デザインに基づいて応答を受け取ります。
この応答には、キー ID と推奨エンティティのエンティティ ID が含まれます。
この方法で配信 API と Recommendations を使用すると、HTML以外のデバイスで訪問者にレコメンデーションを表示する前に、追加の手順を実行できます。 例えば、配信 API からの応答を受けて、最終結果を表示する前に別のシステム（CMS、PIM、e コマースプラットフォームなど）のエンティティ属性の詳細（在庫、価格、評価など）をリアルタイムで参照できます。
このガイドで概要を説明しているアプローチを使用すると、任意のアプリケーションを取得して、Target からの応答を活用し、パーソナライズされたレコメンデーションを提供できます。