Data Lockerを使用したSSOTレポートの取得｜アドネットワーク向け

以下の手順に従って、Data Lockerを設定してください。なお、設定変更を行った後、機能が有効になるまで最大3時間かかる場合があります。 

前提条件：

以下のいずれかのストレージの作業手順を完了してください。

• AWS バケット
• GCS バケット
• [Beta] Yandex バケット
• BigQuery データウェアハウス

 Data Lockerを設定するには：

1. 所有している AppsFlyerのパートナーアカウントで管理画面へログインしてください。
2. 管理画面内で以下に移動してください：
   • 広告媒体の場合： 左メニューのReport > Data Locker
     
   • マーケティングパートナーの場合： アカウントメニューをクリックして、 Data Lockerへ進んでください。
3. DataLockerのセットアップ手順のうち、ステップ3〜16に従って設定してください。

代理店アカウント経由で計測の連携設定がされている場合：代理店アカウントからはパートナーアカウントへ権限を付与することができないので、本件に関する権限付与の作業は、広告主へ依頼する必要があります。

アドネットワークがSSOTデータを取得できるようにするには（広告主アカウント上）：

1. AppsFlyerの管理画面に入り、左メニューの連携 > 連携済みパートナーへ進んでください。 
2. 対象のアドネットワークを検索して選択してください。 
3. 連携設定 をクリックして、連携設定のページに移動してください。
4. ［連携］のタブで パートナーを有効にする のトグルがONになっていることを確認してください。OFFの場合、SSOTデータは共有されないのでご注意ください。
5.  権限 のタブへ移動してください。 
6. 広告媒体権限をONにし、追加で以下の各権限についてもONにしてください：
   • 集計コンバージョンデータへのアクセス
   • アプリ内イベントの集計データへのアクセス権限を付与する
   • 収益データへのアクセス権限を付与する
7. 最後に、右下の 権限を保存のボタンをクリックしてください。 
8. 上記対応後に、権限を付与したことをアドネットワークに伝えてください。
9. 複数アプリが対象の場合には、連携しているアプリ毎に同じ作業を繰り返してください。 

AppsFlyerは、通常のSKAdNetworkレポートでは提供できないデータをモデル化して提供しています。

• Null コンバージョン値（CV）：SKANでは、Appleがユーザーのプライバシーを保護するために実際のデータを「Null」値に置き換えることがあります。データが省略されないように、これらのNULL値は SSOTでモデル化されます。（詳細）
• より長いインストール以降の計測指標：インストール後2日間を超えた後のSKANのデータ粒度は制限が多く、不正確になる可能性があります。高いデータ品質を維持するために、days_post_attributionが2を超えた場合、収益と、アプリ内イベントのユニークユーザー数をAppsFlyerが推定します。（詳細）

国データ：SKANはデータ粒度を制限しており、多くのケースにおいて国データを利用できません。このような場合は、データをモデル化して効率的なパフォーマンス分析を可能にします。（詳細）

直近のインストール日のデータを分析する場合、インストール後の長期間（例：7日間）のイベント指標が完全に成熟していない（出揃っていない）可能性があります。このような場合、指標は使用できますが、部分的なデータがレポートに反映されます。

その他の仕様：

• レポートは、入手可能なデータが利用可能になるとすぐに表示されます。
• 5日後に、インストール後2日間までの指標が完成します*。
• 7日後に、インストール後7日間までの指標が完成します。なお、インストール後15日以内までは、推定値が調整される場合があります。

部分的なデータの理由：

• データの成熟度：インストール日からの経過時間が分析対象とするイベント日数よりも短い場合、データはまだ蓄積途中であり完全ではありません。
• SKANの遅延仕様：SKANデータはランダムに遅延してレポートされます。たとえば、インストール後最初の2日間のイベント情報は、インストール後最大 96 時間後 (4日後) までにレポートされます。
• SKAN推定値のデータ反映のタイミング：インストール後2日以降の期間のSKANデータが推定されます。AppsFlyerのモデル化機能は、7日後に最初の推定値を生成します。この期間（2日目から7日目）、AppsFlyerの従来の計測手法のデータは利用できますが、SKAN推定値のデータは利用できません。

例：インストール日が1月1日の場合

• 1月2日：SKANデータはまだ受信されていません。インストール後2日間とインストール後7日未満のデータはどちらも部分的であり、AppsFlyerの従来の計測手法のデータで構成されます。
• 1月3日：SKANデータが部分的にレポートされ始めます。インストール後2日間のデータは部分的なままですが、一部SKAN計測のデータが含まれるようになります。インストール後7日間のデータには、推定されたSKANデータはまだ含まれません（最初のモデル化されたデータは、インストールから7日後に利用可能になります）。そのため、インストール後2～7日目までの間は、インストール後2日間と比較して、インストール後7日間の推定値が小さくなる可能性があります。
• 1月6日：インストール後の最初の2日間のSKANデータは、遅延のあったポストバックも含めて完全に受信されます。この時点で、インストール後 2日間の指標が完成しますが、インストール後7日間の指標はまだこの時点では完成していません。
• 1月8日：インストール後7日間のSKAN推定値データが完成します。AppsFlyerのSKAN推定値は、1月16日まで数値の調整が続きます。 

