コンテンツにスキップ

ドラッグ&ドロップでアプリ内メッセージを作成する

ドラッグ&ドロップエディターは、ほとんどのアプリ内メッセージを作成するための推奨される方法です。従来のエディターと同じコアレイアウトでモーダルメッセージやフルスクリーンメッセージを作成できるほか、行、Content Blocks、テンプレート、マルチページフローによってさらに細かくカスタマイズできます。エディターのビルディングブロックについては、エディターブロックを参照してください。

既存のカスタムHTMLテンプレートやサードパーティが作成したテンプレートを使用する場合は、ドラッグ&ドロップエディターで再作成する必要があります。

アプリ内メッセージをキャンペーンで送信するかキャンバスで送信するか迷っていますか?キャンペーンは単一のターゲットメッセージに適しており、キャンバスはマルチステップのユーザージャーニーに適しています。メッセージの作成場所を選択したら、以下の手順に従ってドラッグ&ドロップのアプリ内メッセージを作成します。

前提条件

SDKの要件

最小SDKバージョン 推奨SDKバージョン
最小SDKの詳細

ドラッグ&ドロップエディターで作成したメッセージは、最小SDKバージョン(前のセクションの表を参照)を使用しているユーザーにのみ送信できます。ユーザーがアプリケーションを更新していない場合(つまり、古いSDKバージョンを使用している場合)、そのユーザーはアプリ内メッセージを受信しません。

ドラッグ&ドロップエディターで利用できるすべての機能を活用するには、SDKを推奨SDKバージョンに更新してください。これにより、次の追加機能を利用できます。

  • メッセージを閉じないテキストリンク
  • プッシュプライマーをリクエストするボタンアクション

これらの機能それぞれの最小SDK要件は次のとおりです。

テキストリンク* プッシュプライマーのリクエスト

*アプリ内メッセージにURLへリダイレクトするリンクを含めた場合、エンドユーザーが指定の最小SDKバージョンを使用していないと、リンクを選択した時点でメッセージが閉じ、ユーザーはメッセージに戻ってフォームを送信できなくなります。

その他の前提条件

  • Web SDKでは、初期化オプションallowUserSuppliedJavascriptをtrueに設定する必要があります。enableHtmlInAppMessagesオプションでもこれらのメッセージは機能しますが、このオプションは非推奨のため、allowUserSuppliedJavascriptに更新してください。
  • Google Tag Managerを使用している場合は、GTMの設定で「Allow HTML In-App Messages」を有効にする必要があります。

ステップ1: アプリ内メッセージを作成する

新しいアプリ内メッセージまたはキャンバスステップを作成し、編集方法としてドラッグ&ドロップエディターを選択します。

ステップ2: テンプレートを選択する

編集方法としてドラッグ&ドロップエディターを選択した後、次のいずれかを選択できます。

  • 空白のモーダルテンプレートから始める
  • Brazeのドラッグ&ドロップアプリ内メッセージテンプレートを使用する
  • 保存済みのドラッグ&ドロップアプリ内メッセージテンプレートを選択する

メッセージを作成を選択して、ドラッグ&ドロップエディターでアプリ内メッセージのデザインを開始します。

基本、背景画像、電話番号の取得、空白のテンプレートから選択できるBrazeテンプレートセクション。

ダッシュボードのテンプレートセクションから、すべてのテンプレートにアクセスすることもできます。

ステップ3:追加ページを追加する(オプション)

アプリ内メッセージにページを追加すると、オンボーディングフローやウェルカムジャーニーのようなシーケンシャルフローでユーザーをガイドできます。ページはビルドタブのページセクションから管理できます。

3つのページで構成されたヘルスケア企業のアプリ内メッセージ。

アプリ内メッセージはデフォルトで1ページから始まります。新しいページを追加するには:

  1. + ページを追加を選択します。
  2. カスタムテンプレートまたはBraze提供のテンプレートのリストから選択します。
  3. ページにわかりやすい名前を付けます。これはページ同士を接続する際に役立ちます。

