アプリ内メッセージを作成する
Brazeプラットフォームでは、キャンペーン、キャンバス、またはAPIキャンペーンとしてアプリ内メッセージやブラウザ内メッセージを作成できます。ほとんどのユースケースではドラッグ&ドロップエディターの使用をお勧めします。また、アプリ内メッセージ準備ガイドを使用して、事前にメッセージを計画し、すべての素材を準備しておくことをお勧めします。
前提条件
始める前に、以下を準備してください。
| 要件 | 説明 |
|---|---|
| Braze SDK | Braze SDKをアプリまたはWebサイトに統合します。 |
| キャンペーンまたはキャンバス | 単一のターゲットメッセージにはキャンペーンを、マルチステップのユーザージャーニーにはキャンバスを使用します。 |
| メッセージプラン | アプリ内メッセージ準備ガイドを使用して、コンテンツとアセットを準備します。 |
編集エクスペリエンス
ほとんどのアプリ内メッセージには、ドラッグ&ドロップエディターを使用してください。従来のエディターと同じコアレイアウトのモーダルメッセージやフルスクリーンメッセージに加え、行、Content Blocks、テンプレート、マルチページフロー、継続的な機能更新をサポートしています。ステップごとの手順については、ドラッグ&ドロップでアプリ内メッセージを作成するを参照してください。
スライドアップメッセージやカスタムHTMLが必要な場合は、従来のエディターを使用してください。
ドラッグ&ドロップメッセージを従来のエディターに切り替えると、メッセージが HTML に変換されます。ドラッグ&ドロップエディターに戻すことはできません。
メッセージの作成を始める
- メッセージング > キャンペーン に移動し、キャンペーンを作成 を選択します。
- アプリ内メッセージ を選択します。アプリ内メッセージはマルチチャネルキャンペーンでは使用できません。
- キャンペーンにわかりやすく意味のある名前を付けます。
- 必要に応じてチームとタグを追加します。
- タグを使用すると、キャンペーンを見つけやすくなり、レポートを作成しやすくなります。たとえば、レポートビルダーを使用する際に、特定のタグでフィルタリングできます。
- キャンペーンに必要な数のバリアントを追加して名前を付けます。追加したバリアントごとに、異なるプラットフォーム、メッセージタイプ、レイアウトを選択できます。このトピックの詳細については、多変量テストとABテストを参照してください。

キャンペーン内のすべてのメッセージが類似している場合や同じコンテンツを含む場合は、追加のバリアントを加える前にメッセージを作成してください。その後、バリアントを追加 ドロップダウンから バリアントからコピー を選択できます。
- キャンバスコンポーザーを使用してキャンバスを作成します。
- キャンバスを設定したら、キャンバスビルダーでステップを追加します。ステップにはわかりやすく意味のある名前を付けてください。
- ステップスケジュールを選択し、必要に応じてディレイを指定します。アプリ内メッセージを含むステップは、アクションベースにすることはできません。
- 必要に応じて、このステップのオーディエンスをフィルタリングします。セグメントを指定し、追加のフィルターを加えることで、このステップの受信者をさらに絞り込むことができます。オーディエンスオプションは、メッセージ送信時にディレイの経過後にチェックされます。
- 昇進動作を選択します。
- メッセージと組み合わせたい他のメッセージングチャネルを選択します。

1つのステップに複数のアプリ内メッセージバリアントを含めることはできません。
キャンバス固有の詳細については、キャンバスのアプリ内メッセージを参照してください。
配信プラットフォーム
メッセージを受信するプラットフォームを選択します。プラットフォームの選択は個々のバリアントに適用されるため、異なるプラットフォーム間でエンゲージメントをテストできます。
| プラットフォーム | メッセージ配信 |
|---|---|
| モバイルアプリ | Android、iOS、Kindle、tvOSアプリ |
| Webブラウザ | Webアプリ |
| モバイルアプリとWebブラウザの両方 | Android、iOS、Kindle、Kepler、tvOS、Webアプリ |
| Rokuデバイス | Rokuアプリ |
メッセージタイプ
配信プラットフォームを選択したら、メッセージタイプとレイアウトを選択します。利用可能なタイプは、配信プラットフォームと編集エクスペリエンスによって異なります。外観、動作、クリエイティブの仕様については、アプリ内メッセージタイプを参照してください。
| メッセージタイプ | 編集エクスペリエンス | 利用可能なレイアウト | 使用するタイミング |
|---|---|---|---|
| フルスクリーン | ドラッグ&ドロップおよび従来型 | 画像とテキスト、または画像のみ。従来型エディターでは縦向きまたは横向きを強制できます。 | ユーザーの完全な注意を必要とする重要なお知らせやプロモーション。 |
| モーダル | ドラッグ&ドロップおよび従来型 | テキストとオプションの画像、または画像のみ。Rokuはモーダルメッセージのみをサポートしています。 | 画面全体を覆うことなく目立たせたいプロモーションや機能のプロンプト。 |
| スライドアップ | 従来型 | アプリ画面の上部または下部に表示されます。 | 新機能やCookie通知など、画面の残りの部分をブロックすべきでない短いお知らせ。 |
| カスタムHTML | 従来型 | カスタムHTML、CSS、JavaScriptをサポートしています。JavaScriptを使用するには allowUserSuppliedJavascript を有効にしてください。 |
標準のメッセージタイプではサポートされないカスタムレイアウトやインタラクティブなエクスペリエンス。 |
| メールキャプチャフォーム | 従来型 | サポートされているアプリおよびWebプラットフォームの選択で利用可能です。 | アプリやWebサイトのユーザーからメールアドレスを収集する場合。 |
| CSSを使用したWebモーダル | 従来型 | Web Browsers を選択した場合に利用可能です。 | カスタムCSSが必要なWeb専用のモーダルメッセージ。 |

