ローデータレポート仕様 Ver. 5

ローデータレポート内のカラム(フィールド)ローデータレポートで提供されるデータ内容、名称、および形式について。

ローデータレポートのCSVは、以下の方法で取得できます。

  • ダウンロード: 管理画面左メニューレポート > データエクスポート
  • API: 適切なAPIを選択
  • Data Locker: Data Lockerにファイルを保存。

Push API のパラメータはいくつかの種類がありますが以下のローデータの仕様に似ています。(詳細は全リストへ)

ローデータのフィールドは、 Master API とPull APIのURLクエリにもあります。

ローデータレポートの使用方法とマーケティングのヒント

CSVファイルの日付カラムに関する注意: 日付のデータ形式はyyyy-mm-ddです。CSVファイルをExcelで開くと、PC上の日付/時刻の設定を使用して日付カラムが表示されます。 Excel で適切な日付の表示方法を選択してください。

レポートカラムの仕様表

各レポートフィールドは以下を含みます。

  • APIパラメータ名: API側での名称
  • 表示名: AppsFlyerから取得したレポート内での表示
  • ソース: 以下のような、各情報のソース元:
  • 詳細
  • 一部限定: 特定のレポートにおいてのみフィールドが使用可能な場合、以下のように示されます。
    • リターゲティング:これらのフィールドは、リターゲティングキャンペーンのレポートにおいて別の意味を持って使用されます。
    • Data Locker:Data Locker内のデータにおいて使用します。
  • フィールドタイプと長さ:
    • String型 :文字列の最大長
      :ほとんどのフィールドは長さ制限が適用されません。たとえば、パートナーが100文字を超える長さのキャンペーン名を送信可能です。
    • Date Time: yyyy-mm-dd hh:mm:ssの形式の文字列。例:2019-09-17 00:09:25
      :Excelを使用してCSVファイルを開くと、デフォルトの地域設定を使用して表示されますが、Excel内で表示形式を変更できます。フォーマットされていない値を表示するには、エディターを使用してファイルを開いてください。
    • Enum型 - n文字 :Enum型のフィールドには特定の値のみを含めることができます。たとえば、Cost currencyは3文字で、指定された通貨コードのみを含むことができます。
    • Enum型 - 5文字:boolean型: フィールドの値はTRUEまたはFALSEのいずれかです。
ローデータレポートのフィールド (ver.5) : ソース別

APIパラメータ名

カラム名

データソース

詳細

一部限定

フィールドタイプ

af_ad

ad

計測リンク

Facebookの場合も含まれます。

 

String型 - 最大100文字まで

af_ad_id

Ad ID

計測リンク

Facebookの場合も含まれます。

 

String型 - 最大24文字まで

af_ad_type

Ad Type

計測リンク

広告の種類(バナー、フッターなど)

 

String型 - 最大24文字まで

af_adset

Adset

計測リンク

Facebookの場合も含まれます。

 

String型 - 最大100文字まで

af_adset_id

Adset ID

計測リンク

 

 

String型 - 最大24文字まで

af_c_id

Campaign ID

計測リンク

キャンペーン   String型 - 最大24文字まで

af_channel

Channel

計測リンク

メディアソースのChannel名 (例:YouTube for Google / Instagram for Facebookなど )   Dynamic Enum型/String型 - 最大20文字まで

af_cost_currency*

Cost Currency

計測リンク

コストの通貨単位 (リスト)   Enum型 - 3文字

af_cost_model

Cost Model

計測リンク

CPC / CPI / CPM / その他(現状、コスト計測はこのカラムの値に関係なく、CPIベースで計算)

 

String型 - 最大20文字まで

af_cost_value

Cost Value

計測リンク

元の通貨での費用 / 小数点第4位までサポート(例:320.5095)   String型 - 最大20文字まで

af_keywords

Keywords

計測リンク

一部の連携媒体から取得

 

String型 - 最大100文字まで

af_attribution_lookback

Attribution Lookback 計測リンク クリック計測におけるルックバックウィンドウ。新規ユーザーが、広告を表示したメディアソースへ紐付けられるCTIT(クリックからインストールまで)の有効期間。
注:計測リンク内における同義のパラメーターはaf_click_lookbackです。

 

 

 

最大3文字まで

af_prt

Partner

計測リンク

代理店名 / PMD

 

String型 - 最大50文字まで

af_reengagement
_window

Reengagement Window

計測リンク

リエンゲージメント後に発生したイベントをリターゲティング媒体へ紐付ける期間

制限: このフィールドは、リターゲティングキャンペーンに入力されません。

