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

<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/advocate-program/advocate-reporting-and-analytics/run-an-advocate-program-report) レポートの生成手順については。

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

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

<details>

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

デフォルトでは、レポートには以下の参加者情報が含まれます：

* 名前
* ユーザーおよびアカウント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                                | 参加者のアカウントに対する一意の識別子（該当する場合、複数のプログラムで使用されます）。                                                             |
| メール                                    | 参加者のメールアドレス。                                                                                             |
| 名（First Name）                          | 参加者の名。                                                                                                   |
| 姓（Last Name）                           | 参加者の姓。                                                                                                   |
| メールハッシュ                                | 参加者のメールをハッシュ（暗号化）したバージョンで、他システムとのプライバシーに準拠したマッチングに有用です。                                                  |
| **紹介および共有情報**                          |                                                                                                          |
| 紹介コード                                  | 参加者に紐づく一意のコードで、参加者が生成した紹介の追跡に使用されます。                                                                     |
| 共有リンク                                  | 参加者に関連する一意の紹介リンク。                                                                                        |
| Facebook共有リンク                          | Facebookで紹介を共有するための事前生成されたリンク。                                                                           |
| Twitter共有リンク                           | Twitterで紹介を共有するための事前生成されたリンク。                                                                            |
| メール共有リンク                               | メールで紹介を共有するための事前生成されたリンク。                                                                                |
| LinkedIn共有リンク                          | LinkedInで紹介を共有するための事前生成されたリンク。                                                                           |
| クリーン共有リンク                              | トラッキングパラメータのない紹介リンクのバージョンで、特定のプラットフォームやユースケースでより中立的です。                                                   |
| **ジオロケーションおよびロケール**                    |                                                                                                          |
| 初回記録IP（First Seen IP）                  | 参加者が最初に記録された際のIPアドレス。                                                                                    |
| 最終記録IP（Last Seen IP）                   | この参加者で最後に確認されたIPアドレス。                                                                                    |
| ロケール（Locale）                           | 参加者の優先言語および地域設定（例：en-US）。                                                                                |
| 国コード（Country Code）                     | ロケールやIPアドレスに基づく参加者の国（例：ZA、US）。                                                                           |
| **タイムスタンプ**                            |                                                                                                          |
| 作成日（Date Created）                      | 参加者アカウントがAdvocateで作成された日時。                                                                               |
| 米国税フォーム提出日（Date Us Tax Form Submitted） | （該当する場合）コンプライアンスや報酬処理のために米国税フォームが提出された日付。                                                                |
| **ユーザースタッツ（エクスポートに含めた場合）**             |                                                                                                          |
| 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.で接頭辞が付いた独立した列として表示されます。 |
| **その他**                                |                                                                                                          |
| 紹介ソース                                  | 参加者があなたのプログラムに至った元のソースまたはチャネル（例： *オーガニック（organic）*, *メール（email）*, *パートナーサイト（partner site）*).             |

</details>

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

この *ユーザーイベントエクスポート* レポートは、あなたの組織からAdvocateプログラムに受信したすべてのユーザーイベントの記録を提供します。時間範囲、イベントキー、ユーザーIDなどで絞り込むためのフィルタを適用できます。

<details>

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

デフォルトでは、レポートには以下が含まれます：

* イベントID
* イベントキー
* ユーザーおよびアカウントID
* 発生日時（Date Triggered）
* 受信日時（Date Received）
* 処理日時（Date Processed）

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

| 列                                  | 説明                                                                                  |
| ---------------------------------- | ----------------------------------------------------------------------------------- |
| **イベントおよびユーザー情報**                  |                                                                                     |
| イベントID                             | 受信した各イベントに対して生成される一意のID。イベント提出の追跡、デバッグ、監査に有用です。                                     |
| イベントキー（Event Key）                  | purchaseのようなイベントの種類やラベル、 `purchase`, `signup`、またはあなたのシステムが送信する任意のカスタム定義キー。          |
| ユーザーID（User 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>

#### 報酬履歴（Reward history）

この *報酬履歴（Reward history）* レポートは各報酬と参加者および紹介との関係の詳細な記録を提供します。この情報は貸借対照表を作成したり、ある時点でのすべての報酬の状態を把握する際に役立ちます。

<details>

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

デフォルトでは、レポートには次の **報酬フィールド** の情報が含まれます：

* 報酬ID（Reward ID）
* 報酬タイプ（Reward Type）
* 報酬の値（Reward Value）

