コンテンツにスキップ

よくある質問

この記事では、アプリ内メッセージに関するよくある質問への回答を提供します。

ブラウザー内メッセージとは何ですか?アプリ内メッセージとの違いは何ですか?

ブラウザー内メッセージは、Webブラウザーに送信されるアプリ内メッセージです。ブラウザー内メッセージを作成するには、アプリ内メッセージのキャンペーンまたはキャンバスを作成する際に、送信先フィールドでWebブラウザーを選択してください。

デバイスがオフラインの場合、アプリ内メッセージは表示されますか?

場合によります。アプリ内メッセージはセッション開始時に配信されるため、デバイスがオフラインになる前にペイロードをダウンロードできていれば、オフライン中でもアプリ内メッセージを表示できます。ペイロードがダウンロードされていない場合、アプリ内メッセージは表示されません。

ユーザーのデバイスにすでにアプリ内メッセージのペイロードがある状態でメッセージの有効期限が変更された場合、デバイス上の有効期限は更新されますか?

ユーザーがセッションを開始すると、Brazeはそのユーザーが対象となっているアプリ内メッセージに変更が加えられていないかを確認し、必要に応じて更新します。そのため、有効期限が変更された後にユーザーがセッションを記録すると、更新された情報を含むアプリ内メッセージがデバイスに送信されます。

アプリ内メッセージキャンペーンでサイレント時間を設定するにはどうすればよいですか?

サイレント時間機能は、アプリ内メッセージキャンペーンでは使用できません。この機能は、特定の時間帯にユーザーへメッセージが送信されないようにするためのものです。アプリ内メッセージキャンペーンでは、ユーザーがアプリ内でアクティブな場合にのみアプリ内メッセージを受信します。

特定の時間帯にアプリ内メッセージを送信するための回避策として、次のサンプルLiquidコードを使用してください。指定したタイムゾーンで午後7時59分以降または午前8時より前にアプリ内メッセージが表示される場合、メッセージが中止されます。

{% assign time = 'now' | time_zone: ${time_zone} %}{% assign hour = time | date: '%H' | plus: 0 %}
{% if hour > 19 or hour < 8 %}
{% abort_message("Outside allowed time window") %}
{% endif %}
MESSAGE HERE

ユーザーはアプリ内メッセージを閉じた後、再度受信できますか?

キャンペーン

アプリ内メッセージキャンペーンでは、配信コントロールで再適格性をオンにする (ユーザーがキャンペーンを再受信できるようにする) と、ユーザーがキャンペーンを再度受信できるようになります。再受信までの期間は、設定した再適格性の期間と、Brazeが前回の送信をどのように記録したかによって異なります。再適格性とメッセージ受信の関係など、キャンペーンの動作については、キャンペーンとキャンバスの再適格性を参照してください。

再適格性がオフの場合、ユーザーは一度受信したキャンペーンを、適格条件を満たしただけで再度受信することは通常ありません。

キャンバス

キャンバスから送信されたアプリ内メッセージの場合、ユーザーがメッセージを再度表示できるかどうかは、キャンペーンの配信コントロールだけでなく、キャンバスのエントリコントロール (ユーザーのキャンバスへの再エントリを許可するなど) とステップの設定によって決まります。

アプリ内メッセージの適格性はいつ計算されますか?

キャンペーン

アプリ内メッセージキャンペーンでは、ユーザーのデバイスがアプリ内メッセージをダウンロードする時点で、そのユーザーがターゲットオーディエンスに含まれているかどうかをBrazeがチェックします。これは通常、セッション開始時に行われます。デバイスは適格なメッセージを保存しておき、各メッセージのトリガーが発生した時点で表示します。トリガーの発生がセッションの後半であっても同様です。

開始時刻が未来に設定されているキャンペーンでは、開始時刻の最大1時間前にセッションを開始したデバイスにもBrazeがメッセージを送信します。これにより、メッセージを予定どおりの時刻に表示できるように準備しておけます。たとえば、午前6時30分にセッションを開始したユーザーは、午前7時に開始するキャンペーンを受信します。Brazeは午前6時30分にそのユーザーの適格性をチェックし、午前7時以降にトリガーが発生した時点でメッセージが表示されます。

セッション中の適格性

セッション中に適格になったユーザーは、次回のセッション開始時にメッセージを受信します。

メッセージが表示される直前に適格性を再度チェックするには、表示前にキャンペーンの適格性を再評価するを選択します。ユーザーが条件を満たさなくなった場合、メッセージは表示されません。この設定によって、セッション開始後に適格になったユーザーにメッセージが送信されることはありません。詳細については、ターゲットにするユーザーを選択するを参照してください。

