> 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/advocate-program/advocate-rewards/create-bulk-cash-rewards-with-advocate.md).

# Advocateで大量の現金報酬を作成する

紹介によるコンバージョンなど、多くの報酬はプログラムのルールに基づいて自動的に付与されますが、アンケートへの回答やコンテストでの優勝など、手動またはオフラインでのアクションに対して参加者に報酬を付与する必要がある場合もあります。

「 **一括報酬** 」インポートツールを使うと、CSVファイルをアップロードして、複数のアドボケイトに現金、ポイント、ギフトカードを一度に付与できます。この機能には、資金が支払われる前にデータが正しいことを確認できるドライランの安全機能が含まれています。

### インポートファイルを準備する

{% hint style="success" %}
**注**：グローバルインポート設定を使用する場合は、 `userId` のリストのみを送信すれば済みます。
{% endhint %}

まず、報酬を付与するユーザーの一覧を含むCSVまたはJSONLファイルを用意します。

* **必須列**：ファイルには最低限、次の列を含める必要があります `userId` ユーザーを識別するための列です。
* **任意の列**：報酬の詳細（例：金額、単位、種類）をファイルに含めることができます。または、ファイルを簡潔にするため、インポート中にプラットフォームで次の項目を *グローバルのデフォルト値* として設定することをおすすめします。

#### ファイル列のリファレンス

<table data-header-hidden><thead><tr><th width="297.484375">列</th><th>説明</th><th>要件</th></tr></thead><tbody><tr><td><code>userId</code></td><td>ユーザーの一意のID。</td><td><mark style="color:$danger;">必須</mark></td></tr><tr><td><code>assignedCreditInCurrencyBaseUnit</code></td><td>付与する金額（例：50）。</td><td>条件付き<br>（グローバルデフォルトが設定されている場合は不要）</td></tr><tr><td><code>rewardUnit</code></td><td>報酬の単位（例：USD、POINTS）。</td><td>条件付き<br>（グローバルデフォルトが設定されている場合は不要）</td></tr><tr><td><code>globalRewardKey</code></td><td>付与する、事前設定済み報酬のキー。</td><td><p>条件付き<br>（グローバルデフォルトが設定されている場合は不要）</p><p><br></p></td></tr><tr><td><code>discountPercent</code></td><td>割引として付与する金額</td><td>条件付き<br>（グローバルデフォルトが設定されている場合は不要）</td></tr><tr><td><code>dateScheduledFor</code></td><td>この日付まで報酬を保留します。</td><td>任意</td></tr><tr><td><code>uniqueId</code></td><td>取引を一意に識別するID。</td><td><mark style="color:$success;">推奨</mark><br>ファイルを再実行した場合に報酬が重複しないよう、安全キーとして使用されます。</td></tr><tr><td><code>customerNote</code></td><td>顧客に表示されるメモを追加します。</td><td>任意</td></tr><tr><td><code>internalNote</code></td><td>顧客には表示されない、社内用のメモを追加します。</td><td>任意</td></tr></tbody></table>

{% stepper %}
{% step %}

#### インポート設定を構成する

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. 「 *インポートの種類*」で、 **リワード**.

<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%2FNCv4EHK61ypIahnjieFB%2FScreenshot%202026-05-19%20at%2010.12.35.png?alt=media&amp;token=1b2a3fe3-f3ba-4bff-9612-a47317c223f7" alt=""><figcaption></figcaption></figure></div>

**プリセット値（グローバルデフォルト）の設定**

時間を節約し、CSVファイルのエラーを減らすために、インポートするすべての行に適用されるプリセット値を定義できます。

* **報酬**：事前に設定された報酬を選択するか、単位を手動で指定します（例："Cash/USD"）。
* **プログラム**：レポートのために、これらの報酬を特定のプログラムに関連付けます。
* **報酬の保留期間**: ![](https://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FiZjM1xY8o3v1iR3Zaysd%2FToggle.svg?alt=media\&token=b1550d48-bba9-4e81-8604-bc12370c5caa) **［オンに切り替え］** にして、ユーザーが報酬を利用できるようになるまでの猶予期間（例：30日）を設けます。これにより、必要に応じて報酬を取り消す時間を確保できます。

{% hint style="success" %}
**注**：ここで値を設定した場合（例：報酬単位：USD）、CSVファイルにその列を **含める必要はありません** 。
{% endhint %}
{% endstep %}

{% step %}

#### アップロードとテスト実行

現金報酬は確定後に取り消せないため、システムでは、報酬を処理する前に詳細を確認できるよう、テスト実行（テストインポート）が必要です。

1. 「 *インポートするユーザーのCSVまたはJSONLファイルをアップロード* 」で「 **ファイルを選択」を選択します。**.
2. 「 **テストインポートを実行** 」を選択してテストを開始します。
3. システムは報酬を **作成せずに** ファイルを処理します。

<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%2FXzOTAlFdV9PBePeTWjd2%2FScreenshot%202026-05-19%20at%2010.15.36.png?alt=media&amp;token=859ccc75-e655-4002-b915-b8225028ddff" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

#### 確認と確定

テスト実行が完了すると、インポートとエクスポートの一覧にステータスが表示されます。確認プロセスの一環として、メール（ギフトカード、支払い設定など）が送信される場合があります。

1. **確認**：エラーがある場合（ ![](https://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F42gbg9NHA1obODpwpxh1%2Ficons8-high-importance-16.png?alt=media\&token=80a809ae-ca8e-43d4-af95-a416a44c8ec3) **［感嘆符］**&#x3067;表示）、「 **エラーレポートをダウンロード** 」を選択してファイルを修正し、再試行します。また、「 **レポートをダウンロード** 」を選択すると、作成予定のすべての報酬の記録を取得できます。エラーの有無にかかわらず、確認のためにダウンロードすることをおすすめします。
2. **確定**：テストが成功した場合（ ![](https://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FvdMZSNCvTeUSIm6qrJ5o%2Ficons8-check-16.png?alt=media\&token=998fe3ad-c8a2-4dbc-bdc0-8f79e246b314) **［チェックマーク］**&#x3067;表示）、「 **インポートを実行」を選択します。**.
3. 全体への影響をまとめた確認画面が表示されます（例：「このインポートを実行すると、412件の報酬が作成されます」）。「 **インポートを実行** 」を選択して確定し、報酬を支払います。

続行しない場合は、実行をキャンセルし、「破棄」を選択してテスト実行を削除できます。

<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%2FNa7x8cn8GL73umRhPqxk%2Fimage3.jpg?alt=media&amp;token=232b052b-b167-4613-81d1-581178951f27" alt=""><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}


---

# 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/advocate-program/advocate-rewards/create-bulk-cash-rewards-with-advocate.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.