含まれるフィールドの完全な一覧は、 [サンプル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（Advocateによって生成）。                                                                                                                            |
| タイプ（Type）                                                                                                          | 報酬のカテゴリまたはタイプ（例： *現金（Cash）*, *ギフトカード（Gift card）*, *クーポン（Coupon）*, *カスタム（Custom）*).                                                                         |
| 値（Value）                                                                                                           | 報酬の数値的な値（例：10、100など）。                                                                                                                                      |
| 単位（Unit）                                                                                                           | 値に関連付けられた単位（例： *USD*, *ポイント（points）*, *ZAR*, *%*).                                                                                                         |
| 名前                                                                                                                 | 報酬の表示名（reward configurationで定義されたものとして） [報酬設定（reward configuration）](https://help.impact.com/brand/ja/advocate-program/advocate-rewards/create-a-reward)). |
| 報酬ソース（Reward Source）                                                                                               | 報酬を引き起こしたトリガーの説明（例： *紹介（Referral）*, *ゴール（Goal）*, *手動（Manual）*, *API*).                                                                                     |
| Fuel Tankタイプ（Fuel Tank Type）                                                                                       | 使用される報酬ファンドの種類（FuelTank統合を使用している場合）。例： *プリペイド（Prepaid）*, *ギフトカード（Gift card）*.                                                                              |
| Fuel Tankコード（Fuel Tank Code）                                                                                       | 外部提供に関連するコード（例：バウチャーやギフトカードのコード）。                                                                                                                          |
| プログラムID（Program ID）                                                                                                | 報酬が発行されたAdvocateプログラムのID。                                                                                                                                  |
| プログラム報酬キー（Program Reward Key）                                                                                      | プログラム内で使用される特定の報酬設定の内部識別子。                                                                                                                                 |
| グローバル報酬キー（Global Reward Key）                                                                                       | グローバルレベルで設定された報酬のクロスプログラム識別子（該当する場合）。                                                                                                                      |
| **報酬のタイムスタンプ（Reward Timestamps）**                                                                                  |                                                                                                                                                            |
| 作成日（Date Created）                                                                                                  | 報酬レコードがシステムに作成された時刻。                                                                                                                                       |
| 予定日（Date Scheduled For）                                                                                            | 報酬が発行されるよう予定されていた日時（例：遅延や待機期間の後）。                                                                                                                          |
| 付与日（Date Given）                                                                                                    | 報酬が実際に参加者に付与された日時。                                                                                                                                         |
| 有効期限日（Date Expires）                                                                                                | 報酬の有効期限（日付）（該当する場合）。                                                                                                                                       |
| 取消日（Date Cancelled）                                                                                                | 報酬が無効化または取り消された日付。                                                                                                                                         |
| 引換日（Date Redeemed）                                                                                                 | 参加者が報酬を引き換えた日付（該当する場合）。                                                                                                                                    |
| 更新日（Date Modified）                                                                                                 | 報酬レコードに対して直近で行われた更新の日付。                                                                                                                                    |
| **クレジットおよび価値の追跡（Credit and Value Tracking）**                                                                       |                                                                                                                                                            |
| 割り当てられたクレジット（Assigned Credit）                                                                                      | この報酬に割り当てられたクレジットの額（一部のモデルでは値と異なる場合があります）。                                                                                                                 |
| 引き換えられたクレジット（Redeemed Credit）                                                                                      | 報酬から実際に引き換えられたクレジットの額。                                                                                                                                     |
| 利用可能な価値（Available Value）                                                                                           | 未使用または未引換の残りの報酬部分。                                                                                                                                         |
| **報酬のステータスおよびメッセージ（Reward Status & Messaging）**                                                                    |                                                                                                                                                            |
| ステータス（Statuses）                                                                                                    | 報酬の現在のステータス（例： *保留（Pending）*, *予定（Scheduled）*, *付与済み（Given）*, *期限切れ（Expired）*, *キャンセル（Cancelled）*).                                                        |
| 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>

#### 紹介履歴（Referral history）

この *紹介履歴（Referral history）* レポートはあなたの紹介プログラムで作成された各紹介接続の状態の記録を提供します。この情報はプログラムの成功を確認したり、プログラムがもたらした新規顧客数を追跡する際に役立ちます。

<details>

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

デフォルトでは、レポートには以下が含まれます：

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

フィールドの完全な一覧は、 [サンプル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) 紹介アクティビティレポート（referral activity report）。

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