カスタムコードメッセージには、閉じるまたは非表示にするコントロールを含める必要があります。次のスニペットを使用できます。
<a href="appboy://close">X</a>
メッセージの作成
利用可能なフィールドは、プラットフォーム、メッセージタイプ、レイアウト、編集エクスペリエンスによって異なります。
| フィールドまたは設定 | 制御する内容 | 備考 |
|---|---|---|
| 言語 | 言語固有のLiquid条件を追加します。 | コンテンツを作成する前に言語を追加してください。 |
| 画像 | アップロードされた画像、画像URL、バッジ、またはFont Awesomeアイコンを追加します。 | オプションはメッセージタイプによって異なります。 |
| ヘッダーとメッセージ | メッセージテキストを設定します。 | Liquidやその他のパーソナライゼーションをサポートしています。 |
| ボタンテキストとクリック時の動作 | 最大2つのボタンとそのアクションを設定します。 | 利用可能なアクションは、選択したプラットフォームによって異なります。 |
| メッセージを閉じる | ユーザーがメッセージを閉じる方法を制御します。 | 自動的に閉じるか、ユーザーが閉じるまで待つかを選択します。 |
| スライドアップの位置 | スライドアップをアプリ画面の上部または下部に配置します。 | スライドアップメッセージのみで利用可能です。 |
| HTMLとアセット | カスタムコードとアップロードされたアセットを定義します。 | カスタムコードメッセージタイプで利用可能です。 |
| キーと値のペア | ユーザーデバイスに追加のカスタムフィールドを送信します。 | 設定タブで構成します。 |
ドラッグ&ドロップでの作成については、ドラッグ&ドロップでアプリ内メッセージを作成するを参照してください。
作成タブでは、メッセージのコンテンツと動作を編集できます。

作成タブの内容は、選択したメッセージオプションによって異なります。
言語
言語を追加を選択し、提供されたリストから希望の言語を選択します。これにより、メッセージにLiquidが挿入されます。コンテンツを作成する前に言語を選択して、Liquid内の適切な場所にテキストを入力できるようにすることをお勧めします。利用可能な言語の完全なリストを参照してください。
画像
メッセージタイプに応じて、画像をアップロード、バッジを選択、またはFont Awesomeを使用できます。画像をアップロードするには、画像を追加を選択するか、画像URLを入力します。画像を追加を選択するとメディアライブラリが開き、以前にアップロードした画像を選択したり、新しい画像を追加したりできます。メッセージタイプとプラットフォームにはそれぞれ推奨される比率と要件があるため、画像を発注または作成する前に必ず確認してください。

ヘッダーと本文
ヘッダーとメッセージのコピーを入力します。Liquidやその他のパーソナライゼーションを使用できます。ヘッダーとメッセージのコンテンツは明確で簡潔にしてください。
一部のメッセージタイプではヘッダーが不要なため、ヘッダーの入力を求められません。
AIコピーを生成する
メッセージコピーを生成するには、AIコピーライティングアシスタントを使用します。

右から左に読むメッセージを作成する
アラビア語やヘブライ語などの言語については、右から左に読むメッセージの作成を参照してください。
ボタンテキスト
メッセージタイプに応じて、本文の下に最大2つのボタンを表示できます。カスタムボタンテキストと色を作成および編集できます。また、メールキャプチャフォーム内に利用規約リンクを追加することもできます。
ボタンを1つだけ使用する場合、追加のボタン用のスペースを残す代わりに、メッセージ下部の利用可能なスペースを占めるように自動的に調整されます。
プライマリボタンの選択
プライマリの行動喚起にはボタン2を使用します。メッセージの他の部分と区別できるように、コントラストのある色を設定してください。

