> 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プログラムレポートの生成](https://help.impact.com/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
* メールアドレス
* カスタムフィールド
* セグメント
* 紹介情報（該当する場合）

レポートの生成時に、次の情報を追加で含めることもできます。

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

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

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

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

</details>

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

この *ユーザーイベントのエクスポート* レポートには、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) ![](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など）。                                                                                                                         |
| 単位                                                                                                                 | 値に関連付けられた単位（例： *米ドル*, *ポイント*, *南アフリカ・ランド*, *%*).                                                                                           |
| 名前                                                                                                                 | 報酬の表示名（ [報酬設定](https://help.impact.com/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。                                                                                                                  |
| プログラム報酬キー                                                                                                          | プログラム内で使用された特定の報酬設定を示す内部識別子。                                                                                                               |
| グローバル報酬キー                                                                                                          | グローバルレベルで設定された報酬をプログラム間で識別するための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          | 参加者に関連付けられた内部アカウント ID。ユーザーが組織やセグメント化されたアカウントグループに属している場合に特に重要です。                     |
| メールアドレス          | 参加者のメールアドレス。報酬の手動付与や外部システムとの同期によく使用されます。                                             |
| <p>名</p><p>姓</p> | 参加者の氏名。報酬処理時のパーソナライズや絞り込みに役立ちます。                                                     |
| 紹介コード            | 参加者に割り当てられた紹介コード。参加者はこのコードを共有して他の人を紹介し、報酬の対象条件を満たしたかを確認します。                          |
| **報酬情報**         |                                                                                      |
| 種類               | 報酬のカテゴリまたは方法（例： *現金*, *ギフトカード*, *ポイント*, *カスタム*）。報酬の付与方法やグループ分けを判断するのに役立ちます。          |
| 単位               | 報酬額の単位（例： *米ドル*, *南アフリカランド*, *ポイント*, *%*）。残高の計算や地域ごとの支払い処理に重要です。                     |
| 金額               | このユーザーが受け取れる未払い報酬の合計残高。支払いやエクスポートの準備に使用する主要な数値です。                                    |
| 割り当て済みクレジット合計    | このユーザーにこれまで割り当てられたクレジットの総額（利用済みかどうかを問いません）。この参加者に配分されたプログラム全体のコストを示します。              |
| 利用済みクレジット合計      | この参加者がすでに利用した報酬の合計。実際のコストと債務の監査に役立ちます。                                               |
| 期限切れクレジット合計      | ユーザーに割り当てられたものの、利用される前に期限切れとなった報酬の合計。未請求の報酬や付与機会の損失を把握するのに役立ちます。                     |
| **ユーザーメタデータ**    |                                                                                      |
| 画像 URL           | 参加者のプロフィール画像またはアバターの URL（収集している場合）。主に表示上の目的で使用され、該当する場合はユーザー向けダッシュボードにも表示されます。       |
| 初回確認時のIPアドレス     | 参加者の登録時またはアクティブ化時に最初に記録された IP アドレス。コンプライアンス対応、位置情報のタグ付け、不正分析に役立ちます。                  |
| 最終確認IP           | 参加者に関連付けられた最新の IP アドレス。ユーザーが現在もアクティブか、利用を継続しているかを判断するのに役立ちます。                        |
| 作成日              | Advocate で参加者アカウントが作成された日付。コホート分析や、時間の経過に伴う報酬の利用状況の分析に役立ちます。                         |
| 紹介元              | 参加者を獲得した元の流入元またはチャネル（例： *メール*, *オーガニック*, *パートナー*）。チャネルごとの紹介プログラムのリーチと効果を評価するのに役立ちます。 |
| ロケール             | 参加者の言語と地域の設定（例： *英語（米国）*, *フランス語（フランス）*）。パーソナライズされたコミュニケーションや地域ごとの報酬オプションに重要です。      |

</details>

#### ユーザーごとの報酬残高

この *ユーザーごとの利用可能な報酬残高* このレポートには、未換金の報酬の一覧が表示されます。このレポートタイプは、次の機能を通じて報酬を一括付与する際に使用することを想定しています。 [報酬の一括換金](https://help.impact.com/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" %}
**注**：このレポートには、割引率、燃料タンク、ギフトカードの報酬に関する詳細は含まれません。これらの報酬タイプの詳細については、 *ユーザーごとの報酬残高* レポートを使用してください。
{% endhint %}

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

| 列                  | 説明                                                                                                                                                                                                                                                        |
| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **参加者情報**          |                                                                                                                                                                                                                                                           |
| 名                  | 報酬処理時の識別やパーソナライズに使用する、参加者の名。                                                                                                                                                                                                                              |
| 姓                  | 参加者の姓です。                                                                                                                                                                                                                                                  |
| メールアドレス            | 報酬の送付や、CRMまたは報酬プロバイダーなどの外部システムとの照合に使用する、参加者のメールアドレス。                                                                                                                                                                                                      |
| ユーザーID             | Advocate内で参加者に割り当てられた一意の識別子。                                                                                                                                                                                                                              |
| アカウントID            | 参加者に紐づく内部アカウントID。                                                                                                                                                                                                                                         |
| セグメント              | 参加者を分類するために使用するタグまたはカテゴリー（ [参加者をグループ化](https://help.impact.com/brand/ja/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participants/manage-advocate-user-segments.md) （例： *地域別*, *ライフサイクルの段階別*, *顧客タイプ別*）。フィルタリングや異なる付与ルールの適用に役立ちます。 |
| **報酬のステータスとタイミング** |                                                                                                                                                                                                                                                           |
| ブロック日              | 該当する場合、ユーザーが報酬を受け取れないようブロックされた日付。ブロック状態では換金できないことがあります。このフィールドには、ブロックが適用された日付が表示されます。                                                                                                                                                                     |
| **報酬データ**          |                                                                                                                                                                                                                                                           |
| ユニット名              | 報酬ユニットのラベルまたは表示名（例： *紹介報酬金*, *ストアクレジット*）。プログラムが提供する複数の報酬タイプを区別するのに役立ちます。                                                                                                                                                                                  |
| 通貨                 | 報酬額の通貨コード（例： *米ドル*, *南アフリカランド*, *ユーロ*）。報酬の付与時、特に複数の国や支払いシステムをまたぐ場合に必要です。                                                                                                                                                                                  |
| 利用可能な価値            | この参加者が現在利用できる、未換金の報酬額。支払額を決定する際に使用する基本の値です。                                                                                                                                                                                                               |
| 換金予定額              | 現在、換金処理の対象として登録されている値（例：一括付与で処理待ち、または処理待ちの金額）。二重換金の防止や、換金対象の重複がないことの確認に役立ちます。                                                                                                                                                                             |
| 換金済み報酬の合計額         | この参加者がすでに換金した報酬の合計額。過去の換金状況を把握でき、報酬上限の管理にも役立ちます。                                                                                                                                                                                                          |
| 単位                 | 報酬ユニットの内部コードまたはシステムコード（例： *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> | Advocate で参加者の W-9 フォームが提出済みとして記録され、回収された日付。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.
