Raw Data Reports V5

What’s New?

  • Selecting which fields for which the Pull API report should download
  • Attribution window information for clicks and impressions
  • Contributor data
  • Additional fields and updates

NOTES:

  • Reports in the new format only show data from a week prior to the date of the release and beyond.
  • For information on V4 reports for both Android and iOS, click here.

Selecting Fields in Pull API

The new Pull API (v5) supports reports with selectable fields. This enables customers to download relevant information to suit their requirements.

In order to specify the requested fields, append the following fields parameter to the API call.  Each column you request should be added to the fields parameter by specifying the API Name as it appears in the table below:

&fields=API_Name_A,API_Name_B

Example:

https://hq.appsflyer.com/export/id341333333/installs_report/v5?api_token=24b7b9fe-6ddd-4ddd-94c8-ea176340c8ad&from=2016-03-09&to=2016-03-10&fields=attributed_touch_type,attributed_touch_time

V5 Reports 

To view V5 Raw Data Reports click Export Data in the left side bar

The Export Data page opens.  Scroll down to Raw Data Reports for the report you want to view.

Raw_Data_Reports_V5.png

New Report Fields 

See below to download a sample Raw Data Report.

API Name

(v5)

Display Name (v5)

Display Name (v4)

Source

(Link / SDK/ AF)

Description

attributed_touch_type

Attributed Touch Type

n/a

link

The type of the touch we attributed to (could be click / impression / TV / pre-installed)

attributed_touch_time

Attributed Touch Time

Click time /

Install time

link

The time of the touch we attributed to

install_time

Install Time

Install Time

sdk

Time the installation took place.  

NOTE:  This is based on the first time that the app was actually launched.

af_prt

Partner

Agency/PMD (af_prt)

link

Agency or PMD

media_source

Media Source

Media Source

link

Regular networks (excluding FB etc.) will appear on the link.

is_retargeting

Is Retargeting

n/a

link

TRUE / FALSE

retargeting_conversion_type

Retargeting Conversion Type

n/a

AF

Re-engagement / Re-attribution

af_channel

Channel

Channel (af_channel)

link

Channel of the media source, such as YouTube for Google, Instagram fo Facebook etc. 

af_keywords

Keywords

Keywords (af_keywords)

link

Received from Google Integration

campaign

Campaign

Campaign Name (c)

link

Note: campaign name for special integrations (e.g. Facebook) returns via API and not via link.

af_c_id

Campaign ID

Campaign ID (af_c_id)

link

Campaign 

af_adset

Adset

Adset Name (af_adset)

link

Facebook info is also included

af_adset_id

Adset ID

Adset ID (af_adset_id)

link

Facebook info is also included

af_ad

Ad

Ad Name (af_ad)

link

Facebook info is also included

af_ad_id

Ad ID

Ad ID (af_ad_id)

link

Facebook info is also included

af_ad_type

Ad Type

Ad Type (af_ad_type)

link

Type of ad (banner, footer etc.) 

af_siteid

Site ID

Site Id (af_siteid)

link

Publisher ID

af_sub1

Sub Param 1

Sub Param 1 (af_sub1)

link

Custom parameter to be defined by the customer 

af_sub2

Sub Param 2

Sub Param 2 (af_sub2)

link

Custom parameter to be defined by the customer 

af_sub3

Sub Param 3

Sub Param 3 (af_sub3)

link

Custom parameter to be defined by the customer  

af_sub4

Sub Param 4

Sub Param 4 (af_sub4)

link

Custom parameter to be defined by the customer 

af_sub5

Sub Param 5

Sub Param 5 (af_sub5)

link

Custom parameter to be defined by the customer 

http_referrer

HTTP Referrer

HTTP Referrer

AF

Identifies the address of the webpage that linked to the AppsFlyer click URL. By checking the referrer, you can see from where the request originated.

original_url

Original URL

n/a

link

Click/Impression URL.  For example http://your.url.com 

user_agent

User Agent

n/a

link

The user agent for the URL 

af_cost model

Cost Model

Cost Model (af_cost_model)

link

CPC / CPA / CPM

af_cost_value

Cost Value

Cost (af_cost_value)

link

Cost in original currency 

af_cost currency

Cost Currency

Cost Currency (af_cost_currency)

link

Currency of the cost 

contributor1_af_prt

Contributor 1 Partner

n/a

AF

Agency or PMD

contributor1_media_source

Contributor 1 Media Source

Contributor 1 Media Source

AF

Media Source of the contributor 

contributor1_campaign

Contributor 1 Campaign

Contributor 1 Campaign

AF

Campaign of the contributor 

contributor1_touch_type

Contributor 1 Touch Type

n/a

AF

The type of the touch

(could be click / impression / TV)

contributor1_touch_time