リターゲティング 最大3文字まで

af_siteid

Site ID

計測リンク

パブリッシャーID/配信面   String型 - 最大24文字まで

af_sub_siteid

Sub Site ID

計測リンク

サブパブリッシャーID

 

String型 - 最大50文字まで

af_sub1

Sub Param 1

計測リンク

広告主側で自由に定義可能なカスタムパラメーター   String型 - 最大100文字まで

af_sub2

Sub Param 2

計測リンク

広告主側で自由に定義可能なカスタムパラメーター   String型 - 最大100文字まで

af_sub3

Sub Param 3

計測リンク

広告主側で自由に定義可能なカスタムパラメーター   String型 - 最大100文字まで

af_sub4

Sub Param 4

計測リンク

広告主側で自由に定義可能なカスタムパラメーター   String型 - 最大100文字まで

af_sub5

Sub Param 5

計測リンク

広告主側で自由に定義可能なカスタムパラメーター   String型 - 最大100文字まで

campaign

キャンペーン

計測リンク

キャンペーン名 (Facebookなどの一部の媒体は、URLではなくAPI経由で取得)

 

String型 - 最大100文字まで

is_retargeting

Is Retargeting

計測リンク

true / false

リターゲティング

Enum型 - 5文字 : boolean型

media_source

Media Source

計測リンク

媒体名 (通常媒体は計測URL内に記載)

 

String型 - 最大50文字まで

original_url

Original URL

計測リンク

