次の方法で共有

Intelligent Recommendations アカウントの FAQ

  • [アーティクル]

この記事では、Intelligent Recommendations の使用中に発生する可能性のある一般的な質問、または問題に対する回答を提供します。

コンテンツ

アカウントのメンテナンス

このセクションは、Intelligent Recommendations アカウントの構成、または保守に関連する質問を対象としています。

トップに戻る

Intelligent Recommendations アカウント の新規作成方法を教えてください

アカウントを構成する手順については、構成の概要にアクセスしてください。

トップに戻る

モデリングやサービングのリソースを作成するにはどうすればよいですか？

モデリングと提供リソースを作成する方法の手順については、アカウント作成クイック スタート ガイドの手順 5 を参照してください。

トップに戻る

Intelligent Recommendations サポートチームに連絡するにはどうすればよいですか？

上記で回答が得られなかった質問や問題については、Microsoft Azure ポータルでサポート チケットを開くことで、Intelligent Recommendations サポート チームに問い合わせることができます。

  1. 左側のメニューで ヘルプ + サポート を選択します。
  2. Support request の作成を選択します。
  3. フォームに入力します。 サポート チケットを作成します。

トップに戻る

サービング エンドポイントの URL はどこにありますか？

サービング エンド ポイントの URL を見つける方法については、Azure portal の Intelligent Recommendations アカウントにアクセスし、使用するエンドポイントリソースを検索してください。 そこから、配信 URL のエンドポイントをコピーできます。 詳細については、推奨結果を表示するためのクイックスタート ガイド にアクセスしてください。

トップに戻る

データ契約のエラーを解決するにはどうすればよいですか?

データ契約で返されるエラーログを理解するには、エラーの種類 を参照してください。

トップに戻る

モデリング インスタンスのエラー ログを表示するにはどうすればよいですか?

モデリング インスタンスのエラー ログを表示するには、エラー モデリングを有効化するようにアカウントを設定します。 詳細については、エラー ログの設定 を参照してください。 返される可能性のあるエラーの種類の詳細については、エラーの種類 を参照してください。

トップに戻る

ログ フォルダーに書き込まれたログが表示されないのはなぜですか?

専用ログ フォルダーに書き込まれたログが表示されない場合は、IR アカウントに関連するコンテナーに書き込むためのアクセス権があるかどうかを確認することができます:

  1. Intelligent Recommendations アカウントに移動します。
  2. 報告タブを選択します。
  3. [アクセスを確認する] ボタンをクリックします
  4. 返されたメッセージに「ストレージ アカウントにアクセスするための構成がありません」 とある場合は、関連付けられたコンテナーにアクセスするための書き込みアクセス許可を付与する 必要があります。 「要求されたストレージ アカウントが存在しないか、アクセス許可がありません」というメッセージが返された場合は、指定された URL が正しいことを確認してください。

日付のタイムスタンプの構成が正しくない場合はどうなりますか?

タイムスタンプに問題がある場合、その商品は利用可能な候補のリストから削除され、おすすめ候補から除外されます。 この問題を解決するには、ItemsAndVariants データ エンティティの入力を確認することから始め、リリース日がサポートされている日時形式 ("yyyy-MM-ddTHH: mm:ss.fffZ") であることを確認します。

トップに戻る

model.json CSV の読み取りに関する問題

Excel やその他の CSV 非対応ツールで CSV を開くと、データ エンティティの CSV 形式に必要な空白列が削除される場合があります。 メモ帳や関連アプリで CSV を開き、コンテンツを変更せずに確認することをお勧めします。

トップに戻る

入力データのモデリングと更新を同時に実行すると、場合によって混合したデータ バージョンからデータをモデリングしたり、またはレコメンデーションの結果が不適切になる可能性があります。 入力データを適切に更新する詳細な方法については、ベスト プラクティス ガイド を参照してください。

トップに戻る

API の結果とエラー ログ

このセクションは、API の結果またはエラー ログのドキュメントに関連する質問を対象としています。

トップに戻る

API リクエストを行う承認されたユーザーであるかどうかを確認するにはどうすればよいですか？

サービスを正常に呼び出せるようになる前に、エンドポイント リソースの許可されたユーザーのリストにユーザーを追加する必要があります。 許可されたユーザーのステータスを確認する方法の詳細については、 API リクエストを作成するためのクイックスタート ガイドの手順 2 にアクセスしてください。

トップに戻る

URL が適切であるにもかかわらず、要求が失敗しました。

URL が正しい場合、リクエストを行ったユーザーがこのエンドポイント リソースの認証ユーザー リストに含まれていない可能性があります。

許可されたユーザーのステータスを確認する方法の詳細については、 API リクエストを作成するためのクイックスタート ガイドの手順 2 にアクセスしてください。

トップに戻る

アカウントを作成したばかりですが、結果が表示されません。

サービスを開始したばかりの場合、結果が出るまでに時間がかかります。 作成した各モデルのモデリング状態を追跡できます。 詳細については モデリング状態レポート ガイド を参照してください。

また、ログ フォルダーを参照して、データ契約に関する問題や、変更または修正が必要であるかどうかを確認できます。