Contributor 1 Touch Time

n/a

AF

The time of the touch

contributor2_af_prt

Contributor 2 Partner

n/a

AF

Agency or PMD 

contributor2_media_source

Contributor 2 Media Source

Contributor 2 Media Source

AF

Media Source of the contributor 

contributor2_campaign

Contributor 2 Campaign

Contributor2 Campaign

AF

Campaign of the contributor 

contributor2_touch_type

Contributor 2 Touch Type

n/a

AF

The type of the touch

(could be click / impression / TV) 

contributor2_touch_time

Contributor 2 Touch Time

n/a

AF

The time of the touch 

contributor3_af_prt

Contributor 3 Partner

n/a

AF

Agency or PMD 

contributor3_media_source

Contributor 3 Media Source

Contributor 3 Media Source

AF

Media Source of the contributor  

contributor3_campaign

Contributor 3 Campaign

Contributor 3 Campaign

AF

Campaign of the contributor  

contributor3_touch_type

Contributor 3 Touch Type

n/a

AF

The type of the touch

(could be click / impression / TV) 

 

contributor3_touch_time

Contributor 3 Touch Time

n/a

AF

The time of the touch  

country_code

Country Code

Country Code

sdk

Country Code.  For example GB, US

ip

IP

IP

sdk

IP address

region

Region

Region

AF

Based on ip from the SDK

state

State

State

AF

Based on ip from the SDK

city

City

City

AF

Based on ip from the SDK

wifi

WIFI

WIFI

sdk

TRUE / FALSE

operator

Operator

n/a

sdk

Operator name

carrier

Carrier

n/a

sdk

Carrier name 

language

Language

Language

sdk

Device language

appsflyer_id

AppsFlyer ID

n/a

sdk

Installation identifier 

advertising_id

Advertising ID

Advertising Id

sdk

The advertising ID is a user-resettable, unique, anonymous ID for advertsing provided by Google Play services.

idfa

IDFA

IDFA

sdk

For iOS - Device IDFA

n/a

n/a

MAC

   

android_id

Android ID

Android Id

sdk

Android device ID 

customer_user_id

Customer User ID

Customer User Id

sdk

Customer user ID, as set by the developer. This is used as the user identifier in the advertiser's system.

imei

IMEI

IMEI

sdk

Device IMEI for Android and iOS 

idfv

IDFV

IDFV

sdk

App level identifier for a particular vendor

platform

Platform

n/a

sdk

iOS / Android / Windows Mobile

device_type

Device Type

Device Type

sdk

Tablet / Phone

os_version

OS Version

OS Version

sdk

Operation System version 

app_version

App Version

App Version

sdk

Version of the app

sdk_version

SDK Version

SDK Version

sdk

Version of the SDK 

app_id

App ID

n/a

sdk

ID of the app.  

For iOS: id12345678.  

For Android: com.appsflyer.referrersender

app_name

App Name

n/a

sdk

Name of the app

bundle_id

Bundle ID

n/a

sdk

Identification to match either a single app or a group of apps (for iOS)

af_attribution_lookback

Attribution Lookback

n/a

link

Time period for which AppsFlyer attributes events

event_time

Event Time

Event Time

sdk

The time of the event happened

event_name

Event Name

Event Name

sdk

The name of the event that took place

event_value

Event Value

Event Value

sdk

The value of the event 

event_revenue

Event Revenue

Event Revenue

sdk

The revenue created as a result of the event 

event_revenue_usd

Event Revenue USD

n/a

AF

The amount of the revenue in US dollars 

event_revenue_currency

Event Revenue Currency

n/a

sdk

The amount of the revenue in local currency 

is_receipt_validated

Is Receipt Validated

Is Receipt Validated

AF

true/false/null when implemented in the SDK, empty otherwise

n/a

n/a

Appsflyer device id

sdk

 

postal_code

Postal code

n/a

AF

Based on ip of the SDK

dma

DMA

n/a

AF

Designated Market Area - regions are the geographic areas in the US where local television viewing is measured by the Nielsen company.

af_reengagement_window

Reengagement window

n/a

link

The re-engagement attribution window is the number of days in which an event can be attributed to a re-targeting campaign

event_source

Event source

n/a

AF

The source of the event - either SDK or S2S

is_primary_attribution

Is Primary Attribution

n/a

AF

During a re-engagement window, we can attribute to either the original media source (prior to the re-engagement) or to the re-engagement media source. While the event is within the re-engagement window, the original media source will not be the primary attribution. Outside of the re-engagement window, it will be the the primary attribution. 

af_sub_siteid

Sub Site ID

n/a

 

Placeholder to be populated at a later date

Was this article helpful?
2 out of 2 found this helpful
Have more questions? Submit a request
Powered by Zendesk