> 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>トランザクションの一意識別子。</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" %}
**注**: ここで値（例: Reward Unit: 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 %}

#### 確認して確定する

テスト実行が完了すると、Imports & Exports一覧にステータス項目が表示されます。レビュー処理の一環としてメールが送信される場合があります（ギフトカード、支払い設定など）。

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