はじめに
HTML アプリ内メッセージを活用すると、複雑なアプリ内メッセージのレイアウトを作成して使用し、アプリ内にいるユーザーのエンゲージメントを高めることができます。 HTML アプリ内メッセージでは、次の機能がサポートされています。- HTML テンプレートを使用して、モバイルアプリ内でポップアップを表示できます。これにより、アプリ内キャンペーンでアンケート、リード獲得、スピンホイールなどの機能を利用できるようになります。サンプルテンプレートはこちらで入手できます。
- アプリ内メッセージキャンペーンでの横向きモードと縦向きモードのサポート
- アプリ内メッセージキャンペーンでのタブレットと TV OS のサポート
- カスタム HTML テンプレートのアップロード: 独自のアプリ内テンプレートを作成して ZIP ファイルとしてアップロードするか、アプリ内キャンペーンの作成時に HTML を貼り付けるだけで使用できます。
HTML アプリ内キャンペーンの作成
アプリ内キャンペーン作成の 2 番目のステップ (キャンペーン作成のコンテンツセクション) には、次の 3 つのタブがあります。- All templates
- Custom template editor
- Saved templates

All Templates セクションの事前構築済み HTML テンプレート
アプリ内キャンペーンで HTML テンプレートを使用するには、次の手順に従ってください。- キャンペーン作成のステップ 2 で、‘All templates’ タブに移動し、以下に示すように HTML テンプレートセクションまでスクロールします。
- 4 つの HTML テンプレートと、カスタム HTML エディターを使用してカスタム HTML テンプレートを作成するオプションがあります。任意の HTML テンプレートを選択するか、カスタム HTML テンプレートを作成します。
事前構築済みの HTML テンプレート
MoEngage でサポートされている HTML テンプレートは次のとおりです。- アンケートテンプレート
- Popup-Promotional
- FullScreen- Lead Gen
- FullScreen- Carousel
- ゲーミフィケーションテンプレート - スピンホイールとスクラッチカード
アンケートテンプレート
アンケートテンプレートは、アンケートをすばやく作成するために使用できる、あらかじめデザインされたレイアウトまたはフォーマットです。多くの場合、顧客満足度、従業員フィードバック、イベント評価など、特定の種類のアンケートに共通する質問があらかじめ用意されています。アンケートテンプレートは、“filter by use case” セクションで “survey” フィルターを選択すると見つけることができます。アプリ内キャンペーンでは、次のアンケートテンプレートを利用できます。- Popup Survey Template
- Survey Popup and Emoji
- Survey popup- Radio buttons with emoji
- Survey popup - Multi Screen
- Survey popup - NPS Slider

Popup Survey Template
名前が示すとおり、このテンプレートはモバイルデバイスでポップアップアンケートを実施するために使用します。次の画像は、このテンプレートが縦向きモードのモバイルデバイスでどのように表示されるかを示しています。

Pop-up Survey Template の詳細
このテンプレートは、アンケートに対するユーザーの回答を取得するために使用できます。ステップ 1: ユーザーの回答をユーザー属性で取得する
以下の画像に示すように、アンケートの回答はユーザー属性として取得されます。Code View にはテンプレートの HTML コードが表示されており、Popup-Survey Template のコードの 88 行目で、ユーザーが入力した内容をユーザー属性 “survey_response” として取得しています。ユーザー属性名は必要に応じてカスタマイズできます。
ステップ 2: ユーザーの回答時にイベントをトリガーする
ユーザーが回答を送信したときに、イベント “MOE_RESPONSE_SUBMITTED” をトリガーします。テンプレートのコードでは、これは 88 行目で行われています。フィードバックフォームからユーザーの入力を取得するイベント属性 “survey_response” が、MOE_RESPONSE_SUBMITTED イベントのトラッキングに使用されます。イベント名とイベント属性名は必要に応じてカスタマイズできます。トラッキングされたこのイベントは、必要に応じて MoEngage の外部にデータを送信したり、フォローアップキャンペーンをトリガーしたりするために使用できます。
ステップ 3: データのトラッキング
このテンプレートのデータは、以下に示すようにトラッキングされ、MoEngage のユーザープロファイルに保存されます。
Survey popup- emoji and text box
このテンプレートを使用して、ユーザーからフィードバックを収集できます。このテンプレートには、デフォルトで画像、評価用の絵文字、詳細なフィードバック用のテキストボックス、フィードバックを送信するボタンが含まれています。たとえば、最近リリースした製品についてユーザーからフィードバックを得たい場合、絵文字を使用してすばやくフィードバックを得ることができ、ユーザーが詳細なフィードバックを共有したい場合はテキストボックスを使用できます。

