Raw Data Report Specification V5

  • Advertisers
  • Developers

Introduction

The raw data report specification V5 describes the name, content, and format of raw data provided by AppsFlyer.  Data is supplied to you by:

  • Download: Downloading CSV files containing the raw data. Go to  Reports > Export Data.  
  • API: Using our push API raw data results
  • Data locker:  Deposit the files in your data locker. 

Note that V5 fields are found in the Master API and Pull API URL queries. 

Push API message parameters are similar to those of the raw data reports but may have some variation (see full list).

For FAQs and marketing tips on how you can use the raw data reports, go here.

Report Fields Specification Table

Each report field contains the following:

  • API Name: as used by the API
  • Display Name: as it appears in reports generated by AppsFlyer
  • Source: the original source location of the field content as follows:
  • Description
  • Type and Max Length: In general,  unless indicated otherwise, field values are strings,  unlimited in length, as they may contain user-generated values. Some fields do have a maximum length or logical data type, which is specified. Some unlimited fields may have a specified number in square brackets in the type and max length column, which indicates a logical (but unenforced) upper limit of the field length.

Raw Data Fields V5 sorted by source

API Pramater Name

Display Name

Source

Description

Type and Max Length

af_ad

ad

Link

Facebook info is also included

String - 100 char max

 

af_ad_id

 

Ad ID

Link

Facebook info is also included

String - 24 char max

 

af_ad_type

Ad Type

Link

Type of ad (banner, footer etc.)

String - 24 char max

af_adset

Adset

Link

Facebook info is also included

String - 100 char max

af_adset_id

Adset ID

Link

 

String - 24 char max

af_c_id

Campaign ID

Link

Campaign String - 24 char max

af_channel

Channel

Link

Channel of the media source, such as YouTube for Google, Instagram for Facebook, etc. Dynamic Enum - String - 20 char max

af_cost_currency*

Cost Currency

Link

Currency of the cost (list) Enum - 3 char max

af_cost_model

Cost Model

Link

CPC / CPI / CPM / Other. Currently all cost is calculated according to CPI regardless of this value

String - 20 char max

af_cost_value

Cost Value

Link

Cost in original currency. Supporting up to 4 digits after the decimal point. eg. 320.5095 String - 20 char max

af_keywords

Keywords

Link

Received from Partner Integration

String - 100 char max

af_click_lookback

Attribution Lookback Link Lookback Window for click Attribution. This window's duration is the maximum CTIT (Click Time to Install) for the new user to be attributed to the source displaying the ad/link.

3 char max

af_prt

Partner

Link

Agency or PMD

String - 50 char max

af_reengagement_window

Reengagement Window

Link

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

af_siteid

Site ID

Link

Publisher ID String - 24 char max

af_sub_siteid

Sub Site ID

Link

Sub-publisher ID

String - 50 char max

af_sub1

Sub Param 1

Link

Optional custom parameter defined by the advertiser String - 100 char max

af_sub2

Sub Param 2

Link

Optional custom parameter defined by the advertiser String - 100 char max

af_sub3

Sub Param 3

Link

Optional custom parameter defined by the advertiser String - 100 char max

af_sub4

Sub Param 4

Link

Optional custom parameter defined by the advertiser String - 100 char max

af_sub5

Sub Param 5

Link

Optional custom parameter defined by the advertiser String - 100 char max

campaign

Campaign

Link

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

String - 100 char max

is_retargeting

Is Retargeting

Link

TRUE / FALSE

Enum - 5 char max

media_source

Media Source

Link

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

String - 50 char max

original_url

Original URL

Link

Click/Impression URL. For example http://your.url.com URL - 2083 char max

user_agent

User Agent

Link

The user agent for the URL String - 200 char max

advertising_id

Advertising ID

SDK

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

android_id

Android ID

SDK

Android device ID 20 char max

amazon_aid

Amazon Fire ID

SDK

Amazon Fire TV advertising ID

40 char max

app_id

App ID

SDK

ID of the app.

  • iOS: id123456789
  • Android: com.appsflyer.referrersender

For iOS - 12 char max
For Android - String - 100 char max

app_name

App Name

SDK

Name of the app String - 100 char max

app_version

App Version

SDK

Version of the app 8 char max

