メインコンテンツにスキップ

アプリ内メッセージのトラブルシューティング

Chat、Post、Banner、Survey、Product Tourが期待通りに送信されない場合の対処方法をいくつか紹介します。

対応者:Laura Jolly

誤ったページで送信されている

メッセージが誤ったウェブサイトのURLで送信されている場合:

  • オーディエンスやページルールが正しい論理で設定されているか確認してください。例えば、複数の否定ルール(「is not」「does not contain」)を組み合わせる場合は、ほとんどの場合『OR』ではなく『AND』で区切る必要があります。また、正確一致の「URL is」フィルタを使用している場合は、https://を含む完全なURLと末尾のスラッシュを含めていることを確認してください。フィルタの効果的な設定方法の詳細はこちらをご覧ください。

  • 最初は正しいページで受信し、その後別のページに移動しましたか?「フォローページ」動作により、アプリ内メッセージがユーザーに操作(クリックまたは閉じる)されない場合、ユーザーが他のページに移動しても表示が持続します — URLルールで明示的に除外されたページを含めて — ユーザーが操作するまで持続します。ユーザープロファイルの「Recent page views」を確認し、タイムスタンプをメッセージ受信のタイムスタンプと比較してみてください。

  • ページURLルールを設定する際は、フルアドレスではなく該当するパス部分(例: /dashboard)のみを使用してください。フルURLを使用すると、domainの違いやクエリパラメータ、末尾スラッシュにより不一致が発生する可能性があります。

イベントトリガーが機能していない

イベントトリガー付きのメッセージが送信されない場合:

  • メッセージを公開したばかりの場合、オーディエンスの人々はオンラインになり、イベントをメッセージが公開された後にトリガーする必要があることに注意してください。公開前にイベントをトリガーしていた場合、送信されません。過去のイベントを取り込むには、トリガーの代わりにオーディエンスルールにイベントを入れることができます。

  • イベントトリガーと同じイベントのオーディエンスルールを組み合わせましたか?トリガーとルールを組み合わせる場合、イベントトリガーは同じリクエスト内でユーザーを即時に更新しないため、ターゲティングルールはイベントをトリガーした時点で満たされている必要があります。例えば、ユーザーが購入アイテムイベントを初めてトリガーしたときだけメッセージを送信し、以降は送信しないようにしたい場合、カウントを0(つまりそのイベントを一度もトリガーしていないユーザー)に設定します。カウントは次のリクエストまで1に更新されないからです。

  • イベントトリガーが必要ですか、それともオーディエンスルールでターゲティングできますか?「トリガー」セクション(いつ送信するか/どこで送信するか)は任意なので、ユーザーが特定のアクションを取ったときだけ送信する必要がない限り、すべてのメッセージにイベントを含める必要はありません。

全画面で表示されない

Messengerアイコンの赤いバッジ通知としては送信されるが、画面にポップアップしない場合:

  • ユーザーに同時に他の保留中のメッセージが送信されていますか? 複数のメッセージはMessengerアイコンに赤いバッジとして表示され、同時に多数のポップアップを受けないようにします。ユーザープロファイルの「Recent content」を確認して、同じ時間帯に受信したメッセージを確認できます。

  • ChatまたはPostのコンテンツが「送信形式: Badge」に設定されていますか?これらは常にバッジ通知として送信されます。設定を「Snippet」や「Show the full message」に変更しない限り。

ウェブベースのモバイルアプリでチャットメッセージがポップアップしない

モバイルアプリがネイティブのiOSやAndroid SDKではなくウェブベースのMessengerを使用している場合、apiUpdateピンにマッチするチャットは自動的にスニペットやフルメッセージのポップアップとして表示されません。これは意図的な動作です — Intercomは更新ピンで未読メッセージの照会を意図的にスキップします。更新ピンは継続的に実行されるため、毎回実行するとMessengerが全員にとって遅くなるからです。ページロードでトリガーされるチャットはすぐに表示されます。

注意:この動作はウェブベースのMessengerを使用しているモバイルアプリにのみ影響します。ネイティブのiOSやAndroid SDKを使用しているアプリは影響を受けません。

未読メッセージの状態を強制的に更新するには、Intercom('shutdown')を呼び出し、その後にIntercom('boot', { ...same user data... })を呼び出します。これによりapiBootピンがトリガーされ、未読メッセージのチェックが行われます。Messengerが閉じている間にこれを実行してください — 会話が開いている間にshutdownを呼び出すと、それが閉じられ、ユーザーにとって中断となります。

