> 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-uploads-and-connections.md).

# 商品カタログのアップロードと接続のトラブルシューティング

impact.comが商品カタログを処理するには、まずカタログファイルを正常に受信する必要があります。このガイドはアップロード方法別に構成されています。カタログで使用している方法のセクションに進んでください。 [*URLから取得*](#pull-from-url-recommended), [*統合ショッピングカートからのインポート*](#integrated-shopping-cart-import-recommended), [*impact.com FTPサーバー*](#impact.com-ftp-server), [*impact.com SFTPサーバー*](#impact.com-sftp-server)または [*直接アップロード*](#direct-upload)を使用します。カタログでどの方法が使われているかわからない場合は、カタログを編集して [*アップロード方法* の設定を確認してください。](https://help.impact.com/brand/ja/what-would-you-like-to-learn-about/platform-features/product-catalogs/add-product-catalogs-as-a-brand.md#upload-your-product-catalog).

impact.comでは、 *URLから取得* または *統合ショッピングカートからのインポート*をおすすめします。これらの方法では、カタログを取得するタイミングと更新頻度をimpact.comが管理するためです。impact.com FTPサーバー、impact.com SFTPサーバー、または *直接アップロード*を使用する場合は、定期的に（できれば毎日、少なくとも毎週）更新されたカタログデータを提供する必要があります。

impact.comがファイルを受信したものの、カタログにエラーや警告が表示される場合は、 [商品カタログのエラーと警告のトラブルシューティング](https://help.impact.com/brand/ja/what-would-you-like-to-learn-about/platform-features/product-catalogs/troubleshoot-product-catalog-errors-and-warnings.md).

## URLから取得（推奨）

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

| 問題                       | 確認する内容                                                                                                                                                                                                              | 解決方法                                                                                                                                                                                         |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| URLが直接ダウンロードリンクではない      | URLをブラウザーで開きます。ログインページやクラウドストレージのランディングページにリダイレクトされる場合、または404や403エラーが返される場合、そのURLは直接ダウンロードリンクではありません。                                                                                                               | ファイルを直接ダウンロードする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で認証が必要                | このアップロード方法では、セッションベースまたはCookieベースの認証はサポートされていません。                                                                                                                                                                   | 一般公開されている直接ダウンロードURL、URLに埋め込んだHTTP Basic認証（`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コマースプラットフォームからカタログを取得します。接続に関する問題の多くは、認証情報の誤りや読み取り権限の不足が原因です。以下からご利用のプラットフォームを選んでください。

### Shopify（推奨）

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

* パスワードには、次の形式の **Admin API アクセストークン**を使用してください。先頭は `shpat_` （または `shap_`）です。Shopify 管理画面の **アプリ** **→** **API 認証情報** **→** **Admin API アクセストークン**.
* 「 **Admin API アクセストークン**」が表示されない場合は、Shopify で **アプリをインストール** を選択して生成してください。
* アプリに `read_products` 権限（スコープ）が付与されていることを確認してください。付与されていない場合、Shopify は、この操作には販売者による承認が必要であることを示すエラーを返します。対象となるスコープは `read_products` です。
* コレクションの場合は、Shopify 管理画面で **商品** **→** **コレクション**に移動して、コレクション ID を確認します。コレクションを選択すると、ページ URL の末尾に ID が表示されます。

設定手順の詳細については、 [Shopify 商品カタログ連携ガイド](https://integrations.impact.com/integration-guides/for-brands/plugin-integrations/e-commerce/integrate-with-shopify/shopify-product-catalog).

### Amazon（推奨）

Amazon ショッピングカート連携は、 [セラーサブスクリプション](https://help.impact.com/brand/ja/what-would-you-like-to-learn-about/seller-program/amazon-seller-program/amazon-seller-program-explained.md) を利用しているブランド専用で、セルフサービス機能ではありません。Amazon API の制限により、Amazon から自動でインポートできるカタログは最大 1,000 商品です。セラーカタログに 1,000 商品を超える商品がある場合は、代わりに *URL から取得*などのファイルアップロード方式を使用してください。

設定手順については、 [Amazon 連携ガイド](https://integrations.impact.com/integration-guides/for-brands/plugin-integrations/e-commerce/integrate-with-amazon).

### BigCommerce

BigCommerce に接続するには、2 つの値と適切な読み取り専用権限が必要です。

* impact.com の UI に **ストアハッシュ** と **アクセストークン** を入力します。ストアハッシュは、ストアの API パスに含まれる識別子です。
* BigCommerce で API アカウントを作成する際、 **商品** と **情報と設定** の権限を読み取り専用に設定してください。

参考として、BigCommerce の [API トークンの作成](https://developer.bigcommerce.com/docs/storefront-auth/tokens#create-a-token).

### WooCommerce

次のように表示される場合 *WooCommerceに接続できませんでした。もう一度お試しください*。認証情報とAPI設定を確認してください。

* お使いの **APIユーザー名** は、WooCommerceの *コンシューマーキー*で、 **APIパスワード** は、 *コンシューマーシークレット*.
* WooCommerceでレガシーREST APIを有効にします： **WooCommerce** **→** **設定** **→** **高度な設定** **→** **レガシーAPI**を選択し、チェックボックスをオンにして有効にします。

詳しくは、 [WooCommerce REST APIのドキュメント](https://woocommerce.com/document/woocommerce-rest-api/).

### Shoplazza

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

設定方法については、Shoplazzaの [プライベートアプリの作成ガイド](https://www.shoplazza.dev/reference/quick-construction-of-private-apps).

## impact.com FTPサーバー

FTPの問題の多くは、接続設定または認証情報が原因です。

| 問題             | 確認する内容                                    | 解決方法                                                                                                                             |
| -------------- | ----------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| サーバーに接続できない    | 接続先ホストが `products.impact.com` 、ポートが `21`. | FTPクライアントに正しいホストとポートを設定し、再接続してください。                                                                                              |
| FTP認証情報が見つからない | 接続するには、アカウント用に発行されたFTPログイン情報とパスワードが必要です。  | アカウントの技術設定で、 *FTP商品データシステムの認証情報* を確認してください。見つからない場合やアクセスできない場合は、 [サポートにお問い合わせください](https://app.impact.com/support/portal.ihtml). |

## impact.com SFTPサーバー

impact.com SFTPサーバーは、特定の連携専用のアップロード方法です。

| 問題                  | 確認する内容                                                                                   | 解決方法                                                                                                                                  |
| ------------------- | ---------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| フィードプラットフォームが接続できない | プラットフォームの接続先ホストが `products.impact.com` 、ポートが `22`であり、アカウント用に発行された認証情報を使用していることを確認してください。 | FileZillaやCyberduckなどの一般的なSFTPクライアントで、同じ認証情報を使って接続をテストしてください。クライアントでは接続できるのにフィードプラットフォームでは接続できない場合は、以下の手順でカタログを *URLから取得* に切り替えてください。 |

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

impact.com では、フィードをプッシュするのではなく、プルすることをおすすめしています。impact.com がフィードプラットフォームの SFTP サーバー（例: SFTPGo）からフィードを直接プルすると、カタログを更新するタイミングと頻度を impact.com が管理できるため、impact.com の SFTP サーバーに依存する必要がなくなります。プルに切り替えることで、フィードプラットフォーム（例: Feedonomics）がファイルを impact.com の SFTP サーバーにプッシュする際に発生する可能性のある接続エラーも解消できます。

切り替える前に、フィードプラットフォーム（例: Feedonomics）にフィード用の送信用 SFTP ロケーションを設定してもらい、次の情報を確認してください。

* SFTP/FTP ホストとポート（例: sftpgo.feedonomics.com:22）
* ユーザー名とパスワード
* ファイルパス（例: incoming/catalog\_feed.txt.gz）

{% hint style="warning" %}
**警告:** 新しいカタログを作成するのではなく、既存のカタログを更新してください。同じ *アップロードファイル名* を使用して新しいカタログを作成すると、 *ファイル名はすでに使用されています* というエラーが発生します。また、既存のカタログが他のプログラムで使用されている場合があります。
{% endhint %}

1. 左側のナビゲーションメニューで、 ![](https://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[エンゲージ]** **→** **コンテンツ** **→** **商品** **→** [**商品カタログ**](https://app.impact.com/secure/advertiser/engage/ads/productcatalogs/manage-ads-product-catalog-flow.ihtml).
2. 既存のカタログにカーソルを合わせ、 **編集**.
3. ［ *アップロード方法* ］セクションで、 **URL からプル**.
4. を選択します。 **形式** フィードファイルに合った形式を選択します。
5. ［ **アップロードファイル名**］に、拡張子を含めてファイル名を正確に入力します。
6. ［ **プル URL** ］に、次の形式で入力します。 `sftp://[username]:[password]@[host]:22/[path/to/file]`.
   * 認証情報に特殊文字が含まれる場合は URL エンコードします。たとえば、 `@` は次のようになります。 `%40`.
7. ［ **取得頻度**, **取得時刻**と **タイムゾーン**.
8. を選択します。 **保存**.

## 直接アップロード

直接アップロードの問題は、通常、形式またはファイル名の不一致、あるいはファイルサイズが上限の 1 GB を超えていることが原因です。

| 問題            | 確認する内容                                                                                             | 解決方法                                                                                              |
| ------------- | -------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
| 形式の選択が間違っている  | 選択した形式（例: TXT）が、アップロードしたファイル（例: XML）と一致していません。                                                     | ファイルを再アップロードし、ファイルに合った形式を選択してください。XML ファイルの拡張子は `.xml` で、CSV ファイルの拡張子は `.csv`、タブ区切りファイルには `.txt`. |
| ファイル名が一致しない   | アップロードするファイル名は、次の名前と完全に一致している必要があります。 *アップロードファイル名* （拡張子を含む）カタログ設定で指定されている名前。                      | ファイル名を変更するか、次の設定を更新してください。 *アップロードファイル名* 両者が完全に一致するようにしてください。                                     |
| 圧縮ファイルを処理できない | impact.com は gzip および標準の zip 圧縮ファイルに対応しています。圧縮ファイルでは、圧縮形式を示すために2つ目の拡張子を使用できます。例： `catalog.xml.gz`. | 圧縮形式が gzip または zip であること、またファイル形式と圧縮形式の両方に正しい拡張子が使用されていることを確認してください。                              |


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.impact.com/brand/ja/what-would-you-like-to-learn-about/platform-features/product-catalogs/troubleshoot-product-catalog-uploads-and-connections.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