キャンバス

キャンバス内のアプリ内メッセージでは、ユーザーがステップに到達した時点で、Brazeがそのステップのオーディエンスをチェックします。その後、メッセージはユーザーの次回のセッション開始時にダウンロードされます。

アーカイブしたアプリ内メッセージキャンペーンで、アプリ内メッセージのインプレッションが引き続き発生するのはなぜですか?

これは、アプリ内メッセージキャンペーンが有効だったときにセグメント条件を満たしていたユーザーで発生することがあります。

これを防ぐには、キャンペーンの設定時に表示前にキャンペーンの適格性を再評価するを選択してください。

アプリ内メッセージの開封数が表示されないのはなぜですか?

アプリ内メッセージでは開封数の指標を使用しません。Brazeは、メッセージが画面に表示されたときにインプレッション数を記録し、ユーザーがメッセージ本文やボタンを操作したときにクリック数を記録します。マルチチャネルのエクスポートやレポートにアプリ内メッセージの行が含まれている場合は、メールのような開封数ではなく、インプレッション数とクリック数を比較してください。定義については、アプリ内メッセージのレポートを参照してください。

同じセッション内で複数のアプリ内メッセージを表示できますか?

はい。ただし、トリガーイベントが1回発生するごとに表示できるアプリ内メッセージは1つだけです。複数のアプリ内メッセージキャンペーンが同じトリガー (セッション開始など) を共有している場合、そのトリガーが発生するたびに、最も優先度の高いメッセージのみが表示されます。セッション開始トリガーの場合、1セッションにつき表示できるメッセージは1つだけで、対象となる別のメッセージを表示できる次の機会は次のセッションになります。

複数のメッセージが同じ優先度レベルを共有している場合は、最も新しく作成されたメッセージが最初に表示されます。セッション開始トリガーの場合、次に新しいメッセージは後続のセッションで表示されます。その他のトリガータイプの場合、次に新しいメッセージはそのトリガーイベントが次に発生したときに表示されます。これは同じセッション内のこともあれば、後のセッションのこともあります。

同じ優先度グループ内での表示順序を制御するには、いずれかのキャンペーンの配信設定に移動して正確な優先度を設定を選択し、キャンペーンをドラッグ&ドロップして希望する順序に並べ替えます。詳細については、優先度を選択するを参照してください。

アプリ内メッセージのインプレッションとクリックはどのように記録されますか?

ユーザーのアクションごとにインプレッションとクリックがどのように記録されるかについては、アプリ内メッセージのレポートを参照してください。従来のエディターで作成したフルスクリーンメッセージに固有の例については、ユーザーアクション別のフルスクリーンメッセージの指標を参照してください。

アプリ内メッセージの有効期限を「1日後」に設定した場合、Brazeはどのように計算しますか?

Brazeは、1日の有効期限を、ユーザーがメッセージを受信できる状態になってから24時間後として計算します。

テンプレート化されたアプリ内メッセージとは何ですか?

表示前にキャンペーンの適格性を再評価するが選択されている場合、またはメッセージに次のいずれかのLiquidタグが含まれている場合、アプリ内メッセージはテンプレート化されたアプリ内メッセージとして配信されます。

  • canvas_entry_properties
  • connected_content
  • {sms.${*}} などのSMS変数
  • catalog_items
  • catalog_selection_items
  • event_properties

Brazeは、アイドル状態のアプリ内メッセージキャンペーン (アクティブなままであるものの、送信していない、または不要になったキャンペーン) にもテンプレート化された配信を使用します。これらのキャンペーンは、設定されたオーディエンスとトリガーのルールに引き続き従います。

Brazeは、アプリのパフォーマンスを保護するためにテンプレート化された配信を使用することもあります。Liquidコンテンツの準備によってセッションの応答が数秒以上遅れる場合、Brazeは残りの処理を後回しにします。これらのメッセージは、トリガーされた時点でレンダリングされます。

つまり、セッション開始時にデバイスが受信するのは、メッセージ全体ではなく、そのアプリ内メッセージのトリガーです。ユーザーがアプリ内メッセージをトリガーすると、ユーザーのデバイスがネットワークリクエストを送信して実際のメッセージを取得します。

Brazeがセッション開始時に処理するLiquidの量を減らすには、アプリ内メッセージのパフォーマンスを最適化するを参照してください。

アプリ内メッセージの中止動作はどのように機能しますか?

