> 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" %}
**重要:** 開始するには、アクティブな商品カタログが必要です。最初の商品アップロードを作成する方法については、 [商品カタログを追加する](/brand/ja/what-would-you-like-to-learn-about/platform-features/product-catalogs/add-product-catalogs-as-a-brand.md).
{% endhint %}

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

{% 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] → コンテンツ → 商品 → 商品プロモーション**.
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` のファイル。
   * 次を [*商品プロモーションフィードのフィールドリファレンス*](#para-idm73509110741608) これらのフィールドの詳細については以下を参照してください。
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] → コンテンツ → 商品 → 商品プロモーション**.
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` のファイル。
   * 次を [*商品プロモーションフィードのフィールドリファレンス*](#para-idm73509110741608) これらのフィールドの詳細については以下を参照してください。
6. 入力してください **名前** ファイルの *アップロードファイル名*.
   * [このテンプレートを表示](https://docs.google.com/spreadsheets/d/1OUr9Hoc2DRnS3KnyXwAetcgtho76ftej/edit?usp=sharing\&ouid=106843525620835185016\&rtpof=true\&sd=true) して、プロモーションをアップロードする際の参考にしてください。
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は数値形式で、スペースや記号を含めることはできません。例： `103330482`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| 適用範囲 `[product_applicability]`      | はい  | この属性は、プロモーションがすべての商品に適用されるか、特定の商品にのみ適用されるかを示します。 | <p>サポートされている値:</p><p>• <code>all\_products</code></p><p>• <code>specific\_products</code></p><p><strong>注：</strong> impact.com があなたの <a href="https://support.google.com/merchants/answer/2906014?hl=en">Googleプロモーションフィードファイル</a> 内の特定の商品と対応付けできるのは、 <a href="/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>が含まれている場合のみです。つまり、 <code>specific\_products</code> 値は、商品フィードにプロモーションIDが含まれていない場合は使用できません。</p> |
| 説明 `[long_title]`                   | はい  | 各プロモーションの完全なタイトル。                                | タイトルの最大長は60文字です。例： `購入でマグカップ無料`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| 有効 `[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>オンライン</code></p><p>• <code>店舗内</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| オファーコードの種類 `[offer_type]`           | はい  | この属性は、顧客がオファーを引き換えるためにクーポンコードが必要かどうかを示します。       | <p>サポートされている値:</p><p>• <code>コードなし</code></p><p>• <code>一般コード</code></p><p><strong>重要:</strong> この属性の値が <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>

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

<details>

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

次の *商品プロモーション* 画面の *健全性* 列で、 *エラー* または *警告* を選択すると、エラーの種類やエラーメッセージなど、エラーの詳細が表示されます。 [商品プロモーションファイルを管理する](/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} | アップロードファイル内で、必須フィールドのうち1つ以上が不足しています。    |
| 有効期限切れのためスキップされたレコード             | プロモーションの有効終了日は過去の日付のため、そのレコードはスキップされます。 |

</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.
