Pull API ローデータ

プレミアム機能

概要:このAPIを使用して、CSVファイルでローデータレポートを取得できます。

PullAPIRaw_us-en.png

Pull API ローデータ

  • Pull APIを使用すると、ローデータレポートをCSVファイルで取得できますローデータレポートの詳細はこちら
  • 利用可能なオプションでフィルター:メディアソース、日付範囲、アプリ内イベント名、地域。 
  • Pull APIの追加機能は次のとおりです:
    • 通貨を選択
    • タイムゾーンを選択

Pull API経由で利用可能なローデータレポート

レポート 説明 更新頻度
ローデータレポート(非オーガニック)
インストール 非オーガニックインストールを記録します。ユーザーがアプリを初回起動した際に記録が生成されます。 リアルタイム
アプリ内イベント ユーザーが実行したイベントを記録します。 リアルタイム
アンインストール ユーザーがアプリをアンインストールしたときに記録します。 毎日
再インストール アプリをアンインストールした後に、UAメディアソースと接触し、再アトリビューション期間中にアプリを再インストールしたユーザーを記録します。 リアルタイム
ローデータレポート(オーガニック) 
オーガニックインストール ユーザーが初めてアプリを起動したときに記録します。 継続的
オーガニックアプリ内イベント ユーザーが実行したイベントの詳細を記録します。 継続的
オーガニックアンインストール ユーザーがアプリをアンインストールした記録。 毎日
オーガニック再インストール リエンゲージメント期間中にリターゲティングメディアにアトリビュートされたユーザーによる広告収益を記録します。 毎日
リターゲティング
コンバージョン リターゲティングキャンペーンに接触した後にアプリを開いたユーザーの記録。 リアルタイム
アプリ内イベント リエンゲージメント期間中にユーザーが実行したアプリ内イベント。 リアルタイム
広告収益のローデータ 
帰属広告収益  メディアソースに紐づくユーザーの広告収益を記録します。 毎日
オーガニック広告収益 メディアソースに紐づかないユーザーの広告収益を記録します。 毎日
Protect360 不正防止
インストール 不正と識別されたためどのメディアソースの成果にも紐づいていないインストールを記録します。 リアルタイム
アトリビューション後のインストール 不正と識別されたため一切計測されなかったアプリ内イベントを記録します。 リアルタイム
アプリ内イベント Protect360が不正と認定したアプリ内イベントを記録します。 毎日
アトリビューション後のアプリ内イベント 一度メディアソースへアトリビューションされたが不正と判断されたインストールに紐づくアプリ内イベント、もしくはインストール自体に関係なく不正と判定されたアプリ内イベントを記録します。 毎日
クリック Protect360によりブロックされたユーザーが実行したクリックを記録します。 毎日
ブロックされたインストールのポストバック ブロックされたインストールと判断されたメディアソースに送信されたポストバックのコピーを記録します。 リアルタイム
ポストバック
インストールポストバック ユーザーがアプリを初回起動した際に生成されるインストールイベントを記録します。 毎日
アプリ内イベントポストバック メディアソースに送信されたアプリ内イベントポストバックを記録します。 毎日
リターゲティングアプリ内イベントポストバック リエンゲージメント期間中にユーザーが実行したアプリ内イベントを記録します。 リアルタイム
リターゲティングコンバージョンのポストバック リエンゲージメント期間中にユーザーが実行したアプリ内イベントを記録します。 リアルタイム

Pull API ローデータの使用

Pull APIローデータを使用するには:

  1. AppsFlyerAdmin_us-en.png APIトークンを取得します。管理者はトークンを取得する必要があります。
  2. 認証ヘッダーで使用するためにAPIトークンをデベロッパーに渡します。
  3. 次のセクションで説明するように、APIコールを行うときに入力するパラメーターを開発者へ渡してください。パラメーターは、レポートが何に焦点を当て、どのように編成されるかを決定し、レポートの時間枠を定義します。
  4. 開発者に、開発者ハブのPull APIローデータ手順に従うように伝えます。