• プライマリフォルダはレポートタイプ別に整理され、含まれる想定値は、'ssot_unified'、'ssot_reargeting'、'sot_user_quisition' のいずれかです。
• これらのフォルダ内のサブフォルダは、インストール日順に整理されます。

バージョン管理

• 各インストール日のフォルダには複数のバージョンが格納され、各バージョンは毎日作成されます。
• 各バージョンには、そのインストール日の更新された累積データが反映されます。
• レポートには、インストール日で入手可能なすべてのデータが含まれます。たとえば、4月18日の各インストール日の最新バージョンには、その時点の4月18日までのすべてのデータが含まれます。
• ヒント：正確性を確保するために、常に最新バージョンのレポートデータを処理してください。

各インストール日は、最大15個までのバージョンに制限されます。つまり15日後、すべての指標が完全にフィックスして完成します。（詳細）

レポートへのパスは次の形式で構成されます：

<bucket-name>/t=<ssot_unified OR ssot_retargeting OR ssot_user_acquisition>/install_date=<yyyy-mm-dd>/version=<unix timestamp>/<parquet file number>

例：広告主バケットにおけるフォルダ階層の場合：

bucket
|
└── t=ssot_unified
    |
    ├── install_date=2024-05-05
    |   |
    |   └── version=1714890235
    |   |    |
    |   |    ├── part-00000-4762858-d62a-446e-b499-dd05f2d5434d-c000.csv.gz
    |   |    |
    |   |    ├── part-00001-4762858-d62a-446e-b499-dd05f2d5434d-c000.csv.gz
    |   |    │
    |   |    └── part-00002-4762858-d62a-446e-b499-dd05f2d5434d-c000.csv.gz
    |   |
    |   |
    |   └── version=1714890286
    |        |
    |        ├── part-00000-1d295376-d024-4321-8d34-1fbb37cbb58d-c000.csv.gz
    |        |
    |        ├── part-00001-1d295376-d024-4321-8d34-1fbb37cbb58d-c000.csv.gz
    |        │
    |        └── part-00002-1d295376-d024-4321-8d34-1fbb37cbb58d-c000.csv.gz
    |   |
    .   . 
    .   .

説明：

• t：　 レポートトピック（タイプ）
• install_date：　アプリのインストール日を指します。つまり、インストール後のアクティビティは、ユーザーアクションが発生した日ではなく、ユーザーがアプリをダウンロードしたインストール日に基づいて表示されます。
• version：　バージョンが作成された日時を示すUnix形式のタイムスタンプです。

統合レポート、ユーザー獲得レポート、リターゲティングレポートを別々に、またはまとめてBIで取得することが可能です。これらをまとめて読み込んで、独自にデータをフィルターする場合は以下の対応が必要です：

• 統合レポート：　is_primary_attribution=true または NULL のデータを使用してください。
• ユーザー獲得レポート：　conversion_type=Install のデータを使用してください。
• リターゲティングレポート：　conversion_type=re_engagement と re-attribution のデータを使用してください。
• 統合ビュー：　データ読み込みのプロセスにおいて統合ビューのデータを使用すると、キャンペーンタイプ間でデータを分割できます：

• その場合は、conversion_type=install、re-engagement、re-attribution（SKAN計測における再ダウンロード）を使用してください。
• 詳細については、「リターゲティングイベントの二重計測ロジック」のページを参照してください。

• アトリビューション（インストール、リエンゲージメントなど）データの場合、この値は0です。
• 収益とアプリ内イベントについては、データは事前定義されているコホート毎に分類され、現状はインストール後「2日」と「7日」のみに制限されています。

アプリ内イベントと収益を正確に分析するには、days_post_attributionのディメンションにフィルターを適用する必要があります。詳細は、以下のクエリ例を参考にしてください。

よくある間違いの例として、特定のディメンションの収益列を合計するという単純なロジックを適用してしまうケースが挙げられます。この方法では、一部の収益データが 2 回 (1 回は days_post_install=2、もう 1 回は days_post_install=7) カウントされるため、誤った数値になります。この例は、特定のアプリ内イベントにおけるユニークユーザー数を分析する場合にも関係します。

考慮事項：

