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

エラー数

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

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

キャンペーンやキャンバスにセグメントフィルターを追加すると、それらのフィルターはBraze内でクエリに変換される（これらのクエリの文字数は、ダッシュボードユーザーが確認する文字数と1対1で対応するわけではない）。BrazeがキャンペーンやCanvasを送信する際、対象オーディエンスの全フィルターを組み合わせたクエリを実行する。対象オーディエンス向けに、生成されるクエリの文字数を制限する閾値を適用する。特定のキャンペーンやキャンバスに対しては、参照される全セグメント（追加フィルターを含む）の文字数を合計する。特定のセグメントについて、全てのフィルターとフィルター値にわたる文字数を合計する。

キャンペーン、キャンバス、またはセグメントが閾値を超え、開始できなくなった場合、ダッシュボードにエラーが表示される。このエラーが発生した場合、再度実行する前に対象オーディエンスを絞り込むこと。具体的には：

• オーディエンスが複数のセグメントを持つ場合、それらのセグメントに重複がないことを確認せよ。例えば、同じフィルターが複数のセグメントに現れるような事態は避けること。
• セグメントフィルターで古いデータを参照していないことを確認せよ。例えば、古いフィルターは、キャンバスが数ヶ月前から停止されているにもかかわらず、過去1週間で特定のキャンバスステップを受け取っていないユーザーを探してしまうかもしれない。
• ユーザー IDやメールのリストだけから成るセグメント（正規表現フィルターを使うことが多い）は、CSVインポートに変換できる。そして単一のCSVフィルターに簡素化できる。
• CDIを持っているなら、データウェアハウスから直接グループを取得するCDIセグメントを作成できるかもしれない。

フィルターの最適化に関するさらなる支援が必要な場合は、サポートに連絡することもできる。

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に送信されたデータは拒否されることに留意してほしい。

分析とレポート

キャンペーンアナリティクスのメッセージ送信数またはユニーク受信者数がセグメント数と一致しない

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

1. キャンペーン開始後に、ユーザーが孤立したか、アーカイブまたは削除が行われた可能性がある。
   
   例えば、1,000人のユーザーがキャンペーンを受け、同じ日にCSVエクスポートを行ったとしよう。1,000人のユーザーが報告されていることがわかるだろう。翌月、1,000 人のユーザーのうち 50 人が削除されます (例えば、users/delete エンドポイントによる)。ここでもう一度 CSV エクスポートを行うと、950 人のユーザーが報告されますが、[キャンペーン分析] の [ユニーク受信者数] は 1,000 人のままです。
   
   言い換えれば、Unique Recipients（ユニーク受信者）メトリクスは、インクリメントされたカウントであり、セグメンターとCSVエクスポートは、現在存在するユーザーのカウントを提供する。
   
   

2. キャンペーンには再応募資格が設定されているため、ユーザーは何度もキャンペーンに再応募できる。
   
   例えば、あるメールキャンペーンで、再応募資格を0分に設定し（ユーザーはオーディエンスセグメントの条件を満たしている限り、キャンペーンに再応募できる）、キャンペーンを1ヶ月以上実施しているとしよう。このフィールドには重複したユーザーに送信されたメッセージが含まれるため、Campaign Analyticsの 送信メッセージ数はセグメントの数と一致しない。
   
   これは、Braze がユニークユーザーを日次ユニーク受信者数 (1 日に特定のメッセージを受信したユーザー数) としてカウントしているためです。つまり、「ユニーク」な期間は 1 日しかないため、再適格者はユニーク受信者として複数回カウントされます。その結果、日次ユニーク受信者数が CSV エクスポートのユーザープロファイル数より多くなることがあります。CSV ファイル内のユーザープロファイルは、真にユニークなものです。

ユーザーは一つのアプリにのみセッションを記録しているにもかかわらず、二つのアプリに割り当てられている。

セグメントを作成する際、特定のアプリを使用したユーザーをターゲットにできる。ユーザーが特定のアプリに割り当てられるには、そのアプリでセッションを保持している必要がある。ただし、アプリでセッションを保持していなくても、ユーザーが特定のアプリに割り当てられるケースが二つ存在する。

最初のシナリオは、エンド/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"
    }
  ]
}

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