appsflyer_id

AppsFlyer ID

SDK

Unique Installation identifier

24 char max (iOS)

33 char max (Android)

bundle_id

Bundle ID

SDK

Identification to match either a single app or a group of apps (for iOS) String - 100 char max

carrier

Carrier

SDK

Carrier name String - 50 char max

country_code

Country Code

SDK

Country Code. For example GB, US Enum - 2 char max

custom_data

Custom Data

SDK

Data that can be inserted via the SDK and is exported to Raw Reports. See documentation for Android and iOS. String 1024 char max

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. String - 100 char max

devicetim_category

Device Category

SDK

Possible values include:

phone, tablet, other

(Compatible with Android SDK v4.8.8 and above.)

String - 20 char max

device_type

Device Type

SDK

Commercial model name of the device, e.g. SM-GM284 or iPhone7

String - 100 char max

event_name

Event Name

SDK

The name of the event that took place String - 100 char max

event_revenue

Event Revenue

SDK

The amount or revenue according to the Event Revenue Currency. String - 20 char max

event_revenue_currency*

Event Revenue Currency

SDK

The Event Revenue Currency as reported to the AppsFlyer SDK. String - 20 char max

event_time

Event Time

SDK

The time of the event happened Date Time - 24 char max

event_value

Event Value

SDK

The value of the event String - 1000 char max

idfa

IDFA

SDK

For iOS - Device IDFA 40 char max

idfv

IDFV

SDK

App level identifier for a particular vendor 40 char max

imei

IMEI

SDK

Device IMEI for Android and iOS 14 char max

install_app_store

Install App Store

SDK

Identifies the Android store where the app is downloaded from (details) String - 50 char max

install_time

Install Time

SDK

Time of the first launch after the installation took place. Format "mm/dd/yyyy hh:mm:ss PM/AM". Example: "11/19/2016 8:32:12 PM"

 

 

Date Time - 24 char max

ip

IP

SDK

IP address IP - 15 char max (for IPv4)

language

Language

SDK

Device language String - 20 char max

operator

Operator

SDK

Operator name String - 50 char max

os_version

OS Version

SDK

Operation System version 8 char max

platform

Platform

SDK

iOS / Android / Windows Mobile

Enum - 8 char max

sdk_version

SDK Version

SDK

SDK version 8 char max

wifi

WIFI

SDK

TRUE/FALSE

Enum - 5 char max

gp_broadcast_referrer

GP Broadcast Referrer

SDK

Google Play Broadcast Referrer

String - 100 char max

amazon_aid

Amazon Fire ID

 

Amazon advertising ID

String - 100 char max

city

City

AF

The most granular location of the user based on the device IP. Usually the value holds a city name, but it can also be districts, boroughs, etc., which are more accurate.

String - 100 char max

attributed_touch_time

Attributed Touch Time

AF

The time of the touch we attributed to. Format "mm/dd/yyyy hh:mm:ss PM/AM". Example: "11/19/2016 8:32:12 PM"

Date Time - 24 char max

attributed_touch_type

Attributed Touch Type

AF

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

Enum - 10 char max

contributor_1_af_prt

Contributor 1 Partner

AF

Agency or PMD -
always converted to lowercase

String - 50 char max

contributor_1_campaign

Contributor 1 Campaign

AF

Campaign of the contributor String - 100 char max

contributor_1_match_type

Contributor 1 Match Type

AF

Possible values include:

gp_referrer,  id_matching, srn

String - 50 char max

contributor_1_media_source

Contributor 1 Media Source

AF

Media Source of the contributor String - 50 char max

contributor_1_touch_time

Contributor 1 Touch Time

AF

The time of the touch

Date Time - 24 char max

contributor_1_touch_type

Contributor 1 Touch Type

AF

The type of the touch

click, impression, TV)

Enum - 10 char max

contributor_2_af_prt

Contributor 2 Partner

AF

Agency or PMD String - 50 char max

contributor_2_campaign

Contributor 2 Campaign

AF

Campaign of the contributor String - 100 char max

contributor_2_match_type

Contributor 2 Match Type

AF

Possible values include:

gp_referrer/id_matching/srn

String - 50 char max

contributor_2_media_source

Contributor 2 Media Source

