> 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/getting-started-with-advocate/data-requirements-for-advocate-users.md).

# Advocateユーザーのデータ要件

Advocateのデータ収集方法は独特です。というのも、AdvocateにはCreatorやPerformanceのようなパートナーマーケットプレイスがなく、impact.comはあなたのAdvocateプログラムに登録しているエンドユーザーと直接の関係を持たないためです。キャッシュ支払いは例外で、ユーザーは報酬の支払いを円滑にするために銀行情報と税務情報をimpact.comに提供します。

<div data-with-frame="true"><figure><img src="https://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-dceec20685c4f1335a1f645dff448f862fcaf7f2%2F3c95b14a395878b4e7c83a88a16a3648e83a0ba22005d07e284b229583aaa425.png?alt=media" alt=""><figcaption></figcaption></figure></div>

#### 直接データ

直接データは、通常はエンドユーザーが入力するか、直接提供されるなど、ソースからそのまま取得されます。

一意のIDをユーザーに使用する場合、直接のユーザーデータがなくてもプログラムを実行することは可能です。一意のIDのみでプログラムを実行するということは、 *できません* 次のAdvocate機能を使用できません:

* メールを送信する
* Tango Card連携を通じてギフトカード報酬を送信する
* 不正管理

Advocateにユーザーデータを送信する際、次のユーザーデータ項目を含めることができます。

<details>

<summary>直接ユーザーデータ項目</summary>

* ユーザーID（必須）
  * ユーザーのメールアドレスを、次の形式で保存して使用することを推奨します。 `SHA1` ハッシュ。
* アカウントID（必須）
  * ユーザーのメールアドレスを、次の形式で保存して使用することを推奨します。 `SHA1` ハッシュ。
* 名（任意）
* 姓（任意）
* メールアドレス（ユーザーにメールを送信したい場合は必須、それ以外は任意）
* ユーザーのロケール（任意）
* ユーザーの国（任意）
* dateUsTaxFormSubmitted（任意）
* Cookie（任意）
  * AdvocateプログラムのCookie： `Base64URL` 使用された共有リンク、Cookieの有効期限、紹介者の一意の紹介コードを含むエンコードされたオブジェクト。
* セグメント（任意）
* カスタムフィールド（任意）
  * ユーザーに関する追加データを保存するために使用できる自由形式のフィールド。たとえば、郵送先住所、サブスクリプションの階層、電話番号など。
* ユーザー作成日（Advocate内）（任意）
* ユーザー最終更新日（Advocate内）（任意）

</details>

#### 取引および支払いデータ

* **現金報酬：** 現金支払いシステムを使用している場合、Advocateは支払いプロセスの一環として、ユーザーが提供した銀行情報と税務情報もimpact.comに直接取得・保存します。ユーザーはまた、支払いに関連する利用規約に同意する必要があります。もしあなたが *しない* 現金支払いシステムを使用しない場合、たとえば代わりにギフトカードや割引コードを報酬として付与する場合、エンドユーザーはimpact.comとの関係を持ちません。
* **Tango Card報酬連携：** ギフトカードの報酬にTango Card連携を使用している場合、ユーザーの名、姓、メールアドレスが報酬の履行を円滑にするためにTango Cardへ渡されます。

#### 間接データ

エンドユーザーは間接データを直接入力しません。代わりに、より深いインサイトを得るために他のソースから収集されます。

次のデータ項目はユーザーについて追跡・保存されますが、個人を特定できる情報（PII）ではありません。

<details>

<summary>間接ユーザーデータ項目</summary>

* ウィジェットの読み込み回数
* トラフィック（ユーザーの共有リンクが生成した紹介トラフィック量）
* ユーザーが獲得した報酬
* IPアドレス（実装にJavaScriptを使用している場合）
  * ユーザーがウィジェットを読み込んだとき、および／または紹介先ユーザーになったとき、プラットフォームによってそのユーザーのIPアドレスが取得・保存されます。

</details>

#### ユーザーデータの使用

ユーザーデータは次の方法で使用できます：

* **ユーザー識別：** ユーザーIDとアカウントIDは、ユーザーを識別するために使用されます。
* **パーソナライズされたコンテンツ：** ユーザーの名、姓、メールアドレスを提供いただくことで、当社のプラットフォームがエンドユーザーに紹介に関するメールを送信し、ウィジェットやメールでパーソナライズされたコンテンツを提供できるようになります（例：「あなたの友人Bobが購入を完了しました。もうすぐ報酬が届きます！」）。
* **不正検知：** ユーザーの氏名、メールアドレス、IPアドレスは、潜在的に不正な紹介を検出するために当社の不正管理ツールで使用されます。
* **国際化：** ユーザーの国とロケールは国際化に使用されます。
* **支払いと税務登録：** エンドユーザーは、次の目的で銀行情報と税務情報を提供します：
  * 報酬の支払いを受け取るため。
  * 米国のW-9税務フォームが提出されたことを示すため。


---

# 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/getting-started-with-advocate/data-requirements-for-advocate-users.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.