• 最終バージョン：　常にインストール日ごとに利用可能な最新バージョンのデータを参照して、分析には最新かつ正確なデータを使用してください。
• 収益の計算：　revenue_usd (USD換算の収益金額) は、イベント発生日のUSDの為替レートを使用して計算されているので注意してください。
• アトリビューションデータの分析：　event_name=af_conversion のデータは、アトリビューション（インストール、リアトリビューション（SKANにおける再ダウンロード）、リエンゲージメント）のデータを意味します。アトリビューション数はユニークユーザー数の指標の下に表示され、これらのデータの収益指標は空になります。前述の通り、days_post_attribution の値は0になります。
• 管理画面上の数値との比較：　インストールを管理画面上のデータと比較する場合、新規インストールと再ダウンロード、両方のコンバージョンタイプを合計してください。SKANオーバービュー上では、インストールのフィルタで新規インストールと再ダウンロードの両方が選択されています。
• アプリ内イベントの分析：　event_nameが「af_conversion」ではないデータが、アプリ内イベントに関するデータです。イベントを実行したユニークユーザー数はユニークユーザー数の指標に表示され、これらのイベントから発生した収益は収益指標に表示されます。
• コンバージョンタイプ：　conversion_typeののディメンションを使用して、ユーザー獲得とリターゲティングのコンバージョンを区別してください。なお、SKANデータの場合にはinstallと再ダウンロードで更に分解されます。データをSSOTモードをONにした管理画面と比較する場合は、どちらのタイプもインストールと見なして処理されます。
• 広告収益イベント：　これらは可能な場合は含まれています。
• データの分割：　すべてのアプリデータが1つのファイル内にまとめて提供されます。App ID の項目を使用してアプリ毎にデータを分割するか、Data Locker上でアプリ毎に分割するよう設定してください。

以下は、BI担当者が Data Lockerを介して抽出できるコホートデータの、一般的で実用的な応用例です。各例は、SQL ステートメントとサンプルの Excel ビジュアルで示されています。

SELECT install_date, SUM(unique_users) AS total_attributions
FROM ssot_unified
WHERE event_name = 'af_conversion'
    AND af_c_id = '4475903638579'  -- Change to your specific campaign
    AND app_id = 'YOUR_APP'
GROUP BY install_date;

SELECT install_date, conversion_type, SUM(unique_users) AS total_conversions
FROM ssot_unified
WHERE event_name = 'af_conversion'
    AND af_c_id = '4475903638579'  -- Change to your specific campaign
    AND conversion_type IN ('install', 're-download')  
-- The dashboard sums both under the install field
    AND app_id = 'YOUR_APP'
GROUP BY install_date, conversion_type;

SELECT install_date, conversion_type, geo, SUM(unique_users) AS total_conversions
FROM ssot_unified
WHERE event_name = 'af_conversion'
    AND conversion_type IN ('re-attribution', 're-engagement')  
-- Both types are relevant for re-targeting
    AND app_id = 'YOUR_APP'
GROUP BY install_date, conversion_type, geo;

SELECT install_date, attribution_method, media_source, SUM(unique_users) 
AS total_installs
FROM ssot_unified
WHERE event_name = 'af_conversion'
    AND conversion_type = 'install'
    AND app_id = 'YOUR_APP'
GROUP BY install_date, attribution_method, media_source;

SELECT install_date,
       af_adset,
       SUM(revenue_usd) AS total_revenue_day_7
FROM ssot_unified
WHERE media_source = 'facebook'
    AND days_post_attribution = 7  -- Choose a specific post-install period (cohort)
    AND app_id = 'YOUR_APP'
GROUP BY install_date, af_adset;

SELECT install_date,
       SUM(IF(days_post_attribution = 2, revenue_usd, 0)) AS total_revenue_day2,
       SUM(IF(days_post_attribution = 7, revenue_usd, 0)) AS total_revenue_day7
FROM ssot_unified
WHERE app_id = 'YOUR_APP'
GROUP BY install_date;

SELECT install_date, media_source, SUM(revenue_usd) AS total_purchase_revenue
FROM ssot_unified
WHERE event_name = 'af_purchase'  -- Change to your specific event
    AND days_post_attribution = 7  -- Choose a specific post-install period (cohort)
    AND app_id = 'YOUR_APP'
GROUP BY install_date, media_source;

SELECT install_date,
  SUM(IF(days_post_attribution = 2 AND 
event_name = 'af_complete_tutorial', unique_users, 0)) 
  / SUM(IF(event_name = 'af_conversion', unique_users, 0)) 
AS conversion_rate_day2_af_tutorial_conversion
FROM ssot_unified
WHERE conversion_type = 'install'  
-- Choose the conversion types for the sample group you want to measure
    AND app_id = 'YOUR_APP'
GROUP BY install_date;

SELECT install_date,
       af_c_id,
       SUM(IF(days_post_attribution = 2, revenue_usd, 0)) 
       / SUM(IF(event_name = 'af_conversion', unique_users, 0)) AS ARPU_day2,
       SUM(IF(days_post_attribution = 7, revenue_usd, 0)) 
       / SUM(IF(event_name = 'af_conversion', unique_users, 0)) AS ARPU_day7
FROM ssot_unified
WHERE conversion_type = 'install'  
       -- Choose the conversion types for the sample group you want to measure
    AND app_id = 'YOUR_APP'
GROUP BY install_date, af_c_id;

SELECT install_date, media_source, SUM(skan_duplicates)
FROM ssot_unified
WHERE app_id = 'YOUR_APP'
    AND event_name = 'af_conversion'
GROUP BY install_date, media_source;

SELECT install_date, media_source, SUM(skan_duplicates)
FROM ssot_unified
WHERE app_id = 'YOUR_APP'
GROUP BY install_date, media_source;