概要:ダイナミッククエリでは、データコラボレーションプラットフォーム(DCP)のデータに対して、独自のSQLクエリを直接実行できます。自社のデータ、自社のAppsFlyerアトリビューションデータ、またはコラボレーション内で共有されたデータを照会し、レポートを設定せずに知りたい情報を取得できます。
ダイナミッククエリについて
ダイナミッククエリでは、DCPのデータに対して必要に応じた独自のクエリをリアルタイムで実行し、コラボレーションに関する具体的な疑問への答えを迅速かつ効率的に取得できます。
- 連携相手がオーディエンスを作成する前に、自社のデータをより適切にセグメント化できるようにします。
- ダイナミッククエリで、独自のキャンペーン計測ロジックを構築できます。
ダイナミッククエリの動作は、自社のデータを照会する場合と、コラボレーション内で共有されたデータを照会する場合で異なります。
開始前の準備
クエリを実行する前に、出力先のクラウドバケットを設定してください。どのクエリも自社のクラウドバケットに対して実行され、結果が自社のストレージに直接書き込まれるため、この設定が必要です。 AppsFlyerはクエリ結果を保存しないため、データは自社のクラウド環境内に保持されます。
自社データに対するクエリの実行
以下では、自社が所有するデータにアクセスし、クエリを実行する方法を説明します。この画面のソースパネルには、自社が所有するソースのみが表示されます。連携相手のソースは追加できません。コラボレーションで共有されたデータを照会する場合は、コラボレーションデータに対するクエリの実行を参照してください。
ダイナミッククエリを開く
- AppsFlyerのサイドメニューで、連携 > Data Clean Roomを開きます。
- 「ダイナミッククエリ」タブを選択します。
自社データに対するクエリの作成
-
ソースパネルで、ソースのフィールドを確認します。フィールドをクリックすると、重複を除いた値をプレビューできます。
注意
クエリを作成する前に実際の値を確認し、データに合ったフィルターを設定できます。詳しくは、データコラボレーションプラットフォーム(DCP) | ソースの作成と管理を参照してください。
-
ローデータ単位でも集計単位でも、自由にクエリを作成できます。ここにあるソースはすべて自社が所有しているため、権限チェックはなく、GROUP BYも必須ではありません。
注意
AppsFlyerをご利用の場合は、自社のAppsFlyerアトリビューションデータも同じ方法で照会できます。ただし、自社のデータであっても、結果は集計データのみです。
コラボレーションデータに対するクエリの実行
以下では、コラボレーションで共有されたデータにアクセスし、クエリを実行する方法を説明します。自社が所有するデータのみを照会する場合は、自社データに対するクエリの実行を参照してください。
コラボレーション内でダイナミッククエリを開く
- AppsFlyerのサイドメニューで、連携 > Data Clean Roomを開きます。
- 「コラボレーション」タブを選択し、該当するコラボレーションを選択します。
- 「ダイナミッククエリ」タブを選択します。
コラボレーションで共有されたデータを照会する場合、ダイナミッククエリは、そのコラボレーションに追加されたすべてのソースにアクセスできます。
コラボレーションデータに対するクエリの作成
-
ソースパネルで、ソースのフィールドを確認します。フィールドをクリックすると、重複を除いた値をプレビューできます。
注意
クエリを作成する前に実際の値を確認し、データに合ったフィルターを設定できます。詳しくは、データコラボレーションプラットフォーム(DCP) | ソースの作成と管理を参照してください。
-
クエリに結合が必要かどうかは、ソースの権限の種類を確認して判断します。権限には、次の2種類があります。
権限の種類 結合の要否 結果の粒度 重複データ 必要。自社のソースと結合する必要があります。 集計データのみ すべてのデータ 不要。自由に照会できます。 集計データのみ -
GROUP BY句、または
COUNT(*)などの集計関数を使用してクエリを作成します。重要
自社が所有していないソースの結果は、共有権限の種類にかかわらず、常に集計データになります。ローデータ単位の結果を取得できるのは、自社が所有するソースのみです。
サンプルクエリの確認
以下の例で、各権限の実際の使用方法を説明します。
コラボレーション候補のブランドの特定
このクエリは「すべてのデータ」権限を使用し、過去60日間の顧客数と収益に基づいて、コラボレーション内の上位ブランドを特定します。
SELECT
t.brand_name,
COUNT(DISTINCT t.hashed_email) AS total_clients,
COUNT(*) AS total_purchases,
SUM(t.revenue) AS total_revenue
FROM <collaborator_transactions_table> t
WHERE t.event_time BETWEEN DATE_SUB(current_date(), 60) AND current_date()
GROUP BY t.brand_name
ORDER BY total_revenue DESC
LIMIT 20;
ロイヤルティ会員向けリターゲティングセグメントの作成
このクエリは「重複データ」権限を使用します。過去30日間の自社のロイヤルティ会員データと連携相手の購入データを結合し、国別に集計します。
SELECT
t.country,
COUNT(DISTINCT l.hashed_email) AS loyalty_members,
COUNT(*) AS total_purchases,
SUM(t.revenue) AS total_revenue
FROM <collaborator_transactions_table> t
JOIN <my_loyalty_club_table> l ON l.hashed_email = t.hashed_email -- required join satisfies intersection permission
WHERE t.event_time BETWEEN DATE_SUB(current_date(), 30) AND current_date()
AND t.brand_name = '<collaborator_brand_name>'
GROUP BY t.country
ORDER BY total_revenue DESC
LIMIT 20;
ユーザー獲得(UA)キャンペーンに向けたオーディエンスの探索
このクエリは「すべてのデータ」権限を使用し、連携相手の取引を国別・カテゴリ別にセグメント化します。ユーザー獲得用のオーディエンスを作成する前に、価値の高いオーディエンスを見つけられます。
SELECT
t.country,
t.category,
COUNT(DISTINCT t.hashed_email) AS total_buyers,
COUNT(*) AS total_purchases,
SUM(t.revenue) AS total_revenue,
AVG(t.revenue) AS avg_order_value
FROM <collaborator_transactions_table> t
WHERE t.event_time BETWEEN DATE_SUB(current_date(), 30) AND current_date()
GROUP BY t.country, t.category
ORDER BY total_buyers DESC
LIMIT 20;
クエリ結果の確認とダウンロード
以下では、クエリの実行と結果の管理について説明します。
ダイナミッククエリの実行モード
各クエリは、次のいずれかのモードで実行されます。
- サンプルデータ(デフォルト):データの一部を使用して実行します。データセット全体に対して実行する前に、クエリを調整できます。
- すべてのデータ:ソース全体に対して実行します。「ダウンロード」ボタンを利用できるのは、このモードのみです。
注意
実行モードのすべてのデータと、権限の種類のすべてのデータを混同しないでください。権限の種類は、連携相手がアクセスできる範囲を制御します。実行モードは、クエリの実行対象となるデータ量を制御します。
クエリ履歴
タブやワークシートを切り替えても、クエリと結果は保持されます。複数のワークシートを開き、異なるクエリを同時に操作できます。
「すべての実行(All runs)」を選択すると、サンプルデータまたはすべてのデータの各モードで実行したクエリの履歴を、実行ごとのステータスと所要時間とともに確認できます。
結果の上限とダウンロード
結果は1ページ100行、最大10ページ(合計1,000行)まで表示されます。結果をすべて確認するには、ダウンロードしてください。表示上限を超えていても、結果の合計件数は表示されます。この件数表示の上限は1,000万件です。実際の結果が2,000万件でも、表示される件数は1,000万件です。
最大100万行を直接ダウンロードできます。結果がこの上限を超える場合は、ダイナミッククエリからクラウドバケットへ案内されます。クラウドバケットには、最大1,000万行を保存できます。上限の拡張が必要な場合は、担当のカスタマーサクセスマネージャー(CSM)にお問い合わせください。
プライバシー保護とクエリの制限
ダイナミッククエリでは、複数のレベルでプライバシーを保護します。
-
自社が所有していないソースの結果は、常に集計データです。コラボレーションデータに対するクエリの実行を参照してください。
- AppsFlyer ID、Android ID、IDFA(広告識別子)など、キー型の識別子フィールドは、クエリ結果では常にハッシュ化された値で返されます。
- ソースパネルでは、AppsFlyer IDやAndroid IDなど、キーに分類されるフィールドについて、重複を除いた値を確認することはできません。
特性と制限事項
| 特性 | 説明 |
|---|---|
| 結果の表示上限 | 1,000行(1ページ100行、最大10ページ) |
| ダウンロード上限 | 直接ダウンロードは100万行、クラウドバケット経由は1,000万行。拡張は担当CSMにお問い合わせください。 |
| クラウドバケットの設定 | ダウンロード前だけでなく、クエリを実行する前に必須 |
| 実行モード | サンプルデータ(デフォルト、ダウンロード不可)と、すべてのデータ(ソース全体、ダウンロード可能) |
関連情報
- Data Clean Roomのダイナミッククエリ
- データコラボレーションプラットフォーム(DCP)ガイド
- データコラボレーションプラットフォーム(DCP)の共有権限
- データコラボレーションプラットフォーム(DCP) | コラボレーションの作成
- ローデータのフィールド定義