Brazeでは、ユーザーがメッセージを受信する条件を満たすアクションを実行したにもかかわらず、メッセージのLiquidロジックによって対象外と判定され、メッセージを受信しなかった場合に中止が発生します。例を挙げます。

  1. Samが、メールキャンペーンをトリガーするはずのアクションを実行します。
  2. メール本文には、カスタム属性のスコアが50未満の場合はこのメールを送信しない、というLiquidロジックが含まれています。
  3. Samのカスタム属性のスコアは20です。
  4. BrazeはSamがこのメールを受信すべきでないと判断し、メールは中止されます。
  5. 中止イベントが記録されます。

ただし、アプリ内メッセージはプル型のチャネルであるため、中止の仕組みが少し異なります。

標準のアプリ内メッセージの中止動作

アプリ内メッセージはセッション開始時にデバイスによって取得され、デバイスにキャッシュされます。そのため、インターネット接続の品質にかかわらず、メッセージをユーザーに即座に配信できます。たとえば、ユーザーがセッション内で5件のアプリ内メッセージを受信する場合、セッション開始時に5件すべてを受信します。メッセージはローカルにキャッシュされ、定義されたトリガーイベント (セッション開始、カスタムイベントを記録するボタンのクリックなど) が発生したときに表示されます。

つまり、アプリ内メッセージを中止すべきかどうかを判断するロジックは、トリガーが発生する前に実行されます。これを説明するために、メールの例に登場したSamがプッシュ通知を購読しているとしましょう。

  1. Samがスマートフォンで、Brazeを利用したアプリを起動してセッションを開始します。
  2. ワークスペース内のアクティブなキャンペーンのオーディエンス条件に基づくと、Samは5つの異なるキャンペーンの対象になる可能性があります。5件すべてがSamのスマートフォンに取得され、キャッシュされます。
  3. Samはこれらのメッセージをトリガーするアクションをまだ実行していませんが、セッション内でそれらのメッセージを受信する可能性があります。
  4. 2件のアプリ内メッセージのLiquidには、Samをメッセージの受信対象から除外するルール (スコアのカスタム属性が十分に高くないなど) が含まれています。
  5. Samには、自分を除外する2件のアプリ内メッセージは送信されませんが、残りの3件のメッセージは送信されます。
  6. 中止イベントは記録されません。

Samのケースでは中止の定義を満たさないため、Brazeは中止イベントを記録しません。Samはメッセージをトリガーするアクションを実行していないからです。アプリ内メッセージの場合、Brazeがユーザーにメッセージを表示すべきでないと判断する前に、ユーザーが実際にトリガーを実行することはありません。

テンプレート化されたアプリ内メッセージの中止動作

テンプレート化されたアプリ内メッセージでは、トリガーイベントが発生したときに、メッセージを表示すべきかどうかをSDKが再評価します。そのため、中止動作が異なります。次の例で説明します。

  1. Samがスマートフォンで、Brazeを利用したアプリを起動してBrazeのセッションを開始します。
  2. アクティブなキャンペーンのオーディエンス条件から、Samはテンプレート化されたアプリ内メッセージの対象になる可能性があるため、メッセージのペイロードを含まないトリガー情報がSamのデバイスに送信されます。
  3. Samがカスタムイベントを記録するボタンを選択し、テンプレート化されたアプリ内メッセージがトリガーされます。
  4. Samのデバイスが、アプリ内メッセージを取得するためのネットワークリクエストを送信します。
  5. メッセージのLiquidロジックによって中止となるため、Brazeはこれを中止として記録します。Samはこの評価の前にトリガーアクションを実行しているからです。

アプリ内メッセージの中止動作の比較

次の表は、Samが経験したアプリ内メッセージのフローを比較したものです。

アプリ内メッセージ 中止動作
標準 Samがメッセージをトリガーするアクションを実行していないため、中止イベントは記録されませんでした。

中止の定義は「トリガーアクションを実行したにもかかわらずメッセージが表示されなかった」ことであるため、標準のアプリ内メッセージでは中止が記録されません。アプリ内メッセージはトリガーアクションが発生する前にデバイスに配信されるため、Liquidロジックによって除外されたアプリ内メッセージを中止とみなすのは理にかなっていません。
テンプレート化 Samがトリガーアクションを実行してテンプレート化されたアプリ内メッセージをトリガーしたものの、Liquidテンプレートで中止となったため、中止イベントが記録されました。

テンプレート化されたアプリ内メッセージでは、トリガーアクションが実行された後にLiquidの評価が行われるため、中止が記録されます。