既存のページを複製するには:

  1. リスト内のページにカーソルを合わせ、 その他のオプションを選択します。
  2. 複製を選択します。
  3. ページにわかりやすい名前を付けます。これはページ同士を接続する際に役立ちます。

ページを削除または名前変更するには:

  1. リスト内のページにカーソルを合わせ、 その他のオプションを選択します。
  2. 名前変更または削除を選択します。

ステップ3a:ページを接続する

マルチページのアプリ内メッセージはシーケンシャルです。つまり、ユーザーはタップまたはクリックしてフロー内の次のページに移動することでメッセージを操作します。

ページを接続するには:

  1. 開始ページを選択します。
  2. キャンバス内のボタンまたは画像要素を選択します。
  3. クリック時の動作をページに移動に設定します。
  4. 開始ページからリンクしたいページを選択します。
  5. すべてのページがリンクされるまで続けます。

アプリ内メッセージのページ2に移動するようにプライマリアクションボタンを編集しているユーザー。

ページが他のページにリンクされていない場合、メッセージを起動できません。

ステップ4:アプリ内メッセージを作成してデザインする

ここでは、ブランドならではのスタイルをまとったメッセージがランウェイに登場します。エディターブロックとスタイル設定を組み合わせて、アプリ内メッセージをカスタマイズしてデザインできます。

ステップ 5: キーと値のペアを追加する (オプション)

キーと値のペアを追加すると、メッセージと一緒に追加のカスタムデータをユーザーのデバイスに送信できます。Brazeはこれらのペアをメッセージのペイロードに含めて配信するため、アプリでペアを読み取り、それに応じた処理を実行できます。たとえば、アプリでキーと値のペアを使用して、カスタムスタイルやレイアウトロジックを適用したり、メッセージをアプリ内の特定の場所にルーティングしたり、独自の分析にメタデータを渡したりできます。

  1. メッセージ作成画面で、設定タブを選択します。
  2. キーと値のペアタブを選択し、新しいペアを追加を選択します。
  3. 各ペアのキーと値を入力します。さらにペアを追加するには、もう一度新しいペアを追加を選択します。

アプリでキーと値のペアを読み取る例については、キーと値のペアを使用したメッセージスタイルのカスタマイズを参照してください。

ステップ6: アプリ内メッセージをテストする

プレビューとテストセクションでは、さまざまなデバイスでアプリ内メッセージをプレビューし、自分のデバイスにテストメッセージを送信できます。ここで、ドラッグ&ドロップのアプリ内メッセージキャンペーンの詳細が、すべてのプラットフォームで揃っているかを確認できます。

キャンペーンを送信する前に、必ずアプリ内メッセージをテストすることが重要です。テストを行うことで、最終的なメッセージがユーザーからどのように見えるかを把握できます。

ユーザーとしてメッセージをプレビューする

プレビューとテストタブから、ユーザーになったつもりでメッセージをプレビューできます。特定のユーザーやランダムなユーザーを選択したり、カスタムユーザーを作成したりできます。

  • ランダムユーザー: Brazeがデータベースからランダムにユーザーを選択し、そのユーザーの属性やイベント情報に基づいてアプリ内メッセージをプレビューします。
  • ユーザーを選択: メールアドレスまたはexternal_idに基づいて特定のユーザーを選択できます。アプリ内メッセージは、そのユーザーの属性とイベント情報に基づいてプレビューされます。
  • カスタムユーザー: ユーザーをカスタマイズできます。Brazeは利用可能なすべての属性とイベントの入力欄を表示します。プレビューメールに表示したい情報を入力してください。

テストチェックリスト

アプリ内メッセージをテストする際は、次の点を確認してください。

  • さまざまなデバイスでメッセージをテストしましたか?
  • 画像やメディアは期待どおりに表示され、動作しますか?
  • Liquidは期待どおりに機能しますか?Liquidが情報を返さない場合に備えて、デフォルトの属性値を設定していますか?
  • 文章は明確かつ簡潔で、正確ですか?
  • ボタンはユーザーを適切な遷移先に誘導していますか?

よくある質問

分析ページに本文クリックが表示されないのはなぜですか?

