# 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]**&#x3067;示されます）、 **エラーレポートをダウンロード** を選択してファイルを修正し、再試行してください。また、 **レポートをダウンロード** を選択すると、作成されるすべての報酬の記録を取得できます。エラーの有無にかかわらず、確認のために推奨されます。
2. **確認**：テストが成功した場合（ ![](/files/c06e91ab7efd9770a84fd6ea87dc52088c52a255) **\[Checkmark]**&#x3067;示されます）、 **インポートを実行**.
3. 確認モーダルが表示され、合計の影響が要約されます（例：「このインポートを実行すると412件の報酬が作成されます」）。 **インポートを実行** を選択して、確認し報酬を支払います。

続行しないことにした場合は、実行をキャンセルしてから、Discard を選択してテスト実行を削除できます。

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


---

# Agent Instructions: 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:

```
GET https://help.impact.com/brand/ja/nitsuitebitaidesuka/advocate-program/advocate-rewards/advocatedewosuru.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.