> 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-promotions/upload-product-promotion-files.md).

# 商品プロモーションファイルをアップロード

この *商品プロモーション* 機能を使うと、特別オファーやプロモーションをパートナーと共有できます。これらのオファーは、パートナーの商品フィード、商品API、impact.comの商品マーケットプレイスに表示され、 *特別オファー* タグが検索結果の商品タイルに直接表示されます。

{% hint style="warning" %}
**重要：** 開始する前に、有効な商品カタログが必要です。初めての商品データをアップロードする方法については、 [商品カタログを追加する](https://help.impact.com/brand/ja/what-would-you-like-to-learn-about/platform-features/product-catalogs/add-product-catalogs-as-a-brand.md).
{% endhint %}

#### プロモーションファイルをアップロードする

ファイルを作成するには、 [プロモーションファイルのテンプレート](https://docs.google.com/spreadsheets/d/1OUr9Hoc2DRnS3KnyXwAetcgtho76ftej/edit?usp=sharing\&ouid=106843525620835185016\&rtpof=true\&sd=true) を使用してください。どちらのアップロード方法でも同じファイル形式を使用できます。

{% tabs %}
{% tab title="直接アップロード" %}

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-product-promotion-flow.ihtml).
2. 右上隅で、 **プロモーションファイルをアップロード**.
3. を選択し、 **プロモーションファイル名**.
4. を入力します。 ![](https://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-590bdf4e1ffbcc1fe86ad456bebab6a28c64af1f%2Ffd6e4291628446bb1fe27a831f7874b256a28cc84833d72cce2e73b94641edb7.svg?alt=media) **\[ラジオボタン]** **直接アップロード** 方法を選択します。
5. ファイルの **形式**.
   * impact.comがサポートしているのは、 *Google Merchant Center（TXT形式）* （例： `.txt` ）と *Google Merchant Center（CSV形式）* （例： `.csv` ファイルのみです。
   * 各フィールドの詳細については、以下の *商品プロモーションフィードのフィールドリファレンス* をご覧ください。
6. を選択し、 **ファイルを選択**.
   * アップロードするファイルをコンピューターから選択します。
7. 使用する **言語** を選択し、 **保存**.
   {% endtab %}

{% tab title="URLから取得" %}
このオプションでは、FTP/SFTPサーバーまたはHTTP/HTTPS URLからファイルを取得し、プロモーションデータを最新の状態に保てます。

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-product-promotion-flow.ihtml).
2. 右上隅で、 **プロモーションファイルをアップロード**.
3. を選択し、 **プロモーションファイル名**.
4. アップロード方法として ![](https://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-590bdf4e1ffbcc1fe86ad456bebab6a28c64af1f%2Ffd6e4291628446bb1fe27a831f7874b256a28cc84833d72cce2e73b94641edb7.svg?alt=media) **\[ラジオボタン]** **URLから取得** を選択します。
5. ファイルの **形式**.
   * impact.comがサポートしているのは、 *Google Merchant Center（TXT形式）* （例： `.txt` ）と *Google Merchant Center（CSV形式）* （例： `.csv` ファイルのみです。
   * 各フィールドの詳細については、以下の *商品プロモーションフィードのフィールドリファレンス* をご覧ください。
6. 次の項目を入力します。 **名前** のファイルを次の欄に入力します： *アップロードファイル名*.
7. 次の項目に入力します： **取得URL** プロモーションデータファイルがあるディレクトリを指すURLです。
   * このURLにはFTPまたはHTTPSのURLを指定できます。例： `ftp://ftp.acme.com` または `https://acme.com/anvil_promotions/anvil.txt`
8. 次の項目を選択します： **取得頻度** impact.comがファイルを取得する頻度：
   * 毎日
   * 8時間ごと
   * 4時間ごと
   * 2時間ごと
9. 次の項目を選択します： **取得時刻** impact.comがファイルを取得する時刻です。
   * 表示されるオプションはGMT -05:00（米国東部時間）です。
10. 次の項目を選択します： **タイムゾーン**.
11. 使用する **言語** を選択し、 **保存**.
    {% endtab %}
    {% endtabs %}

<details>

<summary>商品プロモーションフィードのフィールドリファレンス</summary>

| 想定されるフィールド                          | 必須？ | 説明                                                | 形式                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| ----------------------------------- | --- | ------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ID `[promotion_id]`                 | はい  | 各プロモーションを一意に識別するIDです。                             | IDは大文字と小文字を区別し、最大50文字です。スペースや記号は使用できません。例： `103330482`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| 適用対象 `[product_applicability]`      | はい  | この属性は、プロモーションがすべての商品に適用されるか、特定の商品にのみ適用されるかを指定します。 | <p>サポートされている値:</p><p>• <code>all\_products</code></p><p>•<code>specific\_products</code></p><p>impact.comがプロモーションを <a href="https://support.google.com/merchants/answer/2906014?hl=en">Googleプロモーションフィードファイル</a> 内の特定の商品に関連付けるには、 <a href="https://help.impact.com/brand/ja/what-would-you-like-to-learn-about/platform-features/product-catalogs/add-product-catalogs-as-a-brand.md">商品カタログ</a> に <code>promotion\_id</code>が含まれている必要があります。商品カタログにプロモーションIDが含まれていない場合、 <code>specific\_products</code> の値は使用できません。詳しくは、 <a href="#link-promotions-to-specific-products">プロモーションを特定の商品に関連付ける</a>.</p> |
| 説明 `[long_title]`                   | はい  | 各プロモーションの正式なタイトル。                                 | タイトルは最大60文字です。例： `Free mug with purchase`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| 有効期間 `[promotion_effective_dates]`  | はい  | プロモーションの期間。                                       | <p>•  <strong>開始</strong> と <strong>終了</strong> 日付はスラッシュ（/）で区切ります。</p><p>• 日付形式は（YYYY-MM-DD）で、その後に「T」、セールの開始時刻または終了時刻、およびセールのタイムゾーンを表す文字列が続きます。</p><p>• 例： <code>2009-07-19T03:00:00+00:00/2009-07-26T21:00:00+00:00</code></p>                                                                                                                                                                                                                                                                                                                                                                       |
| 表示 `[promotion_display_dates]`      | いいえ | この属性では、プロモーションが有効になる日付と期間を指定します。                  | 開始 **開始** および **終了** 日付はスラッシュ（/）で区切ります。例： `2009-07-19T03:00:00+00:00/2009-07-26T21:00:00+00:00`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| チャネル `[redemption_channel]`         | はい  | この属性は、プロモーションがオンラインまたは店舗で有効であることを示します。            | <p>サポートされている値:</p><p>• <code>online</code></p><p>• <code>in\_store</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| オファーコードの種類 `[offer_type]`           | はい  | この属性は、顧客がオファーを利用する際にクーポンコードが必要かどうかを示します。          | <p>サポートされている値:</p><p>• <code>no\_code</code></p><p>• <code>generic\_code</code></p><p><strong>重要:</strong> この属性の値が <code>generic\_code</code>、その後 <code>generic\_redemption\_code</code> は必須です。</p>                                                                                                                                                                                                                                                                                                                                                                                                   |
| オファーコード `[generic_redemption_code]` | いいえ | この属性は、オンラインでプロモーションを利用する際に使用できるコードを指定します。         | 最大長は20文字です。例： `EXTRA20`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| 遷移先 `[promotion_destination]`       | いいえ | この属性は、各プロモーションの形式を指定します。                          | <p>サポートされている値:</p><p>• <code>Shopping\_ads</code></p><p>•<code>Buy\_on\_Google\_listings</code></p><p>• <code>Free\_listings</code></p><p>プロモーションを1つ以上の配信先に送信するには、配信先ごとに別の列として値を入力してください。</p>                                                                                                                                                                                                                                                                                                                                                                                                         |

</details>

#### プロモーションを特定の商品に関連付ける

プロモーションが一部の商品にのみ適用される場合は、 `product_applicability` を `specific_products` に設定して、プロモーションファイルに記載します。次に、対象となる各商品の商品カタログにプロモーションのIDを追加し、impact.comが商品とプロモーションを照合できるようにします。すべての商品に適用される場合は、 `all_products` を使用し、これらの手順は省略してください。

1. プロモーションファイルで、プロモーションに一意の `promotion_id`を指定します。例： `103330482`.
2. Google Merchant Centerの商品カタログに `promotion_id` フィールドを追加します。
   * impact.comがサポートするGoogle Merchant Centerのファイル形式については、 [商品カタログのファイル形式](https://help.impact.com/brand/ja/what-would-you-like-to-learn-about/platform-features/product-catalogs/file-formats-for-product-catalogs.md) をご覧ください。
3. プロモーションの適用対象となる各商品に、同じ `promotion_id` の値を入力します。
   * 大文字と小文字を含め、値が完全に一致している必要があります。
4. 更新した商品カタログとプロモーションファイルをアップロードします。
   * 詳しくは、 [商品カタログを追加する](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-a-promotion-file).
   * プロモーションは、商品カタログ内の `promotion_id` が一致する商品にのみ適用されます。

{% hint style="info" %}
**例：** 「 *購入するとマグカップをプレゼント* 」プロモーションはコーヒー豆とフレンチプレスに適用されますが、やかんには適用されません。説明をわかりやすくするため、その他の必須列は省略しています。
{% endhint %}

プロモーションファイル：

| promotion\_id | product\_applicability | long\_title      |
| ------------- | ---------------------- | ---------------- |
| 103330482     | specific\_products     | 購入するとマグカップをプレゼント |

商品カタログ：

| id       | title      | promotion\_id |
| -------- | ---------- | ------------- |
| SKU-1001 | コーヒー豆、1 kg | 103330482     |
| SKU-1002 | フレンチプレス    | 103330482     |
| SKU-1003 | ティーケトル     |               |

#### エラーと警告メッセージのトラブルシューティング

<details>

<summary>エラーと警告を表示する</summary>

「 *製品プロモーション* 」画面の「 *健全性* 」列で「 *エラー* 」または「 *警告* 」を選択すると、エラーの種類やエラーメッセージなどの詳細を確認できます。詳しくは、 [製品プロモーションファイルの管理](https://help.impact.com/brand/ja/what-would-you-like-to-learn-about/platform-features/product-promotions/manage-your-product-promotion-files.md) を参照してください。プロモーションファイルの状態 *健全性* に関する詳細が記載されています。

</details>

<details>

<summary>エラーを検索してフィルタリングする</summary>

ファイルの「 *エラー* 」と「 *警告* 」をクリックし、検索フィールドとフィルターを使用して、アップロードされたプロモーションファイルのエラーを絞り込むことができます。

*エラーの種類* フィルターには以下が含まれます。

* すべて
* 警告
* エラー
* 複製

</details>

<details>

<summary>エラーと警告メッセージ</summary>

| エラーメッセージ                                         | 説明                                        |
| ------------------------------------------------ | ----------------------------------------- |
| Required field(s) missing:{Required field}       | アップロードファイルに1つ以上の必須フィールドがありません。            |
| Records skipped due to an expired effective date | プロモーションの有効終了日が過去の日付であるため、そのレコードはスキップされます。 |

</details>


---

# 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-promotions/upload-product-promotion-files.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.
