> 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).

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

参加者がマイクロサイトを通じてプログラムに登録すると、フォームを介して登録データを収集し保存します。あなたが [マイクロサイトを設定する](/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 の参加者フィールドをフォーム値または静的データに設定するよう構成できます。マイクロサイトには、次の既定のマイクロサイト フォーム フィールドが付属しています。 *名*, *姓*, *メールアドレス*、および *パスワード*。登録フォームを変更して、次のようなマイクロサイトユーザーに関する追加情報を収集できます。 *電話番号*r、 *国/地域*, *事業タイプ*などを追加できます。また、利用規約のチェックボックスを追加して、ユーザーに規約への同意を促すこともできます。

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

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. 〜で *マイクロサイト* カードで、 **コンテンツを編集**.
   * この操作により、Microsite エディターが開き、Microsite のスライドアウトが表示されます。
3. 以下の *ログアウト時レイアウト* セクションで、 **登録**.
4. 〜の中で *コンポーネント* メニューで、 **追加** → **Microsite コンポーネント**.
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 参加者フィールド*、選択してください **マッピングを追加**.
5. ドロップダウンリストから Advocate の値を選択し、次の値でマッピング値を入力します *JSONata 式* テキストボックス。登録時に評価されます。
   * **セグメントに追加:** 登録後に参加者をセグメントに追加するための特定のルールを構成します。

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

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

     **例:** 国 → `countryCode`
   * **ロケール:** 参加者のロケール フィールドに指定され、マッピングされた locale フォーム フィールドの値。

     **例:** ロケール → `locale`
   * **紹介コード:** 紹介者の一意の紹介コードを取得します。

     **例:** `$exists(referredByCodes) AND referredByCodes != ""`
   * **紹介可能:** ユーザーが紹介可能かどうかを示します。

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

   * 登録フォームの送信内容を確認するには、次を参照してください。 [登録フォームの送信内容を表示する](/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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
