問題
セグメントクエリがユーザー数を返さずに失敗し、そのセグメントを使用するキャンペーンも同様に失敗します。クエリが失敗する箇所に応じて、次のいずれかが表示されます。'queryString' failed to satisfy constraint: Member must have length less than or equal to 262144など、長さの制約を示す失敗理由。- 原因が示されず、クエリの実行中に予期しないエラーが発生したことを示す一般的な失敗理由。
- セグメントが実行中の状態のままで、件数が返されない。
手順
セグメント定義は実行前に単一のクエリにシリアル化され、そのシリアル化されたクエリの最大長は 256 KB（262,144 文字）です。MoEngage はクエリ全体を評価するため、この制限は完全に展開された定義に適用されます。つまり、画面に表示される条件だけでなく、定義内で参照されているすべてのカスタムセグメントの定義も含まれます。 これはネストの制限とは別の制限です。セグメントのネストが 6 レベルを大きく下回っていてもクエリ長を超える場合があり、逆に 256 KB よりはるかに短くてもネストの制限を超える場合があります。一方の制限内に収まっていても、もう一方の制限内に収まるとは限りません。 クエリ長は、次のパターンで最も急速に増加します。- 多数のカスタムセグメントを OR で組み合わせる。 参照される各カスタムセグメントは、親クエリ内で独自の完全な定義に展開されます。
- 除外ブロックでカスタムセグメントを使用する。 除外されたカスタムセグメントも含めるカスタムセグメントと同様に展開されるため、複数のカスタムセグメントの除外リストは、同じサイズの包含リストと同程度の長さを追加します。
- 多数の値が選択されたフィルター。 携帯電話番号、商品 ID、都市名など、数百の値に一致する単一のフィルターは、複数の通常の条件を合わせたよりも多くの長さを追加する場合があります。
- OR で結合したカスタムセグメントのリストを 1 つのセグメントに置き換える。 複数のカスタムセグメントが 1 つの属性の値だけで異なる場合は、それらすべての値に一致する 1 つのフィルターを持つ単一のセグメントとして再構築します。それぞれ 1 つの言語に一致する 10 個のセグメントは、言語フィルターに 10 個の値を列挙した 1 つのセグメントになります。
- 長い値のリストをファイルセグメントに移動する。 識別子をファイルセグメントとしてアップロードし、フィルターに値を列挙する代わりにそれを参照します。ファイルセグメントは、ネストやカスタムセグメントの制限にもカウントされません。
- 冗長な参照をフラット化する。 1 つか 2 つの条件を追加するためだけにカスタムセグメントを参照している場合は、それらの条件を親クエリにインライン化し、参照を削除します。
- セグメントとキャンペーンを分割する。 定義が、まとめて評価する必要のないオーディエンスを対象としている場合は、2 つ以上のセグメントを作成し、それぞれに対してキャンペーンを実行します。
例
あるセグメントが、10 個のカスタムセグメントを OR で組み合わせて定義されています。各カスタムセグメントは優先言語ごとに 1 つずつあり、いずれも同じオーディエンスにフィルタリング済みです。この定義は 1 つの定義あたり 10 個のカスタムセグメントという制限内にあり、深さも 2 レベルしかありませんが、10 個の参照がそれぞれ独自の完全な定義に展開されるため、シリアル化されたクエリは 256 KB を超え、length less than or equal to 262144 エラーで失敗します。このセグメントをターゲットとするすべての定期キャンペーンも同様に失敗します。
定義を単一のセグメント（共通のオーディエンスフィルター AND 優先言語が 10 個の値のいずれか）として再構築すると、展開された 10 個の定義が、10 個の値を持つ 1 つのフィルターに置き換えられます。クエリは件数を返し、キャンペーンは再開されます。