• 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 select the report you want to view.

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

Field Type

Space Allocation

Data Definition

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/FMP (af_prt)

link

Agency or FMP (FMP previously known as 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 FMP

     

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 FMP      

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 FMP      

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