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

<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 プログラム レポートの実行](/brand/ja/nitsuitebitaidesuka/advocate-program/advocate-reporting-and-analytics/run-an-advocate-program-report.md) を参照してください。

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

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

<details>

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

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

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

レポートを生成すると、オプションで次を含めることができます:

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

フィールドの完全な一覧は、 [サンプル CSV のダウンロード](https://assets.ctfassets.net/s68ib1kj8k5n/7Am85AH6wmNdArmjRNW3vr/95f52c5d79311509d795a0be4c94166f/User_Details_Report_Sample.csv) ![](/files/ed3b94ea5dfb5606155c2234b71fd1a91c1eb13b) 時に確認できます。

**レポート列リファレンス**

| 列                         | 説明                                                                                                            |
| ------------------------- | ------------------------------------------------------------------------------------------------------------- |
| **ユーザー情報**                |                                                                                                               |
| ID                        | Advocate システム内での参加者の一意の識別子です。                                                                                 |
| アカウント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>

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

この *ユーザーイベントのエクスポート* レポートには、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>

#### 報酬履歴

この *報酬履歴* レポートには、各報酬と参加者・紹介との関係に関する詳細な記録が表示されます。この情報は、貸借対照表の作成や、ある時点でのすべての報酬の状態を把握するのに役立ちます。

<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) ![](/files/ed3b94ea5dfb5606155c2234b71fd1a91c1eb13b) または [サンプル JSONL](https://assets.ctfassets.net/s68ib1kj8k5n/5BeuDmYM1WFAySjqntGeji/f321cf59a96d45061645d971e06fb569/Reward_Details_Example_Report_JSONL.jsonl) ![](/files/ed3b94ea5dfb5606155c2234b71fd1a91c1eb13b) 報酬詳細レポートのダウンロード時に確認できます。

レポートを生成すると、オプションで次を含めることができます:

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

**レポート列リファレンス**

| 列                                                                                                                  | 説明                                                                                                   |
| ------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------- |
| **報酬情報**                                                                                                           |                                                                                                      |
| ID                                                                                                                 | 報酬インスタンスの一意の ID（Advocate により生成）。                                                                     |
| 種類                                                                                                                 | 報酬のカテゴリまたは種類（例: *現金*, *ギフトカード*, *クーポン*, *カスタム*).                                                     |
| 値                                                                                                                  | 報酬の数値（例: 10、100 など）。                                                                                 |
| 単位                                                                                                                 | 値に関連付けられた単位（例: *USD*, *ポイント*, *ZAR*, *%*).                                                           |
| 名前                                                                                                                 | 報酬の表示名（ [報酬設定](/brand/ja/nitsuitebitaidesuka/advocate-program/advocate-rewards/create-a-reward.md)). |
| 報酬ソース                                                                                                              | 報酬のトリガーとなったものを説明します（例: *紹介*, *目標*, *手動*, *API*).                                                     |
| Fuel Tank Type                                                                                                     | 使用された報酬ファンドの種類です（FuelTank 連携を使用している場合）。例: *前払い*, *ギフトカード*.                                           |
| Fuel Tank コード                                                                                                      | 外部の引き渡しに関連付けられたコードです（例: バウチャーやギフトカードのコード）。                                                           |
| プログラム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> | 紹介した人の基本連絡先情報です。                                                                                     |
| **紹介者情報（Advocate）**                                                                                                |                                                                                                      |
| 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>

#### 紹介履歴

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

<details>

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

既定では、レポートには次が含まれます:

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

フィールドの完全な一覧は、 [サンプル CSV のダウンロード](https://assets.ctfassets.net/s68ib1kj8k5n/7B4pBHawfu9GtzE5mL1yo2/4fd194ee3080c5190639abab70b35e47/Referral_Activity_Report.csv) ![](/files/ed3b94ea5dfb5606155c2234b71fd1a91c1eb13b) 紹介アクティビティ レポート。

**レポート列リファレンス**

| 列                                                            | 説明                                                           |
| ------------------------------------------------------------ | ------------------------------------------------------------ |
| **紹介メタデータ**                                                  |                                                              |
| 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>

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

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

<details>

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

既定では、レポートには次が含まれます:

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

フィールドの完全な一覧は、 [サンプル CSV のダウンロード](https://assets.ctfassets.net/s68ib1kj8k5n/5iv0ByBQquLwShSyRjawck/e04b55a4e5afe24c01d5192c10682aab/Reward_Balances_by_User.csv) ![](/files/ed3b94ea5dfb5606155c2234b71fd1a91c1eb13b) 報酬残高レポート。

**レポート列リファレンス**

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

</details>

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

この *利用可能なユーザー別報酬残高* レポートには、未引き換えの報酬一覧が表示されます。このレポートタイプは、 [一括報酬引き換え](/brand/ja/nitsuitebitaidesuka/advocate-program/advocate-rewards/redeem-rewards-in-bulk.md) プロセスを通じて報酬を付与する際に使用することを想定しています。

<details>

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

既定では、レポートには次が含まれます:

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

フィールドの完全な一覧は、 [サンプル CSV のダウンロード](https://assets.ctfassets.net/s68ib1kj8k5n/7CggBzV2U5EoJqp1HFF5SA/f3b417f460c0d960f8429b26824a225b/Available_Reward_Balances_by_User.csv) ![](/files/ed3b94ea5dfb5606155c2234b71fd1a91c1eb13b) に含まれています。

{% hint style="info" %}
**注**: このレポートには、Percentage Discount、Fuel Tank、または Gift Card の報酬に関する詳細は含まれません。これらの種類の報酬の詳細については、 *ユーザー別報酬残高* レポートを使用してください。
{% endhint %}

**レポート列リファレンス**

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

</details>

#### 米国 W-9 税務レポート

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

<details>

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

既定では、レポートには次が含まれます:

* 名前、ユーザーおよびアカウント 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>

#### 支払いと税務

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

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

<details>

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

既定では、レポートには次が含まれます:

* 名前、ユーザーおよびアカウント 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>


---

# 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-reporting-and-analytics/advocate-program-reports-explained.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.
