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

各商品カタログには、カタログ内にどのような問題があるか、または問題がある場合はそれを示すヘルススコアがあります。カタログを *優秀* の範囲にするには、含まれているエラー、警告、重複をトラブルシューティングして修正する必要があります。

{% embed url="<https://res.cloudinary.com/product-enablement/video/upload/v1748512824/PXA%20Microlearnings/eng-350-5.mp4>" %}

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) **\[Engage]** → **コンテンツ** → **製品** → [**商品カタログ**](https://app.impact.com/secure/advertiser/engage/ads/productcatalogs/manage-ads-product-catalog-flow.ihtml).
2. カタログにエラー、警告、または重複した明細項目がある場合、 *ヘルス* 列にそれぞれの件数が表示されます。

   <div data-with-frame="true"><figure><img src="https://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-9a3d68cc94a312c25c5b840f7f73db9b71587572%2Fb76503d532a4a200ba58a55e8566656e34d7d2ec6339f0ea82c83761550c2ea4.png?alt=media" alt=""><figcaption></figcaption></figure></div>

   * カタログを自動取得するアップロード方法は、次回の取得イベントが発生した際に自動的に更新されるはずです。

<details>

<summary>ヘルスの説明</summary>

| ヘルス指標   | 説明                                                                                      |
| ------- | --------------------------------------------------------------------------------------- |
| **保留中** | 商品カタログはアップロード中です。                                                                       |
| **処理中** | 商品カタログは処理中です。                                                                           |
| **優秀**  | 正常なカタログを示します。この商品データセットは完全で構造も適切であり、効果的に機能する可能性が最も高い状態です。                               |
| **良好**  | カテゴリやステータスなどの重要なデータを含む、推奨される特定のフィールドが欠けている可能性があることを示します。これらの不足を解消することで、カタログ全体の品質が向上します。 |
| **不良**  | 送信したレコードの10％を超えて必須情報が欠落していることを示します。このカタログは修正して再アップロードする必要があります。                         |

</details>

#### エラーと警告を表示

1. その *ヘルス* 列で、 **エラー**, **警告**、または **重複** のリンクを選択します。
   * エラーまたは警告の詳細が表示されたページにリダイレクトされます。impact.comでは、重複セット内の最初の項目のみが反映され、最初の項目と重複するそれ以降の項目はすべて無視されます。
2. 必要に応じて、 *検索* フィールドとページ上部のフィルターを使用して問題を絞り込んでください。

<details>

<summary>フィルターの説明</summary>

|            |                                                                     |
| ---------- | ------------------------------------------------------------------- |
| **エラーの種類** | 以下に対して特定のフィルターを適用できます *エラー*, *警告*, *重複*、または *すべての* 問題。              |
| **必須**     | 不足している必須の商品カタログフィールド、または特定の *すべての* フィールドをフィルターできます。                 |
| **推奨**     | 不足している推奨の商品カタログフィールド、または特定の *すべての* フィールドをフィルターできます。                 |
| **無効**     | 特定の検証ベースのエラーでフィルターできます。これは重複SKU、無効なGoogleカテゴリコード、またはその他のエラーのいずれかです。 |

</details>

3. 問題を確認し、必要に応じて変更を加えます。その後、商品カタログを再アップロードします。

<details>

<summary>一般的なエラーと警告メッセージ</summary>

| エラーメッセージ                                                                                                                                                       | 説明                                                                                                                                                        |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| *レコード 'X': 必須フィールドが不足しています: (field name)*                                                                                                                      | 指定された行に、1つ以上の必須フィールドがありません。                                                                                                                               |
| *レコード 'X': CatalogItemId(CatalogItemId): 必須フィールドが不足しています: (field name)*                                                                                        | データファイル内の行に必須フィールドがありません。                                                                                                                                 |
| *リクエストに対するカタログが見つかりません。アップロードしたファイル名がカタログに登録されたものと同じか確認してください*                                                                                                 | 商品カタログ作成時の *アップロードファイル名* が、 *アップロード方法* セクションで設定したものと、実際にアップロードしたファイル名が完全に一致していません。                                                                        |
| *カタログファイルに属性が存在しません*                                                                                                                                           | 商品カタログのデータファイルに処理可能なデータが含まれていません。                                                                                                                         |
| *IDを持つカタログ項目がカタログ内に複数回出現しており、最初のもの以降は無視されます*                                                                                                                   | 2つ以上の項目が同じIDを持っています。すべての商品には一意の値が必要です。重複した項目は処理されません。                                                                                                     |
| *レコード 'X' にエラーがあります: (line X) 囲まれたトークンと区切り文字の間に無効な文字があります*                                                                                                     | データファイル内の行に、二重引用符の無効な使用が含まれています。これらは、フィールド全体を二重引用符で囲み、その他のすべての二重引用符を2つの二重引用符に置き換えることで適切に処理する必要があります（例: *3" フロッピー* は *"3"" フロッピー"*).                       |
| *(Startline X) 囲まれたトークンが終了する前に EOF に達しました*                                                                                                                     | <p>EOF は「ファイル終端」を意味します。記載された開始行には、閉じられていない開始二重引用符があります。このエラーは、ファイルの終端まで読み取っても閉じる二重引用符が見つからなかったために発生しました。</p><p>または、予期しない改行によってデータストリームが中断された可能性があります。</p> |
| *(catalog type) フィールドの解析エラー: 値: (field)*                                                                                                                       | 商品フィールドが無効であり、受け付けることができません。                                                                                                                              |
| *レコード (recordNumber) にエラーがあります: 区切られた値の数 (FieldsLength) が想定される数 (ColumnNamesLength) と一致しません*                                                                   | 特定のデータ行で、ヘッダーのない列にデータが存在する場合、このエラーが発生します。                                                                                                                 |
| *カタログファイル内に有効なレコードが見つかりませんでした*                                                                                                                                 | データファイルが空である（つまりデータがない）、検出されたデータが有効でない、または指定したファイル名が正しくない、のいずれかです。                                                                                        |
| *ファイル内のレコードの10％を超えるものにエラーがありました。*                                                                                                                              | このエラーが発生すると、データファイルは処理できません。                                                                                                                              |
| *内部システムエラーにより処理に失敗しました。ユーザー側での対応は不要です。当社のエンジニアリングチームには通知されており、問題の解決に向けて対応しています。最後に正常に処理されたカタログは、引き続きメディアパートナーに提供されます。詳細情報が必要な場合は、impact.com サポートまでお問い合わせください。* | 詳細については、 [impact.com ステータスページ](https://status.impact.com/) でサービス中断の情報を確認してください。                                                                           |
| *値 (field value) を持つフィールド (field name) に有効なプロトコルがありません*                                                                                                        | フィールド値が適切な形式のURLではありません。                                                                                                                                  |

</details>

#### Google Merchant 形式のエラー

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

{% tabs %}
{% tab title="Google 商品カテゴリが見つかりません" %}
選択すると *エラー* の *商品カタログ* が表示されることがあります *Google 商品カテゴリが見つかりません* の *提案* 列にそれぞれの件数が表示されます。

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

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

<div data-with-frame="true"><figure><img src="https://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c92f932de0c30c466560ef0f2b9c13a8f48100a2%2Fb61fc4733fe334479ac8dcd599a078e24be5c384633e0414cb57ba3ae9350ed3.png?alt=media" alt=""><figcaption></figcaption></figure></div>
{% endtab %}

{% tab title="Google 商品カテゴリの不一致" %}
選択すると *エラー* の *商品カタログ* が表示されることがあります *Google 商品カテゴリの不一致* の *無効* 列にそれぞれの件数が表示されます。

これは、カタログ内の商品に使用されているカテゴリが、期待される [分類コード](https://www.google.com/basepages/producttype/taxonomy-with-ids.en-US.txt) （例: 7386）または Google が提供する完全なカテゴリ形式と一致していないことを意味します。完全なGoogleカテゴリ形式の例を以下に示します。

`動物・ペット用品 > ペット用品 > 鳥用品 > 鳥かごアクセサリー > 鳥かご用フード・ウォーターディッシュ`

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

<div data-with-frame="true"><figure><img src="https://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-a49a1b97a47722c72fe9bbb76fd2e902c1ca39ae%2F629fe5a5a308cd2ed6bd628db9c9c22547490d92bb19d1011d1657669d9b6296.png?alt=media" alt=""><figcaption></figcaption></figure></div>
{% endtab %}
{% endtabs %}
