> 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. 左側のナビゲーションメニューで次を選択します ![](/files/7ddd72d8e69e7055d9408cf4847c5c54abf9f71d) **\[Engage] → レポート → インポートとエクスポート**.
2. 右上隅で、 **インポート**.
3. 次の項目の下の *インポートタイプ*の下にある **報酬**.

<div data-with-frame="true"><figure><img src="/files/c9279dafff092f99da504ba75845a3ffbc57c6fd" alt=""><figcaption></figcaption></figure></div>

**事前設定値（グローバルのデフォルト）を設定する**

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

* **報酬**：事前設定済みの報酬を選ぶか、手動の単位（例：「Cash/USD」）を指定します。
* **プログラム**：レポート目的で、これらの報酬を特定のプログラムに関連付けます。
* **報酬保留期間**: ![](/files/966a7b9c51811043ca7c1811ec6f6b9ef39fd26f) **\[オンに切り替える]** ユーザーが報酬を利用できるようになる前に、安全余裕期間（例：30日）を追加します。これにより、必要に応じて取り消しを行う時間を確保できます。

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

{% step %}

#### アップロードとドライラン

現金報酬は確定であり取り消しできないため、システムではドライラン（テストインポート）が必要です。これにより、報酬を処理する前に詳細を安心して確認できます。

1. 次の項目で *インポート対象ユーザーのCSVまたはJSONLファイルをアップロードします* 選択 **ファイルを選択**.
2. 選択して **テストインポートを実行** して、テスト状態を開始します。
3. システムはファイルを処理します **ことなく** 報酬を作成します。

<div data-with-frame="true"><figure><img src="/files/bae54714dbb7a00e502c98b852be33294fc4c905" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

#### 確認して完了する

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

1. **確認**：エラーがある場合（次の表示で示されます ![](/files/23e28077dcefa89ff564104723ea19318b4c8b02) **\[Exclaimation]**）、 **エラーレポートをダウンロード** してファイルを修正し、再試行します。また、 **レポートをダウンロード** して、作成されるすべての報酬の記録を取得します。エラーの有無にかかわらず、確認用にダウンロードすることをおすすめします。
2. **確認**：テストが成功した場合（次の表示で示されます ![](/files/c06e91ab7efd9770a84fd6ea87dc52088c52a255) **\[Checkmark]**）、 **インポートを実行**.
3. 合計の影響を要約した確認モーダルが表示されます（例：「このインポートを実行すると412件の報酬が作成されます」）。選択 **インポートを実行** して、報酬の確定と支払いを行います。

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

<div data-with-frame="true"><figure><img src="/files/b9c4ef0bd473c51596144b5ae8e9ce6338fa56c2" 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.