セグメント数、推定オーディエンス、および Segments API について理解する

セグメント数とリスト数が示す内容

Klaviyo のセグメント数とリスト数は、カウントが計算された時点で、そのセグメントの条件を現在満たしているプロファイル数、またはそのリストに現在含まれているプロファイル数を表します。動的セグメントは、ユーザーが条件を満たす、または満たさなくなるたびに自動的に再計算されます。一方、リストは、フォーム、外部連携、またはインポートを通じて追加するプロファイルの静的なコレクションです。

キャンペーン ビルダーに推定オーディエンスが表示される理由

キャンペーン設定でリストまたはセグメントを選択すると、Klaviyoはリストまたはセグメントの生のサイズではなく、推定受信者数を表示します。この推定では、リストまたはセグメントへの登録に加えて、次のような追加ルールが適用されます：

• 送信抑制のステータス（例：購読解除またはバウンスしたプロファイル）
• 選択したチャネルでマーケティングを受信可能なプロファイルかどうか
• キャンペーンから除外するリストとセグメント

これらのフィルターにより、推定オーディエンスは、リストとセグメントビューで表示されるリストまたはセグメントのサイズよりも小さくなることがよくあります。スケジュール設定により、Klaviyoが受信者を選択するタイミングが決まります。スケジュール設定の直後、または送信開始前に1回だけです。後続のスキップにより、実際に送信されるメッセージ数が減少する可能性があります。受信者の決定タイミングを変更する方法をご確認ください。

セグメントのカウントが更新される頻度

動的セグメントの件数は、次のような基になるデータの変更に応じて更新されます。

• ユーザーが該当または非該当となる原因となる新しいイベント（例: 開封、クリック、注文）
• プロファイルプロパティの変更
• 購読ステータスの更新と送信抑制

ほとんどのアクティブなセグメントはほぼリアルタイムで更新されますが、変更の処理には時間がかかる場合があります。リストとセグメントに表示される数は、次と異なる場合があります：

• 送信対象ルールを考慮した、キャンペーンビルダーでの推定オーディエンス
• 受信者の選択と送信時間チェックの適用後に、実際に送信されたメッセージ数

詳細については、セグメントの更新の仕組みをご覧ください。

送信抑制、同意、スマート送信が件数に与える影響

プロファイルが選択したリストまたはセグメントに属していても、以下の場合、Klaviyo は送信しません。

• 購読解除やバウンス後に送信抑制済みとなったメールプロファイルなど、チャネルに対して送信抑制済みとなります。
• そのチャネルではマーケティングを受信できません。SMSにはSMSの同意が必要です。メールの場合、未購読としてマークされているプロファイルは、すべてのアカウントで自動的に除外されるわけではありません。対象となるかどうかは、アカウントの同意設定とプロファイルの送信抑制ステータスによって異なります。
• スマート送信が有効になっている場合、該当するスマート送信の期間内に同じチャネルで別のマーケティングメッセージが送信されているため、対象外となります。

この見積もりには、チャネルの対象可否とオーディエンスの除外が考慮されています。スマート送信はメッセージ送信時に確認され、実際の送信数がさらに減少する場合があります。

Segments API を使用してセグメント数を取得する

Segments APIを使用すると、件数などのセグメントレベルの情報を取得できます。個別のセグメントの件数をリクエストしてください。すべてのセグメントを一覧表示するエンドポイントでは、プロファイル数は返されません。

segments:read権限を持つプライベートAPIキーまたはOAuthトークンを使用してください。セグメント数を取得するには：

1. セグメントIDが必要な場合は、GET /api/segments/をリクエストし、レスポンス内で該当のセグメントを見つけてください。レスポンスにさらにページがある場合は、links.nextに従ってください。
2. リクエストGET /api/segments/{id}/?additional-fields[segment]=profile_countで、{id}をセグメントIDに置き換えています。

個別セグメントのレスポンスで、次を確認してください：

• data.id：セグメント識別子。ほかのAPI呼び出しで使用できます。data.attributes.createdは、セグメントが作成された日付を示します。
• data.attributes.profile_count：カウントが読み取られた時点のセグメント内のプロファイル数。これはメンバーシップ数であり、キャンペーン受信者数の推定値ではありません。

セグメントのメンバーシップは動的に変化するため、APIが返すカウントは特定時点のスナップショットであり、呼び出し間で変更される可能性があります。data.attributes.is_processingがtrueの場合は、処理が完了するまで待ってからカウントを比較してください。

外部ツールに件数を同期するためのベスト プラクティス

セグメント数を BI ツールや外部ダッシュボードに同期する場合：

• トレンドの比較をしやすくするために、一貫したスケジュール（例: 毎日同じ時間）でカウントを取得してください。
• Klaviyo と外部システムの間で、レポート作成のタイムゾーンを合わせてください。
• 適用した追加フィルター（例：送信抑制済みプロファイルの削除）を記録しておき、後工程のユーザーが、アプリで表示される数値と異なる理由を把握できるようにします。

セグメントサイズ、推定オーディエンス、送信数の差異を照合する際は、常に次を比較してください:

• オーディエンス定義（リスト/セグメント条件）。
• 送信可否ルール（送信抑制、同意、スマート送信）、
• 各カウントが取得された時刻。