# アドボケイトプログラムレポートの解説

<a href="https://pxa.impact.com/student/activity/1687872?sid=0c0e3e5c-54c9-4435-9bee-ebcdccb7f292&#x26;sid_i=0?utm_source=app.impact.com&#x26;utm_medium=owned-platform&#x26;utm_content=&#x26;utm_campaign=help-center" class="button primary">PXAコースを受講する</a>

Advocateでは、プログラムおよび参加者データ向けに、さまざまなダウンロード可能なレポートを提供しています。すべてのレポートにはフィルタリングオプションがあり、ダウンロードするデータをより細かく制御できます。各レポートは .CSV または Excel ファイルとしてダウンロードできます。

この記事では、各レポートの違いと、それぞれに含まれるデータの種類について説明します。手順については、 [Advocateプログラムレポートを実行する](https://help.impact.com/brand/ja/nitsuitebitaidesuka/advocate-program/advocate-reporting-and-analytics/run-an-advocate-program-report) を参照してください。

#### ユーザー詳細レポート

&#x20; *ユーザー詳細* レポートには、すべてのプログラムにおける各参加者の詳細情報が含まれます。参加者全員の一覧をエクスポートして、Advocateの共有リンクと紹介コードを含め、記録を最新の状態に保ちましょう。

<details>

<summary>レポートの詳細</summary>

デフォルトでは、レポートには次のような参加者情報が含まれます:

* 名前
* ユーザーIDとアカウントID
* メールアドレス
* カスタムフィールド
* セグメント
* 紹介情報（該当する場合）

レポート生成時に、必要に応じて次の項目を含めることができます:

* **ユーザー統計**、参加者に関するトラフィック、収益などの分析情報を含みます。
* **紹介共有リンクとコード**、該当する場合。これは、各参加者のAdvocate共有リンクとコードを含めるために、CMSやメールシステムで連絡先レコードを更新する際に役立ちます。

フィールドの完全な一覧は、 [サンプルCSVをダウンロード](https://assets.ctfassets.net/s68ib1kj8k5n/7Am85AH6wmNdArmjRNW3vr/95f52c5d79311509d795a0be4c94166f/User_Details_Report_Sample.csv) ![](https://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-06e12321258e7eb7ac63ef7e73640b29fcf2baad%2Fcff634f1183ca82d3b56ab55dd636140372687d8dbc6520872cdbe5010347326.svg?alt=media) ユーザー詳細レポート

**レポートの列の参照**

| 列                        | 説明                                                                                                                   |
| ------------------------ | -------------------------------------------------------------------------------------------------------------------- |
| **ユーザー情報**               |                                                                                                                      |
| ID                       | Advocateシステム内で参加者を一意に識別するIDです。                                                                                       |
| アカウントID                  | 参加者のアカウントを一意に識別するIDです（該当する場合、複数のプログラム間で使用されます）。                                                                      |
| メール                      | 参加者のメールアドレスです。                                                                                                       |
| 名                        | 参加者の名です。                                                                                                             |
| 姓                        | 参加者の姓です。                                                                                                             |
| メールハッシュ                  | 参加者のメールをハッシュ化（暗号化）したものです。プライバシーに配慮した他システムとの照合に役立ちます。                                                                 |
| **紹介＆共有情報**              |                                                                                                                      |
| 紹介コード                    | 参加者に紐づく一意のコードで、参加者が獲得した紹介を追跡するために使用されます。                                                                             |
| 共有リンク                    | 参加者に関連付けられた一意の紹介リンクです。                                                                                               |
| Facebook共有リンク            | Facebookで紹介を共有するための事前生成済みリンクです。                                                                                      |
| Twitter共有リンク             | Twitterで紹介を共有するための事前生成済みリンクです。                                                                                       |
| メール共有リンク                 | メールで紹介を共有するための事前生成済みリンクです。                                                                                           |
| LinkedIn共有リンク            | LinkedInで紹介を共有するための事前生成済みリンクです。                                                                                      |
| クリーン共有リンク                | 追跡パラメータのない紹介リンクのバージョンです。特定のプラットフォームや用途ではより中立的です。                                                                     |
| **ジオロケーション＆ロケール**        |                                                                                                                      |
| 最初に検出されたIP               | 参加者が最初に記録されたIPアドレスです。                                                                                                |
| 最後に検出されたIP               | この参加者について最も最近検出されたIPアドレスです。                                                                                          |
| ロケール                     | 参加者の優先言語および地域設定です（例: en-US）。                                                                                         |
| 国コード                     | ロケールまたはIPアドレスに基づく参加者の国です（例: ZA、US）。                                                                                  |
| **タイムスタンプ**              |                                                                                                                      |
| 作成日時                     | Advocateで参加者アカウントが作成された日時です。                                                                                         |
| 米国税務フォーム提出日              | （該当する場合）コンプライアンスまたは報酬処理のために米国税務フォームが提出された日付です。                                                                       |
| **ユーザー統計（エクスポートに含めた場合）** |                                                                                                                      |
| stats.date Modified      | 参加者の統計が最後に更新された日付です。                                                                                                 |
| stats.traffic            | 参加者の紹介活動によって発生した訪問数の合計です。                                                                                            |
| stats.referrals          | 参加者が成立させた紹介の成功件数の合計です。                                                                                               |
| stats.conversions        | それらの紹介から発生したコンバージョン（例: 購入、登録）の合計件数です。                                                                                |
| stats.goals              | 参加者の紹介活動に関連する特定の目標達成数です（プログラム内でカスタム定義）。                                                                              |
| stats.rewards            | 参加者が獲得した報酬の総数です。                                                                                                     |
| stats.widget Loads       | この参加者によって紹介ウィジェットまたは共有インターフェースが読み込まれた回数です。                                                                           |
| stats.revenue            | この参加者から紹介されたユーザーによって生み出された総収益です。                                                                                     |
| stats.generated Revenue  | stats.revenueと同義です。レポートによっては、収益の発生源が複数ある場合に区別されることがあります。                                                             |
| stats.referred Revenue   | この参加者の紹介リンクを通じて登録または購入した参加者に直接帰属する収益です。                                                                              |
| **カスタムデータ**              |                                                                                                                      |
| custom Fields.example    | プログラムで定義した任意のカスタムフィールドのプレースホルダーです（例: *ロイヤルティID*, *内部メモ*, *地域タグ*）。各フィールドは独立した列として表示され、custom Fields. がプレフィックスとして付きます。 |
| **その他**                  |                                                                                                                      |
| 紹介元                      | 参加者がプログラムにたどり着いた元のソースまたはチャネルです（例: *オーガニック*, *メール*, *パートナーサイト*).                                                      |

</details>

#### ユーザーイベントのエクスポート

&#x20; *ユーザーイベントエクスポート* レポートは、あなたの組織からAdvocateプログラムへ送信されたすべてのユーザーイベントの記録を提供します。フィルターを適用して、期間、イベントキー、ユーザーIDなどを絞り込むことができます。

<details>

<summary>レポートの詳細</summary>

デフォルトでは、レポートには次の項目が含まれます:

* イベントID
* イベントキー
* ユーザーIDとアカウントID
* トリガー日時
* 受信日時
* 処理日時

**レポートの列の参照**

| 列                                  | 説明                                                                                   |
| ---------------------------------- | ------------------------------------------------------------------------------------ |
| **イベント＆ユーザー情報**                    |                                                                                      |
| イベントID                             | 受信した各イベントごとに生成される一意のIDです。イベント送信の追跡、デバッグ、監査に役立ちます。                                    |
| イベントキー                             | イベントの種類またはラベルです。たとえば `purchase`, `signup`や、システムが送信する任意のカスタム定義キーなどです。                 |
| ユーザーID                             | イベントが関連付けられているAdvocate内の参加者の一意の識別子です。                                                |
| アカウントID                            | ユーザーに紐づくアカウントIDで、特にユーザーが異なるアカウント構造に属する可能性があるプログラムで重要です。                              |
| **イベントのタイムスタンプ**                   |                                                                                      |
| イベント発生日時 – YYYY-MM-DD              | イベントが実際に発生した日付です（システムから報告されたもの）。たとえば、購入や登録が行われた日付です。                                 |
| イベント受信日 – YYYY-MM-DD               | Advocateがイベントをあなたのシステムから受信した日付です。バッチ処理やシステム遅延により、トリガー日時と異なる場合があります。                  |
| イベント処理日 – YYYY-MM-DD               | イベントが正常に処理され、Advocateに保存された日付です。イベントが追跡、報酬、レポートに利用可能になった時点を示します。                     |
| **イベントデータフィールド（イベントペイロードに含まれる場合）** |                                                                                      |
| fields.coupon                      | イベントデータに含まれて送信された場合の、イベント中に適用されたクーポンまたは割引コードです。インセンティブの利用状況や特定のプロモーショントリガーの追跡に役立ちます。 |
| fields.revenue                     | イベントに関連する収益額です。通常、購入イベントでパフォーマンス、報酬、ROIを算出するために使用されます。                               |
| fields.currency                    | 通貨コード（例: *USD*, *ZAR*, *EUR*）で、収益額に紐づきます。地域をまたぐレポートや為替調整後の報酬計算の際に重要です。               |
| fields.lead Created Date           | イベントの一部として送信された場合の、リード（ユーザー）がシステム内で作成された元の日付です。ユーザーイベントを元の獲得日やCRMレコードと結びつけるのに役立ちます。  |

</details>

#### 報酬履歴

&#x20; *報酬履歴* レポートは、各報酬の詳細記録と、参加者および紹介との関係を提供します。この情報は、貸借対照表の作成や、特定時点でのすべての報酬の状況把握に役立ちます。

<details>

<summary>レポートの詳細</summary>

デフォルトでは、レポートには **報酬フィールド** 情報として次のような項目が含まれます:

* 報酬ID
* 報酬タイプ
* 報酬額

含まれるフィールドの完全な一覧は、 [サンプルCSVをダウンロード](https://assets.ctfassets.net/s68ib1kj8k5n/7E5DNWKrh7iQMNGYQBWRiS/3ae6c7a9109542215763a07a18cb0494/Reward_Details_Example_Report_CSV.csv), [サンプルExcel](https://assets.ctfassets.net/s68ib1kj8k5n/2MQjc4XjXGPNhsv10tHal6/dc40679812b99d0aef4ace46a780e1ee/Reward_Details_Example_Report_XLSX.xlsx) ![](https://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-06e12321258e7eb7ac63ef7e73640b29fcf2baad%2Fcff634f1183ca82d3b56ab55dd636140372687d8dbc6520872cdbe5010347326.svg?alt=media) または [サンプルJSONL](https://assets.ctfassets.net/s68ib1kj8k5n/5BeuDmYM1WFAySjqntGeji/f321cf59a96d45061645d971e06fb569/Reward_Details_Example_Report_JSONL.jsonl) ![](https://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-06e12321258e7eb7ac63ef7e73640b29fcf2baad%2Fcff634f1183ca82d3b56ab55dd636140372687d8dbc6520872cdbe5010347326.svg?alt=media) 報酬詳細レポート

レポート生成時に、必要に応じて次の項目を含めることができます:

* **参加者の詳細** 名前、ユーザーIDとアカウントID、メールアドレス、カスタムフィールド、セグメント、紹介情報（該当する場合）など。
* **紹介フィールド** 紹介ID、顧客アドボケートフィールド、紹介された友人のフィールドなど。

**レポートの列の参照**

| 列                                                                                                                  | 説明                                                                                                                         |
| ------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------- |
| **報酬情報**                                                                                                           |                                                                                                                            |
| ID                                                                                                                 | 報酬インスタンスの一意のID（Advocateによって生成）。                                                                                            |
| タイプ                                                                                                                | 報酬のカテゴリまたは種類です（例: *現金*, *ギフトカード*, *クーポン*, *カスタム*).                                                                         |
| 値                                                                                                                  | 報酬の数値です（例: 10、100 など）。                                                                                                     |
| 単位                                                                                                                 | 値に関連する単位です（例: *USD*, *ポイント*, *ZAR*, *%*).                                                                                  |
| 名前                                                                                                                 | 報酬の表示名です（ [報酬設定](https://help.impact.com/brand/ja/nitsuitebitaidesuka/advocate-program/advocate-rewards/create-a-reward)). |
| 報酬元                                                                                                                | 報酬を引き起こした要因を説明します（例: *紹介*, *目標*, *手動*, *API*).                                                                             |
| Fuel Tankの種類                                                                                                       | 使用された報酬資金の種類です（FuelTank連携を使用している場合）。例: *前払い*, *ギフトカード*.                                                                    |
| Fuel Tankコード                                                                                                       | 外部 fulfillment に関連付けられたコードです（例: バウチャーやギフトカードのコード）。                                                                         |
| プログラムID                                                                                                            | 報酬が発行されたAdvocateプログラムのIDです。                                                                                                |
| プログラム報酬キー                                                                                                          | プログラム内で使用される特定の報酬設定に対する内部識別子です。                                                                                            |
| グローバル報酬キー                                                                                                          | グローバルレベルで設定された報酬のクロスプログラム識別子です（該当する場合）。                                                                                    |
| **報酬のタイムスタンプ**                                                                                                     |                                                                                                                            |
| 作成日時                                                                                                               | システム内で報酬レコードが作成された時点です。                                                                                                    |
| 予定日時                                                                                                               | 報酬が発行されるよう予定された時点です（例: 遅延後や待機期間後）。                                                                                         |
| 付与日時                                                                                                               | 実際に参加者へ報酬が発行された時点です。                                                                                                       |
| 失効日時                                                                                                               | 報酬の失効日です（該当する場合）。                                                                                                          |
| キャンセル日時                                                                                                            | 報酬が無効化またはキャンセルされた日付です。                                                                                                     |
| 利用日時                                                                                                               | 参加者が報酬を利用した日付です（該当する場合）。                                                                                                   |
| 更新日時                                                                                                               | 報酬レコードに対する最新の更新が行われた日付です。                                                                                                  |
| **クレジット＆値の追跡**                                                                                                     |                                                                                                                            |
| 割り当て済みクレジット                                                                                                        | この報酬に割り当てられたクレジットの額です（モデルによっては値と異なる場合があります）。                                                                               |
| 利用済みクレジット                                                                                                          | 報酬から利用されたクレジットの額です。                                                                                                        |
| 利用可能額                                                                                                              | 残っている未使用または未利用の報酬部分です。                                                                                                     |
| **報酬のステータス＆メッセージ**                                                                                                 |                                                                                                                            |
| ステータス                                                                                                              | 報酬の現在のステータスです（例: *保留中*, *予定済み*, *付与済み*, *期限切れ*, *キャンセル済み*).                                                                |
| meta.status                                                                                                        | 技術的またはシステムレベルのステータスです（診断やエラー処理に役立ちます）。                                                                                     |
| meta.message                                                                                                       | 報酬の配信に関連付けられたメッセージです（例: 「報酬は正常に配信されました」）。                                                                                  |
| meta.internal Message                                                                                              | 管理者向けの内部専用メモです（例: 失敗の理由やフラグ）。                                                                                              |
| meta.date Modified                                                                                                 | 報酬に関連するメタデータが最後に更新された日時です。                                                                                                 |
| meta.customMeta.testMeta                                                                                           | プログラムが送信する任意のカスタムメタデータフィールドのプレースホルダーです（この場合、testMetaはサンプルです）。                                                              |
| **参加者（ユーザー）情報**                                                                                                    |                                                                                                                            |
| user.id                                                                                                            | 報酬を受け取るユーザーのIDです。                                                                                                          |
| user.account Id                                                                                                    | Advocate内でそのユーザーに関連付けられたアカウントIDです。                                                                                         |
| <p>user.first Name</p><p>user.last Name</p><p>user.email</p>                                                       | 参照やCRM照合のために含まれる基本的な参加者情報です。                                                                                               |
| **紹介コンテキスト（報酬が紹介ベースの場合）**                                                                                          |                                                                                                                            |
| referral.id                                                                                                        | この報酬を発生させた紹介のIDです。                                                                                                         |
| referral.date Referral Started                                                                                     | 紹介アクションが開始された時点です（例: クリックまたは共有イベント）。                                                                                       |
| referral.date Modified                                                                                             | 紹介レコードが最後に更新された時点です。                                                                                                       |
| referral.referral Code Used                                                                                        | 紹介されたユーザーが登録またはアクションを行うために使用したコードです。                                                                                       |
| **紹介されたユーザー情報（友人）**                                                                                                |                                                                                                                            |
| referral.referred User.id                                                                                          | 紹介された人（「友人」）のIDです。                                                                                                         |
| referral.referred User.account Id                                                                                  | 紹介者の一意のアカウントIDです。                                                                                                          |
| <p>referral.referred User.first Name</p><p>referral.referred User.last Name</p><p>referral.referred User.email</p> | 紹介者の基本連絡先情報です。                                                                                                             |
| **紹介者情報（アドボケート）**                                                                                                  |                                                                                                                            |
| referral.referrer User.id                                                                                          | 紹介を行った人（「アドボケート」）のIDです。                                                                                                    |
| referral.referrer User.account Id                                                                                  | 紹介者の一意のアカウントIDです。                                                                                                          |
| <p>referral.referrer User.first Name</p><p>referral.referrer User.last Name</p><p>referral.referrer User.email</p> | 紹介者の基本連絡先情報です。                                                                                                             |
| referral.date Converted                                                                                            | 紹介が正式にコンバージョンした日付です（例: 登録完了や購入完了）。これにより報酬が発生します。                                                                           |

