For the complete documentation index, see llms.txt. This page is also available as Markdown.

Advocateで現金報酬を一括作成する

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

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

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

まず、報酬を付与したいユーザーの一覧を含むCSVまたはJSONLファイルが必要です。

  • 必須列:ファイルには少なくとも userId ユーザーを識別するための

  • 任意列:報酬の詳細(例:金額、単位、種類)をファイルに含めることができます。あるいは、次のように設定することをおすすめします グローバルのデフォルト として、インポート処理中にプラットフォーム側で設定すると、ファイルを簡略化できます。

ファイル列の参照

userId

ユーザーの一意のID。

必須

assignedCreditInCurrencyBaseUnit

付与する金額(例:50)。

条件付き (グローバルのデフォルトが設定されている場合は不要)

rewardUnit

報酬の単位(例:USD、POINTS)。

条件付き (グローバルのデフォルトが設定されている場合は不要)

globalRewardKey

付与する事前設定済み報酬のキー。

条件付き (グローバルのデフォルトが設定されている場合は不要)

discountPercent

割引として付与する金額

条件付き (グローバルのデフォルトが設定されている場合は不要)

dateScheduledFor

この日付まで報酬を保留します。

任意

uniqueId

トランザクションの一意の識別子。

推奨 ファイルを再実行した場合に重複報酬を防ぐ安全キーとして使用されます。

customerNote

顧客に表示されるメモを追加します。

任意

internalNote

顧客には表示されない、社内用のメモを追加します。

任意

1

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

  1. 左側のナビゲーションメニューで次を選択します [Engage] → レポート → インポートとエクスポート.

  2. 右上隅で、 インポート.

  3. 次の項目の下の インポートタイプの下にある 報酬.

事前設定値(グローバルのデフォルト)を設定する

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

  • 報酬:事前設定済みの報酬を選ぶか、手動の単位(例:「Cash/USD」)を指定します。

  • プログラム:レポート目的で、これらの報酬を特定のプログラムに関連付けます。

  • 報酬保留期間: [オンに切り替える] ユーザーが報酬を利用できるようになる前に、安全余裕期間(例:30日)を追加します。これにより、必要に応じて取り消しを行う時間を確保できます。

2

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

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

  1. 次の項目で インポート対象ユーザーのCSVまたはJSONLファイルをアップロードします 選択 ファイルを選択.

  2. 選択して テストインポートを実行 して、テスト状態を開始します。

  3. システムはファイルを処理します ことなく 報酬を作成します。

3

確認して完了する

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

  1. 確認:エラーがある場合(次の表示で示されます [Exclaimation])、 エラーレポートをダウンロード してファイルを修正し、再試行します。また、 レポートをダウンロード して、作成されるすべての報酬の記録を取得します。エラーの有無にかかわらず、確認用にダウンロードすることをおすすめします。

  2. 確認:テストが成功した場合(次の表示で示されます [Checkmark])、 インポートを実行.

  3. 合計の影響を要約した確認モーダルが表示されます(例:「このインポートを実行すると412件の報酬が作成されます」)。選択 インポートを実行 して、報酬の確定と支払いを行います。

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

最終更新

役に立ちましたか?