実際のクリック/ビュースルーの計測URL( 例:http://your.url.com ) リターゲティング String型 - 最大2083文字まで (URL)

user_agent

User Agent

計測リンク

Original URLにおけるUser Agent   String型 - 最大200文字まで

advertising_id

Advertising ID

SDK

Google Play Servicesによって提供される、ユーザー側で可変のユニークな広告用の匿名ID   String型 - 最大40文字まで

android_id

Android ID

SDK

Androidの端末ID   String型 - 最大20文字まで

amazon_aid

Amazon Fire ID

SDK

Amazon Fire TVの広告ID

 

String型 - 最大40文字まで

app_id App ID

SDK

アプリID
  • iOS: id123456789
  • Android: com.appsflyer.referrersender
 

iOS: String型 - 最大12文字

Android: String型 - 最大100文字

app_name

App Name

SDK

アプリ名   String型 - 最大100文字まで

app_version

App Version

SDK

アプリバージョン   最大8文字まで

appsflyer_id

AppsFlyer ID

SDK

ユニークなインストールの識別子です。アプリの初回起動時にAppsFlyerによって生成されるユニークなIDで、アプリのインストールごとに発番されます。これは、アプリが削除されて再インストールされた場合には新しいIDが発番されることを意味します。Customer User IDも参照してください。 リターゲティング

iOS:String型 - 最大24文字まで

Android:String型 - 最大33文字まで

bundle_id

Bundle ID

SDK

(iOS向け) シングルAppもしくはアプリのグループを照合するための識別子   String型 - 最大100文字まで

Carrier

Carrier

SDK

キャリア名   String型 - 最大50文字まで

country_code

Country Code

SDK

国コード(例:GB, US, JP)   Enum型 - 2文字

custom_data

Custom Data

SDK

  • SDKを使って送信されるデータ
  • ガイド:Android / iOS
  String型 - 最大1024文字まで

customer_user_id

Customer User ID

SDK

アプリ所有者によって実装される、ユニークのユーザー識別子   String型 - 最大100文字まで

device_category

Device Category

SDK

  • 表示される値は次のとおりです。:
    phone, tablet, other
  • Android SDK v4.8.8以降より対応
  String型 - 最大20文字まで

device_type

Device Type

SDK

端末の商用モデル名。
例:SM-GM284, iPhone7など

 

String型 - 最大100文字まで

device_download_time

Device Download Time

SDK

  • 端末上の時間設定を使用したアプリのダウンロード完了時間
  • このフィールドは2019年10月28日に追加
Data Locker Date Time

event_name

Event Name

SDK

計測したイベントの名称   String型 - 最大100文字まで

event_revenue

Event Revenue

SDK

イベント収益通貨を使用した収益額。   String型 - 最大20文字まで

event_revenue_

currency*

Event Revenue Currency

SDK

SDKから送信されたイベントの収益通貨単位   String型 - 最大20文字まで

event_time

Event Time

SDK

イベントが発生した時間 リターゲティング Date Time

event_value

Event Value

SDK

イベントのバリュー値   String型 - 最大1000文字まで

idfa

IDFA

SDK

iOS向け - 端末のIDFA   最大40文字まで

idfv

IDFV

SDK

アプリベンダーのアプリ単位の識別子   最大40文字まで

imei

IMEI

SDK

iOS/Androidにおける端末のIMEI   最大14文字まで

install_app_store

Install App Store

SDK

アプリのダウンロード元となったAndroidストアの情報 (詳細)   String型 - 最大50文字まで

install_time

Install Time

SDK

アプリインストール後の初回起動時間

リターゲティング

Date Time

ip

IP

SDK

IPアドレス   String型 - IP V4で最大15文字まで

language

Language

SDK

端末の言語設定   String型 - 最大20文字まで

operator

Operator

SDK

SIMプロバイダーの名称   String型 - 最大50文字まで

os_version

OS Version

SDK

端末OSのバージョン   String型 - 最大8文字まで

platform

Platform

SDK

想定値:iOS / Android / Windows Mobile

 

Enum型 / String型 - 最大8文字まで

sdk_version

SDK Version

SDK

実装されているSDKバージョン   String型 - 最大8文字まで

wifi

WIFI

SDK

true / false

 

Enum型 - 5文字 : boolean型

gp_broadcast_

referrer

GP Broadcast Referrer

SDK

  • Google PlayのBroadcast Referrer
  • In organic installs the PlayStore

 

 

 

String型 - 最大100文字まで

amazon_aid

Amazon Fire ID

 

Amazonの広告ID

  String型 - 最大100文字まで

city

City

AF

端末のIPアドレスに基づいたユーザーの最も詳細な場所。通常、値には都市名が入りますが、より正確な市区町村名が入ることもあります。

 

String型 - 最大100文字まで

attributed_touch_

time

Attributed Touch Time

AF

広告への接触時間

リターゲティング

Date Time

attributed_touch_

type

Attributed Touch Type

AF

広告への接触タイプ
表示される値は次のとおりです。:
click / impression / TV / pre-installed

リターゲティング

Enum型 - 最大10文字まで

contributor_1_

af_prt

Contributor 1 Partner

AF

代理店名 / PMD名: 常に小文字に変換。

 

String型 - 最大50文字まで

contributor_1_

campaign

Contributor 1 Campaign

AF

Contributorのキャンペーン名   String型 - 最大100文字まで

contributor_1_

match_type

Contributor 1 Match Type

AF

表示される値は次のとおりです。

gp_referrer, id_matching, srn

  String型 - 最大50文字まで

contributor_1_

media_source

Contributor 1 Media Source

AF

Contributorのメディアソース   String型 - 最大50文字まで

contributor_1_

touch_time

Contributor 1 Touch Time

AF

広告への接触時間

 

Date Time

contributor_1_

touch_type

Contributor 1 Touch Type

AF

接触した広告のタイプ

click, impression, TV

 

Enum型 - 最大10文字まで

contributor_2_af_prt

Contributor 2 Partner

AF

代理店名 / PMD   String型 - 最大50文字まで

contributor_2_

campaign

Contributor 2 Campaign

AF

Contributorのキャンペーン名   String型 - 最大100文字まで

contributor_2_

match_type

Contributor 2 Match Type

AF

表示される値は次のとおりです。

gp_referrer/id_matching/srn

  String型 - 最大50文字まで

contributor_2_

media_source

Contributor 2 Media Source

AF

Contributorのメディアソース   String型 - 最大50文字まで

contributor_2_

touch_time

Contributor 2 Touch Time

AF

広告への接触時間   Date Time

contributor_2_

touch_type

Contributor 2 Touch Type

AF

接触した広告のタイプ

(click / impression / TV など)

 

Enum型 - 最大10文字まで

contributor_3_af_prt

Contributor 3 Partner

AF

代理店名 / PMD   String型 - 最大50文字まで

contributor_3_

campaign

Contributor 3 Campaign

AF

Contributorのキャンペーン名   String型 - 最大100文字まで

contributor_3_

match_type

Contributor 3 Match Type

AF

表示される値は次のとおりです。

gp_referrer/id_matching/srn

  String型 - 最大50文字まで

contributor_3_

media_source

Contributor 3 Media Source

AF

コントリビューター(アシスト)として記録されたメディアソース名   String型 - 最大50文字まで

contributor_3_

touch_time

Contributor 3 Touch Time

AF

広告への接触時間   Date Time

contributor_3_

touch_type

Contributor 3 Touch Type

AF

接触した広告のタイプ

click / impression / TV の値が入ります

 

Enum型 - 最大10文字まで

dma

DMA

AF

Designated Market Area:Nielsen社による、テレビ視聴などの計測に使用されるが米国のエリア区分。   String型 - 最大10文字まで

event_revenue_usd

Event Revenue USD

AF

USD、もしくは選択した通貨設定での収益金額 / App Settings内で設定可能です。   String型 - 最大20文字まで

event_source

Event source

AF

eventの計測元 - SDK or S2Sの値が入ります。   Enum型 - 最大3文字まで

http_referrer

HTTP Referrer

AF

AppsFlyerのClick URLが貼られたWebページのアドレスを特定します。リファラを確認することで、どこでリクエストが生まれたかが分かります。   String型 - 最大2083文字まで

is_primary_attribution

Is Primary Attribution

AF

リエンゲージメントウィンドウの期間内は、オーバービューに表示されるインストール元のメディアソースとリターゲティングに表示されるリエンゲージメントを生んだメディアソースのどちらにもイベントを紐付けることができます。リエンゲージメントウィンドウ内にイベントが発生した場合、インストール元のメディアソースのこのカラムにはFALSEの値が入ります。リエンゲージメントウィンドウ外の場合、TRUEの値が入ります。

リターゲティング

Enum型 - 最大5文字まで

is_receipt_validated

Is Receipt Validated

AF

実装されている場合はTRUE / FALSE / NULL、未実装の場合は空欄です。

 

Enum型 - 最大5文字まで

match_type

Match Type

AF

アトリビューション手法のタイプ。表示される値は次のとおりです。:

gp_referrer (Google Play referrer string)

id_matching

fingerprinting

srn (Self-Reporting Network)

tv (TV attribution)

preinstall

  String型 - 最大50文字まで

postal_code

Postal code

AF

SDKのIPアドレスに基づきます。   String型 - 最大10文字まで

region

Region

AF

SDKのIPアドレスに基づきます。

 

String型 - 最大100文字まで

retargeting_

conversion_type

Retargeting Conversion Type

AF

  • Re-engagement
  • Re-attribution

リターゲティング

 

Enum型 - 最大14文字まで

state

State

AF

SDKのIPアドレスに基づきます。

 

String型 - 最大100文字まで

keyword_match_type

Keywords Match Type

AF

検索ネットワークAPIもしくは計測リンクによって返されるキーワードのマッチタイプは、ローデータレポート内で確認可能。

Google AdsとApple Search Adsのみがこのパラメータの値を返します。

  String型 - 最大100文字まで

network_account_id

Network Account ID

AF

広告主のパートナーに関するアカウントID

 

String型 - 最大100文字まで

rejected_reason_

value

Rejected Reason

AF

Targeting Validation Rules レポート内に表示。 - 除外の要因となったルールセットID

 

String型 - 最大100文字まで

rejected_reason Rejected Reason AF Targeting Validation Rules レポート内に表示。 - 除外の要因となったルールセットID   String型 - 最大100文字まで
blocked_reason Blocked Reason AF P360のローデータ内に表示。- install_hijackingなどのブロック理由  Protect360  String型 - 最大100文字まで
blocked_sub_reason Blocked Sub Reason AF

P360のローデータ内に表示。- ブロック済みインストールなどのブロック理由

ブロック理由:インストールハイジャック

blocked sub-reason:referrer_hijack

 Protect360  String型 - 最大100文字まで

blocked_reason_

value

Blocked Reason Value AF ブロックに関する追加情報  Protect360  String型 - 最大100文字まで

blocked_reason_

rule

Blocked Reason Rule AF このフィールドは廃止予定です。値は常にnullです。    廃止予定

gp_click_time

Google Play Click Time

Google Play field

広告クリック後にGooglePlay内のアプリページが読み込まれた時間

ソース元:Google API

Android SDK v.4.8.5以降に対応

使用例:install_timeとgp_clickの時間を比較することにより、ユーザーがアプリのダウンロードを開始してからアプリを開くまでにかかる時間についての示唆を得られます。

  Timestamp

gp_install_begin

Google Play Install Begin Time

Google Play field

インストールの開始時刻
ソース:ユーザーの端末、つまり端末に表示されている時間をいみします。

注意:

Android SDK v.4.8.5以降に対応

  Timestamp

gp_referrer

Google Play Referrer

Google Play field

インストールされたアプリのリファラURL

Android SDK v.4.8.5以降に対応

  String型 - 最大1024文字まで

gp_broadcast_referrer

GP Broadcast Referrer

Google Play field

Google PlayのBroadcast Referrer

  String型 - 最大1024文字まで

通貨単位.

この記事は役に立ちましたか?
5人中4人がこの記事が役に立ったと言っています