Ctrlk
Integrations HubContact SupportLog In
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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

各商品カタログには、カタログ内の問題を示すヘルススコアがあります。このガイドを使って、ファイルのアップロードと処理からパートナーへの表示やプロモーションまで、カタログ設定のあらゆる段階での問題をトラブルシュートし、カタログを 優良 範囲内に。

ヒント： 健全なカタログは、エラーを消すだけではありません。 商品カタログのベストプラクティス データを完全で、構造化され、優れた可視性とパフォーマンスを発揮できるように整えるための

カタログのヘルススコア

  1. 左側のナビゲーションメニューから、次を選択します [エンゲージ] → コンテンツ → 商品 → 商品カタログ.

  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 の認証情報 をアカウントの技術設定で確認してください。見つからない、またはアクセスできない場合は、 サポートにお問い合わせください.

impact.com の SFTP サーバー

impact.com の SFTP サーバーは、特定の統合向けに予約された特殊なアップロード方法です。

問題
確認する項目
修正方法

フィードプラットフォームが接続できない

プラットフォームがホストに接続していることを確認してください products.impact.com のポート 22、また認証情報がアカウントに対して発行されたものであることを確認してください。

FileZilla や Cyberduck などの標準的な SFTP クライアントで同じ認証情報をテストしてください。クライアントは接続できるのにフィードプラットフォームが接続できない場合は、以下の手順でカタログを URLから取得 に切り替えてください。

プッシュからプルに切り替える

フィードプラットフォーム（例: Feedonomics）で impact.com の SFTP サーバーにファイルをプッシュすると接続エラーが発生する場合、代わりに impact.com がフィードプラットフォームの SFTP サーバー（例: SFTPGo）から直接フィードを取得するよう再設定できます。これにより impact.com の SFTP 依存を完全になくせるため、推奨される解決策です。

切り替える前に、フィードプラットフォーム（例: Feedonomics）にフィード用の送信先 SFTP 場所を設定してもらい、以下を提供してもらってください:

  • SFTP/FTP ホストとポート（例: sftpgo.feedonomics.com:22）

  • ユーザー名とパスワード

  • ファイルパス（例: incoming/catalog_feed.txt.gz）

警告： 新しいカタログを作成するのではなく、既存のカタログを更新してください。同じ アップロードファイル名 を使用する新しいカタログは ファイル名は既に使用されています エラーを返し、既存のカタログがすでに他のプログラムを支えている可能性があります。

  1. 左側のナビゲーションメニューから、次を選択します [エンゲージ] → コンテンツ → 商品 → 商品カタログ.

  2. 既存のカタログにカーソルを合わせてから、 編集.

  3. で、 アップロード方法 セクションで、 URLから取得.

  4. 各申請者の横にある 形式 を選択し、フィードファイルに一致するものを選択してください。

  5. 次を入力してください。 アップロードファイル名、拡張子を含めてファイル名と完全に一致させます。

  6. 次を入力してください。 プル URL の形式 sftp://[username]:[password]@[host]:22/[path/to/file].

    • 認証情報内の特殊文字は URL エンコードしてください。たとえば @ は %40.

  7. 使用する 取得頻度, 取得時刻、および タイムゾーン.

  8. 選択 保存.

URLから取得

のサポート対象プロトコルは URLから取得 です http://, https://, ftp://、および sftp://。カタログが正しく読み込まれない、更新されない、または処理されない場合は、以下の表を使って問題を特定し、解決してください。

問題
確認する項目
修正方法

URL が直接ダウンロードリンクではありません

URL をブラウザーで開いてください。ログインページ、クラウドストレージのランディングページにリダイレクトされる、または 404 もしくは 403 エラーが返る場合、その 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、または URL に埋め込まれた HTTP Basic Auth（https://user:pass@host/path）、あるいは URL 内に認証情報を含めた FTP/SFTP を使用してください。フィードにブラウザーでのログインが必要な場合は、カタログを別のアップロード方法に切り替えてください。たとえば 直接アップロード または impact.com の FTP サーバー.

URL が 2,048 文字を超えている

署名付きクラウドストレージ URL は 2,048 文字の制限を超えることがあり、切り詰められる可能性があります。

直接ダウンロードを維持できる短縮 URL を使うか、より短い URL でファイルをホストしてください。

カタログが処理中または保留中のまま止まっている

ファイルが URL でまだアクセス可能かどうか、またファイルサイズがプル頻度に対して異常に大きくないかどうかを確認してください。

ファイルが利用可能であることを確認してください。カタログが 処理中 または 保留中, サポートにお問い合わせください のままなら、手動で再処理をリクエストしてください。