それでも結果が表示されない場合は、Intelligent Recommendations アカウントに、関連するコンテナーからデータを読み取るアクセス許可が与えられていることを確認してください:

  1. Intelligent Recommendations アカウントに移動します。
  2. [モデリング] タブを選択します。
  3. 関連するモデリング コンポーネントを選択します。
  4. [接続文字列] タブを選択します。
  5. [アクセスを確認する] ボタンをクリックします。
  6. 返されたメッセージに「ストレージ アカウントにアクセスするための構成がありません」 とある場合は、関連付けられたコンテナーにアクセスするための読み取りアクセス許可を付与する 必要があります。 「要求されたストレージ アカウントが存在しないか、アクセス許可がありません」というメッセージが返された場合は、指定された URL が正しいことを確認してください。

また、ストレージ アカウントに配置したフォルダーとファイルが正しいことを検証してください。 詳細については、model.json ファイルをダウンロードし、ルート フォルダーを構成する を参照してください。

トップに戻る

モデルのモデリング ステータスを追跡するにはどうすればよいですか?

Intelligent Recommendations のお客様は、アカウントに作成した各モデルのモデリング状態を追跡できます。 モデルを構成した後、サービスは定期的にステータス ログ ファイルを作成し、(モデリング層の) すべてのアルゴリズムの現在の状態を報告します。 これらのログにアクセスする方法の詳細については、モデリング ステータス レポート ガイドを参照してください。

トップに戻る

ログ ファイルはどこにありますか、またはなぜそれらは空ですか?

正しいストレージ BLOB データ共同作成者アクセス許可を付与しなかった場合、または誤った接続文字列を指定した場合、ログ ファイルが空になる可能性があります。 確認する際は、クイック スタート ガイドに従います。

さらに、エラー ログ ファイルが正しく構成されていること と、モデリング インスタンスの接続文字列がログ ファイルを含むフォルダーを指していることを確認してください。

トップに戻る

特定の製品または特定のリストのみが結果を返さないのはなぜですか?

一般に、特定の項目またはユーザーに対する対話が不十分である場合、結果の品質に影響を与えたり、または結果を返さなくなる可能性があります。 新しい製品が特定のレコメンデーション リストに表示される前は、シグナルの取得に時間がかかる場合もあります。 ダッシュボードを使用すると、いつでも製品のパフォーマンスを詳しく確認できます。

トップに戻る

トレンド リスト API は、リスト内の各アイテムをスコアリング (ランク付け) するときに、製品の経過時間とそのインタラクション カウントの両方を考慮に入れます。

まず最初に、設定した時間枠内の対話件数をカウントしてから、次にモデルが製品の使用年数 (カタログに記載されているリリース日からの日数) を考慮します。 アイテムが新しいほどスコアは高くなり、製品が「古くなる」につれて、そのスコアは指数関数的に減衰します。

トレンドの結果を制御するには、Reco 構成データ エンティティ フォルダー の 2 つの構成可能なフィールドを調整する必要があります。

  • TrendingListMaxAgeDays は、製品の最大経過日数を日数で設定します。 TrendingListMaxAgeDays の日数より前にリリースされた製品は、トレンド リストに表示されません。
  • TrendingListTransactionsIntervalDays は、インタラクションが集計される時間枠を設定します。 アイテムはこの値よりも古い可能性がありますが、TrendingListTransactionsIntervalDays の日数未満のインタラクションのみがカウントされます。

Reco 構成データ エンティティでこれらの設定を調整し、モデルを再公開します。 次に、レコメンデーション結果の表示を開始する必要があります。

トップに戻る

「おすすめ」の結果が空の場合はどうすればよいですか?

「おすすめ」機能は、Standard または Premiumとしてマークされた機能セットを持つインスタンスのモデリングでのみ使用できます。 機能セットが正しく構成されていることを確認した場合は、レコメンデーションを取得しようとしているユーザーを詳しく調べてください。 インタラクション データ (以前の購入など) の履歴のないユーザー ID は、「おすすめ」を呼び出したときに結果を返しません。 また、ユーザーが最近、パーソナライズされたレコメンデーションの受信をオプトアウトしたかどうかを確認します。 パーソナライズをオプトアウトしたユーザーは、パーソナライズされたレコメンデーションを受け取りません。

トップに戻る

同じような商品のレコメンデーションが表示されないのはなぜですか?

同じような商品のレコメンデーションは類似の画像に基づいており、これらのレコメンデーションは、Premium 機能セットを選択し、データ契約でアイテムの写真を共有している顧客にのみ表示されます。 モデルに Premium 機能セットを選択し、画像からアイテムへのマッピング データ エンティティ で概説されているように画像が正しく構成されていることを確認してください。

トップに戻る

API ステータス コードの完全なリストはどこにありますか?

API ステータス コードの詳しいリストは、こちらのサンプル API リクエスト ページで入手できます。

API 要求を追跡するために、Intelligent Recommendation は、どのパラメーターに対応していますか?

次に示す 1 つ以上の追跡 ID をヘッダー パラメーターとして API 要求に追加します (オプション)。 API 要求で問題が発生した場合は、これらのパラメーターを 1 つ以上追加すると、提供した関連 ID に基づいて要求の追跡と調査を効果化できます。

ヘッダー キー パラメーター description
相関 ID
trace-id
parent-id 同じユーザーや地域など、必要に応じて要求のグループ化に使用できます。

これらのヘッダー パラメーターは、URI、クエリ パラメーター、シナリオなどに関係なく、任意の要求タイプに追加できます。

参照

クイック スタート ガイド: サンプルデータを使った Intelligent Recommendations の設定と実行
クイック スタート ガイド: 認証された API コールの実行
API 状況コード
エラー ログ
構成の概要
データ コントラクトの概要