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

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

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

## 概要

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

## SDKの最小バージョン

このエディターで作成したポップアップを表示するには、プラットフォームごとに次のバージョン以上のNotifly SDKを使います。

* Android - 1.17.0
* iOS - 1.17.0
* Flutter - 1.11.0
* React Native - 3.9.0

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

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

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

![アプリ内ポップアップテンプレートの一覧](https://mintcdn.com/notifly/DHduOkdsm1-HMvmh/images/i18n/ja/in-app-message/popup-template.png?fit=max\&auto=format\&n=DHduOkdsm1-HMvmh\&q=85\&s=c942f7e39b5292d0638170530fa268dd)

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

![テンプレート作成画面](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/DHduOkdsm1-HMvmh/images/i18n/ja/in-app-message/editor-basic.png?fit=max\&auto=format\&n=DHduOkdsm1-HMvmh\&q=85\&s=91a759a5ae3817df19011523e1bbc12c)

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

**左側のブロックパネル**では、画像、テキスト、ボタン、区切り線、余白、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.openDeepLink('myapp://product/123')">
  アプリで商品を見る
</button>

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

| メソッド | 説明 |
| - | - |
| `notiflyPopup.close()` | ポップアップを閉じます。 |
| `notiflyPopup.hideForDays(days)` | ポップアップを閉じ、指定日数の間は同じポップアップを表示しません。 |
| `notiflyPopup.hideForever()` | ポップアップを閉じ、以降は同じポップアップを表示しません。 |
| `notiflyPopup.openUrl(url, options?)` | URLを開きます。HTTPまたはHTTPSのURLをアプリ内ブラウザで開くには、`openMode` に `current` を指定します。外部ブラウザで開くには `new_tab` を指定します。既定値は `new_tab` です。アプリのディープリンクには `openDeepLink()` を使います。 |
| `notiflyPopup.openDeepLink(url)` | 指定したディープリンクを開きます。 |
| `notiflyPopup.nextSlide()` | カルーセルの次のスライドに進みます。 |
| `notiflyPopup.prevSlide()` | カルーセルの前のスライドに戻ります。 |
| `notiflyPopup.goToSlide(index)` | `index` で指定したスライドに移動します。最初のスライドは `0` です。 |

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

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

| ボタン名の入力例 | ボタンのアクション | 発生するイベント | イベントパラメーター |
| - | - | - | - |
| `coupon_cta` | URLまたはディープリンクを開く | `notifly__main_button_click` | `button_name = coupon_cta`, `campaign_id = aB3dE7` |
| `close_popup` | 閉じる | `notifly__close_button_click` | `button_name = close_popup`, `campaign_id = aB3dE7` |
| `dismiss_today` | 今後表示しない、またはN日間表示しない | `notifly__hide_in_app_message_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）、線の太さ、アイコンの色、縦と横のオフセットを設定できます。

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

ツールバーの **保存** をクリックします。保存したテンプレートは **アプリ内ポップアップテンプレート** に表示され、キャンペーンやユーザージャーニーの設定で選べます。

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

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

## **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.