Master API — APIによるユーザー獲得メトリック

https://hq.appsflyer.com/export/master_report/v4?api_token=api_token &app_id=app_id&from=yyyy-mm-dd&to=yyyy-mm-dd&groupings=groupings&kpis=kpis

コールパラメーター

パラメータ名	パラメータの値	必須？
api_token	管理者はトークンを取得する必要があります。APIトークンを取得するには、 管理画面右上メールアドレス > APIトークンをクリックします。	はい
app_id	AppsFlyerに表示されるアプリ識別子 AppsFlyerに表示されているとおりにアプリIDを挿入します。 iOSアプリの先頭にidを付与してください。 app_id=allを使用してすべてのアプリを照会します。	はい
from	LTVアトリビューション日付期間の下限。 形式：文字列 yyyy-mm-dd 例： from: 2020-01-02	はい
活用	LTVアトリビューション日付期間の上限。 範囲内の日数：1～31日 1日のみの場合：from と to の値は同一になります。 形式: yyyy-mm-dd 例： from: 2021-01-01, to: 2021-01-31 ＝31日	必須
groupings	パラメーターでグループ化し、コンマで区切ります。使用可能なリストについては、グループ化の表を参照してください。 例：groupings=pid,geo	必須
KPI	含めるKPIのリスト（それぞれをコンマで区切って指定）KPIリストについては、以下の KPI表を参照してください。 例：kpis=installs,clicks, impressions,sessions,retention_day_7	必須
フィルター	データは、1つ以上のフィルターオプションを使用してフィルター処理できます。	いいえ
currency	アプリ固有の通貨を設定するには currency=preferred とセットしてください。	いいえ
timezone	アプリ固有のタイムゾーンを使用してデータを返すには、timezone=preferred を設定します。参照：ローカリゼーションルール	いいえ
形式	デフォルト設定で、レスポンスデータはすべてCSVファイル形式となります。JSONフォーマットでの受け取りを希望する場合は、&format=jsonをURLに追加ください。	いいえ

これらのディメンションを使うことで、データをグループで表示し、情報をより簡単に、より正確に精査することが可能になります。詳細はこちらをご覧ください。

KPIはアプリの状況を確認するための指標となります。KPIは、以下のタブでタイプ別にグループ化されています。

算出KPI

Master APIレポートでは、上記のKPIに加え、算出KPIを追加することが可能です。これにより、独自の計算レポートをMaster API レポートに含めることができます。

KPI計算式の中には、いくつでもKPIを挿入いただいても構いません。

標準の算術演算子がサポートされています：％2bとしてエンコードされた加算（+）、減算（-）、乗算（*）、％2fとしてエンコードされた除算（/）。

計算式を挿入するKPIは、フィールド名は必ず 「calculated_kpi_」から始め、そのあとに有用な文字列で続けてください。例：calculated_kpi_purchaserate

kpis=installs,loyal_users_rate&calculated_kpi_3days_retention=
retention_day_1%2Bretention_day_2%2Bretention_day_3

kpis=installs&calculated_kpi_rev_per_impression=revenue%2Fimpression

kpis=installs,roi,arpu_ltv,cost,revenue&calculated_kpi_roi_day_7=
(cohort_day_7_total_revenue_per_user-average_ecpi)%2Faverage_ecpi

次の時間粒度オプションを使用できます：デイリー

時間枠項目の To と From を仕様して、選択した時間範囲で必要な粒度を決定してください。

現地通貨とアプリ固有のタイムゾーンは、 アプリ設定ページから設定します。Master APIのデータは、システムの既定の通貨とタイムゾーン、またはアプリ固有のタイムゾーンと通貨を使用してデータを抽出できます。

以下が適用されます：

• アプリ固有のタイムゾーン/通貨の使用は、すべてのアプリが同じタイムゾーン/通貨を持つ場合にのみサポートされます。それ以外の場合は、UTC と USD が使用されます。タイムゾーンと通貨は別々です。つまり、すべてのアプリの通貨が同じでタイムゾーンが同じでない場合は、アプリ固有の通貨を使用できますが、アプリ固有のタイムゾーンは使用できません。
• リクエストされた時間範囲内にダッシュボードでリクエストされたタイムゾーンが変更された場合、生成されたレポートには、最新のタイムゾーンの変更から始まる値が含まれます。

