【Eloqua】アナリティクス エクセレンス シリーズ | 集計データ クエリ
Analytics Excellence Series | Aggregate Data Queries
Analytics Excellence シリーズの詳細については、メイン ページをご覧ください 。
Eloqua 25A リリースでは、レポート API の集計データ クエリが導入され、大規模なデータセットを処理しなくても高レベルの分析情報を簡単に取得できるようになります。
集計データクエリを使用すると、合計、平均、カウントなどの要約結果を取得して計算できるため、データ取得がより効率的かつ実用的なものになります。重要なユースケースの 1 つは、固有の指標を追跡することです。これにより、マーケティング担当者は、メールにエンゲージした受信者の数を把握できます。もう 1 つの貴重なユースケースは、専用のエンドポイントがない特定の指標を取得することです。このクエリ オプションを使用すると、Reporting API ですぐには利用できない主要なエンゲージメント指標を計算できます。
この投稿では、 Reporting API で集計クエリを使用する方法について 詳しく説明し、エンドポイント API で固有の開封数とクリック数を計算するためのリクエスト構文を提供します。
仕組み:
要約: Reporting API はイベント (メールの開封など) を処理し、集計された値 (ユニーク開封数、合計クリック数など) を返します。
効率性:何千ものレコードを取得する代わりに、コンパクトで要約されたデータセットを取得します。
柔軟性:結果をグループ化してフィルタリングし、ニーズに合わせて分析情報をカスタマイズできます。
集計クエリを使用する理由
✅パフォーマンスの向上– 転送されるデータの量が削減され、クエリがより高速かつ効率的になります。
✅より簡単な分析– 追加の処理を必要とせずに、すぐに使用できる分析情報を返します。
✅スケーラビリティ– 大規模なデータセットを効率的に処理し、エンタープライズレポート作成に最適です。
____________________________________________________________________________
例: レポート API を使用して一意のメール開封数を取得する
シナリオ: 2024 年 5 月 29 日以降に送信されたメールの一意のメール開封数を取得したいとします。
クエリ:
GET baseUrl/1/EmailOpen?$apply=filter(sentDateHour gt 2024-05-29)/groupby((emailid),aggregate(contactID with countdistinct as UniqueOpens))
詳しく見る:
· filter(sentDateHour gt 2024-05-29): 2024 年 5 月 29 日以降のメール開封のみが含まれるように結果をフィルタリングします。この日付は必要に応じて変更できます。
· groupby((emailid)): データをメール ID 別にグループ化し、各メールのエンゲージメントを個別にカウントします。
· aggregate(contactID with countdistinct as UniqueOpens): 各メールを開いた個別の連絡先をカウントし、 としてラベル付けしますUniqueOpens。
API レスポンスの例 (JSON 出力)
API 応答の例を次に示します。
💡パフォーマンス最適化のヒント（リクエスト構文の例付き）
クエリのパフォーマンスを最適化するには、可能な限りメールIDまたはキャンペーンIDでフィルタリングすることをお勧めします。以下のリクエストとクエリ構文の例は、集計データクエリを使用して各IDで一意のクリックとオープンを取得する方法を示しています。
メールID別の合計開封数とユニーク開封数
GET baseUrl/1/EmailOpen?$apply=filter(sentDateHour gt 2024-09-29 and emailID eq 15031)/groupby((emailid),aggregate($count as totalOpens,contactID with countdistinct as UniqueOpens))
特定の電子メールの合計開封数とユニーク開封数を返します。
キャンペーン ID ごとの合計開封数とユニーク開封数
GET baseUrl/1/EmailOpen?$apply=filter(sentDateHour gt 2024-09-29 and EloquaCampaignID eq 9108)/groupby((emailid,EloquaCampaignID),aggregate($count as totalOpens,contactID with countdistinct as UniqueOpens))