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

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
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=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.