> 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 更新日            | 参加者の統計が最後に更新された日付。                                                                                         |
| 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。                                                                                           |
| プログラム報酬キー                                                                                                          | プログラム内で使用された特定の報酬設定の内部識別子。                                                                                          |
| グローバル報酬キー                                                                                                          | グローバルレベルで設定された報酬の、プログラム横断の識別子（該当する場合）。                                                                              |
| **報酬のタイムスタンプ**                                                                                                     |                                                                                                                     |
| 作成日                                                                                                                | システム内で報酬レコードが作成されたとき。                                                                                               |
| 予定発行日                                                                                                              | 報酬の発行予定日時（例：遅延または待機期間後）。                                                                                            |
| 付与日                                                                                                                | 報酬が実際に参加者へ発行されたとき。                                                                                                  |
| 有効期限日                                                                                                              | 報酬の有効期限日（該当する場合）。                                                                                                   |
| キャンセル日                                                                                                             | 報酬が無効化またはキャンセルされた日付。                                                                                                |
| 引き換え日                                                                                                              | 参加者が報酬を引き換えた日付（該当する場合）。                                                                                             |
| 更新日                                                                                                                | 報酬レコードに対する最新の更新が行われた日付。                                                                                             |
| **クレジットと価値の追跡**                                                                                                    |                                                                                                                     |
| 割り当て済みクレジット                                                                                                        | この報酬に割り当てられたクレジット額（一部のモデルでは値と異なる場合があります）。                                                                           |
| 引き換え済みクレジット                                                                                                        | 報酬から引き換えられたクレジット額。                                                                                                  |
| 利用可能価値                                                                                                             | 報酬の残りの未使用または未引き換え分。                                                                                                 |
| **報酬ステータスとメッセージ**                                                                                                  |                                                                                                                     |
| ステータス                                                                                                              | 報酬の現在のステータス（例： *保留中*, *予定済み*, *付与済み*, *期限切れ*, *キャンセル済み*).                                                           |
| 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>

#### 紹介履歴

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

<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*, *ポイント*, *%*）。残高計算や地域ごとの支払い処理に重要です。                              |
| Amount           | このユーザーに対して利用可能な未払報酬の合計残高。支払い準備やエクスポート時に使用する中心となる数値です。                                    |
| 付与済みクレジット合計      | このユーザーにこれまで付与されたクレジットの総額（引き換えの有無にかかわらず）。この参加者に割り当てられたプログラム全体のコストを示します。                   |
| 引き換え済みクレジット合計    | この参加者がすでに引き換えた報酬の合計部分。実際のコストと負債の監査に役立ちます。                                                |
| 期限切れクレジット合計      | ユーザーに割り当てられたものの、引き換え前に期限切れとなった報酬の合計。未請求報酬や取りこぼした付与機会の把握に役立ちます。                           |
| **ユーザーメタデータ**    |                                                                                          |
| 画像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" %}
**注**：このレポートには、Percentage Discount、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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
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=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