| 列                                                                                                                                | 説明                                                                     |
| -------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- |
| **紹介メタデータ（Referral Metadata）**                                                                                                   |                                                                        |
| ID                                                                                                                               | Advocate内の紹介レコードの一意の識別子。                                               |
| 更新日（Date Modified）                                                                                                               | 紹介レコードのいずれかの部分が最後に更新された最新の日付。                                          |
| 紹介開始日（Date Referral Started）                                                                                                     | 紹介が最初に開始された日時（例：紹介リンクがクリックされた時）。                                       |
| コンバート日（Date Converted）                                                                                                           | 紹介がコンバートした日時。通常、紹介されたユーザーが必要なアクション（サインアップや購入など）を完了した時。                 |
| ユーザー更新日（Date User Modified）                                                                                                      | この紹介に関連するユーザーデータ（紹介者または紹介先）が最後に更新された時刻。                                |
| プログラムID（Program ID）                                                                                                              | この紹介が属するAdvocate紹介プログラムのID。                                            |
| プログラム名（Program Name）                                                                                                             | 複数のプログラムを管理している場合に役立つ、紹介プログラムの名称。                                      |
| **紹介された友人（新規顧客）情報**                                                                                                              |                                                                        |
| <p>紹介されたユーザーのメール（Referred User Email）</p><p>紹介されたユーザーの名（Referred User First Name）</p><p>紹介されたユーザーの姓（Referred User Last Name）</p> | 紹介されたユーザーの基本的な識別情報。                                                    |
| 紹介されたユーザーの紹介コード（Referred User Referral Code）                                                                                     | 紹介されたユーザーに割り当てられた紹介コード（後に他者を紹介できる場合）。                                  |
| <p>紹介されたユーザーの初回記録IP（Referred User First Seen IP）</p><p>紹介されたユーザーの最終記録IP（Referred User Last Seen IP）</p>                          | 紹介されたユーザーの最初と直近のアクティビティで記録されたIPアドレス。                                   |
| 紹介されたユーザーの画像URL（Referred User Image Url）                                                                                         | キャプチャまたは割り当てられた場合の紹介されたユーザーの画像またはアバターのURL。                             |
| 紹介されたユーザーのロケール（Referred User Locale）                                                                                             | 言語/地域設定（例： *en-US*, *fr-FR*)。紹介されたユーザーの。                               |
| 紹介されたユーザーの作成日（Referred User Date Created）                                                                                        | 紹介されたユーザーアカウントがAdvocateで作成された日付。                                       |
| 紹介されたユーザー（Referred User）                                                                                                         | Advocateシステム内の紹介されたユーザーの内部ID。                                          |
| 紹介されたアカウント（Referred Account）                                                                                                     | 紹介されたユーザーに関連付けられた内部アカウントID（マルチアカウントプログラムで使用）。                          |
| **紹介者（カスタマーアドボケイト）情報**                                                                                                           |                                                                        |
| <p>紹介者のユーザーメール（Referrer User Email）</p><p>紹介者の名（Referrer User First Name）</p><p>紹介者の姓（Referrer User Last Name）</p>               | 紹介者の基本的な識別情報。                                                          |
| 紹介者の紹介コード（Referrer User Referral Code）                                                                                           | 紹介者に属する紹介コードで、紹介されたユーザーが使用した可能性のあるコード。                                 |
| <p>紹介者の初回記録IP（Referrer User First Seen IP）</p><p>紹介者の最終記録IP（Referrer User Last Seen IP）</p>                                      | 紹介者の最初と直近のアクティビティで記録されたIPアドレス。                                         |
| 紹介者の画像URL（Referrer User Image Url）                                                                                               | 紹介者の画像またはアバターのURL。                                                     |
| 紹介者のロケール（Referrer User Locale）                                                                                                   | 紹介者のロケール設定。                                                            |
| 紹介者の作成日（Referrer User Date Created）                                                                                              | 紹介者がシステムに初めて登録または記録された日時。                                              |
| 紹介者（Referrer User）                                                                                                               | Advocate内の紹介者の内部ID。                                                    |
| 紹介者のアカウント（Referrer Account）                                                                                                      | 紹介者に関連付けられたアカウントID。                                                    |
| **モデレーションおよびステータス（Moderation & Status）**                                                                                         |                                                                        |
| モデレーションステータス（Moderation Status）                                                                                                  | 紹介の全体的なモデレーションステータス（例： *承認（Approved）*, *却下（Rejected）*, *保留（Pending）*.) |
| モデレーション日（Date Moderated）                                                                                                         | モデレーションの決定（承認/却下）が行われた日付。                                              |
| 紹介支払い日（Date Referral Paid）                                                                                                       | 紹介に関連する報酬が支払われた日時。                                                     |
| 紹介終了日（Date Referral Ended）                                                                                                       | 紹介レコードが正式に終了した日時（例：期限切れや完了のため）。                                        |
| 紹介先のモデレーションステータス（Referred Moderation Status）                                                                                     | 紹介先ユーザー側に特有のモデレーションステータス。                                              |
| 紹介者のモデレーションステータス（Referrer Moderation Status）                                                                                     | 紹介者側に特有のモデレーションステータス。                                                  |
| **報酬参照（Reward References）**                                                                                                      |                                                                        |
| 紹介先の報酬（Referred Reward）                                                                                                          | 紹介されたユーザーに付与された報酬のIDまたは参照（該当する場合）。                                     |
| 紹介者の報酬（Referrer Reward）                                                                                                          | 紹介者に付与された報酬のIDまたは参照（該当する場合）。                                           |

