# 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%2FJZUEnGwGzclqEoxytkpg%2Fimage1.jpg?alt=media&#x26;token=2411fab1-369d-41ac-8061-7cd222024542" 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%2Fgit-blob-d0b6669ae76a7bef06a8d6940d7ad5c16bb8d018%2F7cb018d4face8d7cceb880eb5086c812e764fbcfe6f2a0377f88bc7576973070.svg?alt=media) **\[オンにする]** ことで、報酬がユーザーに使用可能になる前に（例：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%2F4FJcNAj9poM9VKuQ74dW%2Fimage2.jpg?alt=media&#x26;token=856d4d41-7ca3-47ed-a774-71127c5c0e23" 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&#x26;token=232b052b-b167-4613-81d1-581178951f27" alt=""><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}
