商品カタログのエラーと警告をトラブルシューティング

各商品カタログにはヘルススコアがあり、カタログ内にどの問題が存在するか（存在する場合）を示します。カタログを 優良 の範囲にするには、存在するエラー、警告、重複をすべて調査して修正する必要があります。

1. 左側のナビゲーションメニューから ［Engage］ → コンテンツ → 商品 → 商品カタログ.
2. カタログにエラー、警告、または重複行項目がある場合は、それぞれがいくつあるかを以下で確認できます Health 列。

   

   • カタログを自動取得するアップロード方法は、次回の取得イベント時に自動で更新されるはずです。

ヘルスの説明

ヘルスインジケーター	説明
保留中	商品カタログをアップロードしています。
処理中	商品カタログを処理しています。
非常に良好	正常なカタログであることを示します。この商品データセットは完全で、構造も整っているため、効果的に機能する可能性が最も高くなります。
良好	カテゴリやステータスなど、重要なデータを含む一部の推奨フィールドが欠落している可能性があることを示します。これらの不足を補うことで、カタログ全体の品質が向上します。
不良	送信したレコードの10%を超える部分で必須情報が不足していることを示します。このカタログは修正して再アップロードする必要があります。

エラーと警告を表示

1. で Health 列で、 エラー, 警告、または 重複 リンクを選択します。

   • エラーまたは警告の詳細が記載されたページにリダイレクトされます。重複セット内では最初の項目のみが impact.com に表示され、最初の項目と重複するものはすべて無視されます。
2. 必要に応じて 検索 ページ上部のフィールドとフィルターを使って、問題を絞り込みます。

フィルターの説明

エラーの種類	特定の エラー, 警告, 重複、または すべて の問題をフィルタリングできます。
必須	必須の商品カタログフィールドの欠落や、任意の特定の すべて フィールドの値が削除されます。
推奨	推奨される商品カタログフィールドの欠落や、任意の特定の すべて フィールドの値が削除されます。
無効	検証ベースの特定のエラーをフィルタリングできます。これは、重複SKU、無効なGoogleカテゴリーコード、またはその他のエラーのいずれかです。

1. 問題を確認し、必要に応じて修正を行ってください。その後、商品カタログを再アップロードします。

一般的なエラーと警告メッセージ

エラーメッセージ	説明
レコード '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 ステータスページ でサービス中断の詳細をご確認ください。
値 (field value) を持つフィールド (field name) に有効なプロトコルがありません	フィールド値が正しくフォーマットされたURLではありません。

Google Merchant フォーマットのエラー

商品カタログの分類体系として Google Merchant Center 形式を使用している場合、発生する可能性のある問題は2つあります。問題はおそらく形式の カテゴリ セクション。

Google 商品カテゴリがありません

を選択すると エラー で 商品カタログ 画面で、 Google 商品カテゴリがありません で 提案 列。

これは、商品カタログに Google カテゴリコードまたは完全な Google カテゴリ文字列が含まれていないことを意味します。

この問題を解決するには、Google Merchant Center アカウントを参照してください。Google は商品に対してカテゴリを自動的に提案します。修正したカタログをアップロードする際は、この提案を使用してください。

Google 商品カテゴリの不一致

トラブルシューティング 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 からダウンロードし、元のソースファイルと比較して、どこでデータが失われているかを特定してください。必要に応じてフィールド名またはマッピングを更新し、その後再アップロードしてください。