カタログの自動更新が停止した

ファイルが同じ URL でまだ利用可能かどうか、またファイル名、形式、またはサーバーアクセス設定が変更されていないかを確認してください。

元の URL でファイルを復元するか、新しい URL またはファイル名に合わせてカタログ設定を更新してください。大規模カタログ（100万件以上のアイテム）の場合は、タイムアウトを避けるためにプル頻度を下げることを検討してください。

アップロード後にフィールドまたはデータが欠落している

フィールド名が選択した形式の仕様と一致していることを確認してください。たとえば Google Merchant Center のフィールド GMC 形式の場合。標準仕様外のカスタムフィールドは、impact.com のカスタムフィールド枠（数値1, テキスト1など）にマッピングしてください。

impact.com からアップロード済みのカタログをダウンロードし、元のファイルと比較して、どこでデータが失われているかを確認してください。必要に応じてフィールド名またはマッピングを更新し、再アップロードしてください。

統合ショッピングカートのインポート

この方法では、既存の eコマースプラットフォームからカタログを取得します。接続の問題の多くは、誤った認証情報または読み取り権限の不足が原因です。以下からご利用のプラットフォームを選択してください。

たとえば次のようなエラーが表示される場合 Shopify に接続時の HTTP ステータスコードが失敗: 401 または カタログファイルに有効なレコードが見つかりませんでした、通常は認証情報または権限が原因です。

  • パスワードは Admin API アクセストークンである必要があり、 shpat_ （または shap_）で始まります。Shopify 管理画面の アプリ → API 認証情報 → Admin API アクセストークン.

  • が表示されない場合は、 Admin API アクセストークンで、 アプリをインストール して Shopify で生成してください。

  • 次の read_products 権限（スコープ）がアプリに付与されていることを確認してください。これがないと、Shopify は read_products スコープ

  • への加盟店承認が必要であるとするエラーを返します。 商品 → コレクション。コレクションを選択すると、その ID はページ URL の末尾に表示されます。

設定手順の詳細については、 Shopify 商品カタログ統合ガイド.

もし WooCommerce への接続に失敗しました。もう一度お試しください、認証情報と API 設定を確認してください。

  • あなたの APIユーザー名 はあなたの WooCommerce コンシューマーキーであり、 API パスワード はあなたの コンシューマーシークレット.

  • WooCommerce で旧 REST API を有効にします: WooCommerce → 設定 → 詳細設定 → 旧 APIを選択して、チェックボックスをオンにして有効にします。

参考として、 WooCommerce REST API ドキュメント.

BigCommerce への接続には、2つの値と正しい読み取り専用権限が必要です。

  • 次を入力してください。 ストアハッシュ および アクセストークン impact.com UI で。ストアハッシュは、ストアの API パスにある識別子です。

  • 検索バーの横にある 商品 および 情報と設定 BigCommerce で API アカウントを作成するときに、権限を読み取り専用に設定します。

参考として、BigCommerce の API トークンの作成.

Shoplazza のプライベートアプリには、以下のリソースへの読み取りアクセスが必要です: product, collection、および shop.

設定手順については、Shoplazza の プライベートアプリの作成.

アップロード後のエラーと警告をトラブルシュートする

ファイルが受信されると、impact.com は各レコードを検証します。エラーはレコードの処理を妨げ、警告は受け付けられたものの問題を引き起こす可能性のあるデータにフラグを付けます。以下のセクションを使って、それらを解釈し解決してください。

エラーと警告を表示

  1. で、 健全性 列で、 エラー, 警告、または 重複 リンク。

    • より詳細なページにリダイレクトされます。重複セットでは最初の項目のみが impact.com に表示され、最初の項目と重複するその他の項目はすべて無視されます。

  2. 必要に応じて、 検索 フィールドおよびページ上部のフィルターを使って問題を絞り込みます。

  3. 問題を確認し、必要に応じて変更を加えてから、商品カタログを再アップロードしてください。

フィルターの説明
フィルター
説明

エラーの種類

特定の エラー, 警告, 重複、または すべて の問題に絞り込む

必須

特定の不足している必須の商品カタログフィールドを絞り込むか、 すべて 欄に入力します。

推奨

特定の不足している推奨商品カタログフィールドを絞り込むか、 すべて 欄に入力します。

無効

重複 SKU、無効な Google カテゴリコード、その他のエラーなど、特定の検証ベースのエラーに絞り込みます。

よくあるエラーと警告メッセージ

カタログに表示されるメッセージを、 アップロードステータス 列または 健全性 列から開く詳細ページで見つけてください。説明を使って解決してください。

メッセージ
説明

レコード 'X': 必須フィールドが欠落しています: (field name)

