セグメントのトラブルシューティング

以下から該当する症状を見つけて、適切なセクションに移動してください。このページでは、起動エラー、ユーザーの適格性、フィルターの問題、分析の不一致について説明します。フィルターの定義については、セグメンテーションフィルターを参照してください。セグメントサイズの推定値、正確なカウント、履歴メンバーシップチャートについては、セグメントサイズの測定を参照してください。

まずはここから：症状を確認する

標準的な調査パス

ユーザーがセグメントに含まれるべきなのに含まれていない場合、またはセグメントのカウントが正しくないように見える場合は、このワークフローを使用してください。

1. 起動がブロックされた場合： キャンペーンまたはキャンバスでオーディエンスの複雑さや10,000バイトのフィルターエラーが表示された場合は、エラー（CSVの回避策、フィルターの簡素化）から始めてください。
2. ユーザープレビューまたはユーザー検索： 特定のユーザーをセグメントフィルターに対してテストします。ユーザーが条件の一部またはすべてに一致しない場合、トラブルシューティングのために一致しない条件が一覧表示されます。手順については、「セグメントを作成する」のセグメントのテストを参照してください。
3. 正確な統計を計算する： セグメントの推定値が0ユーザーと表示される場合や正しくないように見える場合は、到達可能なユーザーパネルで正確な統計を計算を選択します。計算する前にセグメントを保存してください。計算がすでに実行中の場合は、完了するまでお待ちください。新しい計算が完了するまで、古い数値が表示される場合があります。詳細については、正確な統計の計算を参照してください。
4. フィルター値を確認する： タイプミス、データ型の不一致、古いキャンバスステップの参照、および否定フィルター + ORロジックを確認してください。
5. 複雑さを確認する： 起動がブロックされている場合は、ターゲットオーディエンスが複雑すぎて起動できないを参照してください。
6. サポートに連絡する： それでも問題が解決しない場合は、Brazeサポートにお問い合わせください。

セグメントのユーザー数がゼロと表示される

ダッシュボードのセグメントサイズは、多くの場合ユーザーのサンプルに基づく推定値です。非常に小さなセグメントでは、フィルターに一致するユーザーが存在していても、0を含む推定範囲が表示されることがあります。

• 正確なカウントを取得するには、到達可能なユーザーパネルで正確な統計を計算を選択してください。先にセグメントを保存する必要があります。詳細については、推定カウントに関する考慮事項を参照してください。
• 小さなセグメントでユーザープレビューがゼロユーザーを返した場合でも、必ずしもセグメントが空であるとは限りません。正確な統計を計算を実行して確認してください。詳細については、ユーザープレビューを参照してください。

遡及的なセグメントメンバーシップ

Brazeはユーザーごとの過去のセグメントメンバーシップ履歴を保存しません。特定のユーザーが過去の送信時にセグメントに含まれていたかどうかを遡って確認することはできません。

特定の時点でのメンバーシップを記録するには、キャンペーンやキャンバスを送信する前に、ダッシュボードからセグメントのユーザーをエクスポートするか、/users/export/segmentエンドポイントを呼び出してください。詳細については、セグメンテーションフィルター（セグメントメンバーシップフィルター）およびセグメントデータをCSVにエクスポートを参照してください。

エラー

ターゲットオーディエンスが複雑すぎて起動できない

このまれなエラーは、ターゲットオーディエンスに含まれる正規表現の値が多すぎる場合、正規表現の値が過度に長い場合、フィルターが過度に詳細な場合（「30,000件の郵便番号のいずれかに該当」など）、またはフィルターが多すぎる場合に発生します。これには、参照されるセグメント内のフィルターやターゲットオーディエンスステップで追加されたフィルターなど、キャンペーンまたはキャンバスのオーディエンスに含まれるすべてのフィルターが含まれます。

キャンペーンまたはキャンバスにセグメントフィルターを追加すると、それらのフィルターはBrazeでクエリに変換されます（これらのクエリの文字数は、ダッシュボードユーザーに表示される文字数と1:1で対応するわけではありません）。Brazeがキャンペーンまたはキャンバスを送信する際、ターゲットオーディエンスのすべてのフィルターを組み合わせたクエリを実行します。ターゲットオーディエンスの結果クエリの文字数を制限するしきい値が適用されます。特定のキャンペーンまたはキャンバスについて、参照されるすべてのセグメント（追加のフィルターすべてを含む）の文字数を合計します。特定のセグメントについて、すべてのフィルターとフィルター値の文字数を合計します。

キャンペーン、キャンバス、またはセグメントがしきい値を超えて起動できない場合、ダッシュボードにエラーが表示されます。このエラーが表示された場合は、再度起動する前にターゲットオーディエンスを簡素化してください。以下の方法があります。