パラメーター

パラメータ 説明
開始
  • 日付範囲はおよびパラメータで構成されています。日付はアクティビティ日に関連しています。
  • 形式: 、、または 注意:スペースはここに示すようにエンコードする必要がありますfrom=2020-04-01%2001:00:00 - 一般的に、ブラウザはスペースをエンコードします。
  • 例:2010-01-01 または 2010-01-01 20:15 (時間と分のパラメータがローデータレポートで使用可能)。
終了 終了日。fromfromについて
media_source

media_source:特定のメディアソースに通話を制限(フィルタリング)します。

およびの両方のパラメータを次のように設定します:

  • Meta広告の場合、カテゴリとメディアソースをfacebookに設定します。
  • X広告の場合、カテゴリとメディアソースをtwitterに設定します。
  • その他のメディアソースについては、カテゴリをstandardに設定し、メディアソースをその名前に設定します。
    •  
    •  
最大行数 1回のAPI呼び出しで返される行の最大数。
  • [デフォルト] 値が送信されない場合、最大200K行
  • 200000:最大200K行が返されます
  • 1000000:最大1M行が返されます
  • 例: によって最大1M行が有効になります。
イベント名

指定したイベントでアプリ内イベントをフィルタリングします。カンマ区切りのリストで複数のイベントを選択します。

リターゲティング リターゲティングアトリビューションデータを設定します。
  • [デフォルト] false の場合、ユーザー獲得データ (UA) キャンペーンが返されます。
  • true の場合、リターゲティングアトリビューションデータが返されます。
  • :
追加フィールド

デフォルト項目に加えて追加項目を取得します。

:

通貨

収益と費用の通貨

:アプリ固有の通貨がEURの場合、currency=preferredを送信すると、値がEURで返されます。

タイムゾーン [デフォルト] データはUTCが使用されます。
  •  timezone=[Numerical value]
  • 例:タイムゾーンUTC+10:00の場合は、 注を使用します。、、および:をエンコードする必要があります。例: +10:00は%2B10%3A00にエンコードされます。
地域

国コードでデータをフィルターします。

制限:API呼び出しごとに設定できる国コードのフィルターは1件のみです。

例:

インストール時間から
  • 日付範囲はおよびパラメータで構成されています。日付はアクティビティ日に関連しています。
  • フォーマット:
  • 例:2010-01-01
インストール時間まで 終了日。について
代理店 特定の代理店に通話を制限(フィルター)します。

時間枠の項目

APIの結果が最大値を超える場合、時間と分でレポートを分割してください。以下を適用してください:

  • 開始終了: yyyy-mm-dd hh:mm
  • 開始: 
    • 日付のみ = 選択された日付の開始 (00:00) より
    • 日付と時間 = 00:00を含む
  • パラメータ まで: 
    • 日付のみ = 選択された日の終わり (24:00) まで
    • 日付と時間 = 表示された時間まで(その時間は含まれません)

例: あるアプリの所有者は全てのソースから毎日130万件のインストールがあります。100万行の制限を解決するために、アプリ所有者は一日を12時間のURIコールに分割します。その方法について次の表を参照してください。 

API呼び出し 開始日  終了日 
最初のAPI呼び出し

開始=yyyy-mm-dd

例:

  • 開始=
  • この日の午前00:00から始まります

終了=yyyy-mm-dd 12:00

例:

  • 終了=
  • 12:00ではなく11:59:59まで続きます

オプションA: 2回目のAPI呼び出し 

 

例:

 

  • 2019年12月29日正午から開始
  • 2019年12月29日午前0時まで

from=yyyy-mm-dd 12:00

例:

  • from=
  • 12:00から開始し、12:00を含みます

 

to=yyyy-mm-dd

例:

  • 終了=
  • 深夜に終了

 

オプションB:2回目のAPIコール

from=yyyy-mm-dd 12:00

例:

  • from=
  • 12:00から開始し、12:00を含みます