次のパラメーターを使用して、アプリ固有の設定を選択します。注意：preferredパラメーターを使用しない場合は、通貨の場合は USD、タイムゾーンの場合は UTCという既定の設定が適用されます。

タイムゾーンに対応してレポートが表示されるためには、timezone=preferredパラメーターは必ず使用する必要があります。

Facebook広告のパフォーマンスを比較する：

https://hq.appsflyer.com/export/master_report/v4?api_token=[api_token]
&app_id=com.greatapp&from=[from_date]&to=[to_date]&pid=facebook
&groupings=pid,c,af_adset_id,af_ad_id
&kpis=installs,clicks,impressions,sessions,loyal_users,cost,revenue,arpu_ltv,roi

https://hq.appsflyer.com/export/master_report/v4?api_token=[api_token]
&app_id=com.greatapp,id123456789&from=[from_date]&to=[to_date]&pid=googleadwords_int
&groupings=pid,c,af_adset_id,af_ad_id
&kpis=installs,sessions,loyal_users,cost,revenue,arpu_ltv,roi

https://hq.appsflyer.com/export/master_report/v4?api_token=[api_token]
&app_id=all&from=[from_date]&to=[to_date]&groupings=geo,pid,c&kpis=
installs,clicks,impressions,sessions,loyal_users,cost,revenue,arpu_ltv,
roi&geo=us,ca	

https://hq.appsflyer.com/export/master_report/v4?api_token=[api_token]
&app_id=com.greatapp&from=[from_date]&to=[to_date]&groupings=af_keywords
&kpis=roi,arpu_ltv,average_ecpi,installs,loyal_users_rate,cost,revenue

https://hq.appsflyer.com/export/master_report/v4?api_token=[api_token]
&app_id=com.greatapp,id123456789&from=[from_date]&to=[to_date]&groupings=af_prt,pid,c&kpis=installs,
loyal_users_rate

https://hq.appsflyer.com/export/master_report/v4?api_token=[api_token]
&app_id=com.greatapp&from=[from_date]&to=[to_date]&groupings=af_siteid&pid=affiliates
&kpis=installs,loyal_users_rate,arpu_ltv,retention_day_1,retention_rate_day_1,
retention_day_7,retention_rate_day_7,retention_day_15,retention_rate_day_15,
retention_day_30,retention_rate_day_30

https://hq.appsflyer.com/export/master_report/v4?api_token=[api_token]
&app_id=com.greatapp,id123456789&from=[from_date]&to=[to_date]&groupings=attributed_touch_type
&kpis=installs,sessions,loyal_users_rate,arpu_ltv

https://hq.appsflyer.com/export/master_report/v4?api_token=[api_token]
&app_id=all&from=[from_date]&to=[to_date]&groupings=pid,c
&kpis=installs,loyal_users_rate,retention_day_1,retention_rate_day_1,
retention_day_7,retention_rate_day_7,retention_day_15,retention_rate_day_15,
retention_day_22,retention_rate_day_22,retention_day_30,retention_rate_day_30

• コストデータ：
  • さまざまなコストディメンションが利用可能であることから、広告セット、広告、地域、チャンネル、サイトIDは 広告ネットワークによって異なります。
  • eCPIを取得するには：コストデータが利用可能な場合は、インストールとコストの両方をコールに含めます。
  • 基本的に、オウンドメディアを含むAppsFlyerのURLを使う全てのメディアソースで、リクエストするディメンションに関わらずコストデータが提供可能です。ただし、URLにコストパラメータが存在する必要があります。独自のAPIをもつセルフレポーティングネットワークは一部のディメンションのコストデータのみに対応しています。
    たとえば、 Facebook は同じコールでGeoとChannelによるグループ化をサポートしていません。これらのいずれかによる個別のグループ化がサポートされています。
  • コストデータは存在するが、期間内にインストールデータがないキャンペーンは、Master API 経由では利用できません。
• グループ化：特定のグループ化は、LTV KPI、アクティビティ、またはリテンションKPI でのみ使用できます。特定のKPIが利用不可の場合、”N/A” とAPIから返答されます。例えば、retention_rate_day_7 を af_channel でグループするようにリクエストをすると、“N/A” と返します。
• レポートあたりの最大行数： 20万行
• イベント名： Master API は現在、スラッシュ / を含むイベント名をサポートしていません。この制限を克服するには、イベント名のユーザー / を避けます。
• 処理時間：複数のアプリを選択すると、処理時間が長くなり、応答に時間がかかることがあります。