• オーディエンスが複数のセグメントを参照している場合、同じフィルターが複数のセグメントに含まれているなどの冗長性がないことを確認してください。
• セグメントフィルターで古いデータを参照していないことを確認してください。たとえば、キャンバスが数か月前に停止されているにもかかわらず、過去1週間に特定のキャンバスステップを受信していないユーザーを検索する古いフィルターなどです。
• ユーザーIDやメールアドレスのリストだけのセグメント（正規表現フィルターを使用していることが多い）は、CSVインポートに変換して、単一のCSVフィルターに簡素化できます。
• CDIを使用している場合は、データウェアハウスからグループを直接取得するCDIセグメントを作成できる場合があります。

フィルターの最適化についてさらにサポートが必要な場合は、サポートにお問い合わせください。

注

文字数の制限は2025年4月から適用されています。2025年4月以前に起動されたキャンペーンやキャンバスは免除されており、引き続き制限を超えることができますが、新しく作成されたキャンペーンやキャンバスは制限を超えることができません。免除されたキャンペーンまたはキャンバスを編集または複製した場合、オーディエンスが制限以下に更新されるまで起動できません。

X件のアクティブまたは停止中のキャンペーンまたはキャンバスがオーディエンスの複雑さのしきい値を超えている

このバナーは、アクティブまたは停止中のキャンペーンやキャンバスのオーディエンスがオーディエンスの複雑さのしきい値を超えている場合に、キャンペーンまたはキャンバスのリストの上部に表示されます。バナーを選択すると、しきい値を超えているキャンペーンまたはキャンバスのみにリストがフィルタリングされます。その後、ターゲットオーディエンスが複雑すぎて起動できないのトラブルシューティング手順に従ってください。

フィルターが10,000バイトを超えているか、長すぎて保存できない

Brazeでは、個々のセグメントフィルターを最大10,000バイトに制限しています。これは英語の文字で10,000文字、日本語の文字で3,333文字に相当します。個々のフィルターが10,000バイトを超えると、セグメント内のフィルターであっても、キャンペーンやキャンバスに直接追加されたフィルターであっても、警告が表示されます。

このエラーが発生することは非常にまれですが、発生する場合は通常、ユーザーIDやメールアドレスのリストをターゲットとする正規表現フィルターで発生します。その場合は、以下の手順に従ってフィルターをCSVに変換できます。

1. 影響を受けるセグメントまたは特定の正規表現フィルターからユーザーをエクスポートします。
2. 必要に応じてCSVをクリーンアップします。Braze IDまたはAppboy IDが必要ですが、不要な場合は他のすべての列を削除できます。また、データが最新であることを確認するためにレビューすることをお勧めします（たとえば、ターゲットにする必要がなくなったユーザーを削除します）。
3. CSVファイルを再度インポートします。これにより、ユーザーが自動的に単一の高効率なCSVベースのフィルターにグループ化されます。

ユーザーの行動

ユーザーがセグメントに含まれなくなった

セグメントの作成中にユーザーが見つからない場合、セグメントの適格性を決定するユーザーデータが、ユーザー自身のアクティビティや、以前にインタラクションしたキャンペーンやキャンバスの結果として変更された可能性があります。再適格性がオンになっている場合、ユーザープロファイルには受信したキャンペーンの最新データが表示されます。

特定のユーザーが現在セグメントに一致するかどうかをテストするには、ユーザープレビューまたはユーザー検索を使用してください。

特定のアプリでフィルタリングすると他のアプリのユーザー情報が表示される

ユーザーは複数のアプリを持つことができるため、セグメンテーションページの使用アプリセクションで特定のアプリを選択すると、少なくともそのアプリを持っているユーザーの結果が返されます。このフィルターは、そのアプリのみを持つユーザーに限定した結果を返すわけではありません。

フィルタリング

フィルターオプションが変更された

フィルターオプションは、カスタム属性としてBrazeに渡しているデータの形式（データ型）に関連しています。Brazeがカスタム属性に対して認識しているデータ型を確認するには、データ設定 > カスタム属性に移動してください。

フィルターオプションが変更された場合、それはデータが以前とは異なる形式（データ型）でBrazeに渡されていることを示しています。さまざまなデータ型とそのフィルターオプションの詳細については、カスタム属性のデータ型を参照してください。

ダッシュボードでカスタム属性のデータ型を変更すると、異なる形式でBrazeに送信されたデータは拒否されることに注意してください。アクティブなキャンペーン、キャンバス、またはセグメントで参照されているカスタム属性のデータ型は変更できません。ダッシュボードにエラーが表示され、変更がブロックされます。

カスタム属性の値タブには、約250,000人のユーザーのサンプルからの結果が表示されます。トラブルシューティングのために特定の属性値が存在するかどうかを確認する目的で値タブを使用しないでください。詳細については、値タブを参照してください。