テンプレートの設定
ステップ 1: 画像を変更する テンプレートの画像を変更するには、27 行目に移動して Image src を画像のリンクに置き換えます。または、“upload” をクリックしてエディターに画像をアップロードし、“view uploaded” から URL をコピーして image src で使用することもできます。 このテンプレートで使用されている画像のアスペクト比は 362*171 です。同じアスペクト比を使用するか、ユースケースに応じて変更できます。



Survey popup- Radio buttons with emoji
顧客からすばやくアンケートの回答を集めたい場合は、絵文字付きラジオボタンテンプレートを選択してください。デフォルトでは、ユーザーが選択できる 5 つのオプションのリストが含まれています。ラジオボタンテンプレートのため、ユーザーが選択できるオプションは 1 つだけです。

テンプレートの設定
ステップ 1: 背景を変更する 34 行目の style 要素を変更することで、テンプレートの背景色を簡単に変更できます。



Survey popup - Multi Screen
顧客から複数の回答を収集したい場合は、マルチスクリーンポップアップを使用します。次の画面があります。- ウェルカム画面
- 画像付きの複数オプション選択画面
- フィードバックテキストボックス
- 複数オプション選択画面
- サンクス画面


テンプレートの設定
ステップ 1: ウェルカム画面の画像とテキストを変更する 27 行目から 34 行目で、ウェルカム画面の画像とテキストを変更できます。


Survey popup - NPS slider
NPS スライダーポップアップを使用して、アプリや機能に対する NPS スコアまたは評価をユーザーから取得します。これにより、ユーザーがアプリをどのように認識しているかについて、有益な情報を収集できます。

テンプレートの設定
ステップ 1: 背景を変更する 27 行目の style 要素を変更することで、テンプレートの背景色を簡単に変更できます。



Popup-Promotional Template
これらのテンプレートは、実施中のオファーや売れ筋の製品/サービスを宣伝するために使用できます。

Pop-up Promotional Template の詳細
このテンプレートは、モバイルアプリで実施中のオファー/お得な情報/セールを宣伝するために使用できます。ステップ 1: ターゲット URL またはランディング URL を定義する
他のプロモーションキャンペーンと同様に、ユーザーにボタンやリンクをクリックしてもらい、宣伝しているオファーやお得な情報を表示するランディングページに誘導することが目的です。このテンプレートのボタンは、クリック時にユーザーが遷移すべき URL を開くように設定できます。以下に示すように JS Bridge を実装することで、統計をトラッキングできます。
Fullscreen - Lead Gen Templates
リード獲得テンプレートは、匿名のアプリユーザーのメール ID または携帯電話番号を取得するために使用できます。

