> 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/component-libraries-explained.md).

# コンポーネントライブラリの解説

コンポーネントは、ヒーロー画像やタスクカードなど、ウィジェットやマイクロサイトを構成する個々の部品です。現在のテンプレートはすべて、MintとBedrockのコンポーネントライブラリを使用しています。

<details>

<summary>Mintコンポーネント</summary>

Mintコンポーネントで構築されたウィジェットやマイクロサイトを使うと、カスタマーアドボケイトに最新のAdvocateエクスペリエンスを提供できます。現在のテンプレートの多くはMintコンポーネントを使用しています。現在のコンポーネントライブラリを使用しているかどうかわからない場合は、手動で確認し、必要に応じてライブラリを更新できます。

次の **プログラムウィジェット**:

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. を選択します ![](https://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-3ca70a1ff22f0720bfb8c9e284c7d8178e3a547b%2Fb6a126b0775291b814c5a97f83039ef72ba42d6d02b0fe20f4790213ea01961e.svg?alt=media) **パッケージを追加**.
6. 「 **追加** 」を *Mintコンポーネント* カードで選択します。

次の **マイクロサイト**:

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. を選択します ![](https://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-3ca70a1ff22f0720bfb8c9e284c7d8178e3a547b%2Fb6a126b0775291b814c5a97f83039ef72ba42d6d02b0fe20f4790213ea01961e.svg?alt=media) **パッケージを追加**.
5. 「 **追加** 」を *Mintコンポーネント* カードで選択します。
6. を選択します。 **保存**.

</details>

<details>

<summary>Bedrockコンポーネント</summary>

Mintコンポーネントを使用するすべてのテンプレートには、Bedrockコンポーネントパッケージもインストールされています。Bedrockコンポーネントは参加者には表示されませんが、デザインに高度なロジックを追加できます。条件に応じて別のコンポーネントを表示したり、コンポーネントがどのプログラムからデータを取得するかを指定したりできます。Bedrockコンポーネントパッケージは、ウィジェットエディターまたはマイクロサイトエディターの「 *高度なコンポーネント* 」セクション内の「 *追加* 」タブにあります。

Bedrockコンポーネントパッケージには、次の2つのコンポーネントがあります。

**条件付きセクション**

「 *条件付きセクション* 」コンポーネントを使うと、参加者のメールアドレス、国、セグメント、またはカスタムフィールドに基づいて条件付きコンテンツを追加できます。表示条件を設定するには、 *条件* ボックスにJSONata式を入力します。その後、条件付きセクション内で、特定の参加者グループに表示するコンテンツを適切なグループに移動します。

**プログラムセクション**

「 *プログラムセクション* 」コンポーネントを使うと、子コンポーネントのプログラムIDを上書きできます。特定のプログラムに関連付けられていないコンテンツを表示する場合に使用します。 *プログラムセクション* コンポーネントは、ほとんどのウィジェットとマイクロサイトのテンプレートにデフォルトで含まれています。

</details>

<details>

<summary>カスタムコンポーネントライブラリ</summary>

独自のコンポーネントパッケージを作成して使用することで、Advocate のエクスペリエンスをさらにカスタマイズできます。これらのコンポーネントは任意のテンプレートに追加でき、Advocate が提供するコンポーネントと併用できます。

Advocate ウィジェットでは標準の HTML と [Web コンポーネント](https://www.webcomponents.org/) を使用します。ウィジェットエディターで独自のコンポーネントを使用するには、Web コンポーネントとして作成する必要があります。

カスタムコンポーネントを使ってウィジェットを作成するには、まずカスタムパッケージをインストールします。

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. を選択します ![](https://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-3ca70a1ff22f0720bfb8c9e284c7d8178e3a547b%2Fb6a126b0775291b814c5a97f83039ef72ba42d6d02b0fe20f4790213ea01961e.svg?alt=media) **パッケージを追加**.
6. 選択 ![](https://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-3ca70a1ff22f0720bfb8c9e284c7d8178e3a547b%2Fb6a126b0775291b814c5a97f83039ef72ba42d6d02b0fe20f4790213ea01961e.svg?alt=media) **NPM から追加**.
7. パッケージの *名前*, *バージョン* および *ファイルパス*.
8. を選択します。 **追加**.

</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/manage-advocate-participant-experiences/component-libraries-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.
