> 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. カタログにエラー、警告、または重複行項目がある場合は、 *ヘルス* 列に各件数が表示されます。
* カタログを自動取得するアップロード方法は、次回の取得イベント時に自動更新されるはずです。
ヘルスの説明 | ヘルス指標 | 説明 | | ------- | ----------------------------------------------------------------------------- | | **保留中** | 商品カタログをアップロードしています。 | | **処理中** | 商品カタログを処理しています。 | | **優良** | 健全なカタログであることを示します。この商品データセットは完全で、構造も整っているため、効果的に機能する可能性が最も高くなります。 | | **良好** | カテゴリやステータスなどの重要なデータを含む一部の推奨フィールドが欠落している可能性を示します。これらの欠落を解消すると、カタログ全体の品質が向上します。 | | **不良** | 送信したレコードの10%以上で必須情報が欠落していることを示します。このカタログは修正して再アップロードする必要があります。 |
#### エラーと警告を表示 1. 〜の *ヘルス* 列で、 **エラー**, **警告**、または **重複** リンク。 * エラーまたは警告の詳細が表示されるページにリダイレクトされます。重複セットでは最初の項目のみが impact.com に反映され、最初の項目を複製した他の項目はすべて無視されます。 2. 必要に応じて、 *検索* フィールドとページ上部のフィルターを使って、問題を絞り込んでください。
フィルターの説明 | | | | --------- | ------------------------------------------------------------ | | **エラー種別** | 特定の *エラー*, *警告*, *重複*、または *すべて* 問題で絞り込めます。 | | **必須** | 欠落している商品カタログの必須フィールド、または *すべて* フィールドで絞り込めます。 | | **推奨** | 欠落している商品カタログの推奨フィールド、または *すべて* フィールドで絞り込めます。 | | **無効** | 特定の検証ベースのエラーで絞り込めます。たとえば、重複SKU、無効なGoogleカテゴリコード、その他のエラーなどです。 |
3. 問題を確認し、必要に応じて変更してください。その後、商品カタログを再アップロードします。
よくあるエラーと警告メッセージ | エラーメッセージ | 説明 | | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | | *レコード「X」: 必須フィールドが欠落しています: (field name)* | 指定された行で、1つ以上の必須フィールドが欠落しています。 | | *レコード「X」: CatalogItemId(CatalogItemId): 必須フィールドが欠落しています: (field name)* | データファイルの1行で必須フィールドが欠落しています。 | | *要求に一致するカタログが見つかりません。アップロードしたファイル名が、カタログに登録されている名前と同じか確認してください* | その *アップロードファイル名* で設定された *アップロード方法* セクションが、アップロードしたファイル名と完全には一致していません。 | | *カタログファイルに属性が含まれていません* | 商品カタログのデータファイルに処理可能なデータがありません。 | | *IDが同じカタログ項目がカタログ内に複数回存在し、最初以降のものは無視されます* | 2件以上の項目が同じIDを持っています。すべての商品には一意の値が必要です。重複項目は処理されません。 | | *レコード 'X' にエラーがあります: (line X) 囲まれたトークンと区切り文字の間に無効な文字があります* | データファイルの1行で二重引用符の使い方が無効です。フィールドを二重引用符で囲み、それ以外のすべての二重引用符を二重引用符2つに置き換えて、正しく処理する必要があります（例: *3" floppy* は次のようになります *"3"" floppy"*). | | *(開始行X) 囲まれたトークンが完了する前にEOFに達しました* |

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

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

| | *（カタログ種別）フィールドの解析エラー: 値: (field)* | 商品フィールドが無効なため受け付けられません。 | | *レコード (recordNumber) にエラーがあります: 区切られた値の数 (FieldsLength) が、期待される (ColumnNamesLength) と一致しません* | 特定のデータ行で、ヘッダーのない列にデータが存在する場合、このエラーが発生します。 | | *カタログファイル内に有効なレコードが見つかりませんでした* | データファイルが空（つまりデータがない）、検出されたデータが有効でない、または指定されたファイル名が正しくない、のいずれかです。 | | *ファイル内のレコードの10%以上にエラーがありました。* | このエラーが発生すると、データファイルを処理できません。 | | *内部システムエラーのため、処理に失敗しました。ユーザー側での操作は不要です。弊社エンジニアリングチームには通知済みで、問題の解決に取り組んでいます。最後に正常処理されたカタログは、引き続き Media Partners で利用できます。さらに詳しい情報が必要な場合は、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に更新してください。
ファイル名の不一致その アップロードファイル名 カタログ設定内のファイル名は、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 のリクエストをブロックしている可能性があります。ホスティングプロバイダーまたはITチームに連絡し、impact.com のIPアドレス範囲を許可リストに追加してください。
URLに認証が必要URLから取得は、セッションベースまたはCookieベースの認証をサポートしていません。代わりに次のいずれかを使用してください: 公開アクセス可能な直接ダウンロードURL、URL内に埋め込まれたHTTP Basic Auth（https://user:pass@host/path）、またはURL内に認証情報を含むFTP/SFTP。フィードにブラウザベースのログインが必要な場合は、 直接アップロード または FTPプッシュ.
URLが2,048文字を超えています署名付きクラウドストレージURLは2,048文字の制限を超えることがあり、途中で切り捨てられる可能性があります。直接ダウンロードを保持できるURL短縮サービスを使用するか、より短いURLでファイルをホストしてください。
カタログが処理中または保留中のまま止まっているファイルがまだURLでアクセス可能かどうか、またファイルサイズが取得頻度に対して異常に大きくないか確認してください。ファイルが利用可能であることを確認してください。カタログが引き続き 処理中 または 保留中, サポートにお問い合わせください 手動での再処理を依頼してください。
カタログの自動更新が停止しましたファイルがまだ同じURLで利用可能か、またファイル名、形式、またはサーバーアクセス設定が変更されていないか確認してください。元のURLでファイルを復元するか、新しいURLまたはファイル名を反映するようにカタログ設定を更新してください。大規模カタログ（100万件以上）では、タイムアウトを避けるため取得頻度を下げることを検討してください。
アップロード後にフィールドまたはデータが欠落しているフィールド名が、選択した形式の仕様と一致していることを確認してください。たとえば、 Google Merchant Center のフィールド GMC形式では、標準仕様外のカスタムフィールドを impact.com のカスタムフィールド枠（Numeric1, 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.