Raw Data Reports V5

Introduction

AppsFlyer's raw data fields, in the advanced format called V5, are available in several places:

Report Fields 

The table below contains all the available V5 fields, their data types and their descriptions. All the field values are strings, unlimited in length, as they may contain user-generated values. However, some fields do have max length or logical data type, which are specified per field.

Unlimited fields may have a specified number in square brackets on the "Type & Max Length" column, which symbolizes a logical (but unforced) upper limit to the field's length.

There are 3 sources for the raw data fields: Tracking Links (find more information about AppsFlyer Tracking Link Structure and parameters), SDK or AF, i.e. generated on AppsFlyer's servers. 

API Name

Display Name

Source

Description

Type & Max Length

attributed_touch_type

Attributed Touch Type

link

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

Enum - 10 char max

attributed_touch_time

Attributed Touch Time

link

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

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

event_time

Event Time

sdk

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

event_name

Event Name

sdk

The name of the event that took place Unlimited [100]

event_value

Event Value

sdk

The value of the event  Unlimited [100]

event_revenue

Event Revenue

sdk

The revenue created as a result of the event.  Supporting up to 4 digits after the decimal point. Unlimited [20]

event_revenue_currency*

Event Revenue Currency

sdk

The amount of the revenue in local currency. Supporting up to 4 digits after the decimal point.  Unlimited [20]

event_revenue_usd

Event Revenue USD

AF

The amount of the revenue in US dollars.  Supporting up to 4 digits after the decimal point.  Unlimited [20]

event_source

Event source

AF

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

is_receipt_validated

Is Receipt Validated

AF

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

Enum - 5 char max

af_prt

Partner

link

Agency or PMD

Unlimited - [50]

media_source

Media Source

link

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

Unlimited - [50]

af_channel

Channel

link

Channel of the media source, such as YouTube for Google, Instagram fo Facebook etc.  Dynamic Enum - Unlimited [20]

af_keywords

Keywords

link

Received from Google Integration

Unlimited - [100]

campaign

Campaign

link

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

Unlimited - [100]

af_c_id

Campaign ID

link

Campaign  Unlimited - [24]

af_adset

Adset

link

Facebook info is also included

Unlimited - [100]

af_adset_id

Adset ID

link

Facebook info is also included

Unlimited - [24]

af_ad

Ad

link

Facebook info is also included

Unlimited - [100]

af_ad_id

Ad ID

link

Facebook info is also included

Unlimited - [24]

af_ad_type

Ad Type

link

Type of ad (banner, footer etc.)  Unlimited - [24]

af_site_id

Site ID

link

Publisher ID Unlimited - [24]

af_sub_site_id

Sub Site ID

link

Sub-publisher ID

Unlimited [50]

af_sub1

Sub Param 1

link

Custom parameter to be defined by the customer  Unlimited - [100]

af_sub2

Sub Param 2

link

Custom parameter to be defined by the customer  Unlimited - [100]

af_sub3

Sub Param 3

link

Custom parameter to be defined by the customer   Unlimited - [100]

af_sub4

Sub Param 4

link

Custom parameter to be defined by the customer  Unlimited - [100]

af_sub5

Sub Param 5

link

Custom parameter to be defined by the customer  Unlimited - [100]

af_cost model

Cost Model

link

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

Unlimited - [20]

af_cost_value

Cost Value

link

Cost in original currency. Supporting up to 4 digits after the decimal point. eg. 320.5095 Unlimited - [20]

af_cost currency*

Cost Currency

link

Currency of the cost (list Enum - 3 char max

contributor1_af_prt

Contributor 1 Partner

AF

Agency or PMD

Unlimited - [50]

contributor1_media_source

Contributor 1 Media Source

AF

Media Source of the contributor  Unlimited - [50]

contributor1_campaign

Contributor 1 Campaign

AF

Campaign of the contributor  Unlimited - [100]

contributor1_touch_type

Contributor 1 Touch Type

AF

The type of the touch

(could be click / impression / TV)

Enum - 10 char max

contributor1_touch_time

Contributor 1 Touch Time

AF

The time of the touch

Date Time - 24 char max

contributor2_af_prt

Contributor 2 Partner

AF

Agency or PMD  Unlimited - [50]

contributor2_media_source

Contributor 2 Media Source

AF

Media Source of the contributor  Unlimited - [50]

contributor2_campaign

Contributor 2 Campaign

AF

Campaign of the contributor  Unlimited - [100]

contributor2_touch_type

Contributor 2 Touch Type

AF

The type of the touch

(could be click / impression / TV) 

Enum - 10 char max

contributor2_touch_time

Contributor 2 Touch Time

AF

The time of the touch  Date Time - 24 char max

contributor3_af_prt

Contributor 3 Partner

AF

Agency or PMD  Unlimited - [50]

contributor3_media_source

Contributor 3 Media Source

AF

Media Source of the contributor   Unlimited - [50]

contributor3_campaign

Contributor 3 Campaign

AF

Campaign of the contributor   Unlimited - [100]

contributor3_touch_type

Contributor 3 Touch Type

AF

The type of the touch

(could be click / impression / TV) 

 

Enum - 10 char max

contributor3_touch_time

Contributor 3 Touch Time

AF

The time of the touch   Date Time - 24 char max

region

Region

AF

Based on IP from the SDK

Unlimited - [100]

country_code

Country Code

sdk

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

state

State

AF

Based on IP from the SDK

Unlimited - [100]

city

City

AF

Based on IP from the SDK

Unlimited - [100]

postal_code

Postal code

AF

Based on IP of the SDK Unlimited [10]

dma

DMA

AF

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

ip

IP

sdk

IP address IP - 15 char max (for IPv4)

wifi

WIFI

sdk

TRUE / FALSE

Enum - 5 char max

operator

Operator

sdk

Operator name Unlimited - [50]

carrier

Carrier

sdk

Carrier name  Unlimited - [50]

language

Language

sdk

Device language Unlimited - [20]

appsflyer_id

AppsFlyer ID

sdk

Unique Installation identifier 

24 char max (iOS)

33 char max (Android)

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

idfa

IDFA

sdk

For iOS - Device IDFA 40 char max

android_id

Android ID

sdk

Android device ID  20 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. Unlimited - [100]

imei

IMEI

sdk

Device IMEI for Android and iOS  14 char max

idfv

IDFV

sdk

App level identifier for a particular vendor 40 char max

platform

Platform

sdk

iOS / Android / Windows Mobile

Enum - 8 char max

device_type

Device Type

sdk

Tablet / Phone

Enum - 6 char max

os_version

OS Version

sdk

Operation System version  8 char max

app_version

App Version

sdk

Version of the app 8 char max

sdk_version

SDK Version

sdk

Version of the SDK  8 char max

app_id

App ID

sdk

ID of the app.  

For iOS: id123456789.  

For Android: com.appsflyer.referrersender

For iOS - 12 char max
For Android - Unlimited [100]

app_name

App Name

sdk

Name of the app Unlimited [100]

bundle_id

Bundle ID

sdk

Identification to match either a single app or a group of apps (for iOS) Unlimited [100]

is_retargeting

Is Retargeting

link

TRUE / FALSE

Enum - 5 char max

retargeting_conversion_type

Retargeting Conversion Type

AF

Re-engagement / Re-attribution

Enum - 14 char max

af_attribution_lookback

Attribution Lookback

link

Time period for which AppsFlyer attributes events 3 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 re-targeting campaign 3 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

user_agent

User Agent

link

The user agent for the URL  Unlimited - [200]

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

original_url

Original URL

link

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

 

Note

Here are the possible currency codes

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