> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/ja/what-would-you-like-to-learn-about/advocate-program/advocate-reporting-and-analytics/advocate-program-reports-explained.md).

# Advocateプログラムレポートの解説

<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/what-would-you-like-to-learn-about/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) ![](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                     | 参加者のアカウントに対する一意の識別子です（該当する場合、複数のプログラムで使用されます）。                                                              |
| メール                         | 参加者のメールアドレスです。                                                                                              |
| 名                           | 参加者の名です。                                                                                                    |
| 姓                           | 参加者の姓です。                                                                                                    |
| メールハッシュ                     | 参加者のメールアドレスをハッシュ化（暗号化）したもの。ほかのシステムとのプライバシー準拠の照合に役立ちます。                                                      |
| **紹介・共有情報**                 |                                                                                                             |
| 紹介コード                       | 参加者に紐づく一意のコードで、生成した紹介を追跡するために使用されます。                                                                        |
| 共有リンク                       | 参加者に関連付けられた一意の紹介リンクです。                                                                                      |
| 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です。イベント送信の追跡、デバッグ、監査に役立ちます。                                       |
| イベントキー                               | イベントの種類またはラベルです。たとえば `購入`, `登録`、またはシステムが送信する任意のカスタム定義キーです。                               |
| ユーザー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) ![](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*, *%*).                                                                             |
| 名前                                                                                                                 | 報酬の表示名（ [報酬設定](/brand/ja/what-would-you-like-to-learn-about/advocate-program/advocate-rewards/create-a-reward.md)). |
| 報酬ソース                                                                                                              | 報酬のトリガーになったものを示します（例: *リファラル*, *目標*, *手動*, *API*).                                                                  |
| Fuel Tankタイプ                                                                                                       | 使用された報酬ファンドの種類です（FuelTank 連携を使用している場合）。例: *前払い*, *ギフトカード*.                                                          |
| Fuel Tank コード                                                                                                      | 外部履行に関連付けられたコードです（例: バウチャーまたはギフトカードコード）。                                                                            |
| プログラムID                                                                                                            | 報酬が発行された Advocate プログラムのIDです。                                                                                       |
| プログラム報酬キー                                                                                                          | プログラム内で使用された特定の報酬設定の内部識別子です。                                                                                        |
| グローバル報酬キー                                                                                                          | グローバルレベルで設定された報酬の、プログラム横断の識別子です（該当する場合）。                                                                            |
| **報酬のタイムスタンプ**                                                                                                     |                                                                                                                     |
| 作成日                                                                                                                | 報酬レコードがシステムに作成された時点です。                                                                                              |
| 予定日                                                                                                                | 報酬が発行予定だった時点です（例: 遅延後または待機期間後）。                                                                                     |
| 付与日                                                                                                                | 報酬が実際に参加者へ発行された時点です。                                                                                                |
| 有効期限                                                                                                               | 報酬の有効期限です（該当する場合）。                                                                                                  |
| キャンセル日                                                                                                             | 報酬が無効化またはキャンセルされた日付です。                                                                                              |
| 引き換え日                                                                                                              | 参加者が報酬を引き換えた日付です（該当する場合）。                                                                                           |
| 更新日                                                                                                                | 報酬レコードへの最新更新が行われた日付です。                                                                                              |
| **クレジットと価値の追跡**                                                                                                    |                                                                                                                     |
| 割り当てクレジット                                                                                                          | この報酬に割り当てられたクレジット額です（一部のモデルでは value と異なる場合があります）。                                                                   |
| 引き換え済みクレジット                                                                                                        | 報酬から引き換えられたクレジット額です。                                                                                                |
| 利用可能価値                                                                                                             | 報酬の残りの未使用または未引き換え部分です。                                                                                              |
| **報酬ステータスとメッセージ**                                                                                                  |                                                                                                                     |
| ステータス                                                                                                              | 報酬の現在のステータス（例: *保留中*, *予定済み*, *付与済み*, *期限切れ*, *キャンセル済み*).                                                           |
| 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とアカウント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>

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

この *ユーザー別報酬残高* このレポートは、紹介プログラムを通じて生成された未払い報酬の記録を、金額や受取予定者を含めて提供します。このレポートは、報酬を手動で付与する際や、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 で作成された日付。コホート分析や時間経過に伴う報酬行動の把握に役立ちます。                                |
| 紹介元              | 参加者が獲得された元のソースまたはチャネル（例： *メール*, *オーガニック*, *partner*）。紹介プログラムの到達範囲とチャネル別の効果を評価するのに役立ちます。 |
| ロケール             | 参加者の言語および地域設定（例： *en-US*, *fr-FR*）。パーソナライズされた連絡や地域別の報酬オプションに重要です。                       |

</details>

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

この *ユーザー別利用可能報酬残高* このレポートは、引き換えられていない報酬の一覧を提供します。このレポート形式は、以下を通じて報酬を付与するプロセスの一部として使用することを想定しています。 [一括報酬引き換え](/brand/ja/what-would-you-like-to-learn-about/advocate-program/advocate-rewards/redeem-rewards-in-bulk.md) 処理。

<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。                                                                                                                                                                                                       |
| セグメント          | 参加者を [グループ化するために使用されるタグまたはカテゴリ](/brand/ja/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participants/manage-advocate-user-segments.md) （例： *地域別に*, *ライフサイクル段階で*, *顧客タイプで*）。フィルタリングや異なる付与ルールの適用に役立ちます。 |
| **報酬ステータスと時期** |                                                                                                                                                                                                                             |
| ブロック日          | ユーザーが報酬の受け取りをブロックされた日付（該当する場合）。ブロック状態により引き換えができない場合があり、このフィールドはそのブロックが適用された時点を示します。                                                                                                                                         |
| **報酬データ**      |                                                                                                                                                                                                                             |
| 単位名            | 報酬単位のラベルまたは表示名（例： *紹介キャッシュ*, *ストアクレジット*）。これにより、プログラムが提供する複数の報酬タイプを区別しやすくなります。                                                                                                                                               |
| 通貨             | 報酬金額の通貨コード（例： *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>

#### 支払いと税務

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

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

<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>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://help.impact.com/brand/ja/what-would-you-like-to-learn-about/advocate-program/advocate-reporting-and-analytics/advocate-program-reports-explained.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