クリック時の動作
ユーザーがアプリ内メッセージのボタンを選択すると、プラットフォームとワークスペースの構成に基づいて以下のアクションを利用できます。
| アクション | 説明 |
|---|---|
| メッセージを閉じる | 現在のメッセージを閉じます。 |
| Web URLを開く | Webページを開きます。アプリ内でURLを開くかどうかを選択できます。 |
| アプリケーションへのディープリンク | アプリ内のコンテンツを開きます。詳細については、アプリ内コンテンツへのディープリンクを参照してください。 |
| カスタムイベントを記録 | カスタムイベントを記録します。 |
| カスタム属性を記録 | 現在のユーザーのカスタム属性を設定します。 |
| プッシュ許可をリクエスト | ネイティブのプッシュ許可プロンプトを表示します。詳細については、プッシュプライマーを参照してください。 |
プッシュ許可をリクエスト、カスタムイベントを記録、カスタム属性を記録オプションには、以下の最小SDKバージョンが必要です。
複数のアクションを組み合わせたり、ダッシュボードで利用できない追加のSDKアクション(購読グループへの追加やメール購読タイプの設定など)を実行するには、Braze Actionsディープリンクを使用できます。
iOSデバイスオプション
iOSアプリを含むメッセージの場合、変更を選択して、すべてのデバイス、すべてのiOSデバイス、iPadのみ、またはiPhoneとiPod Touchのみに送信できます。
メッセージを閉じる
以下のオプションから選択します:
- 自動的に閉じる: メッセージが画面に表示される秒数を選択します(最大60秒)。
- ユーザーが閉じるまで待つ: ユーザーがメッセージを閉じるまで表示し続けます。
メッセージを閉じるとインプレッションが記録されますが、クリックは記録されません。ユーザーアクションによるクリックのトラッキング方法については、クリックトラッキングを参照してください。
スライドアップの位置
この設定はスライドアップメッセージタイプのみに適用されます。スライドアップをアプリ画面の下部から表示するか、アプリ画面の上部から表示するかを選択します。
HTMLとアセット
この設定はカスタムコードメッセージタイプのみに適用されます。利用可能なスペースにHTMLをコピーして貼り付け、ZIPファイルを使用してアセットをアップロードします。
メールキャプチャ入力プレースホルダー
この設定はメールキャプチャフォームメッセージタイプのみに適用されます。メール入力フィールドのプレースホルダーテキストとして表示されるカスタムコピーを入力します。デフォルトは「Enter your email address」です。
デザイン
デザインタブを使用して、従来のエディターで作成されたメッセージの外観を調整します。利用可能な設定は、プラットフォーム、メッセージタイプ、レイアウトによって異なります。
| 設定 | 制御する内容 |
|---|---|
| カラープロファイル | アプリ内メッセージテンプレートギャラリーから再利用可能なカラープロファイルを適用します。 |
| テキスト配置 | サポートされているヘッダーと本文テキストを左揃え、中央揃え、または右揃えにします。 |
| ヘッダーとテキスト | テキストの色と不透明度を設定します。 |
| ボタン | 各ボタンの背景、テキスト、ボーダー、不透明度を設定します。 |
| 背景色 | メッセージの背景色と不透明度を設定します。 |
| 画面オーバーレイ | モーダルおよびフルスクリーンメッセージの周囲の色と不透明度を設定します。 |
| 閉じるコントロール | シェブロンまたはその他の閉じるコントロールの色を設定します。 |
送信前に必ずメッセージをプレビューしてテストしてください。

カスタムコードメッセージタイプにはデザインタブが含まれていません。HTML、CSS、JavaScript、およびアセットは作成タブで追加してください。Web 固有の CSS テンプレートについては、CSS 付き Web モーダルを参照してください。
追加設定
キーと値のペア
キーと値のペアを追加して、ユーザーのデバイスにカスタムフィールドを追加送信できます。
- メッセージ作成画面で、設定 タブを選択します。
- キーと値のペア で、新しいペアを追加 を選択します。
- 各ペアのキーと値を入力します。別のペアを追加するには、新しいペアを追加 を再度選択します。
配信とターゲティング
キャンペーンのトリガーを選択する
キャンペーンをトリガーするアクションを選択し、キャンペーンの開始時刻とオプションの終了時刻を設定します。

カスタムイベントからアプリ内メッセージをトリガーするには、SDKを通じてイベントを記録します。

アプリ内メッセージキャンペーンは、以下のアクショントリガーをサポートしています。
- アプリまたはWebサイトでセッションを開始する
- 購入を行う
- SDKを通じて記録されたカスタムイベントを実行する
サーバートリガーおよびローカルメッセージについては、アプリ内メッセージをトリガーするを参照してください。
オフラインでメッセージをトリガーする
Brazeは対象となるメッセージとそのトリガーをユーザーのデバイスに送信します。メッセージがキャッシュされると、デバイスがオフラインの状態でもトリガーが発生した際に表示できます。