Fullscreen Lead Gen Template の詳細
ステップ 1: ユーザーの詳細を MoEngage 属性で取得する
ユーザーが入力した内容を、MoEngage の標準属性である First Name と Email にそれぞれ保存します。 ステップ 2: イベントをトリガーする ユーザーがこのフォームに回答を送信したときに、イベント “MOE_RESPONSE_SUBMITTED” をトリガーします。このイベントを活用して、MoEngage 経由でこのデータを外部 API エンドポイントに送信できます。以下の画像のハイライトされたコードは、入力データをユーザー属性およびイベントとしてトラッキングする役割を担っています。
ステップ 3: トラッキングしたデータを使用する
このフォームからデータがトラッキングされると、以下に示すようにユーザープロファイルで確認できます。また、このイベントを使用して、Streams または Connector キャンペーン経由で MoEngage の外部にデータを送信することもできます。
Full Screen - Carousel
カルーセルテンプレートを使用すると、複数の製品/サービス/オファーをユーザーに表示できます。以下に示すように、テンプレートは自動的にスクロールします。

Fullscreen Carousel Template の詳細
ステップ 1: 各画像の CTA を定義する
以下のコードのハイライトされた行に示すように、カルーセルの各画像に Call to Action を定義できます。
上記のコードスニペット内の moengage.trackClick(2) 関数は、クリックのトラッキングを担当します。関数内の引数 (1) と (2) により、カルーセルの異なる要素に対するクリックを区別できます。
デバイスの向き
モバイルデバイスでは、このテンプレートは縦向きモードとの互換性が最も高くなります。このテンプレートを横向きモードで表示すると、ユーザーにはスクロールオプションが表示されます。タブレットと TV では、このテンプレートはどの向きでも期待どおりにレンダリングされます。すべての HTML テンプレートに共通する要素
Code View セクション
Code View セクションでは、次の操作を実行できます。- HTML コードを編集して、要件に応じてテンプレートを変更します。
- テンプレートで使用するファイルをアップロードします。この機能を使用すると、画像、CSS、JS ファイルを追加して HTML に埋め込むことができます。詳細については、Asset Uploader セクションを参照してください。
テンプレート設定
Template Settings セクションでは、次の操作を実行できます。
- テンプレートのデバイスの向きを設定します。次のオプションがあります。

- 以下に示すように、Allowed Device Types セクションで許可するデバイスタイプを選択します。

HTML テンプレートの準備
HTML アプリ内メッセージは、モバイルアプリ上でフルスクリーンの Web ビュー内にレンダリングされ、MoEngage SDK は HTML に何の操作も加えずにそのままレンダリングします。 アプリ内メッセージとして表示する HTML テンプレートを準備する際は、次の点に注意してください。- MoEngage が提供するサンプル HTML テンプレートを使用してください。直接ダウンロードして MoEngage にアップロードすることも、必要に応じて編集することもできます。これらのサンプルテンプレートは、独自の HTML テンプレートをゼロから構築する際の参考にもなります。
- HTML テンプレートは、常にモバイルアプリの画面全体を占有します。テンプレートの HTML が画面全体を占有しない場合でも、そこには透明な Web ビューが存在し、ユーザーがアプリを操作できなくなります。この仕様のため、テンプレートの背後には常に透明なオーバーレイを配置することをお勧めします。これは HTML テンプレートの背景として設定できます。
- テンプレートからのすべてのインタラクションは、キャンペーンのパフォーマンス統計 (クリックなど) を計算するため、またはユーザーデータポイント (イベント、ユーザー属性 - メール、携帯電話番号、評価など) として、MoEngage にデータポイントとして記録する必要があります。JavaScript Bridge for HTML In-Apps を活用し、HTML テンプレート内で使用してください。
- iOS では、次の 2 点に注意する必要があります。
- デフォルトでは、Web ビューでズームとスケーリングが有効になっています。無効にするには、HTML でメタタグを使用する必要があります。
- ノッチのある iOS デバイスでは、コンテンツがノッチと重ならないように、セーフエリアをサポートするよう CSS を更新してください。
- 画像で説明されているように HTML テンプレート内で指定された背景画像については、これらの URL がテンプレートのスタイル内にあるため、MoEngage は URL をプリフェッチしません。背景画像にはアップロードしたアセットの URL を使用しないでください。 このような場合は、MoEngage SDK が実行時にダウンロードしてレンダリングする絶対 URL が必要です。その他のすべての画像については、アプリ内メッセージのレンダリング時にバッファが発生しないよう、画像をプリフェッチします。