タイマーやアプリがフォアグラウンドに戻ったときにこれをトリガーすることができます。

Postの開封率が100%ではない

Postが「Show the full message」に設定されているが開封率が100%でない場合:

  • Postは編集され、元々は変更前にユーザーに「Snippet」や「Badge」として送信されていませんでしたか?

  • Postが送信されたとき、ユーザーに同時に他の保留中のメッセージがありましたか?複数のメッセージが同時に送信されようとすると、Postは代わりにMessengerアイコンの赤いバッジ通知として送信され、ユーザーが優先度の高いメッセージを先に確認できるようにします。通知をMessengerで開く必要があり、メッセージ統計で「開封」として記録されます。

  • 通常、完全表示で送信されたPostの開封率は90%以上、しばしば95%以上になります。ただし、ユーザーに他の保留中メッセージがあった場合、またはメッセージが送信されたときと自動表示されるまでの短い間にユーザーがページから離れた場合、メッセージは開封済みとして記録されないことがあります。

  • 開封率が90%を大きく下回る場合は、サイト上のエンドユーザーとしてPostを受信するテストを行い、ブラウザのコンソールを開いてページのエラーをキャプチャしてください。状況によっては、ページエラーがPostの正しい表示を妨げる可能性があります。

一時停止したメッセージを公開できない

メッセージを一時停止していて、再度公開できない場合:

  • 「Fixed」オーディエンスタイプがありますか?Fixedメッセージは停止された後に再度公開できません。これらは特定の時点で一致したユーザーにのみ送信され、その時点は過去になっているためです。メッセージを複製して新しいバージョンを公開する必要があります。

  • メッセージに停止日が設定されていましたか?その日付が過去であれば、再度送信できるように停止日を更新または削除する必要があります。

  • 「▶️ Set live」ボタンがグレーアウトしている場合、ホバーするとなぜ公開できないかを説明するツールチップが表示されます。あるいはメッセージを編集して、セクションに赤いエラーが表示されていないか確認してください。

一時停止したメッセージがまだユーザーに送信されている

メッセージを一時停止したのにユーザーがまだ受信している場合:

  • 一時停止する前に実際に受信しており、ユーザーがそれに操作(クリックや閉じる)しなかったため、次にプラットフォームを訪れたときにポップアップが続いている可能性があります。ユーザープロファイルの「Recent content」を確認して、受信時刻を確認し、メッセージを一時停止した時刻と比較してください。

  • Help Deskでユーザーがアウトバウンドメッセージに返信している場合、アウトバウンドメッセージが送信された時刻(最初のメッセージの下部)を確認してください。彼らは以前に受信したメッセージに返信している可能性があります。

  • 複数の類似メッセージを実行していますか?一時停止されていない別の類似のメッセージを受信した可能性があります。ユーザープロファイルの「Recent content」から受信したメッセージをクリックして、どのアウトバウンドメッセージだったかを確認できます。

対象に一致するユーザーが受信しなかった

メッセージを受信するはずのサンプルユーザーが受信しなかった場合:

  • 公開されてからユーザーがオンラインになりましたか?ユーザーはアプリ内メッセージを受け取るために実際にオンラインになる必要があります。ユーザープロファイルの「Last seen」を確認して、最後にオンラインだった時刻を確認できます。

  • 固定/静的メッセージですか?Fixedメッセージは公開時に一致するため、現在一致しているユーザーが最初に送信された時点で一致していなかった可能性があります。

  • イベントトリガーやURLルールがありますか?ユーザーは公開後にイベントをトリガーするかURLを訪問する必要があり、さらにオーディエンスルールにも一致している必要があります。オーディエンスプレビューに表示されるかもしれませんが、必要なURL訪問やイベントトリガーが行われるかは考慮されていません。

  • コンテンツセクションの「Show first on」でどのチャネルをターゲットにしていますか?「Show first on web」に設定されていて、ユーザーがモバイルでのみアクティブな場合、ウェブで訪問するまでメッセージは届きません。

  • メッセージに開始日や停止日が設定されていて、ユーザーが開始日以降かつ停止日以前にオンラインでしたか?

  • メッセージに特定の送信時間帯のみ送信するカスタムスケジューリング時間がありますか?アプリ内メッセージはエンドユーザーのタイムゾーンで送信されるため、そのスケジュールされた時間帯内にそのユーザーがオンラインである必要があります。

  • ユーザーがメッセージを受信する資格がない理由を判断するために、メッセージマッチングツールを使用することもできます。


別の問題に直面している場合は、チャネル別FAQを試してください:

こちらの回答で解決しましたか?