アプリ内メッセージでConnected Contentはいつ実行されますか?

テンプレート化されたアプリ内メッセージでは、Connected Contentやその他のLiquidタグは、ユーザーがメッセージ内のボタンをクリックしたときではなく、トリガーイベントが発生してデバイスがメッセージのペイロードをリクエストしたときに解決されます。テンプレートの取得ごとに、その表示のためのConnected Contentの呼び出しが含まれる場合があります。

HTMLでConnected Contentが返すRESTデータを参照している場合、そのデータはメッセージがテンプレート化されたセッションで利用できます。複数のボタンが同じConnected Contentのレスポンスを参照しても、クリック時に追加の呼び出しは発生しません。

アプリ内メッセージキャンペーンで、トリガー後に設定できる遅延の最大値はどれくらいですか?

アプリ内メッセージキャンペーンでは、トリガーイベント後の配信を最大2時間 (7,200秒) 遅延させることができます。遅延のオプションはすぐにと遅延後です。より長く待機させる場合は、キャンバスのアプリ内メッセージステップの前に遅延ステップを追加してください。遅延の設定については、アクションベースの配信を参照してください。

アプリ内メッセージが表示されるまでに遅延があるのはなぜですか?

標準のアプリ内メッセージは、トリガーイベント後にキャッシュされたペイロードの準備が整うとすぐに表示されます。AndroidとiOSでは、メッセージ内で参照されている大きな画像やその他のCDNでホストされたアセットのダウンロードが完了するまで、アプリ内メッセージの表示がわずかに遅れることがあります。

テンプレート化されたアプリ内メッセージや、表示前にキャンペーンの適格性を再評価するを選択したキャンペーンでは、トリガー後、メッセージが表示される前に追加のネットワークリクエストが必要です。そのため、わずかな遅延 (安定した接続で通常100ミリ秒未満) が発生する場合があります。詳細については、ターゲットユーザーを選択するを参照してください。

アプリ内メッセージの見た目がダッシュボードのプレビューと異なるのはなぜですか?

配信されたアプリ内メッセージは、次のような場合にダッシュボードのプレビューと異なることがあります。

  • インテグレーションで、特定のプラットフォーム上でカスタムスタイルを適用している、またはデフォルトのアプリ内メッセージUIを上書きしている
  • プレビューで、受信者とは異なる属性を持つテストユーザーのプロファイルを使用している
  • テンプレート化されたコンテンツが、プレビューモードと送信時とで異なる内容に解決される

見た目を検証する際は、プロファイルがターゲットオーディエンスと一致するテストユーザーを使用してテストメッセージを送信してください。

複数ページのアプリ内メッセージで、すべてのページに同じ背景が使用されるのはなぜですか?

複数ページのアプリ内メッセージのいずれかのページで背景画像を有効にすると、その背景はメッセージ内のすべてのページに適用されます。ページごとに異なる背景を使用するには、JavaScriptを含むカスタムHTMLブロックを使用して、ページ間で画像を切り替えてください。

Webのアプリ内メッセージをテストするにはどうすればよいですか?

Webのアプリ内メッセージのテスト送信では、テストデバイスでプッシュが有効になっている必要があります。テストフローでは、アプリ内メッセージが表示されるアプリまたはサイトを開くプッシュ通知が配信されるためです。同じプッシュベースのテスト方法は、Brazeでプッシュが設定されていないすべてのプラットフォームに適用されますが、多くのモバイルインテグレーションではすでにプッシュが有効になっているため、プッシュが未設定の状況は主にWebで発生します。その場合は、代わりに社内のテスト用セグメントに対してライブキャンペーンを使用してください。手順については、テストメッセージを送信するを参照してください。

アプリ内メッセージにはプッシュのインテグレーションが必要ですか?

本番環境でアプリ内メッセージを機能させるために、プッシュ通知は必要ありません。アプリ内メッセージはBraze SDKを通じて配信され、プッシュのインテグレーションがなくてもアクティブなアプリセッション中に表示されます。

ただし、アプリ内メッセージのテスト送信では、テストデバイスでプッシュが有効になっている必要があります。テスト用のアプリ内メッセージは、アプリ内メッセージの表示をトリガーするプッシュ通知を通じて配信されるためです。テストユーザーはプッシュを有効にし、テスト用のプッシュ通知をタップしてアプリ内メッセージを表示する必要があります。

本番のキャンペーンでは、ユーザーはプッシュを介さずに、キャンペーンのトリガー (セッション開始やカスタムイベントなど) に基づいてアプリ内メッセージを表示します。