アプリ内メッセージキャンペーンが停止された後も、停止前にセッションを開始したユーザーは、トリガーイベントを実行した際にキャッシュされたメッセージを引き続き表示する場合があります。これらのユーザーはユニークインプレッションとしてカウントされます。
優先度を選択する
複数のメッセージが同じトリガーを共有している場合に、対象となるアプリ内メッセージが表示される順序を設定します。キャンペーンとキャンバスのメッセージステップは同じ優先順位を使用します。
以下のメッセージ優先度から選択できます。
- 高優先度(他のメッセージより先に表示)
- 中優先度(デフォルト)
- 低優先度(他のメッセージの後に表示)
高、中、低のオプションは優先度バケットです。新規または新たに割り当てられたメッセージは、正確な優先度を設定しない限り、そのバケット内で最も高い位置に配置されます。
正確な優先度を設定を選択すると、キャンペーンとキャンバスをドラッグして特定の順序に並べ替えることができます。また、メッセージをピン留めして、高優先度バケットの最上部に固定することもできます。

ターゲットユーザーを選択する
セグメントとフィルターを使用してユーザーをターゲティングします。Brazeはメッセージをデバイスに送信する前に、正確なセグメントメンバーシップを計算します。

アプリ内メッセージステップに遅延がある場合、Brazeは遅延後にセグメントメンバーシップを評価します。ユーザーが対象である場合、メッセージは次に利用可能なセッション中に同期されます。
キャンペーンの適格性とLiquidを再評価する
キャンペーンの場合、適格性が頻繁に変更される属性に依存する場合、またはメッセージに最新のプロファイルデータが必要な場合は、表示前にキャンペーンの適格性を再評価するを選択します。

このオプションを選択すると、SDKはユーザーがまだ適格であることを確認するための追加リクエストを行います。Brazeはメッセージを表示する直前にLiquidとConnected Contentも評価します。
このオプションにより、ユーザーがキャンペーンの適格基準を満たさなくなった場合に、キャッシュされたメッセージが表示されることを防止できます。

このオプションにはネットワーク接続が必要であり、表示前にリクエストが追加されます。ユーザーがオフラインの際にトリガーする必要があるメッセージには使用しないでください。
REST APIで追加されたデータをメッセージで使用する
/users/trackエンドポイントが同じセッション中に追加したユーザーデータは、そのユーザーのアプリ内メッセージで使用できる場合があります。例えば、ユーザーがトリガーを待機しているアプリ内メッセージのオーディエンスに含まれており、セッションを開始し、その同じセッション中にREST APIがプロファイルを更新した場合、表示前にキャンペーンの適格性を再評価するが選択されていれば、その新しいデータがアプリ内メッセージに表示される可能性があります。Brazeはレンダリングの時点までアプリ内メッセージをテンプレート化しません。
1つのトリガーがBrazeへのデータ送信とアプリ内メッセージの発火の両方を行う場合、スケジュールされた遅延があっても、メッセージはその新しく更新されたプロファイルデータを使用できません。代わりに、2つの別々のトリガーを使用してください。1つはデータを送信するため、もう1つはアプリ内メッセージをトリガーするためです。
キャンバスのメッセージコントロールを設定する
キャンバスのアプリ内メッセージには、有効期限、トリガーアクション、および最大2時間の遅延のコントロールが含まれています。詳細については、キャンバスのアプリ内メッセージを参照してください。
知っておくべきこと
アクティブなアプリ内メッセージキャンペーンの容量
メッセージ配信のパフォーマンスを維持するために、不要になったアクションベースのアプリ内メッセージキャンペーンを停止してください。

デフォルトの容量は、ワークスペースあたり200件のアクティブなアクションベースのアプリ内メッセージキャンペーンです。ワークスペースによって容量が異なる場合があります。これはキャンバスには適用されません。
このカウントには、終了時刻に達していないアクティブなキャンペーンと、終了時刻が設定されていないキャンペーンが含まれます。終了時刻を過ぎたキャンペーン、最大インプレッション数に達したキャンペーン、または無効化されたキャンペーンは除外されます。
ローカルタイムゾーン配信の評価
アプリ内メッセージキャンペーンがユーザーのローカルタイムゾーンを使用する場合、Brazeはそのタイムゾーンでキャンペーンの開始時刻と終了時刻を評価します。キャッシュされたメッセージは、ユーザーが対象条件を満たしており、設定された配信ウィンドウ内でトリガーが発生した場合にのみ表示されます。
次のステップ
アプリ内メッセージの作成が完了したら、キャンペーンまたはキャンバスの構築と検証を続けます。
- キャンバスを設定するか、キャンペーンのスケジュールを完了します
- ユーザーをターゲットにし、コンバージョンイベントを設定します
- メッセージをプレビューしてテストする
- アプリ内メッセージのレポートを確認します