カスタム条件の管理

Recommendations が提供するアルゴリズムが、プロモーションしたい特定の項目を表示できない場合があります。 このような場合、カスタム条件を使用すると、特定のキー品目またはカテゴリに対してレコメンデーション品目の特定のセットを提供できます。 主要品目またはカテゴリと推奨品目の間のマッピングを定義し、そのマッピングをカスタム条件としてインポートします。 このプロセスについては、 カスタム条件のドキュメント で説明しています。 このドキュメントで述べたように、 Target ユーザーインターフェイス (UI) を使用して、カスタム条件の作成、編集、削除をおこなうことができます。 ただし、Target には、カスタム条件をより詳細に管理できるカスタム条件 API のセットも用意されています。

重要

カスタム条件については、次の使用ガイドラインに従います。

API を使用して、特定のカスタム条件に対してすべての操作(作成、編集、削除)をおこなうか、UI を使用してすべての操作(作成、編集、削除)をおこないます。 UI と API を組み合わせてカスタム条件を管理すると、情報が競合したり、予期しない結果が生じる場合があります。 例えば、UI でカスタム条件を作成し、API で編集した場合、UI では更新されませんが、API で表示されるように、バックエンドで更新されます。

カスタム条件の作成

カスタム条件を作成 API を使用してカスタム条件を作成する場合の構文は次のとおりです。

POST https://mc.adobe.io/{{TENANT_ID}}/target/recs/criteria/custom

警告

カスタム条件を作成 API を使用して作成したカスタム条件は、この演習で説明するように、UI に表示され、そこで保持されます。 UI から編集や削除を行うことはできません。 API を使用して を編集または削除できますが、どちらの方法でも、引き続き Target UI に表示されます。 UI での編集または削除のオプションを維持するには、カスタム条件の作成 API を使用するのではなく、 ドキュメント ごとに UI を使用してカスタム条件を作成します。

上記の警告を読んだ後で、このチュートリアルを続行し、UI から削除できない新しいカスタム条件を作成することに慣れてください。

  1. カスタム条件TENANT_IDAPI_KEY を確認し、前に確立した Postman 環境変数を参照します。 以下の画像を比較に使用してください。

    CustomCriteria1 の作成

  2. Body を、カスタム条件の CSV ファイルの場所を定義する raw JSON として追加します。 カスタム条件の作成 API のドキュメントに記載されている例をテンプレートとして使用し、必要に応じて environmentId とその他の値を指定します。 この例では、キーとして LAST_PURCHASED を使用します。

    CustomCriteria2 の作成

  3. リクエストを送信し、作成したカスタム条件の詳細を含む応答を観察します。

    CustomCriteria3 の作成

  4. カスタム条件が作成されたことを確認するには、Adobe Target内で Recommendations / 条件 に移動し、名前で条件を検索するか、次の手順で カスタム条件 API のリスト を使用します。

    CustomCriteria4 の作成

この場合、エラーが発生します。 カスタム条件のリスト API を使用して、カスタム条件をより詳細に調べ、エラーを調べます。

カスタム条件のリスト

すべてのカスタム条件のリストと各条件の詳細を取得するには、 カスタム条件のリスト API を使用します。 構文は次のとおりです。

GET https://mc.adobe.io/{{TENANT_ID}}/target/recs/criteria/custom

  1. TENANT_IDAPI_KEY を前と同じように確認し、要求を送信します。 応答では、カスタム条件の ID と、前述のエラーメッセージに関する詳細をメモします。
    ListCustomCriteria

この場合、サーバー情報が正しくない、つまり Target がカスタム条件の定義を含む CSV ファイルにアクセスできないことが原因で、エラーが発生します。 カスタム条件を編集して、これを修正します。

カスタム条件の編集

カスタム条件定義の詳細を変更するには、 カスタム条件を編集 API を使用します。 構文は次のとおりです。

POST https://mc.adobe.io/{{TENANT_ID}}/target/recs/criteria/custom/:criteriaId

  1. TENANT_IDAPI_KEY を前と同様に確認します。
    EditCustomCriteria1

  2. 編集する(単一の)カスタム条件の条件 ID を指定します。
    EditCustomCriteria2

  3. 本文で、更新された JSON に正しいサーバー情報を指定します。 (この手順では、アクセス可能なサーバーへの FTP アクセスを指定します)。
    EditCustomCriteria3

  4. リクエストを送信し、応答をメモします。
    EditCustomCriteria4

カスタム条件 API を使用して、更新されたカスタム条件の成功を検証します。

カスタム条件の取得

特定のカスタム条件のカスタム条件の詳細を表示するには、 カスタム条件 API の取得 を使用します。 構文は次のとおりです。

GET https://mc.adobe.io/{{TENANT_ID}}/target/recs/criteria/custom/:criteriaId

  1. 詳細を取得するカスタム条件の条件 ID を指定します。 リクエストを送信し、応答を確認します。
    GetCustomCriteria.png
  2. 成功を確認します。 (この場合は、それ以上 FTP エラーがないことを確認します)。
    GetCustomCriteria1.png
  3. (オプション)UI に更新が正しく反映されていることを確認します。
    GetCustomCriteria2.png

カスタム条件の削除

前述の条件 ID を使用して、 カスタム条件を削除 API を使用してカスタム条件を削除します。 構文は次のとおりです。

DELETE https://mc.adobe.io/{{TENANT_ID}}/target/recs/criteria/custom/:criteriaId

  1. 削除する(単一の)カスタム条件の条件 ID を指定します。 「送信」をクリックします。
    DeleteCustomCriteria1

  2. 「カスタム条件を取得」を使用して、条件が削除されたことを確認します。
    DeleteCustomCriteria2
    この場合、404 エラーが発生すると、削除された条件が見つからないことが示されます。

メモ

なお、この条件はカスタム条件の作成 API を使用して作成されたので、削除された場合でも、Target UI から削除されません。

おめでとう! Recommendations API を使用して、カスタム条件の作成、リスト、編集、削除、詳細の取得をおこなうことができるようになりました。 次の節では、Target Delivery API を使用してレコメンデーションを取得します。

次:「サーバー側配信 API を使用したRecommendationsの取得」>

このページ