</details>

#### ユーザーごとの報酬残高（Reward balances by user）

この *ユーザーごとの報酬残高（Reward balances by user）* レポートは、紹介プログラムを通じて生成された未払いの報酬の記録（価値と意図された受取人を含む）を提供します。このレポートは手動での報酬実行やTango Cardのようなシステムへのバッチ処理の一部としてよく使用されます。また、特定期間に紹介プログラムが支払った金額を追跡する際にも役立ちます。

<details>

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

デフォルトでは、レポートには以下が含まれます：

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

フィールドの完全な一覧は、 [サンプル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) 報酬残高レポート（reward balances report）。

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

| 列                                       | 説明                                                                                                                  |
| --------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| **参加者情報（Participant Information）**      |                                                                                                                     |
| ユーザーID（User ID）                         | Advocate内での参加者の一意の識別子。報酬残高を個々のユーザーに結び付けるために使用されます。                                                                  |
| アカウントID                                 | 参加者に関連付けられた内部アカウントID。ユーザーが組織やセグメントされたアカウントグループに所属する場合に特に関連します。                                                      |
| メール                                     | 参加者のメールアドレス。手動での報酬提供や外部システムとの同期に頻繁に使用されます。                                                                          |
| <p>名（First Name）</p><p>姓（Last Name）</p> | 参加者の名と姓。報酬処理時のパーソナライズやフィルタリングに有用です。                                                                                 |
| 紹介コード                                   | 参加者に割り当てられた紹介コード。これは他者を紹介し報酬資格を追跡するために共有されます。                                                                       |
| **報酬情報**                                |                                                                                                                     |
| タイプ（Type）                               | 報酬のカテゴリまたは方法（例： *現金（Cash）*, *ギフトカード（Gift card）*, *ポイント（Points）*, *カスタム（Custom）*）。報酬をどのように履行またはグループ化するかを判断するのに役立ちます。 |
| 単位（Unit）                                | 報酬値の単位（例： *USD*, *ZAR*, *ポイント（Points）*, *%*）。残高計算や地域別の支払い処理に重要です。                                                   |
| 金額（Amount）                              | このユーザーの未払い報酬の合計利用可能残高。支払い準備やエクスポート時に使用される主要な数値です。                                                                   |
| 割り当てられた総クレジット（Total Assigned Credit）    | このユーザーにこれまで割り当てられたクレジットの総額（引換に関係なく）。参加者に割り当てられたプログラム全体のコストを反映します。                                                   |
| 総引換済みクレジット（Total Redeemed Credit）       | この参加者がすでに引き換えた報酬の合計部分。実際のコストと負債の監査に有用です。                                                                            |
| 総期限切れクレジット（Total Expired Credit）        | ユーザーに割り当てられたが引き換えられる前に期限切れになった総報酬。未請求の報酬や失われた履行機会を追跡するのに役立ちます。                                                      |
| **ユーザーメタデータ（User Metadata）**            |                                                                                                                     |
| 画像URL（Image Url）                        | 参加者のプロフィール画像やアバターのURL（収集されている場合）。主に見た目上やユーザー向けダッシュボードで使用されます。                                                       |
| 初回記録IP（First Seen IP）                   | 参加者が追加またはアクティブになったときに記録された最初のIPアドレス。コンプライアンス、位置タグ付け、詐欺分析に有用です。                                                      |
| 最終記録IP（Last Seen IP）                    | 参加者に関連付けられた最新のIPアドレス。ユーザーがまだアクティブか関与しているかを判断するのに役立ちます。                                                              |
| 作成日（Date Created）                       | 参加者アカウントがAdvocateで作成された日付。コホート分析や時間経過による報酬行動の分析に有用です。                                                               |
| 紹介ソース                                   | 参加者が獲得された元のソースまたはチャネル（例： *メール（email）*, *オーガニック（organic）*, *パートナー（partner）*）。チャネル別に紹介プログラムのリーチと効果を評価するのに役立ちます。       |
| ロケール（Locale）                            | 参加者の言語および地域設定（例： *en-US*, *fr-FR*）。パーソナライズされた通信や地域別の報酬オプションに重要です。                                                   |

