> 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). # 商品カタログのエラーと警告をトラブルシュートする 各商品カタログにはヘルススコアがあり、カタログ内にどの問題が存在するか（存在する場合）を示します。カタログを *優良* の範囲にするには、存在するエラー、警告、重複をすべて調査して修正する必要があります。 {% embed url="" %} 1. 左側のナビゲーションメニューから ![](/files/7ddd72d8e69e7055d9408cf4847c5c54abf9f71d) **［Engage］** → **コンテンツ** → **商品** → [**商品カタログ**](https://app.impact.com/secure/advertiser/engage/ads/productcatalogs/manage-ads-product-catalog-flow.ihtml). 2. カタログにエラー、警告、または重複行項目がある場合は、それぞれがいくつあるかを以下で確認できます *Health* 列。
* カタログを自動取得するアップロード方法は、次回の取得イベント時に自動で更新されるはずです。
ヘルスの説明 | ヘルスインジケーター | 説明 | | ---------- | ---------------------------------------------------------------------------------- | | **保留中** | 商品カタログをアップロードしています。 | | **処理中** | 商品カタログを処理しています。 | | **非常に良好** | 正常なカタログであることを示します。この商品データセットは完全で、構造も整っているため、効果的に機能する可能性が最も高くなります。 | | **良好** | カテゴリやステータスなど、重要なデータを含む一部の推奨フィールドが欠落している可能性があることを示します。これらの不足を補うことで、カタログ全体の品質が向上します。 | | **不良** | 送信したレコードの10%を超える部分で必須情報が不足していることを示します。このカタログは修正して再アップロードする必要があります。 |
#### エラーと警告を表示 1. で *Health* 列で、 **エラー**, **警告**、または **重複** リンクを選択します。 * エラーまたは警告の詳細が記載されたページにリダイレクトされます。重複セット内では最初の項目のみが impact.com に表示され、最初の項目と重複するものはすべて無視されます。 2. 必要に応じて *検索* ページ上部のフィールドとフィルターを使って、問題を絞り込みます。
フィルターの説明 | | | | ---------- | ----------------------------------------------------------------------- | | **エラーの種類** | 特定の *エラー*, *警告*, *重複*、または *すべて* の問題をフィルタリングできます。 | | **必須** | 必須の商品カタログフィールドの欠落や、任意の特定の *すべて* フィールドの値が削除されます。 | | **推奨** | 推奨される商品カタログフィールドの欠落や、任意の特定の *すべて* フィールドの値が削除されます。 | | **無効** | 検証ベースの特定のエラーをフィルタリングできます。これは、重複SKU、無効なGoogleカテゴリーコード、またはその他のエラーのいずれかです。 |
3. 問題を確認し、必要に応じて修正を行ってください。その後、商品カタログを再アップロードします。
一般的なエラーと警告メッセージ | エラーメッセージ | 説明 | | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | *レコード 'X': 必須フィールドが不足しています: (field name)* | 指定された行に1つ以上の必須フィールドがありません。 | | *レコード 'X': CatalogItemId(CatalogItemId): 必須フィールドが不足しています: (field name)* | データファイル内の行に必須フィールドがありません。 | | *リクエストに対応するカタログが見つかりません。アップロードしたファイル名が、カタログに登録されているものと同じか確認してください* | この *アップロードファイル名* の *アップロード方法* 商品カタログを作成する際に section で設定した内容が、アップロードしたファイル名と完全に一致していません。 | | *カタログファイルに属性がありません* | 商品カタログのデータファイルに処理可能なデータがありません。 | | *ID が同じカタログ項目がカタログ内に複数回存在し、最初のもの以降は無視されます* | 2件以上の項目が同じIDを持っています。すべての商品には一意の値が必要です。重複項目は処理されません。 | | *レコード 'X' にエラーがあります: (line X) enclosed token と区切り記号の間に無効な文字があります* | データファイル内の行に、二重引用符の無効な使用があります。フィールドを二重引用符で囲み、他のすべての二重引用符を2つの二重引用符に置き換えることで、正しく処理する必要があります（例: *3" フロッピー* になります *"3"" フロッピー"*). | | *(Startline X) enclosed token が完了する前に EOF に到達しました* |

EOF は「ファイルの終わり」を意味します。Startline として示された箇所には、閉じる二重引用符のない開始の二重引用符があります。このエラーは、ファイルの終わりまで読み取っても閉じる二重引用符が見つからなかったために発生しました。

または、予期しない改行によってデータストリームが中断された可能性があります。