AF

Media Source of the contributor String - 50 char max

contributor_2_touch_time

Contributor 2 Touch Time

AF

The time of the touch Date Time - 24 char max

contributor_2_touch_type

Contributor 2 Touch Type

AF

The type of the touch

(could be click/impression/TV)

Enum - 10 char max

contributor_3_af_prt

Contributor 3 Partner

AF

Agency or PMD String - 50 char max

contributor_3_campaign

Contributor 3 Campaign

AF

Campaign of the contributor String - 100 char max

contributor_3_match_type

Contributor 3 Match Type

AF

Possible values include:

gp_referrer/id_matching/srn

String - 50 char max

contributor_3_media_source

Contributor 3 Media Source

AF

Media Source of the contributor String - 50 char max

contributor_3_touch_time

Contributor 3 Touch Time

AF

The time of the touch Date Time - 24 char max

contributor_3_touch_type

Contributor 3 Touch Type

AF

The type of the touch

(could be click / impression / TV)

Enum - 10 char max

dma

DMA

AF

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

event_revenue_usd

Event Revenue USD

AF

The amount of revenue in USD or in preferred currency, configurable under App Settings. String - 20 char max

event_source

Event source

AF

The source of the event - either SDK or S2S Enum - 3 char max

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 where the request originated URL - 2083 char max

is_primary_attribution

Is Primary Attribution

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 primary attribution.

Enum - 5 char max

is_receipt_validated

Is Receipt Validated

AF

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

Enum - 5 char max

match_type

Match Type

AF

Attribution method type. Possible values include:

gp_referrer (Google Play referrer string)

id_matching

fingerprinting

srn (Self-Reporting Network)

tv (TV attribution)

preinstall

String - 50 char max

postal_code

Postal code

AF

Based on IP of the SDK String - 10 char max

region

Region

AF

Based on IP from the SDK

String - 100 char max

retargeting_conversion_type

Retargeting Conversion Type

AF

Re-engagement / Re-attribution

Enum - 14 char max

state

State

AF

Based on IP from the SDK

String - 100 char max

keyword_match_type

Keywords Match Type

AF

The keyword match type returns by search networks APIs or attribution links shall be mapped to the raw report.

Note: Google AdWords and Apple Search Ads are the only networks that return this parameter for search campaigns.

String - 100 char max

network_account_id

Network Account ID

AF

Advertiser's account ID with the partner

String - 100 char max

rejected_reason_value

Rejected Reason

AF

Appears in Targeting Validation Rules Reports - Ruleset ID that caused the rejection

String - 100 char max

rejected_reason Rejected Reason AF Appears in Targeting Validation Rules Reports - the type of rule that caused the rejection e.g. install-validation-rule String - 100 char max
blocked_reason Blocked Reason AF Appears in P360 raw data - the reason the install is blocked e.g. install_hijacking String - 100 char max
blocked_sub_reason Blocked Sub Reason AF

Appears in P360 raw data - a particular reason for a blocked install e.g.

blocked reason: install_hijacking

blocked sub-reason: referrer_hijack

String - 100 char max
blocked_reason_value Blocked Reason Value AF Additional information regarding the block itself String - 100 char max
blocked_reason_rule Blocked Reason Rule AF Deprecated field - always null  N/A

gp_click_time

Google Play Click Time

Google Play field

Time of app page load in Google Play after an ad click.

Time source: Google API

Format: timestamp in seconds

Available from Android SDK version 4.8.5

Use case example: By comparing install_time to gp_click time you can gain an insite as to how long it takes users from the time they begin to download the app until they open the app. 

Date Time - 24 char max

gp_install_begin

Google Play Install Begin Time

Google Play field

Time that installation begins 
Time source: User device. Meaning the time that displays on the device. 

Format: timestamp in seconds

Note: 

Available from Android SDK version 4.8.5

Date Time - 24 char max

gp_referrer

Google Play Referrer

Google Play field

The referrer URL of the installed package.

Available from Android SDK version 4.8.5

String 1024 char max

gp_broadcast_referrer

GP Broadcast Referrer

Google Play field

Google Play Broadcast Referrer

String 1024 char max

Currency codes.

Was this article helpful?
3 out of 4 found this helpful

Page Contents: