Delivery API を使用した Recommendations の取得

Adobe TargetとAdobe Targetの Recommendations API を使用して Web ページにHTMLを配信できますが、アプリ、画面、コンソール、E メール、キオスク、その他のディスプレイデバイスなど、応答を非応答ベースのエクスペリエンスで使用することもできます。 つまり、Target ライブラリと JavaScript を使用できない場合でも、TargetDelivery API を使用すれば、幅広い Target 機能にアクセスして、パーソナライズされたエクスペリエンスを提供できます。

メモ

実際のレコメンデーション(推奨商品や品目)を含むコンテンツをリクエストする場合は、Target Delivery API を使用します。

レコメンデーションを取得するには、ユーザー ID(最近表示された項目などのプロファイル固有のレコメンデーションで使用)、関連する mbox 名、mbox パラメーター、プロファイルパラメーター、その他の属性を含む適切なコンテキスト情報を使用して、Adobe Target Delivery APIPOST呼び出しを送信します。 応答には、推奨される entity.id が含まれ(他のエンティティデータも含まれる)、JSON 形式またはHTML形式で、デバイスに表示できます。

Adobe Targetの Delivery API は、標準の Target リクエストで提供される既存の機能をすべて公開します。

メモ

Delivery API は次のとおりです。

  • 場所とオーディエンスのエクスペリエンスまたはオファーを RESTful な方法で取得できます。
  • 認証は不要です。
  • POST のみ。
  • Cookie またはリダイレクト呼び出しを処理しません。
  • 「ユーザーの役割」を必要とせず、認識もしません。 単にコンテンツを取得したり、Target エッジサーバーにイベントを報告したりします。

Delivery API を使用して Target エクスペリエンス(レコメンデーションを含む)を配信するには、次の手順に従います。

  1. (Visual Experience Composer ではなく)フォームベースのコンポーザーを使用して、Target アクティビティ(A/B、XT、AP、または Recommendations)を作成します。
  2. Delivery API を使用して、先ほど作成した Target アクティビティによって生成されたリクエストに対する応答を取得します。

フォームベースの Experience Composer を使用したレコメンデーションの作成

Delivery API で使用できるレコメンデーションを作成するには、 フォームベースの Composer を使用します。

  1. 最初に、レコメンデーションで使用する JSON ベースのデザインを作成して保存します。 サンプル JSON、およびフォームベースのアクティビティの設定時に JSON 応答を返す方法に関する背景情報については、Recommendation Designs の作成 に関するドキュメントを参照してください。 この例では、デザインの名前は Simple JSON. です。

    server-side-create-recs-json-design.png

  2. Target で、アクティビティ / アクティビティを作成 / Recommendations に移動し、「フォーム」を選択します。

    server-side-create-recs.png

  3. プロパティを選択し、[次へ] をクリックします。

  4. レコメンデーションの応答を受け取る場所を定義します。 次の例では、api_charter という名前の場所を使用しています。 先ほど作成した JSON ベースのデザインを、Simple JSON. という名前で選択します。
    server-side-create-recs-form.png

  5. 保存してレコメンデーションをアクティブ化します。 結果が生成されます。 結果の準備が整ったら、Delivery API を使用して結果を取得できます。

Delivery API の使用

Delivery API の構文は次のとおりです。

POST https://{{CLIENT_CODE}}.tt.omtrdc.net/rest/v1/delivery

  1. クライアントコードは必須です。 クライアントコードは、Recommendations / 設定 に移動するとAdobe Targetに表示される場合があります。 Recommendation API トークン セクションの クライアントコード の値に注意してください。
    client-code.png
  2. クライアントコードを入手したら、Delivery API 呼び出しを作成します。 次の例は、Delivery API Postman コレクション で提供される Web バッチ処理された mbox Delivery API Call で始まり、関連する変更をおこないます。 次に例を示します。
    • browser および address オブジェクトは、非HTMLの使用例では必要ないので、 Body から削除されました。

    • この例で は、ロケーション名として api_charter が表示されます。

    • entity.id を指定します。これは、このレコメンデーションがコンテンツの類似性に基づいているためで、現在の項目キーを Target に渡す必要があるからです。

      server-side-delivery-API-call.png クエリパラメ
      ーターを正しく設定するようにしてください。例えば、必ず
      {{CLIENT_CODE}} 必要に応じて。
      client-code3

  3. リクエストを送信します。 これは、api_charter の場所に対して実行されます。この場所では、アクティブなレコメンデーションが実行され、JSON デザインで定義され、レコメンデーションされたエンティティのリストが出力されます。
  4. JSON デザインに基づいて応答を受信します。
    server-side-create-recs-json-response2.
    png 応答には、キー ID と、推奨エンティティのエンティティ ID が含まれます。

この方法で Delivery API を Recommendations と共に使用すると、HTML以外のデバイスで訪問者にレコメンデーションを表示する前に、追加の手順を実行できます。 例えば、Delivery API からの応答を利用して、最終結果を表示する前に、別のシステム(CMS、PIM、e コマースプラットフォームなど)からエンティティ属性の詳細(在庫、価格、評価など)をリアルタイムで追加検索できます。

このチュートリアルで概要を説明したアプローチを使用すると、Target からの応答を活用してパーソナライズされたレコメンデーションを提供する任意のアプリケーションを入手できます。

実装例

以下のリソースは、非HTML実装の様々な例です。 システムとデバイスが関係するので、すべての実装は一意であることに注意してください。

リソース 詳細
Adobe Target Everywhere - IoT でサーバー側またはを実装 Adobe Targetのサーバー側 API を利用した React アプリケーションに関する実践的な操作を提供するAdobe Summit2019 Lab。
AdobeSDK を使用しないモバイルアプリでのAdobe Target このガイドでは、AdobeSDK をインストールせずにモバイルアプリでAdobe Targetを設定する方法を説明します。 このソリューションでは、Tealium SDK の Web ビューとリモートコマンドモジュールを使用して、Adobe訪問者 API(Experience Cloud) とAdobe Target API にリクエストを送受信します。
モバイルアプリにおけるAdobe Targetの仕組み Target が Mobile SDK でどのように動作するか
API の Target extension in Experience Platform Launch and Implementing Target 設定 Experience Platform Launchで Target 拡張機能を設定し、アプリに Target 拡張機能を追加し、Target API を実装してアクティビティをリクエストし、オファーをプリフェッチし、ビジュアルプレビューモードを開始する手順。
Adobe Target Node Client オープンソースの Target Node.js SDK v1.0
サーバー側の概要 Adobe Target Server Side Delivery API、Server Side Batch Delivery API、Node.js SDK、Adobe Target Recommendations API に関する情報です。
Adobe Campaign Content Recommendations in Email Adobe CampaignのAdobe TargetとAdobe I/O Runtimeを介して E メールでコンテンツのレコメンデーションを活用する方法を説明するブログ。

API を使用した Recommendations 設定の管理

ほとんどの場合、レコメンデーションはAdobe Target UI で設定され、前述の節で説明したような理由で、 Target API を介して使用またはアクセスされます。 この UI と API の調整は一般的です。 ただし、セットアップと結果の使用の両方の API を介してすべてのアクションを実行したい場合があります。 一般的ではありませんが、ユーザーは絶対に設定、実行、および をおこなえば、レコメンデーションの結果を API を使用して完全に活用できます。

Adobe Target Recommendationsエンティティを管理し、サーバー側で配信する方法について、 前の節 で学びました。 同様に、Adobe I/Oを使用すると、Adobe Targetにログインしなくても、条件、プロモーション、コレクション、デザインテンプレートを管理できます。 すべての Recommendations API の完全なリストは、 ここ にありますが、参照用の要約を示します。

リソース 詳細
コレクション コレクションのリスト、作成、取得、編集、削除を行います。
条件 条件をリストして取得します。
デザイン デザインのリスト、作成、取得、編集、削除、検証を行います。
エンティティ エンティティを保存、削除、取得します。
プロモーション プロモーションのリスト、作成、取得、編集、削除を行います。
カテゴリ条件 カテゴリ条件のリスト、作成、取得、編集、削除を行います。
カスタム条件 カスタム条件のリスト、作成、取得、編集および削除を行います。
品目基準 項目基準のリスト、作成、取得、編集、削除を行います。
人気度の条件 人気度条件のリスト、作成、取得、編集および削除。
プロファイル属性条件 プロファイル属性条件のリスト、作成、取得、編集、削除を行います。
最近の条件 最近の条件のリスト、作成、取得、編集、削除を行います。
シーケンス条件 シーケンス条件のリスト、作成、取得、編集、削除を行います。

リファレンスドキュメント

概要とレビュー

おめでとう! このチュートリアルを終了して、次の方法を学習しました。

このページ