| | *(catalog type) フィールドの解析エラー: 値: (field)* | 商品フィールドが無効なため、受け付けることができません。 | | *レコード (recordNumber) にエラーがあります: 区切り値の数 (FieldsLength) が期待値 (ColumnNamesLength) と一致しません* | 特定のデータ行で、ヘッダーのない列にデータが存在する場合、このエラーが発生します。 | | *カタログファイルに有効なレコードが見つかりませんでした* | データファイルが空である（つまりデータがない）、検出されたデータが無効である、または指定したファイル名が正しくない、のいずれかです。 | | *ファイル内のレコードの10%超にエラーがありました。* | このエラーが発生すると、データファイルを処理できません。 | | *処理は内部システムエラーのため失敗しました。ユーザー側での対応は不要です。エンジニアリングチームには通知済みで、問題の解決に取り組んでいます。最後に正常処理されたカタログは引き続き Media Partner にご利用いただけます。詳細が必要な場合は、impact.com サポートまでお問い合わせください。* | 以下を参照してください [impact.com ステータスページ](https://status.impact.com/) でサービス中断の詳細をご確認ください。 | | *値 (field value) を持つフィールド (field name) に有効なプロトコルがありません* | フィールド値が正しくフォーマットされたURLではありません。 |
#### Google Merchant フォーマットのエラー 商品カタログの分類体系として Google Merchant Center 形式を使用している場合、発生する可能性のある問題は2つあります。問題はおそらく形式の `カテゴリ` セクション。 {% tabs %} {% tab title="Google 商品カテゴリがありません" %} を選択すると *エラー* で *商品カタログ* 画面で、 *Google 商品カテゴリがありません* で *提案* 列。 これは、商品カタログに Google カテゴリコードまたは完全な Google カテゴリ文字列が含まれていないことを意味します。 この問題を解決するには、Google Merchant Center アカウントを参照してください。Google は商品に対してカテゴリを自動的に提案します。修正したカタログをアップロードする際は、この提案を使用してください。
{% endtab %} {% tab title="Google 商品カテゴリの不一致" %} を選択すると *エラー* で *商品カタログ* 画面で、 *Google 商品カテゴリの不一致* で *無効* 列。 これは、カタログ内の商品に使用されているカテゴリが、想定される [分類コード](https://www.google.com/basepages/producttype/taxonomy-with-ids.en-US.txt) （例: 7386）または Google が提供する完全なカテゴリ形式と一致していないことを意味します。完全な Google カテゴリ形式の例は以下をご覧ください。 `動物・ペット用品 > ペット用品 > 鳥用品 > 鳥かごアクセサリー > 鳥かご用フード＆ウォーターディッシュ` この問題を解決するには、カタログに記載されている Google 商品カテゴリの形式を修正してから、カタログを再アップロードしてください。
{% endtab %} {% endtabs %} #### トラブルシューティング *URL から取得* 問題 カタログが URL から取得するように設定されていて、正しく読み込まれない、更新されない、または処理されない場合は、下の表を使って問題を特定し、解決してください。
問題確認する項目修正方法
URL が直接ダウンロードリンクではないブラウザーで URL を開いてください。ログインページ、クラウドストレージのランディングページにリダイレクトされる、または 404/403 エラーが返る場合、その URL は直接ダウンロードリンクではありません。URL を、ファイルを直接ダウンロードできるか、ブラウザーで開いたときに生データとして表示されるものに更新してください。
ファイル名の不一致この アップロードファイル名 カタログ設定内の値は、拡張子（.csv, .xml, .txt, .gz).）を含め、URL 上の実際のファイル名と完全に一致している必要があります。 アップロードファイル名 カタログ設定の 要求に一致するカタログが見つかりませんでした というエラー。
形式または区切り記号の不一致選択した形式（CSV、TXT、XML、GMC）がファイルと一致していることを確認してください。区切り形式のファイルを使用している場合は、区切り記号（カンマ、タブ、パイプ）が設定と一致していることを確認してください。カタログ設定の形式または区切り記号を修正してください。不一致があると 有効なレコードが見つかりません というエラーになります。
FTP/SFTP: 認証情報またはパスが無効URL が次の形式になっていることを確認してください: sftp://{username}:{password}@{host}/{file_path}。パスはディレクトリではなく、正確なファイルを指している必要があります。認証情報に特殊文字が含まれる場合は URL エンコードする必要があります（例: @ → %40).FileZilla などの FTP クライアントで認証情報をテストしてください。修正した認証情報と完全なファイルパスを使って URL を更新します。
取得がタイムアウトするか、接続に失敗するサーバーのファイアウォールが impact.com のリクエストをブロックしている可能性があります。ホスティングプロバイダーまたは IT チームに連絡し、impact.com の IP アドレス範囲を許可リストに追加してもらってください。
URL に認証が必要Pull From URL は、セッションベースまたは Cookie ベースの認証をサポートしていません。代わりに次のいずれかを使用してください: 公開アクセス可能な直接ダウンロード URL、URL に埋め込まれた HTTP Basic Auth（https://user:pass@host/path）、または URL に認証情報を含む FTP/SFTP。フィードにブラウザベースのログインが必要な場合は、 直接アップロード または FTP Push.
URL が 2,048 文字を超えている署名付きクラウドストレージ URL は 2,048 文字の制限を超えることがあり、途中で切り詰められる可能性があります。直接ダウンロードを維持する短縮URLを使用するか、より短いURLでファイルをホストしてください。
カタログが Processing または Pending のまま停止しているファイルがまだ URL からアクセス可能かどうか、またファイルサイズが取得頻度に対して異常に大きくないかどうかを確認してください。ファイルが利用可能であることを確認してください。カタログが 処理中 または 保留中, サポートに連絡してください のままの場合は、手動での再処理を依頼してください。
カタログの自動更新が停止したファイルが同じ URL で引き続き利用可能かどうか、またファイル名、形式、またはサーバーアクセス設定が変更されていないかどうかを確認してください。元の URL にファイルを復元するか、新しい URL またはファイル名を反映するようにカタログ設定を更新してください。大規模カタログ（100万件以上）の場合は、タイムアウトを避けるため取得頻度を下げることを検討してください。
アップロード後にフィールドまたはデータが欠落しているフィールド名が選択した形式の仕様と一致していることを確認してください。たとえば、 Google Merchant Center のフィールド は GMC 形式の場合です。標準仕様外のカスタムフィールドは、impact.com のカスタムフィールド枠（数値1, Text1など）。アップロードしたカタログを impact.com からダウンロードし、元のソースファイルと比較して、どこでデータが失われているかを特定してください。必要に応じてフィールド名またはマッピングを更新し、その後再アップロードしてください。
--- # 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.