Skip to content


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

インプレッション

インプレッション分析やクリック分析が記録されていない

メッセージ表示またはクリックアクションを手動で処理するようにアプリ内メッセージデリゲートを設定している場合は、アプリ内メッセージのクリック数とインプレッション数を手動で記録する必要があります。

インプレッションが予想より低い

トリガーはセッション開始時にデバイスへの同期に時間がかかるため、ユーザーがセッション開始直後にイベントや購入を記録すると競合が発生する可能性があります。考えられる回避策の1つは、Campaignをセッション開始時にトリガーするよう変更し、目的のイベントまたは購入でセグメント化することです。なお、イベント発生後の次回セッション開始時にアプリ内メッセージが配信されることに注意してください。

予期したアプリ内メッセージが表示されなかった

ほとんどのアプリ内メッセージの問題は、配信と表示の2つの主要なカテゴリに分けることができます。予期したアプリ内メッセージがデバイスで表示されない原因をトラブルシューティングするには、まずアプリ内メッセージがデバイスに配信されたことを確認してから、メッセージ表示のトラブルシューティングを行う必要があります。

アプリ内メッセージ配信

SDKはセッション開始時にBrazeサーバーからアプリ内メッセージをリクエストします。アプリ内メッセージがデバイスに配信されているかどうかを確認するには、アプリ内メッセージがSDKによってリクエストされ、Brazeサーバーによって返されていることを確認する必要があります。

メッセージがリクエストされ、返されたかどうかを確認する

  1. ダッシュボードで自分自身をテストユーザーとして追加します。
  2. ユーザーを対象としたアプリ内メッセージCampaignを設定します。
  3. アプリケーションで新しいセッションが発生することを確認します。
  4. イベントユーザーログを使用して、セッション開始時にデバイスがアプリ内メッセージをリクエストしていることを確認します。テストユーザーのセッション開始イベントに関連付けられたSDKリクエストを見つけます。
    • トリガーされたアプリ内メッセージをリクエストするためのアプリであれば、Response DataRequested Responsesフィールドに trigger が表示されます。
    • アプリが元のアプリ内メッセージをリクエストするためのものだった場合、Response DataRequested Responsesフィールドに in_app が表示されます。
  5. イベントユーザーログを使って、レスポンスデータに正しいアプリ内メッセージが返されているか確認します。

リクエストされていないメッセージのトラブルシューティング

アプリ内メッセージがリクエストされていない場合、アプリ内メッセージはセッション開始時にリフレッシュされるため、アプリがセッションを正しくトラッキングしていない可能性があります。また、アプリのセッションタイムアウトセマンティクスに基づいて、アプリが実際にセッションを開始していることを確認してください。

イベントユーザーログに記録されたSDKリクエストは、セッション開始イベントが成功したことを示しています。

メッセージが返されない問題のトラブルシューティング

アプリ内メッセージが返されない場合、Campaignターゲティングの問題が発生している可能性があります。

  • Segmentにユーザーが含まれていない。
    • ユーザーのエンゲージメントタブを確認し、Segments欄に正しいSegmentが表示されているか確認します。
  • ユーザーが以前にアプリ内メッセージを受け取ったことがあり、再度受け取る資格がなかった。
    • Campaign Composer配信ステップにあるCampaignの再適格性設定を確認し、再適格性設定がテスト設定と一致していることを確認します。
  • ユーザーがCampaignのフリークエンシーキャップに達した。
  • Campaignにコントロールグループが存在した場合、ユーザーがコントロールグループに分類された可能性があります。
    • Campaignバリアントがコントロールに設定されている受信Campaignバリアントフィルターでセグメントを作成し、ユーザーがそのセグメントに分類されたかどうかを確認することで、これが発生したかどうかを確認できます。
    • 統合テスト目的でCampaignを作成する場合は、コントロールグループの追加をオプトアウトしてください。

アプリ内メッセージ表示

アプリがアプリ内メッセージのリクエストと受信に成功しているのに表示されない場合は、デバイス側のロジックによって表示が妨げられている可能性があります。

  • トリガーされたアプリ内メッセージは、トリガー間の最小時間間隔(デフォルトは30秒)に基づいてレート制限されます。
  • アプリ内メッセージ処理をカスタマイズするようにデリゲートを設定している場合は、デリゲートがアプリ内メッセージ表示に影響していないことを確認してください。
  • 画像のダウンロードに失敗すると、画像付きのアプリ内メッセージが表示されなくなります。SDWebImage フレームワークが正しく統合されていない場合、画像のダウンロードは常に失敗します。画像のダウンロードに失敗していないか、デバイスのログを確認してください。
  • デバイスの向きがアプリ内メッセージで指定された向きと一致しなかった場合、アプリ内メッセージは表示されません。デバイスの向きが正しいことを確認してください。
New Stuff!