> ## Documentation Index
> Fetch the complete documentation index at: https://docs.notifly.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Webポップアップのテンプレートを作成する

> ブロックを組み合わせてWebポップアップのテンプレートを作り、キャンペーンやユーザージャーニーで使います。

## 概要

Notiflyのエディターでブロックを組み合わせて、Webポップアップを作成できます。

## SDKの最小バージョン

このエディターで作成したポップアップを表示するには、サイトにNotiflyのJavaScript SDK **2.12.0** 以上が必要です。

> [!NOTE]
>
> 文言をパーソナライズするには、JavaScript SDK **2.21.0**以上が必要です。これより古いSDKでは、パーソナライズを含むポップアップは表示されません。パーソナライズを使わないポップアップには、上記の最小バージョンが適用されます。

## テンプレートを作成する

サイドバーで **メッセージテンプレート > ウェブ内ポップアップテンプレート** を開きます。

![Webポップアップテンプレートの一覧](https://mintcdn.com/notifly/ZSWJJOaZ4UmG3tpK/images/i18n/ja/web-message/webpopup-new.png?fit=max\&auto=format\&n=ZSWJJOaZ4UmG3tpK\&q=85\&s=4ce5cd0d5dff734af2fa043d6b1b524d)

従来のエディターを使っている場合は、先に **最新エディターを使用** をクリックします。次に **新しいテンプレートを作成** をクリックします。

![テンプレート作成画面](https://mintcdn.com/notifly/DHduOkdsm1-HMvmh/images/i18n/ja/in-app-message/popup-new.png?fit=max\&auto=format\&n=DHduOkdsm1-HMvmh\&q=85\&s=198eb2f679c02d8ace7462569f65b1da)

用意されたレイアウトを選びます。白紙から作る場合は、**最初から作成**を選びます。

## エディターの構成

![ツールバー、ブロックパネル、キャンバス、設定パネルを備えたエディター](https://mintcdn.com/notifly/ZSWJJOaZ4UmG3tpK/images/i18n/ja/web-message/webpopup-editor.png?fit=max\&auto=format\&n=ZSWJJOaZ4UmG3tpK\&q=85\&s=a65301149a7eabb73b2c5de981698933)

**上部のツールバー**では、テンプレート名の入力、操作の取り消しとやり直し、プレビュー、保存ができます。

**左側のブロックパネル**では、画像、テキスト、ボタン、区切り線、余白、HTMLを追加できます。複数の列を並べるには行ブロックを使います。スライドを表示するにはカルーセルを、現在のスライドの位置を示すにはインジケーターを使います。

**中央のキャンバス**には、編集中のポップアップが表示されます。上部のメニューで端末の種類（モバイル、タブレット、デスクトップ）と解像度を切り替えると、画面サイズごとの表示を確認できます。

**右側の設定パネル**には、選択したブロックのスタイル設定が表示されます。選択を解除すると、ポップアップ全体の設定が表示されます。

## **ブロックを追加する**

左側のパネルでブロックを選ぶと、キャンバスのポップアップに追加されます。追加したブロックをクリックすると、青い枠と操作用のツールバーが表示されます。

![選択したブロックのツールバー](https://mintcdn.com/notifly/DHduOkdsm1-HMvmh/images/i18n/ja/in-app-message/toolbar.png?fit=max\&auto=format\&n=DHduOkdsm1-HMvmh\&q=85\&s=c2cdf433a02f381fecf657514c3397e6)

* **上へ移動**または**下へ移動**で、ブロックの順序を変更できます。
* **ブロックを複製**をクリックすると、設定も含めてコピーされます。
* 選択したブロックを取り除くには、**ブロックを削除**をクリックします。

![キャンバス上で選択したブロック](https://mintcdn.com/notifly/DHduOkdsm1-HMvmh/images/i18n/ja/in-app-message/block.png?fit=max\&auto=format\&n=DHduOkdsm1-HMvmh\&q=85\&s=dc0d2d1f501ed76aa3cd72416bfe3a26)

### **コンテンツブロック**

**画像**ブロックを追加し、右側のパネルで画像をアップロードします。幅はパーセントで指定します。高さは自動で調整するか、縦横比で指定します。角の丸み、外側の余白、クリックアクション、代替テキストも設定できます。

画像ブロックの画像URLとクリックアクションには、パーソナライズ変数を使えません。

**テキスト**ブロックの文章は右側のパネルに入力します。同じパネルでフォント、文字サイズ、行の高さ、太さ、文字色、配置を設定できます。一部の文字だけ書式を変えるには、その文字を選んで太字、斜体、下線、文字色を設定します。

ユーザーの名前やイベント情報を差し込むには、パーソナライズ変数を使います。

1. テキストブロックを選択します。右側の**テキスト内容**で、変数を挿入する位置にカーソルを置きます。
2. 入力欄の下にある**パーソナライズ変数**をクリックします。
3. **変数タイプ**と**変数名**を選択または入力します。値がないときに表示する文言は**デフォルト値（任意）**に入力します。
4. **貼り付け**をクリックすると、カーソルの位置にLiquidの式が挿入されます。

![パーソナライズ変数の設定で、ユーザー属性名の name と韓国語のデフォルト値を入力した例](https://mintcdn.com/notifly/DHduOkdsm1-HMvmh/images/i18n/ja/in-app-message/variable-input.png?fit=max\&auto=format\&n=DHduOkdsm1-HMvmh\&q=85\&s=2ff87cfd4bfab138ebb51b785eba194a)

例えば、変数タイプに **ユーザー** を選び、変数名に `name`、デフォルト値に「お客」と入力します。名前が登録されていない場合は、例の「様」と組み合わせて「こんにちは、お客様。」と表示されます。画面例のデフォルト値 `고객` は韓国語で「お客様」を意味します。

```liquid theme={null}
こんにちは、{{ user["name"] | default: "お客" }}様。
```

![パーソナライズ変数を挿入したテキストブロック。キャンバスには置換前のLiquid式が表示されます。](https://mintcdn.com/notifly/DHduOkdsm1-HMvmh/images/i18n/ja/in-app-message/text-example.png?fit=max\&auto=format\&n=DHduOkdsm1-HMvmh\&q=85\&s=eac54d147d703ab7383dddb10c9ba8e8)

Liquidを直接入力することもできます。使用できるデータや構文については、[メッセージのパーソナライズの基本](https://docs.notifly.tech/ja/user-guide/campaigns/personalization/basic.md)を参照してください。

**ボタン**ブロックでは、ラベル、背景色と透明度、角の丸み、枠線、フォント、文字色、配置、内側の余白を設定できます。クリックアクションの初期値は**閉じる**です。ボタンからURLやディープリンクを開くには、**リンクを開く**を選びます。

ボタンの文言をパーソナライズするには、**内容 > ラベル** にある **パーソナライズ変数** を使います。URLやディープリンクをパーソナライズするには、**クリックアクション** で **リンクを開く** を選び、**リンク** 入力欄の **パーソナライズ変数** から値を差し込みます。

**区切り線**ブロックを使うと、コンテンツの間に線を引けます。

**余白**ブロックを使うと、ブロックの間に余白を入れられます。

**HTML** ブロックでは、HTMLとCSSを直接記述できます。HTML要素のイベント属性から `notiflyPopup` のメソッドを呼び出すと、ポップアップを閉じたり、リンクを開いたり、カルーセルのスライドを切り替えたりできます。

変数を挿入するには、HTML入力欄の **パーソナライズ変数** をクリックします。条件分岐や繰り返しで処理を変える場合や、[カタログの参照](https://docs.notifly.tech/ja/user-guide/catalogs/guide.md)、[Connected Contentや `abort_message`](https://docs.notifly.tech/ja/user-guide/campaigns/personalization/advanced)を使う場合は、Liquidを直接入力します。`abort_message` が実行されると、ポップアップは表示されません。

#### `notiflyPopup`のメソッドを呼び出す

以下のように、HTML要素の `onclick` 属性でメソッドを呼び出します。

```html theme={null}
<button onclick="notiflyPopup.openUrl('https://example.com')">
  詳細を見る
</button>

<button onclick="notiflyPopup.hideForDays(7)">
  7日間表示しない
</button>
```

| メソッド | 説明 |
| - | - |
| `notiflyPopup.close()` | ポップアップを閉じます。 |
| `notiflyPopup.hideForDays(days)` | ポップアップを閉じ、指定日数の間は同じポップアップを表示しません。 |
| `notiflyPopup.hideForever()` | ポップアップを閉じ、以降は同じポップアップを表示しません。 |
| `notiflyPopup.openUrl(url, options?)` | URLを開きます。Webポップアップでは、HTMLで指定した `openMode` は無視されます。リンクを新しいタブで開く機能に対応したJavaScript SDKでは、すべてのURLアクションで開き方が共通です。エディターのURLアクションのうち1つでも新しいタブで開くように設定すると、このメソッドで指定したリンクも新しいタブで開きます。その設定がない場合は、現在のタブで開きます。 |
| `notiflyPopup.openDeepLink(url)` | 指定したディープリンクを開きます。 |
| `notiflyPopup.nextSlide()` | カルーセルの次のスライドに進みます。 |
| `notiflyPopup.prevSlide()` | カルーセルの前のスライドに戻ります。 |
| `notiflyPopup.goToSlide(index)` | `index` で指定したスライドに移動します。最初のスライドは `0` です。 |

#### Webプッシュの受信同意を取得する

Webポップアップの**ボタン**ブロックに**Webプッシュの同意処理**を設定すると、そのボタンを押したときにNotiflyが受信同意を記録し、ブラウザに通知の許可を求めます。ユーザーがブラウザの確認画面に回答する前に、Webポップアップは閉じます。ログインしていないユーザーも、このボタンで同意できます。

**JavaScript SDK 2.22.0以上**と、サイトのWebプッシュ設定が必要です。対応していないSDKでは同意ボタンが無効になります。

1. Webポップアップエディターで、同意を受け付ける**ボタン**ブロックを選びます。

2. 右側の**クリックアクション**で**Webプッシュの同意処理**を選びます。このアクションを設定できるのはWebポップアップのボタンのみです。

   ![Webプッシュの同意処理の設定とJavaScript SDK 2.22.0以上の要件](https://mintcdn.com/notifly/ZSWJJOaZ4UmG3tpK/images/i18n/ja/web-message/editor-action.png?fit=max\&auto=format\&n=ZSWJJOaZ4UmG3tpK\&q=85\&s=8e63c3af3b1e46d10cc9a5ef73c16744)

3. ボタンとポップアップの文言で、どのような通知が届くかを案内します。テンプレートを保存し、キャンペーンに設定します。

4. テストユーザーだけを対象にキャンペーンを実行します。対象サイトの通知をまだ許可も拒否もしていないブラウザを使います。ポップアップを表示し、同意ボタンをクリックします。テストユーザーの同意が記録され、ブラウザに通知の許可が求められることを確認します。**プレビュー**にはクリックのログだけが表示されます。

> [!NOTE]
>
> このポップアップからのみ許可を求める場合は、**設定 > SDK設定 > ウェブサイト設定 > 権限要求ポップアップ設定**で**自動表示を使用**をオフにしてください。連携に必要な準備は[JavaScript SDKガイド](https://docs.notifly.tech/ja/developer-guide/javascript-sdk.md#webポップアップのボタンで同意を取得する)を参照してください。

**記録されるユーザー属性**

| ユーザー属性 | 意味 | クリック時に記録する値 |
| - | - | - |
| `$web_push_consent` | Webプッシュの受信に明示的に同意したかどうか | `true` |
| `$web_push_consented_at` | Webプッシュの受信に同意した日時 | UTCのISO 8601形式の文字列。例：`2026-01-01T09:00:00.000Z` |

同意日時は、ボタンをクリックしたブラウザの時計に基づきます。新しく表示されたポップアップで再度同意した場合は、新しいクリック時刻に更新します。一度も同意していないユーザーでは、どちらの値も登録されていないことがあります。

どちらもNotiflyの予約済み属性です。ユーザー属性の設定画面では、新規作成、削除、暗号化の指定はできません。記録された値はユーザーの詳細画面で確認できます。

**ボタンをクリックしたときの動作**

Notiflyは、標準の案内ポップアップを省略してブラウザに通知の許可を直接リクエストします。そのあと、Webポップアップを閉じます。

| ブラウザの権限の状態または結果 | 動作 |
| - | - |
| 許可も拒否もしていない | Notiflyがブラウザに通知の許可を求めます。確認ダイアログが表示されるかどうかはブラウザの仕様によって異なります。 |
| 許可した、またはすでに許可している | ポップアップを閉じた状態でNotiflyがプッシュ通知の購読を登録します。すでに許可済みの場合、ブラウザは再度確認しません。 |
| 拒否した、またはすでにブロックしている | Webポップアップは閉じたままです。すでにブロックしているユーザーが通知を受け取るには、ブラウザの設定で許可する必要があります。 |
| ブラウザの確認ダイアログを閉じた | Webポップアップは閉じたままで、プッシュ通知の購読は登録されません。 |
| 対応していない環境で操作した、Webプッシュを設定していない、または処理に失敗した | ポップアップは閉じ、処理結果は表示されません。配信前に、サイトのWebプッシュ設定と対応環境を確認してください。 |

> [!WARNING]
>
> **受信同意の記録とブラウザの通知権限は別に管理されます。** ブラウザの通知を拒否したり確認画面を閉じたりしても、記録済みの同意は保持されます。`$web_push_consent` が `true` でも、通知を受け取るには、ブラウザで通知を許可し、プッシュ通知の購読を有効にする必要があります。

ユーザーが同意を撤回できるようにするには、サービスに、ユーザーが受信同意を変更できる設定を用意します。撤回したユーザーはキャンペーンの配信対象から除外します。詳しくは[受信同意とブラウザの権限を管理する](https://docs.notifly.tech/ja/user-guide/channel/web-push-notification/guide.md#4-3-%E5%8F%97%E4%BF%A1%E5%90%8C%E6%84%8F%E3%81%A8%E3%83%96%E3%83%A9%E3%82%A6%E3%82%B6%E3%81%AE%E6%A8%A9%E9%99%90%E3%82%92%E7%AE%A1%E7%90%86%E3%81%99%E3%82%8B)を参照してください。

#### ボタンのクリックイベントを区別する

**ボタン**ブロックの設定で、`button_name` と表示される欄に名前を入力します。Notiflyは、その名前をクリックイベントに記録します。ボタンごとにクリックを集計するには、それぞれ異なる名前を付けます。

| ボタン名の入力例 | ボタンのアクション | 発生するイベント | イベントパラメーター |
| - | - | - | - |
| `coupon_cta` | URLまたはディープリンクを開く | `notifly__main_button_click` | `button_name = coupon_cta`, `campaign_id = aB3dE7` |
| `consent_cta` | Webプッシュの同意処理 | `notifly__main_button_click` | `button_name = consent_cta`, `campaign_id = aB3dE7` |
| `close_popup` | 閉じる | `notifly__close_button_click` | `button_name = close_popup`, `campaign_id = aB3dE7` |
| `dismiss_today` | 今後表示しない、またはN日間表示しない | `notifly__close_button_click` | `button_name = dismiss_today`, `campaign_id = aB3dE7` |

### **レイアウトブロック**

**行** ブロックでは、2～4列を横に並べられます。列ごとの幅の比率、縦方向の配置、ブロックの間隔を指定します。背景色と透明度、外側の余白も設定できます。各列に画像、テキスト、ボタンなどを配置できます。

### **カルーセルブロック**

**カルーセル** を使うと、スライドを切り替えて表示できます。1つのポップアップに追加できるのは1つまでです。カルーセルを選ぶと、右側に設定が表示されます。

* **スライド管理** で、スライドの追加、並べ替え、複製、削除ができます。
* **スライド切り替え** で、アニメーションを **Slide**、**Fade**、**なし** から選びます。スワイプとループの有無も設定できます。
* **自動再生** をオンにすると、切り替え間隔を指定できます。
* **インジケーター** で、ドットかスライド番号を選びます。位置、オフセット、サイズ、間隔を調整できます。ドットは表示中のスライドとそれ以外の色を、番号は文字色と背景色を設定できます。

カルーセルと別の位置にインジケーターを表示したい場合は、**インジケーター**ブロックを追加します。

## **ポップアップ全体の設定**

キャンバスの空白部分か、右側の設定パネルの上部にある**ポップアップ**をクリックすると、ポップアップ全体を設定できます。

### **ポップアップタイプ**

* **Dialog**は画面の中央に表示されます。初期設定の形式です。
* **Bottom Sheet**は画面下部からスライドして表示されます。
* **Full Screen**は画面全体に表示されます。

### **背景**

ポップアップのコンテンツ領域の背景色、透明度、背景画像を設定します。

### **ポップアップスタイル**

内側の余白やブロックの間隔を調整します。表示形式に応じて、最大幅や角の丸みもピクセル単位で設定できます。個別入力に切り替えると、角ごとに丸みを、辺ごとに余白を設定できます。

### **オーバーレイ**

ダイアログとボトムシートでは、オーバーレイの色と透明度を設定できます。**クリック時に閉じる**をオンにすると、オーバーレイをクリックしたときにポップアップが閉じます。

### **アニメーション**

ポップアップの**表示アニメーション**と**非表示アニメーション**を個別に設定できます。それぞれ **なし**、**Fade**、**Slide Up**、**Slide Down**、**Slide Left**、**Slide Right** から選べます。

### **閉じるボタン**

閉じる（X）ボタンの表示の有無、位置（左上または右上）、配置（ポップアップの内側または外側）、サイズ（px）、線の太さ、アイコンの色、縦と横のオフセットを設定できます。

## **テンプレートを保存して使う**

編集が終わったら、ツールバーの**保存**をクリックします。保存済みのテンプレートは**Webポップアップテンプレート**で管理します。キャンペーンやユーザージャーニーで選択して利用できます。

パーソナライズ変数を含むテンプレートを保存すると、パーソナライズが自動で有効になります。ポップアップを表示するときに、Notiflyがユーザー情報やイベントの値を変数に差し込みます。

> [!NOTE]
>
> エディターの**プレビュー**では、実際のデータを差し込む前のLiquid式が表示されます。配信時の見え方を確認するには、テストユーザーだけを対象にキャンペーンを実行します。対応するSDKを導入したWebサイトで、そのキャンペーンのトリガーに指定したイベントを発生させます。

## **FAQ**

> [accordion] ポップアップタイプを変えると、設定は初期化されますか？
>
> 配置済みのブロックと内容は保持されます。変更後のタイプによっては一部のスタイル設定が初期化されるため、先にタイプを決めてから個別のスタイルを設定してください。

> [accordion] カルーセルには何枚のスライドを追加できますか？
>
> スライドの枚数に上限はありません。ユーザーが確認しやすいよう、3～5枚を目安にしてください。

> [accordion] フォントを追加できますか？
>
> フォント一覧の一番下にある **フォントを追加** をクリックします。Google Fontsでフォントを選び、**Get font**、**Get embed code** の順にクリックします。`https://fonts.googleapis.com/` で始まるURLを **WebフォントURL** に貼り付け、**フォント名** に正確な名前を入力します。**フォントを読み込む** をクリックし、読み込みが完了したら **追加** をクリックします。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.