Skip to content


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

インプレッション

インプレッションまたはクリックの分析がログに記録されない

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

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

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

期待したアプリ内メッセージが表示されない

アプリ内メッセージの問題の多くは、配信と表示の2つの主要なカテゴリに分類できます。期待したアプリ内メッセージがデバイスに表示されなかった理由をトラブルシューティングするには、まずアプリ内メッセージがデバイスに配信されたことを確認し、次にメッセージの表示をトラブルシューティングしてください。

アプリ内メッセージの配信

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

メッセージがリクエストされて返されているか確認する

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

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

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

イベントユーザーログに表示される、セッション開始イベントが成功したSDKリクエスト。

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

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

  • セグメントにユーザーが含まれていない。
    • ユーザーのエンゲージメントタブを確認し、セグメントの下に正しいセグメントが表示されているか確認してください。
  • ユーザーが以前にそのアプリ内メッセージを受信しており、再度受信する再適格性がない。
    • キャンペーン Composerの配信ステップにあるキャンペーン再適格性設定を確認し、再適格性設定がテスト設定と一致していることを確認してください。
  • ユーザーがキャンペーンのフリークエンシーキャップに達した。
  • キャンペーンにコントロールグループがある場合、ユーザーがコントロールグループに入った可能性がある。
    • これが発生したかどうかは、受信キャンペーンバリアントフィルターを使用してセグメントを作成し、キャンペーンバリアントをコントロールに設定して、ユーザーがそのセグメントに入っているか確認することで確認できます。
    • インテグレーションテスト用のキャンペーンを作成する際は、コントロールグループの追加をオプトアウトしてください。

アプリ内メッセージの表示

アプリがアプリ内メッセージを正常にリクエストして受信しているにもかかわらず表示されない場合、デバイス側のロジックが表示を妨げている可能性があります。

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