サポートされているコンポーネント
HTML アプリ内テンプレートはすべての HTML および CSS コンポーネントをサポートしていますが、次のコンポーネントは特に重要で、HTML アプリ内キャンペーンから大きな価値を引き出すことができます。カスタムテンプレートエディター
カスタムテンプレートエディターでは、次のオプションを使用して HTML テンプレートを作成できます。
ZIP ファイルのアップロード
アプリ内キャンペーン作成のテンプレート選択画面でこのオプションを選択すると、HTML とアセットを 1 つの ZIP ファイルとしてまとめてアップロードできます。 このオプションを選択すると、テンプレートの ZIP ファイルをアップロードできるポップアップが開きます。
- .zip ファイルのサイズが 5MB 未満であることを確認してください。
- Zip 内のファイル名に *, /,
\, &, ~, ” を含めないでください。 - すべての画像は JPG、JPEG、PNG、または SVG 形式である必要があります。
- GIF ファイルはアップロードできませんが、絶対 URL を使用してテンプレートに追加できます。
- 画像に指定する相対パスは、大文字と小文字の区別を含め、zip フォルダーの構造と一致している必要があります。
カスタム HTML のアップロード
アプリ内キャンペーン作成のテンプレート選択画面でこのオプションを選択すると、テンプレートの HTML を MoEngage ダッシュボードに直接貼り付け、必要に応じてアセットをアップロードできます。このオプションを選択すると、コードビューエディターにリダイレクトされ、テンプレートの HTML コードを貼り付けることができます。
アセットアップローダー
カスタム HTML テンプレートを使用してアプリ内キャンペーンを作成する際に、独自のアセットをアップロードし、テンプレートの HTML にリンクできます。
JavaScript Bridge
HTML アプリ内メッセージからのアクションをトラッキングするには、JavaScript Bridge が必要です。アクションには、クリックのトラッキング、メッセージのクローズ、データのトラッキングなどがあります。HTML テンプレートを準備したら、アクションと統計をトラッキングするために、テンプレートに JS メソッドを統合する必要があります。詳細については、HTML アプリ内テンプレートで使用できる JavaScript メソッドを参照してください。テンプレートエラーの修正
MoEngage でアプリ内キャンペーンを作成する際に、以下に示すように最大 3 種類の警告が表示される場合があります。
HTML テンプレートコンテンツのパーソナライズ
すべての HTML テンプレートのコンテンツをパーソナライズできます。キャンペーン作成のステップ 2 の Content タブで、パーソナライズしたいコード行に移動し、@ と入力します。 User Attributes、User Events、Product Sets、Content APIs、Content Blocks を使用してコンテンツをパーソナライズできます。 詳細については、以下を参照してください。
- @ と入力してコンテンツをパーソナライズします。
- Data personalization または Content Block のいずれかをクリックします。
- Data personalization タブをクリックし、ドロップダウンから次のいずれかを選択します。
- User Attributes
- パーソナライズの代替 (フォールバック) として、次のいずれかを選択します。
- No Fallback
パーソナライズされたコンテンツ用のオプションを選択します。このオプションでは、パーソナライズが機能しない場合に代替は使用されません。 - Do not send In-App
パーソナライズが機能しない場合にアプリ内メッセージを送信しないオプションを選択します。 - Replace Text
パーソナライズが機能しない場合に使用するテキストを入力または貼り付けます。
- No Fallback
- Product Sets
- Content API
- Content API のパラメーターの値を変更します。
- Content Block をクリックします。
- 挿入するコンテンツブロックを選択します。
-
Insert only the content of the content block をクリックします。
このオプションを選択した場合:
- コンテンツのみが挿入されます。
- コンテンツはコンテンツブロックとの接続が解除されます。
- コンテンツブロックでのコンテンツの更新は、挿入されたコンテンツには反映されません。
- Done をクリックします。
HTML テンプレートのテスト
HTML テンプレートのプレビューをテストするには、次のようにデバイスプレビューを使用します。

