どのようにお手伝いできますか?

Pull API aggregated data(集計データのPull API)

  • 更新

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

PullAPIAverage_us-en.png

 Pull API ローデータをお探しですか?

こちらの記事 - Pull API ローデータをご覧ください。

Pull API aggregated data(集計データのPull API)

  • Pull APIを使用すると、ユーザー獲得 (UA) とリターゲティングの集計データレポートを CSV ファイルで取得できます。
  • データ更新頻度 は、「データエクスポート」画面および「オーバービュー」ダッシュボード画面の同等レポートと同じです。コストデータを提供するパートナーによっては、数時間の遅延でコストが更新される可能性があることを考慮してください。 
  • 利用可能なオプションでフィルター:
  • Pull APIの追加機能は次のとおりです:
    • アトリビューションタッチタイプを追加
    • タイムゾーンを選択 

Pull APIで利用できる集計パフォーマンスレポート

カテゴリ  UA(非オーガニックインストール) リターゲティング
パートナー(メディアソース) ✓ ✓

パートナー(日付別)

✓ ✓

毎日

✓ ✓

地理

✓ ✓

Geo by Date Report(地域/日付別レポート)

✓ ✓

 

Pull API集計データの使用 

Pull API 集計データを使用する:

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

パラメーター

パラメータ 説明
app_id アプリID
開始
  • 日付範囲はおよびパラメータで構成されています。
  • 形式:
  • 例:2010-01-01
終了 終了日。fromfromについて
media_source

特定のメディアソースに制限(フィルタ)するために使用します。

  • 例:media_source=facebook
attribution_touch_type

このパラメーターを例に示すように設定して、ビュースルーアトリビューション (VTA) のKPI を取得します。 

例:attribution_touch_type=impression

クリック数、インプレッション数、コスト API など、一部のビュースルーKPI には値が関連付けられていないため、代わりにN/Aという値が表示されます。 

currency

収益とコストの通貨

集計Pull APIレポートは常にアプリ固有の通貨を使用します。

リターゲティング

リターゲティングのコンバージョンデータを取得します。

  • [デフォルト] false の場合、ユーザー獲得データ (UA) キャンペーンが返されます。
  • true の場合は、リターゲティングコンバージョンデータが返されます。
  • 例:
timezone

[デフォルト] データはUTCが使用されます。

  • テンプレートURIには、アプリケーション固有のタイムゾーンに設定されたタイムゾーンパラメーターが入力されます。
  • [デフォルト]パラメーターが送信されない場合は、UTC を使用してデータが返されます。

タイムゾーンの選択に関する注意点

  • Joda-Timeタイムゾーンは、夏時間が考慮されます。
  • 2. Joda-Time値は、アプリ設定ページと一致にしてください。
  • 選択したタイムゾーンのデータを取得することは、タイムゾーン設定が行われた日付から可能です。変更日以前のデータでは、タイムゾーンとしてUTCが使用されます。

特性と制限

特性 備考 
必要なAPIトークンタイプ AppsFlyerAdmin_us-en.pngV2.0トークン
アドネットワークのアクセス いいえ
代理店によるデータアクセス Y
代理店の運用媒体の開示設定 Y
App-specific currency Y
アプリ固有のタイムゾーン Y
コスト コストデータはユーザー獲得キャンペーンのみで、リターゲティングまたはアクティブではない(インストールが無い)キャンペーンは対象外です。
データ更新頻度 継続的
過去データ 5年
非オーガニックデータ Y
オーガニックデータ Y
レート制限

制限事項

サイズ制限
  • APIコールは、最大20万行のデータを返します。
    • もしレポートにちょうど20万行含まれている場合、追加の行のデータが不足していると考えてください。
    • 時刻を含むfrom/toパラメータを使用して、複数のAPIコールに分けてデータを取得してください。 
キャンペーン名の変更 Pull APIレポートはキャンペーン名の変更をサポートしていません。