</details>

#### 紹介履歴

&#x20; *紹介履歴* レポートは、紹介プログラムで行われた各紹介接続のステータスの記録を提供します。この情報は、プログラムの成功状況を確認したり、プログラムが獲得した新規顧客数を追跡したりする際に役立ちます。

<details>

<summary>レポートの詳細</summary>

デフォルトでは、レポートには次の項目が含まれます:

* 紹介された友人の詳細（名前、ユーザーIDとアカウントID、メールアドレスなど）
* 顧客アドボケートの詳細（名前、ユーザーIDとアカウントID、メールアドレスなど）
* 紹介ステータス
* モデレーションステータス
* 報酬ID

フィールドの完全な一覧は、 [サンプルCSVをダウンロード](https://assets.ctfassets.net/s68ib1kj8k5n/7B4pBHawfu9GtzE5mL1yo2/4fd194ee3080c5190639abab70b35e47/Referral_Activity_Report.csv) ![](https://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-06e12321258e7eb7ac63ef7e73640b29fcf2baad%2Fcff634f1183ca82d3b56ab55dd636140372687d8dbc6520872cdbe5010347326.svg?alt=media) 紹介活動レポート

**レポートの列の参照**

| 列                                                        | 説明                                                           |
| -------------------------------------------------------- | ------------------------------------------------------------ |
| **紹介メタデータ**                                              |                                                              |
| ID                                                       | Advocate内の紹介レコードの一意の識別子です。                                   |
| 更新日時                                                     | 紹介レコードの任意の部分が最後に更新された最新日付です。                                 |
| 紹介開始日                                                    | 紹介が最初に開始された時点です（例: 紹介されたユーザーが紹介リンクをクリックした時）。                 |
| コンバージョン日                                                 | 紹介がコンバージョンした時点です。通常、紹介されたユーザーが必要なアクション（登録や購入など）を完了した時点を指します。 |
| ユーザー更新日                                                  | この紹介に関与するユーザーデータ（紹介者または紹介された人）が最後に更新された時点です。                 |
| プログラムID                                                  | この紹介が属するAdvocate紹介プログラムのIDです。                                |
| プログラム名                                                   | 紹介プログラムの名前です。複数のプログラムを管理している場合に便利です。                         |
| **紹介された友人（新規顧客）情報**                                      |                                                              |
| <p>紹介されたユーザーのメール</p><p>紹介されたユーザーの名</p><p>紹介されたユーザーの姓</p> | 紹介されたユーザーの基本的な身元情報です。                                        |
| 紹介されたユーザーの紹介コード                                          | 紹介されたユーザーに割り当てられた紹介コードです（後で他の人を紹介できる場合に備えて）。                 |
| <p>紹介されたユーザーの最初に検出されたIP</p><p>紹介されたユーザーの最後に検出されたIP</p>   | 紹介されたユーザーの最初および最新のアクティビティで記録されたIPアドレスです。                     |
| 紹介されたユーザーの画像URL                                          | 紹介されたユーザーに取得または割り当てられた画像またはアバターのURLです。                       |
| 紹介されたユーザーのロケール                                           | 言語/地域設定（例: *en-US*, *fr-FR*）です。                              |
| 紹介されたユーザーの作成日                                            | Advocateで紹介されたユーザーアカウントが作成された日付です。                           |
| 紹介されたユーザー                                                | Advocateシステム内の紹介されたユーザーの内部IDです。                              |
| 紹介されたアカウント                                               | 紹介されたユーザーに紐づく内部アカウントIDです（複数アカウントのプログラムで使用）。                  |
| **紹介者（顧客アドボケート）情報**                                      |                                                              |
| <p>紹介者のメール</p><p>紹介者の名</p><p>紹介者の姓</p>                   | 紹介を行った参加者の基本的な身元情報です。                                        |
| 紹介者の紹介コード                                                | 紹介者に属する紹介コードで、紹介されたユーザーが使用した可能性が高いコードです。                     |
| <p>紹介者の最初に検出されたIP</p><p>紹介者の最後に検出されたIP</p>               | 紹介者の最初および最新のアクティビティで記録されたIPアドレスです。                           |
| 紹介者の画像URL                                                | 紹介者の画像またはアバターのURLです。                                         |
| 紹介者のロケール                                                 | 紹介者のロケール設定です。                                                |
| 紹介者の作成日                                                  | 紹介者が最初に参加した、またはシステムに記録された時点です。                               |
| 紹介者                                                      | Advocate内の紹介者の内部IDです。                                        |
| 紹介者アカウント                                                 | 紹介者に関連付けられたアカウントIDです。                                        |
| **モデレーション＆ステータス**                                        |                                                              |
| モデレーションステータス                                             | 紹介全体のモデレーションステータスです。（例: *承認済み*, *却下済み*, *保留中*.)              |
| モデレーション日時                                                | モデレーションの判断（承認/却下）が行われた日付です。                                  |
| 紹介支払日                                                    | 紹介に関連する報酬が支払われた時点です。                                         |
| 紹介終了日                                                    | 紹介レコードが正式に終了した時点です（例: 失効または完了による）。                           |
| 紹介された側のモデレーションステータス                                      | 紹介されたユーザー側に特有のモデレーションステータスです。                                |
| 紹介者側のモデレーションステータス                                        | 紹介者側に特有のモデレーションステータスです。                                      |
| **報酬参照**                                                 |                                                              |
| 紹介された側の報酬                                                | 紹介されたユーザーに付与された報酬IDまたは参照です（該当する場合）。                          |
| 紹介者の報酬                                                   | 紹介者に付与された報酬IDまたは参照です（該当する場合）。                                |

