> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/ja/what-would-you-like-to-learn-about/platform-features/product-catalogs/troubleshoot-product-catalog-errors-and-warnings.md). # 商品カタログのエラーと警告をトラブルシュート 各商品カタログにはヘルススコアがあり、カタログ内にどの問題が存在するか（存在する場合）を示します。問題は、ファイルのアップロードまたは接続時、処理後、あるいはパートナーが商品を表示・プロモーションしようとしたときなど、どの段階でも発生し得ます。このガイドを使って各段階の問題を解消し、カタログを *優良な* 範囲に。 {% hint style="info" %} **ヒント：** 健全なカタログは、エラーを解消するだけではありません。 [商品カタログのベストプラクティス](/brand/ja/what-would-you-like-to-learn-about/platform-features/product-catalogs/product-catalog-best-practices.md) に従って、データを完全で、構造化され、可視性とパフォーマンスを高めるように設定してください。 {% endhint %} {% embed url="" %} ## カタログのヘルススコア 1. 左側のナビゲーションメニューで、 ![](/files/7ddd72d8e69e7055d9408cf4847c5c54abf9f71d) **\[Engage]** **→** **コンテンツ** **→** **商品** **→** [**商品カタログ**](https://app.impact.com/secure/advertiser/engage/ads/productcatalogs/manage-ads-product-catalog-flow.ihtml). 2. カタログにエラー、警告、または重複行がある場合、 *ヘルス* 列に各数が表示されます。 * アップロード方法によっては、次回フェッチイベントが発生したときにカタログの更新が自動的に取得されます。
ヘルスの説明 | ヘルス指標 | 説明 | | ------- | ------------------------------------------------------------------------------- | | **保留中** | 商品カタログは最初のアップロードまたはデータ取得を待機しています。 | | **処理中** | 商品カタログを処理しています。 | | **優良** | 健全なカタログであることを示します。この商品データセットは完全で構造化されており、効果的に機能する可能性が最も高くなります。 | | **良好** | カテゴリや説明などの重要なデータを含む一部の推奨フィールドが不足している可能性があることを示します。これらの不足を解消すると、カタログ全体の品質が向上します。 | | **不良** | 提供されたレコードの10％超で必須情報が不足していることを示します。このカタログは修正して再アップロードする必要があります。 |
## アップロードと接続の問題をトラブルシュートする カタログを処理する前に、impact.com が確実に受信する必要があります。以下の手順は、カタログ作成時に選択したアップロード方法ごとにまとめています。どの方法が使用されているかわからない場合は、カタログを選択して、その *アップロード方法* の設定を確認してください。 ### 直接アップロード 直接アップロードの問題は、通常、形式またはファイル名の不一致、または1 GBの上限を超えたファイルが原因です。 | 問題 | 確認事項 | 修正方法 | | -------------- | -------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | | 選択した形式が違う | 選択した形式（例：TXT）が、アップロードしたファイル（例：XML）と一致していません。 | 再アップロードし、ファイルに合った形式を選択してください。XMLファイルの拡張子は `.xml` を使用し、CSVファイルは `.csv`、TAB区切りファイルは `.txt`. | | ファイル名の不一致 | アップロードしたファイル名は、 *アップロードファイル名* を含め、カタログ設定で指定した名前と完全に一致していなければなりません。 | ファイル名を変更するか、 *アップロードファイル名* アップロードファイル名を更新して、両者を完全に一致させてください。 | | 圧縮ファイルを処理できません | impact.com は gzip と標準の zip 圧縮ファイルをサポートしています。圧縮ファイルでは、圧縮を示すために2つ目の拡張子を使用できます。たとえば `catalog.xml.gz`. | 圧縮形式が gzip か zip であること、またファイルが形式と圧縮の両方に対して正しい拡張子を使用していることを確認してください。 | ### impact.com FTPサーバー FTP の問題の多くは、接続設定または認証情報に起因します。 | 問題 | 確認事項 | 修正方法 | | ------------- | --------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | | サーバーに接続できません | 接続先ホストが `products.impact.com` ポート `21`. | FTPクライアントを正しいホストとポートに更新し、再接続してください。 | | FTP認証情報がありません | 接続するには、アカウントに発行されたFTPログイン情報とパスワードが必要です。 | 次の項目を確認してください： *FTP Product Data System の認証情報* アカウントの技術設定で。見つからない、またはアクセスできない場合は、 [サポートに連絡してください](https://app.impact.com/support/portal.ihtml). | ### URLから取得 〜でサポートされるプロトコルは *URLから取得* 以下です： `http://`, `https://`, `ftp://`、および `sftp://`です。カタログが読み込まれない、更新されない、または正しく処理されない場合は、以下の表を使って問題を特定し、解決してください。 | 問題 | 確認事項 | 修正方法 | | --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | URL が直接ダウンロードリンクではありません | URLをブラウザーで開いてください。ログインページ、クラウドストレージのランディングページにリダイレクトされる、または404/403エラーが返る場合、そのURLは直接ダウンロードリンクではありません。 | ファイルを直接ダウンロードするか、ブラウザーで開いたときに生データとして表示されるURLに更新してください。 | | ファイル名の不一致 | カタログ設定の *アップロードファイル名* URL 上の実際のファイル名と、拡張子（`.csv`, `.xml`, `.txt`, `.gz`). | 次を更新してください： *アップロードファイル名* ファイル名と完全に一致するようにしてください。わずかな不一致でも *要求に対するカタログが見つかりません* というエラーが発生します。 | | 形式または区切り文字の不一致 | 選択した形式（CSV、TXT、XML、GMC）がファイルと一致していることを確認してください。区切り付きファイルを使用している場合は、区切り文字（カンマ、タブ、パイプ）が設定と一致していることを確認してください。 | カタログ設定で形式または区切り文字を修正してください。不一致が原因で *有効なレコードが見つかりません* というエラーが発生します。 | | FTP/SFTP: 無効な認証情報またはパス | URL が次の形式であることを確認してください： `sftp://{username}:{password}@{host}/{file_path}`。パスはディレクトリではなく、正確なファイルを指している必要があります。認証情報に含まれる特殊文字は URL エンコードする必要があります（たとえば、 `@` は次のようになります： `%40`). | FileZilla などのFTPクライアントで認証情報をテストしてください。修正した認証情報と完全なファイルパスでURLを更新します。 | | 取得がタイムアウトするか、接続に失敗します | サーバーのファイアウォールが impact.com のリクエストをブロックしている可能性があります。 | impact.com のIPアドレス範囲を許可リストに追加するよう、ホスティングプロバイダーまたはITチームに連絡してください。 | | URL に認証が必要です | このアップロード方法は、セッションベースまたはCookieベースの認証をサポートしていません。 | 公開アクセス可能な直接ダウンロードURL、またはURLに埋め込まれた HTTP Basic Auth（`https://user:pass@host/path`）、またはURL内に認証情報を含めた FTP/SFTP を使用してください。フィードにブラウザベースのログインが必要な場合は、カタログのアップロード方法を別の方法に切り替えてください。たとえば *直接アップロード* または *impact.com FTPサーバー*. | | URL が2,048文字を超えています | 署名付きクラウドストレージURLは2,048文字の制限を超えることがあり、切り詰められる場合があります。 | 直接ダウンロードを維持できるURL短縮サービスを使うか、より短いURLでファイルをホストしてください。 | | カタログが［処理中］または［保留中］のまま停止している | ファイルがURLで引き続きアクセス可能か、またファイルサイズが取得頻度に対して異常に大きくないか確認してください。 | ファイルが利用可能であることを確認してください。カタログが *処理中* または *保留中*, [サポートに連絡してください](https://app.impact.com/support/portal.ihtml) のままの場合は、手動での再処理を依頼してください。 | | カタログの自動更新が停止しました | 同じURLでファイルが引き続き利用可能か、またファイル名、形式、サーバーアクセス設定が変更されていないか確認してください。 | 元のURLにファイルを戻すか、新しいURLまたはファイル名に合わせてカタログ設定を更新してください。1,000,000件以上の大規模カタログでは、タイムアウトを避けるため取得頻度を下げることを検討してください。 | | アップロード後にフィールドまたはデータが欠落している | フィールド名が選択した形式の仕様と一致していることを確認してください。たとえば [Google Merchant Center のフィールド](https://support.google.com/merchants/answer/7052112) GMC形式の場合。標準仕様外のカスタムフィールドは、impact.com のカスタムフィールド枠（`Numeric1`, `Text1`など）にマッピングしてください。 | impact.com からアップロード済みカタログをダウンロードし、元のファイルと比較してどこでデータが失われているか確認してください。必要に応じてフィールド名やマッピングを更新し、再アップロードします。 | ### 統合ショッピングカートのインポート この方法は、既存のeコマースプラットフォームからカタログを取得します。接続問題の多くは、認証情報の誤りか読み取り権限の不足が原因です。以下からプラットフォームを選択してください。 {% tabs %} {% tab title="Shopify" %} 次のようなエラーが表示される場合は *Shopify への接続時に HTTP ステータスコードが失敗しました: 401* または *カタログファイルに有効なレコードが見つかりません*、原因は通常、認証情報または権限です。 * パスワードは **Admin API アクセストークン**である必要があります。これは `shpat_` （または `shap_`）で始まります。Shopify管理画面の **アプリ** **→** **API認証情報** **→** **Admin API アクセストークン**. * が表示されない場合は、 **Admin API アクセストークン**を選択して **アプリをインストール** し、Shopifyで生成してください。 * 次の `read_products` 権限（スコープ）がアプリに付与されていることを確認してください。これがないと、Shopify はその操作に merchant approval が必要であるというエラーを返します。 `read_products` スコープ * コレクションの場合は、Shopify管理画面の **商品** **→** **コレクション**でコレクションIDを確認してください。コレクションを選択すると、IDはページURLの末尾に表示されます。 完全な設定手順については、次を参照してください。 [Shopify商品カタログ連携ガイド](https://integrations.impact.com/impact-brand/docs/shopify-product-catalog). {% endtab %} {% tab title="WooCommerce" %} 次の *WooCommerce への接続に失敗しました。もう一度お試しください*が表示された場合は、認証情報とAPI設定を確認してください。 * APIユーザー名は **API Username** WooCommerce の *Consumer Key*であり、 **API Password** は *Consumer Secret*. * WooCommerce でレガシーREST APIを有効にする： **WooCommerce** **→** **設定** **→** **詳細** **→** **レガシーAPI**、次にチェックボックスを選択して有効にします。 参考として、次を参照してください。 [WooCommerce REST API ドキュメント](https://woocommerce.com/document/woocommerce-rest-api/). {% endtab %} {% tab title="BigCommerce" %} BigCommerce への接続には、2つの値と正しい読み取り専用権限が必要です。 * 次を入力してください： **ストアハッシュ** と **アクセストークン** を impact.com のUIに入力します。ストアハッシュは、ストアのAPIパスにある識別子です。 * 次の **商品** と **情報と設定** 権限を、BigCommerceでAPIアカウントを作成する際に読み取り専用に設定します。 参考として、BigCommerce のガイドを参照してください： [APIトークンの作成](https://developer.bigcommerce.com/docs/storefront-auth/tokens#create-a-token). {% endtab %} {% tab title="Shoplazza" %} Shoplazza のプライベートアプリには、次のリソースへの読み取りアクセスが必要です： `商品`, `コレクション`、および `ショップ`. 設定手順については、Shoplazza のガイドを参照してください： [プライベートアプリの作成](https://www.shoplazza.dev/reference/quick-construction-of-private-apps). {% endtab %} {% endtabs %} ## アップロード後のエラーと警告をトラブルシュートする ファイルを受信すると、impact.com は各レコードを検証します。エラーはレコードの処理を妨げ、警告は受け入れられたものの問題を引き起こす可能性のあるデータを示します。以下のセクションを使って解釈し、解決してください。 ### エラーと警告を表示 1. 〜の *ヘルス* 列で、 **エラー**, **警告**または **重複** リンクを選択してください。 * より詳細なページにリダイレクトされます。重複セットでは最初の項目のみが impact.com に表示され、最初の項目と重複する他の項目はすべて無視されます。 2. 必要に応じて、 *検索* フィールドとページ上部のフィルターを使って問題を絞り込んでください。 3. 問題を確認し、必要に応じて修正してから、商品カタログを再アップロードしてください。
フィルターの説明 | フィルター | 説明 | | ------ | ------------------------------------------------------- | | エラータイプ | 特に次をフィルター： *エラー*, *警告*, *重複*または *すべて* の問題。 | | 必須 | 特定の必須商品カタログフィールドの欠落をフィルターします。 *すべて* フィールド。 | | 推奨 | 特定の推奨商品カタログフィールドの欠落をフィルターします。 *すべて* フィールド。 | | 無効 | 重複SKU、無効なGoogleカテゴリコード、その他のエラーなど、特定の検証ベースのエラーをフィルターします。 |
一般的なエラーと警告メッセージ | メッセージ | 説明 | | -------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | | *レコード 'X'：必須フィールドがありません：(フィールド名)* | 指定した行に1つ以上の必須フィールドがありません。 | | *レコード 'X'：CatalogItemId(CatalogItemId)：必須フィールドがありません：(フィールド名)* | データファイルの行に必須フィールドがありません。 | | *要求に対するカタログが見つかりません。アップロードしたファイル名が、カタログに登録されているものと同じか確認してください* | カタログ設定の *アップロードファイル名* カタログ作成時に *アップロード方法* で設定した名前が、アップロードしたファイル名と完全に一致していません。 | | *カタログファイルに属性がありません* | 商品カタログのデータファイルに処理可能なデータがありません。 | | *IDが重複するカタログ項目がカタログ内に複数あり、最初以降のものは無視されます* | 2つ以上の項目が同じIDを持っています。すべての商品には一意の値が必要で、重複項目は処理されません。 | | *レコード 'X' にエラーがあります：（行 X）引用符で囲まれたトークンと区切り文字の間に無効な文字があります* | 行に二重引用符の誤った使用があります。フィールド全体を二重引用符で囲み、それ以外の二重引用符はすべて二重の二重引用符に置き換えてください。 | | *（開始行 X）引用符で囲まれたトークンが終了する前に EOF に達しました* | EOF は「ファイルの終わり」を意味します。記載された開始行には閉じる二重引用符のない開きの二重引用符があるか、予期しない改行によってデータストリームが中断されています。 | | *（カタログタイプ）フィールドの解析エラー：値：（フィールド）* | 商品フィールドは無効で、受け入れられません。 | | *レコード（recordNumber）にエラーがあります：区切り値の数（FieldsLength）が期待値（ColumnNamesLength）と一致しません* | 特定の行で、ヘッダーのない列にデータが存在しています。 | | *カタログファイルに有効なレコードが見つかりませんでした* | データファイルが空であるか、検出されたデータが無効であるか、指定したファイル名が正しくありません。 | | *ファイル内のレコードの10%以上にエラーがありました* | これが発生するとデータファイルは処理できません。次を参照してください。 *10%のエラー閾値を理解する* 以下。 | | *内部システムエラーのため、処理に失敗しました...* | 対応は不要です。最後に正常に処理されたカタログは、引き続きメディアパートナーに利用可能です。次を参照してください。 [impact.com ステータスページ](https://status.impact.com/) でサービス中断の詳細を確認してください。 | | *値（field value）を持つフィールド（field name）に有効なプロトコルがありません* | フィールド値は正しく形式化されたURLではありません。 |
### 書式と区切り文字の警告 | 問題 | 修正方法 | | ------------------------------------------- | ------------------------------------------------------------------------ | | 区切り文字の問題：誤ったカンマ、タブ、または空行によってフィールド間の境界が崩れます。 | カタログファイル内の区切り文字の使用を修正し、各フィールドが一貫して区切られるようにしてから、再アップロードしてください。 | | 説明フィールド内の改行はレコード処理を妨げます。 | 区切り付きテキスト形式（CSVとTSV）では改行はサポートされません。アップロード前に、説明などのテキストフィールドから改行を削除してください。 | ### Google Merchant Center 形式のエラー Google Merchant Center（GMC）形式を使用している場合、ほとんどの問題はその形式の `カテゴリ` セクション、定義済みフィールド値、またはXML構造に関連しています。 {% tabs %} {% tab title="Google商品カテゴリがありません" %} 次を選択すると *エラー* の *商品カタログ* 画面で、 *Google商品カテゴリがありません* 〜の *提案* 列に表示されることがあります。これは、GoogleカテゴリコードまたはGoogleカテゴリの完全な文字列がカタログに含まれていないことを意味します。 これを解決するには、 [Google Merchant Center アカウント](https://merchants.google.com/)を参照してください。Google は項目に対して自動的にカテゴリを提案します。修正したカタログをアップロードする際はこれらの提案を使用してください。
{% endtab %} {% tab title="Google商品カテゴリの不一致" %} 次を選択すると *エラー* の *商品カタログ* 画面で、 *Google商品カテゴリの不一致* 〜の *無効* 列。これは、カタログ内の項目に使用されているカテゴリが、期待される [分類コード](https://www.google.com/basepages/producttype/taxonomy-with-ids.en-US.txt) （例：7386）または Google が提供する完全なカテゴリ形式と一致していないことを意味します。たとえば： `動物・ペット用品 > ペット用品 > 鳥用品 > 鳥かごアクセサリー > 鳥かごのエサ・水入れ` これを解決するには、Google 商品カテゴリの記載形式を修正してから、カタログを再アップロードしてください。
{% endtab %} {% tab title="availability 値が受け入れられません" %} 次のようなエラー *フィールドを解析できませんでした：availability の値* は、定義済みフィールドで GMC が認識しない値が使用されていることを意味します。GMC カタログでは、カテゴリと値は正確でなければなりません。 * 次を使用してください： `availability` を availability フィールドに使用します。 * サポートされる availability 値は次のとおりです： `in_stock`, `out_of_stock`, `preorder`、および `backorder`. * 値フィールドに通貨記号など、書式に影響する特殊記号が含まれていないか確認してください。 {% endtab %} {% tab title="XML：有効なレコードが見つかりません" %} Google Merchant Center（XML形式）のカタログをアップロードして、次の表示が出た場合 *カタログファイルに有効なレコードが見つかりません。ファイルを修正して再アップロードしてください*、XML構造が正しくない可能性があります。 XMLファイルには `rss`, `RDF`または `feed` を開始要素に含める必要があります。ルート要素を修正して再アップロードしてください。 {% endtab %} {% endtabs %} {% hint style="info" %} **eBay Commerce Merchant Center形式：** ある `.csv` ファイルでは、フィールド列の値（カテゴリ）内のスペースをアンダースコアに置き換えてください。たとえば、次を使用します： `Item_Title` ではなく `Item Title`. {% endhint %} ### 10%のエラー閾値を理解する アップロードしたファイル内のレコードの10%以上にエラーがある場合、そのファイルは処理されません。これが発生した場合： * カタログには最後に正常にアップロードされたバージョンが表示され続けるため、古い *最後の正常な送信* タイムスタンプが表示されるはずです。 * カタログ設定の **商品を表示** このオプションは、そのカタログIDに対して以前にファイルが正常にアップロードされていた場合にのみ表示されます。 問題のあるレコードを修正して、エラーを含む割合が10%未満になるようにしてから、再アップロードしてください。 ## カタログをパートナーに公開する 正常なカタログでも、利用可能に設定し、パートナーへの表示要件を満たすまでパートナーには表示されません。カタログの処理は成功したものの、パートナーが表示、商品アクセス、またはトラッキングリンクで問題に遭遇している場合は、このセクションを使用してください。 ### パートナーがカタログを表示できない 次の2つの設定を確認してください： * カタログが利用可能になっていることを確認します： 1. 選択 ![](/files/7ddd72d8e69e7055d9408cf4847c5c54abf9f71d) **\[Engage]** **→** **コンテンツ** **→** **商品** **→** [**商品カタログ**](https://app.impact.com/secure/advertiser/engage/ads/productcatalogs/manage-ads-product-catalog-flow.ihtml) し、カタログを見つけます。 2. 選択 ![](/files/967afd940eacbf83a7772ab9ff5584bc129c9568) **\[その他]** その後、次を選択します **利用可能にする**. * パートナーのアクセスが制限されているか確認します： 1. 選択 ![](/files/7ddd72d8e69e7055d9408cf4847c5c54abf9f71d) **\[Engage]** **→** **コンテンツ** **→** **商品** **→** [**商品カタログ**](https://app.impact.com/secure/advertiser/engage/ads/productcatalogs/manage-ads-product-catalog-flow.ihtml) し、カタログを見つけます。 2. カタログにカーソルを合わせてから、次を選択します **編集**. 3. 〜の *パートナーアクセスを制限* セクションで、次が **特定のパートナーのみにアクセスを許可** が ![](/files/966a7b9c51811043ca7c1811ec6f6b9ef39fd26f) オンになっているか確認します。 4. オンになっている場合は、 ![](/files/ff9165c3126806be1a33d221d3816f6adc58908c) オフにして、次を選択します **保存**. ### パートナーが特定の商品を表示または検索できない 商品がパートナーUIに表示されるには、次のすべての要件を満たす必要があります： * 元の価格が2.00米ドルを超えていること。 * 商品の在庫状況が *在庫切れではないこと。* * 商品に、実際の商品詳細ページにつながる有効な商品URLがあること。 * 商品に画像URLがあること。 * 商品が、次を適用していないカタログに含まれていること [ルール](/brand/ja/what-would-you-like-to-learn-about/platform-features/product-catalogs/create-and-manage-product-catalog-rules.md) が適用されていない。 ### パートナーのトラッキングリンクで「malformed」エラーが返される パートナーが商品からのトラッキングリンクを使用したときに「The link you clicked on is malformed」と表示される場合、通常はディープリンクが有効になっていないか、商品のランディングページのドメインが許可済みドメインとして設定されていません。ディープリンクを有効にし、このエラーを解消するには、許可済みドメインを設定して、次を参照してください [ディープリンク用の許可済みドメインを設定する](/brand/ja/what-would-you-like-to-learn-about/account-administration/program-settings/tracking-settings/set-up-permitted-domains-for-deep-linking.md). --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://help.impact.com/brand/ja/what-would-you-like-to-learn-about/platform-features/product-catalogs/troubleshoot-product-catalog-errors-and-warnings.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.