サンプルテンプレート
サンプル HTML テンプレートは、こちらの記事で入手できます。その他の新機能
HTML アプリ内メッセージでは、さらに次の機能を活用できます。横向きモードでのアプリ内メッセージの表示
アプリ内キャンペーンを横向きモードで表示する必要がある場合は、HTML アプリ内テンプレートを活用し、Template Settings に移動して設定できます。
- アプリ内キャンペーンが縦向きモードのみに設定されている場合、デバイスが縦向きモードから横向きモードに回転すると、アプリ内メッセージは閉じられます。
- デバイスが縦向きモードで、アプリ内キャンペーンが横向きモードのみに設定されている場合、アプリ内キャンペーンは表示されません。
- 選択したデバイスの向きは、異なるバリエーションやプラットフォーム間で同じままです。
- Android では、デバイスを回転させるとアプリ内メッセージが閉じられ、再度レンダリングされます。
タブレットまたは TV でのアプリ内メッセージの表示
タブレットや TV でアプリ内メッセージを表示する必要がある場合は、HTML アプリ内キャンペーンを活用できます。
ネイティブテンプレートの HTML コードのコピー
** HTML コードをコピーする前に、DB で HTML アプリ内メッセージが有効になっていることを確認してください** ネイティブのアプリ内テンプレートを変更したいのに、できなかったことはありませんか? ボタンをクリックするだけでネイティブテンプレートの HTML をコピーし、カスタム HTML エディターで編集して、キャンペーンを公開できるようになりました。 手順は次のとおりです。- キャンペーン作成のステップ 2 で、編集したいテンプレートを選択します。
- テンプレートのプレビューの上にある “Copy HTML” をクリックして、選択したテンプレートの HTML コードをコピーします。

- 次に、ケバブメニューをクリックしてテンプレートを変更します。

- Custom template editor タブから “Custom HTML Upload” を選択します。

- エディター内の既存のコードをすべて削除し、cmd+v または ctrl+v を使用して新しいコードをエディターに貼り付けます。

- これで、テンプレートのコードを編集し、ビジネス目標に応じて変更できます。
- コピーしたコードにはクリックトラッキングがデフォルトで含まれないため、この場合はクリックトラッキングを実装する必要があります。方法についてはこちらをお読みください。
- ネイティブテンプレートで設定されたアクションは、ここに自動的にコピーされません。お客様側でゼロから実装する必要があります。たとえば、別の画面に移動するコードを追加する方法はこちらをご覧ください。
- クローズボタンも実装する必要があります。方法はこちらをご覧ください。
- テンプレートに動的なコンポーネントがある場合は、JavaScript を使用してコード内でインタラクションも処理してください。
- ナッジテンプレートの HTML コードをエディターに貼り付けると、公開時にアプリ内に埋め込まれるのではなく、オーバーレイポップアップとして表示されます。
- 公開後のエラーを避けるため、横向きモードと縦向きモードの両方でキャンペーンをテストしてください。
よくある質問
HTML アプリ内メッセージテンプレートでカスタムフォントを使用するにはどうすればよいですか?- 拡張子が .ttf のフォントファイルを用意します。
- カスタム HTML テンプレートの Code View で、右上隅の Upload をクリックします。
- アップロードする前に、ウィンドウに記載されているガイドラインに従ってください。コンピューターからファイルをアップロードし、Done をクリックします。

- フォントの URL をコピーします。これを行うには、以下に示すように View uploaded ボタンをクリックし、Copy URL をクリックします。

- HTML コード内に次のスタイルを追加します。コピーしたフォントの URL を @font-face セクションで使用します。HTML
