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

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

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

標準的な調査パス

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

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人のユーザーがレポートされます。翌月までに、そのうち50人のユーザーが削除されたとします（たとえばusers/deleteエンドポイントによって）。再度CSVエクスポートを行うと、950人のユーザーがレポートされますが、キャンペーン分析のユニーク受信者数は引き続き1,000のままです。
   
   つまり、ユニーク受信者指標は累積カウントであり、セグメンターとCSVエクスポートは現在存在するユーザーのカウントを提供します。
   
   

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

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

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

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

1つ目のシナリオは、/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}"}
      ]
  }
]
}