> 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/manage-advocate-participant-experiences/microsite-experiences/customize-and-map-your-microsite-registration-form.md).

# マイクロサイト登録フォームをカスタマイズしてマッピングする

参加者がマイクロサイトからプログラムに登録すると、フォームを通じて登録データを収集・保存します。 [マイクロサイトをセットアップ](https://help.impact.com/brand/ja/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/microsite-experiences/set-up-a-microsite.md) するときに自動セットアップを使用すると、フォームが自動的に作成されます。このヘルプ記事では、登録フォームの送信ルールの設定方法と、追加のフォームフィールドのマッピング方法について説明します。

#### マイクロサイトの送信処理ルールをカスタマイズする

フォームの送信処理ルールを設定すると、新しい送信が試みられるたびにチームのメンバーへ通知できます。新しい参加者の登録状況を追跡したい場合や、登録が試みられたものの失敗したときに通知を受け取りたい場合に便利です。また、更新された参加者を特定のユーザーセグメントに自動的に追加または削除することもできます。

1. 左側のナビゲーションメニューから、 ![](https://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage] → データソース** → **フォーム**.
2. カスタマイズする登録フォームにカーソルを合わせ、 **編集**.
3. 「 *登録フォームを更新」ページ*で、下にスクロールして *フォーム送信が成功した場合*.
   * 登録が正常に完了したときにメールを受け取るユーザーを選択します。
   * 登録が正常に完了した後、参加者を追加するユーザーセグメント（ある場合）を選択します。
4. 「 *フォーム送信が失敗した場合* 」セクションで、送信が失敗したときにメールを受け取るユーザーを選択します。
5. 「 **登録を更新**.

#### 登録フォームのフィールドをマッピングする

マイクロサイトの登録フォームを作成したら、登録時にフォームの値または固定データを設定するよう、Advocateの参加者フィールドを構成できます。マイクロサイトには、次のフォームフィールドがデフォルトで用意されています。 *名*, *姓*, *メールアドレス*、および *パスワード*。登録フォームを変更して、マイクロサイトのユーザーに関する追加情報（たとえば、 *電話番*号、 *国／所在地*, *業種*など）を収集できます。また、利用規約への同意を求めるチェックボックスを追加することもできます。

**登録フォームにフィールドを追加する**

1. 左側のナビゲーションメニューから ![](https://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[エンゲージ] → \[コンテンツ]**.
2. 「 *マイクロサイト* 」カードで、 **「コンテンツを編集」**.
   * この操作を行うと、マイクロサイトエディターが開き、マイクロサイトのスライドアウトが表示されます。
3. 「 *ログアウト時のレイアウト* 」セクションで、 **登録**.
4. 「 *コンポーネント* 」メニューから、 **追加** → **マイクロサイトコンポーネント**.
5. 追加データの収集に適したコンポーネントを選択し、 **追加フィールドに追加**.
6. 「 *コンポーネント* メニューで、 **編集** タブが選択されていることを確認し、次の情報を入力します。
   * **必須項目のエラーメッセージ：** 必須項目に情報が入力されていない場合に表示されるメッセージです。
   * **入力ラベル：** 登録フォームに表示する追加フィールドの名前です。
   * **入力の name 属性：** 追加フィールドをユーザーデータにマッピングするためのキーです。
   * ![](https://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FiZjM1xY8o3v1iR3Zaysd%2FToggle.svg?alt=media\&token=b1550d48-bba9-4e81-8604-bc12370c5caa) **\[オンに切り替え]** **任意** 必須項目でない場合。
   * 「 *入力* 」タイプのドロップダウンメニューから、フィールドで情報を収集する方法を選択します。
7. を選択します。 **保存**.

**追加フィールドをマッピングする**

1. 左側のナビゲーションメニューから、 ![](https://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage] → データソース** → **フォーム**.
2. カスタマイズする登録フォームにカーソルを合わせ、 **編集**.
3. 「 *登録フォームの更新ページ*で、 **詳細設定**.
4. 「 *Advocate Participant Field*」の下にある **マッピングを追加**.
5. ドロップダウンリストから Advocate の値を選択し、登録時に評価されるマッピング値を *JSONata Expression(s)* テキストボックスに入力します。
   * **セグメントに追加：** 登録後に参加者をセグメントに追加するためのルールを設定します。

     **例：** `($contains(email, “acme.com”) ? ($append(segments, “Existing”)))`
   * **カスタムフィールド：** 登録フォームで取得するカスタム値をマッピングします。

     **例：** 携帯電話 → `cellPhone`
   * **国：** ユーザーの国コードを取得します。

     **例：** 国 → `countryCode`
   * **ロケール：** 参加者のロケールフィールドに名前を付けてマッピングしたロケールフォームフィールドの値です。

     **例：** ロケール → `locale`
   * **紹介者コード：** 紹介者固有の紹介コードを取得します。

     **例：** `$exists(referredByCodes) AND referredByCodes != ""`
   * **紹介可能：** ユーザーを紹介できるかどうかを指定します。

     **例：** 紹介可能 → `false`
6. 選択 **登録情報を更新** 完了したら。

   * 登録フォームの送信内容を確認するには、次を参照してください。 [登録フォームの送信内容を確認する](https://help.impact.com/brand/ja/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/microsite-experiences/view-your-microsite-registration-form-submissions.md).

   <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%2FSUEDTMBL8XWwd5SDsQrL%2FUntitled%20design%20(51).png?alt=media&amp;token=2c8b47f4-c2b7-4b6b-88be-bb96df00ec44" alt=""><figcaption></figcaption></figure></div>


---

# 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/manage-advocate-participant-experiences/microsite-experiences/customize-and-map-your-microsite-registration-form.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.