to=yyyy-mm-dd+1 00:00

+1 = 翌日の00:00

例:

  • to=
  • つまり時刻が12月30日になる前。
注意: オプションAまたはBのどちらかを使用してください。両者は同じ結果になります。

追加フィールド

追加のレポート項目は既定の項目の一覧に追加されないため、新しい項目が既存のインポートおよび取り込みプロセスに影響を与えることはありません。デフォルト以外のフィールドを取得するには、additional_fields パラメーターを使用します。

デフォルトの項目

デフォルト Pull API 項目
属性付けタッチタイプ
Attributed Touch Time
インストール時刻
Event Time
イベント名
イベント値
イベント収益
Event Revenue Currency
イベント収益USD
Event source
Is Receipt Validated
パートナー
メディアソース
チャネル
Keywords
キャンペーン
キャンペーンID
広告セット
広告セットID
広告
広告ID
広告タイプ
サイトID
サブサイトID
Sub Param 1
Sub Param 2
Sub Param 3
Sub Param 4
Sub Param 5
コストモデル
Cost Value
コスト通貨
Contributor 1 Partner
Contributor 1 Media Source
Contributor 1 Campaign
Contributor 1 Touch Type
Contributor 1 Touch Time
Contributor 2 Partner
Contributor 2 Media Source
Contributor 2 Campaign
Contributor 2 Touch Type
Contributor 2 Touch Time
Contributor 3 Partner
Contributor 3 Media Source
Contributor 3 Campaign
Contributor 3 Touch Type
Contributor 3 Touch Time
地域
国コード
Postal code
DMA
IP
WIFI
オペレーター
Carrier
言語
AppsFlyer ID
Advertising ID
IDFA
Android ID
Customer User ID
IMEI
IDFV
プラットフォーム
デバイスタイプ
OSバージョン
App Version
SDKバージョン
App ID
アプリ名
バンドルID
リターゲティング
リターゲティングコンバージョンタイプ
Attribution Lookback
リエンゲージメント期間
Is Primary Attribution
ユーザーエージェント
HTTPリファラー
元のURL

追加情報

特性と制限

特性 備考 
必要なAPIトークンタイプ AppsFlyerAdmin_us-en.pngV2.0トークン
アドネットワークのアクセス いいえ
代理店によるデータアクセス はい
代理店の運用媒体の開示設定 はい。ただし、代理店フィルタとメディアソースフィルタの両方を使う場合、メディアソースフィルタは非透明な代理店に対しては適用されません。これは、非透明な代理店の場合、フィルタリングされたメディアソース以外のすべてのデータが含まれることを意味します。
App-specific currency はい
アプリ固有のタイムゾーン はい
データ更新頻度
  • オーバービュー管理画面のデータ可用性と同じ。
  • 更新に数時間のタイムラグが生じるレポート:
    • オーガニックアプリ内イベント
  • 毎日更新されるレポート:
    • アンインストール
    • アトリビューション後のアプリ内イベント
    • 広告収益
過去データ はい。  リテンションおよびレート制限ポリシーに従います。 
非オーガニックデータ はい
オーガニックデータ はい
レート制限

生データに関するAPIの制限。 

サイズ制限
  • APIコールは、最大20万行または100万行のデータを返します。
  • レポートの行数が20万/100万ちょうどの場合、いくつかデータが不足していると考えてください。
  • 最大行数を選択するには、maximum_rows パラメータを使用します。
  • 時刻を含むfrom/toパラメータを使用して、複数のAPIコールに分けてデータを取得してください。
Install_date_fromと install_date_to インストールの日付範囲は、アクティビティの日付範囲より前である必要があります。 

トラブルシューティング

症状/メッセージ 解決策
選択された設定期間に対して期待されるデータがレポートに含まれていない、またはローデータレポートと集計データレポートの間に不一致がある状況です。 

timezoneパラメータが設定されていることを確認してください。設定しない場合、データはアプリのタイムゾーンではなくUTCベースで送信されます。