</details>

#### ユーザーごとの利用可能な報酬残高（Available reward balances by user）

この *ユーザーごとの利用可能な報酬残高（Available reward balances by user）* レポートは未引換の報酬一覧を提供します。このレポートタイプは、 [一括報酬引換（bulk reward redemption）](https://help.impact.com/brand/ja/advocate-program/advocate-rewards/redeem-rewards-in-bulk) プロセスを通じて報酬を履行する際に使用することを意図しています。

<details>

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

デフォルトでは、レポートには以下が含まれます：

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

フィールドの完全な一覧は、 [サンプル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" %}
**注意（Note）**：このレポートにはパーセンテージ割引、Fuel Tank、ギフトカード報酬の詳細は含まれません。これらのタイプの報酬の詳細については、 *ユーザーごとの報酬残高（Reward balances by user）* レポートを参照してください。
{% endhint %}

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

| 列                                  | 説明                                                                                                                                                                                                      |
| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **参加者情報（Participant Information）** |                                                                                                                                                                                                         |
| 名（First Name）                      | 参加者の名は、報酬処理時の識別やパーソナライズに使用されます。                                                                                                                                                                         |
| 姓（Last Name）                       | 参加者の姓。                                                                                                                                                                                                  |
| メール                                | 参加者のメールアドレスは、報酬を送信したりCRMや報酬提供者などの外部システムと照合するために使用されます。                                                                                                                                                  |
| ユーザーID（User ID）                    | Advocate内で参加者に割り当てられた一意の識別子。                                                                                                                                                                            |
| アカウントID                            | 参加者にリンクされた内部アカウントID。                                                                                                                                                                                    |
| セグメント                              | に使用されるタグまたはカテゴリ [参加者をグループ化する](https://help.impact.com/brand/ja/advocate-program/manage-advocate-participants/manage-advocate-user-segments) （例： *地域別*, *ライフサイクル段階*, *顧客タイプ*）。フィルタリングや異なる履行ルールの適用に役立ちます。 |
| **報酬のステータスとタイミング**                 |                                                                                                                                                                                                         |
| ブロック日                              | 該当する場合、ユーザーが報酬の受け取りをブロックされた日付。ブロック状態は換金を制限する可能性があり、このフィールドはそのブロックがいつ適用されたかを示します。                                                                                                                        |
| **報酬データ**                          |                                                                                                                                                                                                         |
| 単位名                                | 報酬単位のラベルまたは表示名（例： *紹介キャッシュ*, *ストアクレジット*）。プログラムが提供する複数の報酬タイプを区別するのに役立ちます。                                                                                                                                |
| 通貨                                 | 報酬額の通貨コード（例： *USD*, *ZAR*, *EUR*）。国や支払いシステムを跨いで報酬を履行する際に必要です。                                                                                                                                           |
| 利用可能な価値（Available Value）           | この参加者に現在利用可能な未換金の報酬額。支払額を決定する際のコア値です。                                                                                                                                                                   |
| 換金予定額                              | 現在換金キューに入っている（例：一括履行で保留中、処理待ちの）金額。二重換金を防いだり換金の重複を避けるのに役立ちます。                                                                                                                                            |
| 総換金済み金額                            | この参加者が既に換金した報酬の合計額。過去の換金の洞察を提供し、報酬上限の追跡に役立ちます                                                                                                                                                           |
| 単位（Unit）                           | 報酬単位の内部またはシステムコード（例： *USD*, *ポイント（points）*&#x306A;ど）。履行時のAPI呼び出しや内部ロジックで使用されることがあります。                                                                                                                   |

</details>

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

米国W-9税務レポートは、参加者の米国W-9税務ステータスと年ごとの獲得または保留中の報酬を表示します。

<details>

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

デフォルトでは、レポートには以下が含まれます：

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

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

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

</details>

#### 支払いと税金

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

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

<details>

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

デフォルトでは、レポートには以下が含まれます：

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

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

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

</details>
