> 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/promo-codes/bulk-upload-promo-codes.md).
# プロモコードを一括アップロード
CSV、XLS、またはXLSXファイルから、一度に複数のトラッキングプロモコードを作成できます。ファイルをアップロードすると、impact.comが各行を検証するため、プロモコードを作成する前にエラーを確認して修正できます。
ファイルは、CSVの場合は最大5 MB、XLSおよびXLSXの場合は最大1 MBです。検証はファイルサイズのみに基づくため、行数に制限はありません。
## プロモコードをアップロードする
1. 左側のナビゲーションメニューから、次を選択します  **\[Engage]** → **コンテンツ** → [**プロモコード**](https://app.impact.com/secure/advertiser/engage/ads/view-adv-promo-codes-flow.ihtml).
2. 次の画面で *プロモコード* を選択します **一括アップロード**.
3. 必要に応じて、次を選択します **ダウンロード** サンプルテンプレートファイルを取得するには、または次を選択します **形式の詳細を表示** 必須の列を表示します。
4. 次を選択します **ファイルを選択**を選択し、ファイルを見つけて選択します。ファイルをページにドラッグ＆ドロップすることもできます。
5. 次を選択します **続行**.
6. 次を確認します *データプレビュー* テーブルを確認します。 *検証* 列には、 *承認済み* 準備ができた行、または変更が必要な行のエラーメッセージが表示されます。
* 必要に応じて行を並べ替えるには、列ヘッダーを選択するか、次を選択します **並べ替え順序**.
* 行のすべてのエラーを表示するには、次を選択します  **\[展開]** をプロモコードの横で選択します。 *エラープレビュー* には、各列、その値、および問題が一覧表示されます。
* エラーを修正するには、ファイルを更新し、次を選択します **キャンセル** をファイル名の横で選択してから、修正済みのファイルをアップロードします。
7. 次を選択します **承認してプロモコードを作成**。ボタンの横のメッセージには、impact.comが作成する承認済みプロモコードの数が表示されます。承認された行がない場合、ボタンは無効になります。
impact.comは承認済みのプロモコードを作成し、次の画面に戻ります *プロモコード* 画面。承認済みの行のみが作成されます。impact.comがプロモコードを作成中にエラーが発生すると、エラーコードを含むエラーメッセージが表示されます。サポートに連絡し、このコードを伝えてください。
一括アップロードをキャンセルするには、次を選択します  **\[閉じる]** を画面右上で選択してから、次を選択します **確認**.
{% hint style="success" %}
**注：** 開始日が未来のプロモコードには、 *保留中* ステータスが付きます。 *プロモコード* 画面には、 *有効なプロモコード* がデフォルトで表示されるため、 [*コードスケジュール* フィルター](/brand/ja/what-would-you-like-to-learn-about/platform-features/promo-codes/manage-your-promo-codes.md) を変更して検索してください。
{% endhint %}
## プロモコードファイルをフォーマットする
ファイルでは、大文字・小文字とピリオドを含め、以下に示す列名を正確に使用する必要があります。そうしない場合、アップロードは拒否されます。
| 列 | タイプ | 必須 | 説明 |
| ---------------------- | ------ | --- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `操作` | 文字列 | はい | 一括アップロード操作。許可される値： `CREATE`. |
| `media.id` | 整数 | はい | プロモコードが割り当てられるimpact.comメディアIDです。パートナーアカウントIDまたはメディアソースIDを指定できます。
各トラッキングプロモコードは、1つのパートナーまたはメディアソースにのみ割り当てることができます。別のパートナーがそのコードを宣伝した場合、impact.comは結果として生じるコンバージョンを無効としてフラグ付けし、取り消します。
|
| `code` | 文字列 | はい | 一意のプロモコード。山かっこ（`<`, `>`）または二重引用符を含めることはできません。 |
| `creditRule` | 文字列 | はい | プロモコードのクレジットルール。許可される値：
ALWAYS （常にクレジット）
INVOLVED （関与している場合にクレジット）
WINNER （勝者の場合にクレジット）
|
| `matchMode` | 文字列 | はい | プロモコードの一致モード。許可される値：
LI （完全一致／リテラル）
RE （正規表現）
|
| `deal.id` | 整数 | いいえ | 次のID [取引](/brand/ja/what-would-you-like-to-learn-about/platform-features/deals.md) をプロモコードに関連付けます。取引は、すでにプログラム内に存在している必要があります。 |
| `scheduling.startDate` | 日付 | はい | プロモコードが利用可能になる日時です。タイムゾーンオフセットなしのローカル日時を、次の形式で入力します `YYYY-MM-DDTHH:mm:ss` （例： `2026-10-01T00:00:00`). |
| `scheduling.endDate` | 日付 | はい | プロモコードの有効期限です。次と同じ形式を使用します `scheduling.startDate` （例： `2026-12-31T23:59:59`). |
| `scheduling.timezone` | 文字列 | はい | スケジュールされた日付のIANA（Internet Assigned Numbers Authority）タイムゾーン（例： `America/New_York`). |
| `emailAddresses` | CSV文字列 | いいえ | このプロモコードについて通知するメールアドレスのカンマ区切りリストです。 |
| `comments` | 文字列 | いいえ | この行の自由形式のコメントです。 |
例：この行では、プロモコード `10PEROFF` を、ニューヨーク時間で2026年10月1日から12月31日まで利用可能な、1つのパートナー向けに作成します。
```csv
Operation,media.id,code,creditRule,matchMode,deal.id,scheduling.startDate,scheduling.endDate,scheduling.timezone,emailAddresses,comments
CREATE,1299679,10PEROFF,ALWAYS,LI,,2026-10-01T00:00:00,2026-12-31T23:59:59,America/New_York,carrie.oakey@acmecorporation.io,Holiday promo
```
検証エラーの参照
| 検証メッセージ | 修正方法 |
| ------------------------------------------- | -------------------------------------------------- |
| *認識されない値* | 値が許可される値のいずれにも該当しないか、日付の形式が正しくありません。上記の表を確認してください。 |
| *値に山かっこ（<、>）または二重引用符を含めることはできません。* | プロモコードからこれらの文字を削除してください。 |
| *このプログラムにはすでにこのプロモコードが存在します。* | プログラム内にまだ存在しないプロモコードを使用してください。 |
| *メディアパートナー\[ID]はキャンペーン\[ID]に参加していません* | プログラムに参加しているパートナーまたはメディアソースのメディアIDを使用してください。 |
| *取引が見つかりません* | 既存の取引のIDを使用するか、次を `deal.id` 空白のままにします。 |
| *プロモコードのスケジュールされた手順では、CREATEのみがサポートされています。* | 設定 `操作` に設定します `CREATE`. |
---
# 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/promo-codes/bulk-upload-promo-codes.md?ask=&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.