ドラッグ&ドロップエディターで作成したアプリ内メッセージでは、本文クリックは自動的に収集されません。詳細については、iOSおよびAndroidのSDK変更履歴を参照してください。

ボタンのクリックに基づいてセグメント化できますか?

はい。メッセージ内の最大2つのボタンについて、ボタンのクリックに基づいてセグメント化できます。そのためには、ボタンのレポート用識別子を「0」と「1」に設定します。これらはそれぞれ、セグメンテーションフィルター「アプリ内メッセージボタン1をクリック」と「アプリ内メッセージボタン2をクリック」に対応します。

値が「0」に設定された「レポート用識別子」フィールド。

カスタムHTMLやJavaScriptを使用してアプリ内メッセージをカスタマイズしたり、既存のHTMLメッセージをエディターに移行したりできますか?

既存のHTMLメッセージをエディターに直接移行することはできませんが、カスタムコードブロックに未加工のHTML、CSS、JavaScriptを挿入できます。カスタムコードブロックを使用すると、サードパーティの動画や、Connected Contentや条件文などの高度なLiquidを埋め込むことができます。brazeBridge JavaScriptメソッドとクリックトラッキングの例については、カスタムHTMLアプリ内メッセージを参照してください。

ドラッグ&ドロップエディターの作成画面の表示が最終的なメッセージと異なって見えるのはなぜですか?

ドラッグ&ドロップエディターは、メッセージを作成画面内でレンダリングし、レイアウトを構築・確認できるようにプレビュー専用のスタイルとデフォルトを適用します。これらの処理は、編集中に構造やプレースホルダーコンテンツを確認しやすくするためのもので、ユーザーが受け取るメッセージには含まれません。

エディター専用の動作の一般的な例は以下のとおりです。

  • エディターはカスタムコードブロックを、デフォルトのmin-heightが40pxのbz-html-code-blockコンテナーでラップするため、空のブロックや短いブロックも編集中に表示されたままになります
  • 空白の画像やLiquidを含む画像は、エディター内でプレースホルダーとして表示されます
  • チェックボックスグループとラジオボタンは、アクティブな状態をプレビューできるように最初のオプションが事前選択されます

エディター内でのみ表示が異なる場合、通常はプレビューの動作によるものです。配信されたメッセージのトラブルシューティングを行う際は、エディター専用のフレームやプレビューのデフォルトではなく、メッセージブロック内のスタイルとマークアップを確認してください。

スライドアップ型のアプリ内メッセージを作成するにはどうすればよいですか?

現在、エディターはモーダルメッセージとフルスクリーンメッセージのみに対応しています。表示タイプは、メッセージスタイルパネルのメッセージコンテナーセクションで切り替えることができます。

キャンペーンまたはキャンバス内でアプリ内メッセージを作成した後、テンプレートとして保存できますか?

はい。今後のキャンペーンやキャンバスステップで再利用したいアプリ内メッセージは、エディターを終了した後に表示されるテンプレートとして保存ボタンを使用して、カスタムテンプレートとして保存できます。テンプレートとして保存する前に、まずキャンペーンを開始するか、下書きとして保存する必要があります。

製品ツアー用アプリ内メッセージのプレビュー。

コンテンツ > アプリ内メッセージに移動して、アプリ内メッセージテンプレートを作成・保存することもできます。

ページ分割されたアプリ内メッセージで、Liquid構文がプレーンテキストとして表示されるのはなぜですか?

ページ分割されたアプリ内メッセージをテストする際に、パーソナライズされたコンテンツではなくLiquid構文がプレーンテキストとして表示される場合は、いずれかのページにLiquid構文エラーがある可能性があります。1つのページに構文エラーがあると、メッセージ内のすべてのページでLiquidのレンダリングに影響します。各ページは独立していません。

トラブルシューティングを行うには:

  1. メッセージ内のすべてのページでLiquid構文エラーがないか確認します。あるページでプレビューが崩れていても、エラーがそのページにあるとは限りません。ページは独立していないため、構文エラーはメッセージ内のどこにでも存在する可能性があります。
  2. すべてのLiquidタグが正しく閉じられ、正しい形式になっていることを確認します。
New Stuff!