ネストされたカスタム属性がフィルターオプションとして利用できない

セグメントを作成する際にネストされたカスタム属性がフィルターオプションとして表示されない場合は、まずスキーマを生成してください。データ設定 > カスタム属性に移動し、該当する属性を見つけて、スキーマを生成を選択します。生成が完了すると、その属性はセグメントフィルターのドロップダウンで利用可能になります。詳細については、ネストされたオブジェクトエクスプローラーを使用してスキーマを生成するを参照してください。

セグメントが予想よりもはるかに大きい

制限的に見えるフィルターにもかかわらずセグメントが予想よりもはるかに大きい場合は、同じ属性に対して否定フィルター（is not、does not equal、does not match regex、またはnot included）をOR演算子で複数回使用していないか確認してください。この組み合わせは、その属性のすべての値を持つユーザーをターゲットにする可能性があります。

ORの代わりにANDを使用すべきタイミングについては、「セグメントを作成する」のOR演算子の使用を避けるべき場合を参照してください。

分析とレポート

キャンペーン分析の送信済みメッセージまたはユニーク受信者がセグメント数と一致しない

キャンペーン分析の送信済みメッセージまたはユニーク受信者の数が、セグメントフィルターHas received message from campaign Xのユーザー数と一致しない場合、3つの原因が考えられます。

1. キャンペーン開始後にユーザーがアーカイブ、孤立、または削除された可能性がある
   
   たとえば、1,000人のユーザーがキャンペーンを受信し、同日にCSVエクスポートを行ったとします。1,000人のユーザーが報告されます。翌月までに、その1,000人のうち50人が削除されたとします（たとえば、users/deleteエンドポイントによって）。再度CSVエクスポートを行うと、950人のユーザーが報告されますが、キャンペーン分析のユニーク受信者数は依然として1,000のままです。
   
   つまり、ユニーク受信者指標は累積カウントであるのに対し、セグメンターとCSVエクスポートは現在存在するユーザーのカウントを提供します。
   
   

2. キャンペーンに再エントリ資格が設定されており、ユーザーが複数回キャンペーンに再エントリできる
   
   たとえば、メールキャンペーンの再エントリ資格がゼロ分に設定されており（ユーザーはオーディエンスセグメントの要件を満たす限りキャンペーンに再エントリできる）、キャンペーンが1か月以上実行されているとします。キャンペーン分析の送信済みメッセージ数はセグメントの数と一致しません。このフィールドには重複ユーザーへの送信メッセージが含まれるためです。
   
   これは、Brazeがユニークユーザーを1日あたりのユニーク受信者、つまり1日に特定のメッセージを受信したユーザー数としてカウントするためです。再エントリ資格のあるユーザーは、「ユニーク」の期間が1日しか持続しないため、ユニーク受信者として複数回カウントされます。その結果、1日あたりのユニーク受信者数がCSVエクスポートのユーザープロファイル数よりも多くなることがあります。CSVファイルのユーザープロファイルは真にユニークです。
   
   

3. チャネル識別子を共有するユーザーがフィルターに一致した
   
   Has received message from campaign Xフィルター（およびその他の「受信済み」フィルター）は、メッセージを受信、開封、またはクリックした別のユーザープロファイルと同じプッシュトークンやメールアドレスなどのチャネル識別子を共有するユーザーに一致する場合があります。

ユーザーが1つのアプリでしかセッションを記録していないのに2つのアプリに割り当てられる

セグメントを作成する際、特定のアプリを使用したユーザーをターゲットにできます。ユーザーがそのアプリに割り当てられるには、特定のアプリでセッションを記録している必要がありますが、アプリでセッションを記録していなくても特定のアプリに割り当てられる2つのシナリオがあります。

最初のシナリオは、/users/trackエンドポイントを使用する際にapp_idフィールドが設定されている場合です。具体的には、次の例のようにイベントや購入オブジェクトを使用する場合です：

1
2
3
4
5
6
7
8
9
10
{
    "events": [
    {
      "external_id": "john_doe123",
      "app_id": "my_web_app_id",
      "name": "Custom Event",
      "time": "2025-08-17T19:20:30+1:00"
    }
  ]
}

2番目のシナリオは、プッシュトークンを移行するために/users/trackエンドポイントを使用する際にapp_idフィールドが設定されている場合です。次の例のようになります：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
"app_group_id": "{YOUR_APP_GROUP_ID}",
"attributes": [
{
      "push_token_import": false,
      "external_id": "external_id1",
      "country": "US",
      "language": "en",
      "{YOUR_CUSTOM_ATTRIBUTE}": "{YOUR_VALUE}",
      "push_tokens": [
        {"app_id": "{APP_ID_OF_OS}", "token": "{PUSH_TOKEN_STRING}"}
      ]
  }
]
}