アプリ内メッセージに余分な文字やレンダリングされない文字が表示されるのはなぜですか?

別のアプリ (ワープロソフトやWebページなど) からテキストをコピーすると、メッセージ本文に目に見えない文字や印刷されない文字が挿入されることがあります。これらの文字は不要な記号として表示されたり、カスタムメッセージのLiquidやHTMLを壊したりする場合があります。

不要な文字やレンダリングされない文字を修正するには、Brazeエディターで該当するテキストを入力し直すか、表示されているテキストだけを選択して置き換えるのではなく、不要な文字を直接削除してください。特殊文字を含むカスタムHTMLメッセージの場合は、HTMLの<head>内に<meta charset="UTF-8">を追加してください。詳細については、文字エンコーディングを参照してください。

Android で全画面 HTML のアプリ内メッセージの閉じるボタンが表示されないのはなぜですか?

エッジツーエッジディスプレイを搭載したデバイス (Android 15以降を含む) では、全画面 HTML のアプリ内メッセージがシステムのステータスバーの背後に描画され、レイアウト上部にある閉じるコントロールが隠れることがあります。

Braze Android SDK バージョン37.0.0以降では、HTML のアプリ内メッセージにデフォルトでウィンドウインセットが適用されるため、コントロールはセーフエリア内に表示されます。それでもユーザーの画面で重なりが発生する場合は、最新の Braze Android SDKにアップグレードしてください。

この動作がデフォルトになる前の古い SDK バージョンでは、開発者が BrazeConfig.setIsHtmlInAppMessageApplyWindowInsetsEnabled(true) を有効にすることでこの動作を利用できました。

ドラッグ&ドロップのアプリ内メッセージをカスタマイズする際に知っておくべきことは何ですか?

ドラッグ&ドロップエディターは、モーダルとフルスクリーンの表示タイプをサポートしています。これらのコンテナー内に、エディターのブロックを使ってコンテンツを作成します。

次の点に注意してください。

  • キーと値のペア: 設定タブでキーと値のペアを追加すると、メッセージと一緒にカスタムデータをユーザーのデバイスに送信できます。詳細については、キーと値のペアを追加する (ドラッグ&ドロップ) またはキーと値のペア (従来型) を参照してください。
  • リンクとディープリンク: 各クリック時アクションには、デフォルトで URL フィールドが1つあります。URL に Liquid を使用すると、デバイス、アプリの種類、ユーザー属性に応じてリンクを変えられます。メッセージコンテナーでは、プラットフォーム固有のクリック時の動作をオンにして、プラットフォームごとに異なるリンクを設定することもできます。
  • 不透明度と背景: メッセージコンテナーの不透明度は、メッセージの背景全体に適用されます。個々のブロックでは、それぞれ独自の背景色を設定できます。より細かく制御するには、カスタムコードブロックにカスタム CSS を追加してください。
  • メッセージの幅: エディターでは、メッセージコンテナーの最大幅を 325 px 未満に設定できません。これにより、小さな画面でもコンテンツが読みやすくなります。より狭いレイアウトが必要な場合は、カスタム CSS を使用してください。
  • プラットフォーム固有の背景: 1つのメッセージでは、Web とモバイルで同じ背景画像と色が使用されます。エディターでプラットフォームごとに異なる背景を設定することはできません。
  • 複数ページのメッセージ: 背景画像とメッセージレベルのクリック時アクションは、複数ページのメッセージのすべてのページに適用されます。ページごとに異なる全面画像を使用するには、次のページにリンクするボタンを追加してください。
  • メッセージレベルのスタイル: メッセージレベルのスタイルは、メッセージ全体に適用されます。
  • 背景画像: 背景画像はモーダルに合わせて引き伸ばされます。

エディターに関するその他の考慮事項については、アプリ内メッセージ準備ガイドを参照してください。

Android SDKのログに表示される「Event was published, but no subscribers were found」とはどういう意味ですか?

このログ行は、通常はエラーではありません。Brazeが内部イベント (NoMatchingTriggerEventなど) を発行した時点で、アプリ内メッセージまたはContent Cardsのリスナーが登録されていない場合によく表示されます。

カスタムイベントでアプリ内メッセージがトリガーされるはずなのにこのログが表示される場合は、イベントが記録されていること、ユーザーがキャンペーンまたはキャンバスのオーディエンスに含まれていること、そしてメッセージがContent Cardsに依存している場合はContent Cardsが同期されていることを確認してください。

New Stuff!