指定された行に1つ以上の必須フィールドがありません。

レコード 'X': CatalogItemId(CatalogItemId): 必須フィールドが欠落しています: (field name)

データファイルの1行に必須フィールドが欠落しています。

要求に一致するカタログが見つかりません。アップロードしたファイル名が、カタログに登録されている

この アップロードファイル名 で設定された アップロード方法 と、アップロードしたファイル名と完全に一致していないか確認してください。

カタログファイルに属性がありません

商品カタログデータファイルに処理可能なデータがありません。

ID を持つカタログアイテムがカタログ内に複数回出現しており、最初のもの以降は無視されます

2件以上のアイテムが同じ ID を持っています。すべての商品には一意の値が必要であり、重複アイテムは処理されません。

レコード 'X' にエラーがあります: (line X) encapsulated token と delimiter の間に無効な文字があります

行に無効なダブルクォーテーションの使用があります。フィールドをダブルクォーテーションで囲み、その他のすべてのダブルクォーテーションを2つのダブルクォーテーションに置き換えてください。

(Startline X) encapsulated token が終了する前に EOF に達しました

EOF は「ファイルの終わり」を意味します。記載された開始行には閉じるダブルクォーテーションのない開始ダブルクォーテーションがあるか、予期しない改行がデータストリームを中断しています。

field: の値: (field) の解析エラー

商品フィールドは無効で、受け入れることができません。

レコード (recordNumber) にエラーがあります: 区切り値の数 (FieldsLength) が期待値 (ColumnNamesLength) と一致しません

ある行で、ヘッダーのない列にデータがあります。

カタログファイルに有効なレコードが見つかりませんでした。ファイルの内容が設定済みのカタログ形式と一致しているか確認し、再アップロードしてください。

impact.com はファイルを読み取りましたが、商品レコードが含まれていません。ファイルに商品が含まれており、選択したカタログ形式と一致していることを確認してから再アップロードしてください。

ファイル内のレコードの10%を超えてエラーがあったため、カタログは更新されませんでした。レコードを確認して修正し、ファイルを再アップロードしてください。

カタログを更新するには、エラーが多すぎます。これには、すべてのレコードにエラーがあるファイルも含まれます。参照してください 10% エラーしきい値を理解する を参照してください。

カタログファイルは有効な XML ではなく、読み取れませんでした。ファイルが整形式の XML であることを確認してから再アップロードしてください。

XML ファイルが空、途中で切れている、または閉じられていないタグがあるため、impact.com は読み取れません。XML を修正して整形式にしてから再アップロードしてください。

ファイルは有効な RSS または Atom フィード形式ではないようです。ファイルが設定したカタログ形式と一致しているか確認し、再アップロードしてください。

ファイルは RSS または Atom フィードではありません。たとえば、フィードの代わりにエラーページが保存されている場合などです。XML カタログファイルには rss, RDF、または フィード を開始要素として含める必要があります。

カタログファイルの内容を読み取れませんでした...

impact.com はファイルの内容を読み取れません。一般的な原因は、空のファイル、予期しないファイル構造、無効な区切り文字、または誤った文字エンコードです。ファイルが選択したカタログ形式と一致していることを確認し、再アップロードしてください。問題が続く場合は、 サポートにお問い合わせください.

設定されたプル URL からカタログファイルを取得できませんでした。URL と、ファイルに到達できることを確認してください。

impact.com は次からファイルをダウンロードできません プル URL カタログ設定内の URLから取得 上記を参照して URL の問題をトラブルシュートしてください。

内部システムエラーのため、処理に失敗しました...

対応は不要です。最後に正常に処理されたカタログは引き続きパートナーに利用可能です。詳細は impact.com ステータスページ を参照してください。

値 (field value) を持つフィールド (field name) に有効なプロトコルがありません

フィールド値が適切な形式の URL ではありません。

形式と区切り文字の警告

問題
修正方法

区切り文字の問題: 間違ったカンマ、タブ、または空行によりフィールド間の境界が壊れます。

各フィールドが一貫して区切られるように、カタログファイルの区切り文字の使用を修正してから再アップロードしてください。

説明フィールドの改行がレコード処理を妨げます。

改行は区切りテキスト形式（CSV および TSV）ではサポートされていません。アップロード前に説明などのテキストフィールドから改行を削除してください。

Google Merchant Center 形式のエラー

Google Merchant Center（GMC）形式を使用している場合、問題の多くは形式の カテゴリ セクション、事前定義されたフィールド値、または XML 構造に起因します。

