> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kameleoon.com/llms.txt
> Use this file to discover all available pages before exploring further.

# FAQ

> セットアップ、アルゴリズム、フィード設定、制限事項など、商品レコメンデーションおよびマーチャンダイジング機能に関するよくある質問への回答をご覧ください。

<AccordionGroup>
  <Accordion title="商品レコメンデーション機能はどのように有効化し、アクセスしますか？">
    商品レコメンデーション機能はプレミアム機能です。Kameleoon アカウントで有効化するには、カスタマーサクセスマネージャーにお問い合わせください。**Settings** > **Recommendations** に移動して **Product recommendations** ワークスペースにアクセスします。
  </Accordion>

  <Accordion title="商品レコメンデーション戦略とは何ですか？">
    レコメンデーション戦略は、表示する商品をどのように選択し、フィルタリングするかを定義します。戦略を作成する際は、名前と説明を入力し、ブロックに表示する商品の最大数を定義します。戦略を保存した後、そのルール、テンプレート、デザインを設定します。
  </Accordion>

  <Accordion title="レコメンデーション戦略をウェブサイトに公開するにはどうすればよいですか？">
    **Recommendations** > **Recommendation strategy** をクリックします。次に、レコメンデーションブロックをクリックし、**Copy code** をクリックしてブロックのスニペットを生成します。ブロックを表示したい場所のページのソースコードに貼り付けます。

    また、Kameleoon の [Activation API](../../developer-docs/apis/activation-api-js/api-reference/api-reference#obtainrecommendedproducts) を使用して商品レコメンデーションを配信することもできます。API は最新の保存済みテンプレートバージョンを使用し、推奨商品とテンプレートの HTML を含む JSON オブジェクトを返します。API レスポンスには CSS が含まれていないため、出力にスタイリングを手動で適用する必要があります。

    ブロックのコードを実装する際は、`data-recommender-code` パラメータ（商品レコメンデーションブロック ID）を含めます。**Similar** や **They also buy this** などのアルゴリズムを使用するブロックでは、`data-recommender-item` パラメータを含めて現在の商品の ID を指定します。
  </Accordion>

  <Accordion title="推奨される商品数が、私の総商品在庫よりもはるかに少ないのはなぜですか？">
    総在庫と **Popular** または **Trending** アルゴリズム（**Widgetable** 商品とラベル付けされたもの）でレコメンデーション可能な商品数の間に大きな差異が見られる場合、これらのアルゴリズムには厳格なデータ品質要件があります。

    商品が widgetable となりレコメンデーションの対象となるには、次の 4 つの重要なフィールドをすべて正しく設定し、インポートする必要があります。

    * Price
    * Name
    * URL
    * Picture（画像 URL は有効で取得可能である必要があります）

    これらの必須属性のいずれかが欠落していたり正しくなかったりすると（例：壊れた画像 URL）、Kameleoon は商品をフィルタリングして除外し、レコメンデーションアルゴリズムの結果に表示されません。

    **画像が欠落している場合のトラブルシューティング方法**

    商品が widgetable でない一般的な理由は、カタログ同期プロセス中に Kameleoon が画像をダウンロードできなかったことです。

    **画像をダウンロードできない主な理由**

    商品に有効な画像 URL があるにもかかわらず画像が欠落している場合、ショップのサーバー設定が原因である可能性があります。

    * **サーバーの過負荷:** ショップのストレージまたはサーバーが Kameleoon のシステムからの大量のリクエストを処理できません。システムは **50 個の同時** スレッドを使用して画像をダウンロードするため、しばしばタイムアウトエラーが発生します。
    * **セキュリティブロック:** ファイアウォールや anti-DDoS 保護が、ユーザーエージェントや IP アドレスに基づいてリクエストをブロックする可能性があります。
      * **ユーザーエージェント:** Kameleoon は `Kameleoon Fetcher 2.0` というユーザーエージェントを使用して画像をダウンロードします。ダウンロードが失敗する場合、サーバー設定でこのユーザーエージェントを許可してください。
      * **IP アドレス:** すべての Kameleoon クラスター IP をホワイトリストに登録し、中断のないアクセスを保証してください。[IP のリストはこちら](./recommendations/import-your-product-catalog-feed#syncing-your-product-feed-using-an-xml-file)で確認できます。

    **問題のある商品を見つける方法**

    必要なデータフィールドが欠けている商品を特定するには、**Products Database** にアクセスします。

    1. **Settings** > **Recommendations** > **Products** > **Data feed** をクリックします。
    2. **Widgetable** ドロップダウンから **False** を選択します。
    3. 任意の商品をクリックしてその属性を表示します。Kameleoon は、商品の属性リストで問題（例：価格の欠落や画像取得の失敗）をハイライト表示します。

    **アルゴリズム期間に関するリマインダー**

    結果のトラブルシューティングを行う際は、**Trending** アルゴリズムが選択した期間内の販売注文のみに基づいてレコメンデーションを計算することに注意してください。アルゴリズムは、この期間より古い販売を除外します。
  </Accordion>

  <Accordion title="商品データフィードはどのくらいの頻度で更新されますか？">
    **Store settings** で商品データフィードの更新頻度と特定のタイミングをカスタマイズできます。
  </Accordion>

  <Accordion title="メールキャンペーンで商品レコメンデーションを使用できますか？">
    いいえ。現在、商品レコメンデーションは **web** および **app** チャネルのみをサポートしています。動的なレコメンデーションウィジェットをメールテンプレートに直接プッシュすることはできません。
  </Accordion>

  <Accordion title="レコメンデーション用のプレビューモードはありますか？">
    はい、**Widget Studio** を使用して、ウェブサイト上の商品レコメンデーションをプレビューおよびシミュレートできます。

    これを行うには、商品レコメンデーションブロックを含むウィジェットを作成し、[実験に追加します](./recommendations/use-a-product-recommendation-block-in-a-campaign#use-a-product-recommendation-block-in-an-experiment)。設定が完了したら、Widget Studio の[シミュレーション機能](../assets/widgets/create-a-widget-with-the-widget-studio/simulate-your-widgets)を使用してウィジェットを可視化します。シミュレーションを行うことで、起動前にデザインとアルゴリズムが返す商品の両方を確認できます。
  </Accordion>

  <Accordion title="推奨商品を並べ替えることはできますか？">
    はい。アルゴリズムが返す商品にソート基準を適用できます。例えば、表示される結果を売上トップでソートして、高価値商品を優先することができます。
  </Accordion>

  <Accordion title="レコメンデーションルールで正規表現を使用できますか？">
    いいえ。正規表現（regex）は、現在のところレコメンデーションルール内で複雑なマッチングロジックを定義するために利用できません。
  </Accordion>

  <Accordion title="独自のレコメンデーションアルゴリズムをインポートできますか？">
    いいえ。プラットフォームは Bring Your Own Algorithm（BYOA）をサポートしていません。Kameleoon が提供する組み込みアルゴリズムのスイートを使用してください。
  </Accordion>

  <Accordion title="表示できるレコメンデーションの数に制限はありますか？">
    Kameleoon は厳格な制限を設けていませんが、多数の商品をリクエストするとアルゴリズムのパフォーマンスに影響し、応答時間が増加します。1 ブロックあたり 50 個未満の商品を表示してください。より大きな商品セットを表示するには、[Collections](./merchandising/activate-and-deploy-a-product-collection-on-your-website) を使用してください。
  </Accordion>

  <Accordion title="すべてのアルゴリズムは私のサイトのどこでも動作しますか？">
    いいえ、一部のアルゴリズムは特定の条件下でのみ動作します。例えば、**Similar** 商品アルゴリズム、**Products usually purchased with this item** アルゴリズム、**Store recommendations** アルゴリズムは商品詳細ページでのみ動作します。**Products usually viewed with this product** アルゴリズムは、カートに商品がある場合のみ動作します。
  </Accordion>

  <Accordion title="Google Merchant からインポートした商品サイズを Liquid レコメンデーションテンプレートで使用できますか？">
    はい。サイズがデータフィードにパラメータとして表示される場合、商品サイズをテンプレート内の HTML 変数として使用できます。
  </Accordion>

  <Accordion title="Store Recommendations アルゴリズムにカスタムフィールド名（`shop_recommend` など）を使用できますか？">
    いいえ。Store Recommendations アルゴリズムは、データフィードに特に `accessories` フィールドを必要とします。手動の商品関係に対してカスタムフィールド名は認識されません。

    商品を手動でリンクするには（例：補完アイテムを表示するため）、関連商品 ID を `accessories` フィールドにマッピングします。

    アルゴリズムは、`accessories` タグを介してリンクされた商品のみを表示します。標準フィルタをレコメンデーションブロックに適用することで、これらの結果をさらに制限できます（例：手動リストから在庫切れアイテムを除外する）。
  </Accordion>

  <Accordion title="'Currently on wishlist' レコメンデーションアルゴリズム用のデータはどのように提供しますか？">
    **Currently on wishlist** アルゴリズムを使用するには、ユーザーがウィッシュリストにアイテムを追加した時点を明示的にトラッキングします。レコメンデーションエンジンは、特定の API シグナルなしではこれらのインタラクションを自動的に検出しません。

    [Activation API の `trackAddToWishList()` メソッド](../../developer-docs/apis/activation-api-js/api-reference/api-reference#trackaddtowishlist)を実装します。このメソッドは、Kameleoon に必要なイベントデータを送信し、ウィッシュリストアルゴリズムにデータを供給します。
  </Accordion>

  <Accordion title="Google Merchant Center と Kameleoon XML からそれぞれインポートできる属性はどれですか？">
    サポートされる属性はフィード形式によって異なります。ラベルと在庫データに関する以下の制限事項に注意してください。

    **カスタムラベル（`custom_label_0` - `custom_label_4`）**

    * **サポートされません**。
    * レコメンデーションモジュールは、Google Merchant Center フィードから `custom_label` 属性をインポートしません。これらのフィールドはフィルタリングや表示には使用できません。

    **在庫数量（`stockquantity`）**

    * **Google Merchant フィード:** **サポートされません**。Google 商品データ仕様には数値の在庫数（「availability」ステータスのみ）が含まれません。したがって、Google CSV/XML 経由で正確な在庫数をインポートすることはできません。
    * **Kameleoon XML:** **サポートされます**。正確な在庫数を使用するには、ネイティブの Kameleoon XML 形式を使用し、`stockquantity` フィールドにデータを入力します。
    * **在庫データの表示と使用:** Kameleoon XML 経由で在庫データをインポートすると、値は **Data feed** 概要に表示されます。`stockquantity` 属性を使用してフィルタを作成できます（例：`stockquantity > 5`）。
  </Accordion>

  <Accordion title="カタログ用に XML インポートと API インポートのどちらを選ぶべきですか？">
    カタログサイズと技術インフラに基づいて決定してください。カタログに 50,000 以下の商品が含まれていて、ウェブサイトのデータレイヤーがない場合は、**XML インポート** メソッドを使用してください。逆に、カタログが 50,000 を超える場合は、[**Product Recommendation API** を使用してください](../../developer-docs/apis/product-recommendation-api-rest/tutorials/import-a-product-catalog-into-kameleoon-using-the-product-recommendation-api)。
  </Accordion>
</AccordionGroup>