</details>

#### ユーザー別報酬残高

&#x20; *ユーザー別報酬残高* レポートは、紹介プログラムを通じて生成された未払い報酬の記録を提供します。これには、金額と受取予定者が含まれます。このレポートは、報酬の手動支払いの一環として、またはTango Cardのようなシステムへのバッチ処理の一部としてよく使用されます。また、特定期間に紹介プログラムがどれだけ支払ったかを追跡するのにも役立ちます。

<details>

<summary>レポートの詳細</summary>

デフォルトでは、レポートには次の項目が含まれます:

* 名前、ユーザーIDとアカウントID、メールアドレスなどの参加者詳細
* 報酬タイプ
* 報酬単位
* 報酬額

フィールドの完全な一覧は、 [サンプルCSVをダウンロード](https://assets.ctfassets.net/s68ib1kj8k5n/5iv0ByBQquLwShSyRjawck/e04b55a4e5afe24c01d5192c10682aab/Reward_Balances_by_User.csv) ![](https://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-06e12321258e7eb7ac63ef7e73640b29fcf2baad%2Fcff634f1183ca82d3b56ab55dd636140372687d8dbc6520872cdbe5010347326.svg?alt=media) 報酬残高レポート

**レポートの列の参照**

| 列                | 説明                                                                                      |
| ---------------- | --------------------------------------------------------------------------------------- |
| **参加者情報**        |                                                                                         |
| ユーザーID           | Advocate内での参加者の一意の識別子です。報酬残高を個々のユーザーに関連付けるために使用されます。                                    |
| アカウントID          | 参加者に関連付けられた内部アカウントIDです。ユーザーが組織やセグメント化されたアカウントグループに属する場合に特に重要です。                         |
| メール              | 参加者のメールアドレスです。手動での報酬付与や外部システムとの同期によく使用されます。                                             |
| <p>名</p><p>姓</p> | 参加者の名と姓です。報酬処理時のパーソナライズやフィルタリングに役立ちます。                                                  |
| 紹介コード            | 参加者に割り当てられた紹介コードです。これは他者を紹介し、報酬対象を追跡するために共有するものです。                                      |
| **報酬情報**         |                                                                                         |
| タイプ              | 報酬のカテゴリまたは方法です（例: *現金*, *ギフトカード*, *ポイント*, *カスタム*）。報酬をどのように付与またはグループ化するかを判断するのに役立ちます。    |
| 単位               | 報酬額の単位です（例: *USD*, *ZAR*, *ポイント*, *%*）。残高の計算や地域別の支払い処理に重要です。                            |
| 金額               | このユーザーの未払い報酬として利用可能な合計残高です。支払い準備やエクスポート時に使用される中心的な数値です。                                 |
| 割り当て済みクレジット合計    | このユーザーにこれまで割り当てられたクレジットの総額です（利用済みに関係なく）。この参加者に割り当てられたプログラム全体のコストを反映します。                 |
| 利用済みクレジット合計      | この参加者がすでに利用した報酬の合計部分です。実際のコストと負債の監査に役立ちます。                                              |
| 失効クレジット合計        | ユーザーに割り当てられたものの、利用される前に失効した報酬の合計です。未請求の報酬や失効した付与機会の追跡に役立ちます。                            |
| **ユーザーメタデータ**    |                                                                                         |
| 画像URL            | 参加者のプロフィール画像またはアバターのURLです（収集されている場合）。主に見た目のため、または該当する場合はユーザー向けダッシュボードで使用されます。           |
| 最初に検出されたIP       | 参加者が追加された、またはアクティブになった際に記録された最初のIPアドレスです。コンプライアンス、位置情報のタグ付け、不正分析に役立ちます。                 |
| 最後に検出されたIP       | 参加者に関連付けられた最新のIPアドレスです。ユーザーが現在もアクティブか、関与しているかの判定に役立ちます。                                 |
| 作成日時             | Advocateで参加者アカウントが作成された日付です。コホート分析や時間経過に伴う報酬行動の分析に役立ちます。                                |
| 紹介元              | 参加者が獲得された元のソースまたはチャネルです（例: *メール*, *オーガニック*, *パートナー*）。チャネル別に紹介プログラムの到達度と有効性を評価するのに役立ちます。 |
| ロケール             | 参加者の言語および地域設定です（例: *en-US*, *fr-FR*）。パーソナライズされた連絡や地域別の報酬オプションに重要です。                     |

</details>

#### ユーザー別利用可能報酬残高

&#x20; *ユーザー別利用可能報酬残高* レポートは、未利用の報酬の一覧を提供します。このレポートタイプは、 [一括報酬引き換え](https://help.impact.com/brand/ja/nitsuitebitaidesuka/advocate-program/advocate-rewards/redeem-rewards-in-bulk) プロセスを通じて報酬を付与する際の一部として使用することを目的としています。

<details>

<summary>レポートの詳細</summary>

デフォルトでは、レポートには次の項目が含まれます:

* 名前、ユーザーIDとアカウントID、メールアドレスなどの参加者詳細
* 報酬単位
* 報酬通貨
* 利用可能額

フィールドの完全な一覧は、 [サンプルCSVをダウンロード](https://assets.ctfassets.net/s68ib1kj8k5n/7CggBzV2U5EoJqp1HFF5SA/f3b417f460c0d960f8429b26824a225b/Available_Reward_Balances_by_User.csv) ![](https://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-06e12321258e7eb7ac63ef7e73640b29fcf2baad%2Fcff634f1183ca82d3b56ab55dd636140372687d8dbc6520872cdbe5010347326.svg?alt=media) 利用可能報酬残高レポート内のものです。

{% hint style="info" %}
**注**: このレポートには、パーセンテージ割引、Fuel Tank、またはギフトカード報酬に関する詳細は含まれていません。これらの種類の報酬については、 *ユーザー別報酬残高* レポートを使用して、より詳細な情報を確認してください。
{% endhint %}

**レポートの列の参照**

| 列                  | 説明                                                                                                                                                                                                                              |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **参加者情報**          |                                                                                                                                                                                                                                 |
| 名                  | 参加者の名。報酬処理中の識別やパーソナライズに使用されます。                                                                                                                                                                                                  |
| 姓                  | 参加者の姓です。                                                                                                                                                                                                                        |
| メール                | 参加者のメールアドレス。報酬の送付やCRM・報酬プロバイダーなどの外部システムとの照合に使用されます。                                                                                                                                                                             |
| ユーザーID             | Advocate内で参加者に割り当てられた一意の識別子です。                                                                                                                                                                                                  |
| アカウントID            | 参加者に紐づく内部アカウントID。                                                                                                                                                                                                               |
| セグメント              | 次のように参加者を [グループ化するために使用されるタグまたはカテゴリ](https://help.impact.com/brand/ja/nitsuitebitaidesuka/advocate-program/manage-advocate-participants/manage-advocate-user-segments) （例： *地域別*, *ライフサイクル段階*, *顧客タイプ*）。絞り込みや異なる履行ルールの適用に役立ちます。 |
| **報酬のステータスとタイミング** |                                                                                                                                                                                                                                 |
| ブロック日              | 該当する場合、ユーザーが報酬の受け取りをブロックされた日付。ブロック状態では引き換えができない場合があります。この項目は、そのブロックがいつ適用されたかを示します。                                                                                                                                              |
| **報酬データ**          |                                                                                                                                                                                                                                 |
| 単位名                | 報酬単位のラベルまたは表示名（例： *紹介報酬現金*, *ストアクレジット*）。プログラムが提供する複数の報酬タイプを区別するのに役立ちます。                                                                                                                                                         |
| 通貨                 | 報酬額の通貨コード（例： *USD*, *ZAR*, *EUR*）。報酬を支払う際、特に国や支払いシステムをまたぐ場合に必要です。                                                                                                                                                               |
| 利用可能額              | この参加者が現在利用可能な未引き換え報酬額。これは、支払い額を決定する際に使用される基本値です。                                                                                                                                                                                |
| 引き換え予定額            | 現在引き換え待ちとしてキューに入っている値（例：一括履行で保留中、または処理待ち）。二重引き換えの防止や、引き換えの重複がないことを確認するのに役立ちます。                                                                                                                                                  |
| 累計引き換え額            | この参加者がこれまでに引き換えた報酬の合計額。過去の引き換え状況の把握や、報酬上限の追跡に役立ちます。                                                                                                                                                                             |
| 単位                 | 報酬単位の内部コードまたはシステムコード（例： *USD*, *ポイント*など）。履行時のAPI呼び出しや内部ロジックで使用される場合があります。                                                                                                                                                       |

</details>

#### 米国W-9税務報告書

米国W-9税務報告書では、参加者の米国W-9税務ステータスと、年ごとの獲得済みまたは保留中の報酬が表示されます。

<details>

<summary>レポートの詳細</summary>

デフォルトでは、レポートには次の項目が含まれます:

* 名前、ユーザーIDとアカウントID、メールアドレスなどの参加者詳細
* 参加者のW-9フォームが収集済みとしてマークされた日付
* 税年度ごとの米国課税対象報酬額
* 各参加者が税年度に獲得した報酬の総数

**レポートの列の参照**

| 列                                   | 説明                                                                                       |
| ----------------------------------- | ---------------------------------------------------------------------------------------- |
| **参加者情報**                           |                                                                                          |
| ユーザーID                              | Advocate における参加者の一意の識別子。                                                                 |
| アカウントID                             | 参加者に関連付けられた内部アカウントID。                                                                    |
| メール                                 | 参加者のメールアドレスです。                                                                           |
| 名                                   | 参加者の名です。                                                                                 |
| 姓                                   | 参加者の姓です。                                                                                 |
| **W-9税務情報**                         |                                                                                          |
| <p>米国税務フォーム提出日</p><p>YYYY-MM-DD</p> | 参加者のW-9フォームがAdvocate上で提出済みかつ収集済みとしてマークされた日付。IRSコンプライアンスおよび税務書類のステータス確認に重要です。             |
| **税年度サマリー**                         |                                                                                          |
| 年                                   | 参加者が報酬を獲得した税年度。1099処理のために、獲得額を暦年ごとにまとめるために使用されます。                                        |
| 米国課税対象額（セント）                        | 指定された税年度にこの参加者が獲得した、米国で課税対象となる報酬の合計額をセント単位で表したもの（例：2500 = $25.00）。精度が必要な生データ計算や連携に役立ちます。 |
| 米国課税対象額（ドル）                         | 上記と同じ値ですが、標準的なドル形式（例：25.00）で表示されます。確認や正式なサマリーへの記載がしやすくなります。                              |
| 報酬回数                                | 指定された税年度に、参加者が獲得した個別の報酬インスタンスの総数。監査証跡や、報酬頻度・プログラムへの参加状況の把握に役立ちます。                        |

</details>

#### 支払いと税金

&#x20; *支払いと税金* レポートでは、参加者の税務ステータスと、年ごとの獲得済みまたは保留中の報酬が表示されます。

プログラムが参加者に現金支払いを提供する場合、参加者の税務フォームのステータスに関連する特定の項目が利用可能になります。

<details>

<summary>レポートの詳細</summary>

デフォルトでは、レポートには次の項目が含まれます:

* 名前、ユーザーIDとアカウントID、メールアドレスなどの参加者詳細
* W-8やW-9など、参加者の税務フォームが提出済みとしてマークされた日付
* 税年度ごとの米国課税対象報酬額
* 各参加者が税年度に獲得した報酬の総数
* 税務フォームのステータス。例： *有効*, *保留中*、または *未処理*。支払い保留の理由もレポートに含まれます

**レポートの列の参照**

| 列                                   | 説明                                                                                               |
| ----------------------------------- | ------------------------------------------------------------------------------------------------ |
| **参加者情報**                           |                                                                                                  |
| ユーザーID                              | Advocate における参加者の一意の識別子。                                                                         |
| アカウントID                             | グループ化または組織レポートに使用される参加者のアカウントID。                                                                 |
| メール                                 | 参加者のメールアドレスです。                                                                                   |
| 名                                   | 参加者の名です。                                                                                         |
| 姓                                   | 参加者の姓です。                                                                                         |
| **W-9税務情報**                         |                                                                                                  |
| <p>米国税務フォーム提出日</p><p>YYYY-MM-DD</p> | 参加者がW-9（または該当する米国税務）フォームを提出した日付。現金支払いを行う前の税務適格性確認に重要です。                                          |
| **支払い年度サマリー**                       |                                                                                                  |
| 年                                   | 参加者が報酬を獲得した暦年。                                                                                   |
| 値                                   | その年にこの参加者が獲得または保留中の、最小単位（例：セント）での支払い総額。たとえば、1750 = $17.50。                                       |
| ドル表示額                               | 同じ値を、確認しやすいよう標準的な通貨形式で表示したもの（例：17.50）。                                                           |
| 件数                                  | 指定された年における、参加者の個別の支払い報酬インスタンスの総数。参加者がどのくらいの頻度で支払いを獲得したかを把握するのに役立ちます。                             |
| **支払いの適格性とステータス**                   |                                                                                                  |
| 支払い保留                               | 参加者の支払いが現在保留中かどうかを示します（はい／いいえ）。支払いは、税務フォームの未提出や設定未完了などにより保留される場合があります。                           |
| 支払い保留の理由                            | 参加者が支払い保留となっている理由を説明します（該当する場合）。理由の例： *税務フォームの未提出*, *銀行情報が未提供*, *コンプライアンス審査*.                    |
| 支払い通貨                               | 参加者の支払いが処理されている、または処理される通貨（例： *USD*, *EUR*, *ZAR*）。グローバルな支払いシステムや会計に重要です。                        |
| 支払い設定を開始済み                          | 参加者が支払い方法の設定を開始しているかどうかを示します（例：支払いプロバイダー連携を通じて）。オンボーディングの進捗や、保留中の支払いに対するフォローアップの必要性を把握するのに役立ちます。 |

</details>