次を選択すると エラー の 商品カタログ 画面では、 Google 商品カテゴリが不足しています で 提案 列が表示されることがあります。これは、カタログに Google カテゴリコードまたは Google の完全なカテゴリ文字列が含まれていないことを意味します。

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

次を選択すると エラー の 商品カタログ 画面では、 Google 商品カテゴリの不一致 で 無効 列。これは、カタログ内のアイテムに使用されているカテゴリが、期待される 分類コード （たとえば 7386）または Google が提供する完全なカテゴリ形式と一致していないことを意味します。たとえば:

Animals & Pet Supplies > Pet Supplies > Bird Supplies > Bird Cage Accessories > Bird Cage Food & Water Dishes

これを解決するには、Google 商品カテゴリの記載形式を修正してから、カタログを再アップロードしてください。

次のようなエラー field: availability with value のフィールドを解析できませんでした は、事前定義フィールドに GMC が認識しない値が使われていることを意味します。GMC カタログでは、カテゴリと値は完全に一致している必要があります。

  • 使用して availability フィールド用に

  • サポートされている在庫状況の値は in_stock, out_of_stock, preorder、および backorder.

  • 値フィールドに通貨記号が表示されるなど、書式に影響する特殊記号がないか確認してください。

Google Merchant Center（XML 形式）のカタログをアップロードして ファイルは有効な RSS または Atom フィード形式ではないようですが表示された場合、XML 構造が正しくない可能性があります。

XML ファイルには rss, RDF、または フィード を開始要素として含める必要があります。ルート要素を修正して再アップロードしてください。

もし カタログファイルは有効な XML ではなく、読み取れませんでした。ファイルが空、途中で切れている、または閉じられていないタグがあるためです。XML を修正して整形式にしてから再アップロードしてください。

eBay Commerce Merchant Center 形式: 次の .csv ファイルでは、フィールド列の値（カテゴリ）のスペースをアンダースコアに置き換えてください。たとえば、 Item_Title を Item Title.

10% エラーしきい値を理解する

アップロードしたファイルのレコードの10%以上にエラーが含まれている場合、ファイルは処理されません。その場合:

  • カタログには最後に成功したアップロード時のバージョンが引き続き表示されるため、古い 最後の成功した送信 タイムスタンプが表示されるはずです。

  • この 製品を表示 オプションは、そのカタログ ID に対して以前にファイルが正常にアップロードされた場合にのみ表示されます。

フラグが付いたレコードを修正して、エラーが10%未満になるようにしてから再アップロードしてください。

カタログをパートナーに公開可能にする

健全なカタログでも、あなたが 公開可能にするまで、パートナーには届きません と、次の条件を満たす パートナー表示の要件。このセクションは、カタログの処理が正常に完了したものの、パートナー側で表示、商品アクセス、またはトラッキングリンクに問題が発生している場合に使用します。

パートナーにカタログが表示されない

注: この 利用可能にする オプションは、以下を持つカタログにのみ表示されます 優良 または 良好 状態が 非アクティブ または 有効化保留中.

次の2つの設定を確認してください：

  • カタログが使用可能になっていることを確認します：

    1. 選択 [エンゲージ] → コンテンツ → 商品 → 商品カタログ カタログを見つけます。

    2. 選択 [その他] を選択します 利用可能にする.

  • パートナーアクセスが制限されていないか確認します：

    1. 選択 [エンゲージ] → コンテンツ → 商品 → 商品カタログ カタログを見つけます。

    2. カタログにカーソルを合わせ、次に 編集.

    3. で、 パートナーのアクセスを制限 セクションで、 特定のパートナーのみにアクセスを許可する 次と等しい がオンになっているか確認します。

    4. オンになっている場合は、 オフに切り替えて、 保存.

パートナーに特定の商品が表示されない、または検索できない

商品がパートナー UI に表示されるには、次のすべての要件を満たす必要があります：

  • 元の価格が $2.00 USD を超えていること。

  • 商品の在庫状況が 在庫切れ

  • 商品には、有効な商品 URL があり、実際の商品詳細ページに遷移すること。

  • 商品に画像 URL があること。

  • 商品が、ルールが 適用された カタログに含まれていない。

パートナーのトラッキングリンクが「malformed」エラーを返す

パートナーが商品からのトラッキングリンクを使用したときに「The link you clicked on is malformed」が表示される場合、通常はディープリンクが有効になっていないか、商品のランディングページのドメインが許可ドメインとして設定されていません。ディープリンクを有効にし、許可ドメインを設定してこのエラーを解決するには、次を参照してください： ディープリンクの許可ドメインを設定する.

前へブランドとしてクレジットカードカタログを追加
次へ商品カタログのフィールド要件

最終更新

役に立ちましたか？