Raw-data field dictionary (V5.0 spec)

At a glance: The data field dictionary (raw data specification) describes field contents.

Date fields in CSV files: Date fields in the CSV files have the format yyyy-mm-dd. When you open a CSV file in Excel, date fields are formatted using your computer's date and time settings. Be sure to select the  appropriate date display in Excel.

About the raw data dictionary 

The dictionary columns are: 

  • Field group: Logical grouping based on field use
  • Display Name:
    • Field name used in reports provided via the Export page and Pull API.
    • The notation [n] means that there are multiple instances of the same filed, the difference being the instance number. For example, Sub Param [n] means, Sub Param 1, Sub Param 2, ..., Sub Param 5.  The range of n values is noted as (n=1-5). 
  • Source: The original source location of the field content as follows:
  • Description
    • Some fields have different meanings depending on the context of the event.
    • Meaning as a result of a UA or retargeting campaign.
  • Field type and length:
    • String: The maximum length of the string. We don't usually enforce field length limitations on receipt of the data but the data may be truncated thereafter. Don't exceed the field length specification.
    • Date Time: 
      • String with the format, yyyy-mm-dd hh:mm:ss. For example, 2019-09-17 00:09:25 The time zone used to display the data depends on the data delivery tool as follows:
        • Export data page: app-selected time zone.
        • Push API: time fields have a selected_time_zone option which means app-specific time zone otherwise UTC.
        • Master API: Default is the app-selectable time zone.
        • Data Locker: UTC
      • Note: When opening CSV files using Excel, the field displays using the default regional settings. You can change the display format in Excel. To see the unformatted value, open the file using an editor.
      • Push API:
        • For timestamp fields in UTC: format yyyy-mm-dd hh:mm:ss.sssFor example, 2019-09-17 00:09:25.123 
        • For timestamp fields in the selected time zone: format yyyy-mm-dd hh:mm:ss.sss±th:tm. For example 2019-01-20 04:51:16.000+0000
    • Enum n char: Enum fields can only contain specific values. For example, Cost currency has 3 characters and can contain only currency codes as specified
    • Enum 5 char boolean: The value of the field can be either TRUE or FALSE
    • Sample install record having CSV format

Data fields dictionary

 Tip—to sort the table click on a column name

Field group

Export/Pull API Display name

Source

Description

Field format

Attribution

Ad

Link

Ad name

String 100

Attribution

Ad ID

Link

Ad ID

String 24

Attribution

Ad Type

Link

Example: banner, footer

String 24

Attribution

Adset

Link

Ad set, group that contains one or more ads

String 100

Attribution

Adset ID

Link

Ad set ID, the ID of an Ad set. 

String 24

Attribution

Campaign

Link

Contains one or more ad sets String 100

Attribution

Campaign ID

Link

Campaign ID String 24

Attribution

Channel

Link

Media source channel. Example: YouTube for Google, Instagram for Facebook Dynamic Enum String 20

Attribution

Cost Currency

Link

3-letter currency code (e.g. USD, EUR) that complies with ISO-4217. Default is USD. Enum 3 char

Attribution

Cost Model

Link

Cost model reported on the attribution link. CPC/CPI/CPM/Other. Currently, all cost is calculated according to CPI regardless of this value

String 20

Attribution

Cost Value

Link

Amount of Cost Currency. 4 digits after the decimal point permitted. Example: 320.5095 String 20

Attribution

Keywords

Link

Word(s) used in the user's online search. As reported by the ad network

String 100

Attribution

Attribution Lookback Window

Link

Maximum period of time when an install can be attributed to a specific ad.

3 char max

Attribution

Partner

Link

Agency or PMD

String 50

Attribution

Re-engagement Window

Link

Retargeting: The time period during which events are attributed to a retargeting campaign

NoteThe field is not populated in retargeting campaigns.

3 char max

Attribution

Site ID

Link

Publisher ID String 24

Attribution

Sub Site ID

Link

Sub-publisher ID

String 50

Attribution

Sub Param [n]

(n=1-5)

Link

Parameter populated by the advertiser in the SDK String 100

Attribution

Campaign

Link

Campaign name

String 100

Attribution

Is Retargeting

Link

  • UA: False
  • Retargeting: True for retargeting conversions and events

Enum 5 char boolean

Attribution

Media Source

Link

The media source attributed to an event or restricted

String 50

Attribution

Original URL

Link

  • UA: Click/impression URL used. If the link is a Branded Link: the field is populated using the branded link.
  • Retargeting: contains one of the following: Retargeting link, deep linking data, empty for SRNs.
String 2083 (URL)

Attribution

User Agent

Link

The URL user agent String 200

Device info

Advertising ID

SDK

User-resettable device ID, AKA GAID.  String 40

Device info

Android ID

SDK

Permanent device ID  String 20

App

App ID

SDK

Unique app identifier in Appsflyer. Example: 
  • iOS: id123456789
  • Android: com.appsflyer.referrersender

iOS: String 12

Android: String 100

App

App Name

SDK

Set by the advertiser String 100

App

App Version

SDK

Set by the advertiser 8 char max

Device info

AppsFlyer ID

SDK

UA or re-attribution: Unique installation ID set by AppsFlyer when the app launches for the first time. A new ID is allocated if the app is deleted and then installed again

iOS: String 24

Android: String 33

App

Bundle ID

SDK

ios: Identification to match either a single app or a group of apps in iOS (See Apple developer bundle ID

Android: The app name

Note: This field is not related to AppsFlyer PBA

String 100

Device info

Carrier

SDK

The carrier name provided by Android using getSimCarrierIdName(). See also carrier mapping.

String 50

Device location

Country Code

SDK

  • Country Code using ISO 3166 (alpha-2) Example: US, CN.
  • The United Kingdom code implemented is UK, not GB. 
Enum String 2

Attribution

Custom Data

SDK

  • Data sent by the SDK for integration with third-parties
  • See Android and iOS
String 1024

Device info

Customer
User ID

SDK

A unique app user ID, set by the app owner.  String 100

Attribution

Deeplink URL

SDK

The path for an internal activity in the app that users are deep linked into. Use this for deep linking and deferred deep linking. String1024

Device info

Device Category

SDK

  • Possible values include: phone, tablet, other
  • Compatible with Android SDK V4.8.8 and later
String 20

Device info

Device Type

SDK

The commercial model name of the device. Example: SM-GM284 or iPhone7

String 100

Device info

Device Download Time

SDK

App download completion time using the device's (Android, iOS) clock and converted to UTC. The value always displays as  UTC time.

Format: yyyy-mm-dd hh:mm:ss.sss

-

Event

Event Name

SDK

Name allocated to an event String 100

Event

Event Revenue

SDK

  • Value of revenue using Event Revenue Currency.
  • Amounts outside of the range  $-10,000- $+10,000 (or equivalent) appear in raw data reports but not aggregate reports.
String 20

Event

Event Revenue Currency

SDK

The event revenue currency code reported to the SDK. String 20

Event

Event Time

SDK

UA: time the event happened

Retargeting: will be the same as the install time

Date Time

Event

Event Value

SDK

Detailed event content sent from the SDK. Note: Don't send more than 1000 characters they may be truncated

String 1000

Device info

IDFA

SDK

User resettable advertising ID found ion iOS devices 40 char max

Device info

IDFV

SDK

Vendor ID provided by iOS 40 char max

Device info

IMEI

SDK

Permanent device ID  14 char max

Attribution

Install App Store

SDK

The Android store where the app was downloaded from (details) String 50

Attribution

 

Install Time

SDK

  • UA: Time of the first launch after installation.
  • Retargeting: The first app launch after re-engagement/re-attribution

Date Time

Device location

IP

SDK

IP address being IPV4 or IPV6 String

Device info

Is Lat

SDK

  • Limit ad tracking (LAT): When true, the user has enabled LAT on their device and no advertiser ID is available to AppsFlyer. 
  • Available in Push API only. 
Enum 5 char boolean

Device info

Language

SDK

Language (locale) reported by the device and set by the device OS. Usually has the form ll-DD. Where ll is the language and DD is the dialect.  For example, en-ZA means English as used in South Africa.

String 20

Device info

OAID

SDK

User-resettable ID on some Android devices usually as an alternative to GAID 40 char max

Device info

Operator

SDK

The name of the mobile operator derived from the SIM MCCMNC. Available if the user is registered to the network using Android getNetworkOperatorName() String 50

Device info

OS Version

SDK

Device operating system version String 8

Device info

Platform

SDK

Device platform: iOS, Android, or Windows Mobile

Enum string 8

App

SDK Version

SDK

AppsFlyer SDK version String 8

Device info

WIFI

SDK

TRUE/FALSE

Enum 5 char boolean

Attribution

Store Reinstall

SDK

Apple app store determines if a user brought by Apple Search Ads is a reinstall by using the Apple user ID:

  • New user: false
  • Reinstall by an existing user: true
Enum 5 char boolean

Device info

Amazon Fire ID

SDK

User-resettable advertising ID on Amazon devices.

String 100

Device location

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

Attribution

Attributed Touch Time

AF

UA: time of the touch we attributed to.

Retargeting: retargeting engagement time

Date Time

Attribution

Attributed Touch Type

AF

UA: Possible values: Click, impression, TV, pre-installed

Re-engagement: click, impression (re-attribution only)

Enum 10 char max

Attribution

Contributor [n] Partner (n=1-5)

AF

Agency or PMD -  always converted to lowercase

String 50

Attribution

Contributor [n] Campaign (n=1-5)

AF

  String 100

Attribution

Contributor [n] Match Type (n=1-5)

AF

Possible values: gp_referrer, id_matching, srn String 50

Attribution

Contributor [n] Media Source (n=1-5)

AF

  String 50

Attribution

Contributor [n] Touch Time (n=1-5)

AF

 

Date Time

Attribution

Contributor [n] Touch Type (n=1-5)

AF

Possible values: click, impression, TV

Enum 10 char max

Device location

DMA

AF

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

Event

Event Revenue USD

Event Revenue Preferred

Event Revenue XXX

AF

The amount of revenue. The currency will depend on the reporting tool used.

Preferred or selected means the app-specific currency set in the app settings.

Data Locker: always USD

Export page: selected currency 

Pull API selectable: USD or selected using &currency=preferred. 

Push API: always contains both fields, USD and selected currency

String 20

Event

Event Source

AF

 Either SDK or S2S Enum 3 char max

Attribution

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

Attribution

Is Primary Attribution

AF

UA: True

Retargeting: During a re-engagement window, we attribute to both the original media source (prior to the re-engagement) and to the re-engagement media source. While the event is within the re-engagement window. The original media source will be FALSE (not primary attribution). The re-engagement media source will be TRUE.

Enum 5 char max

Event

Is Receipt Validated

AF

TRUE/FALSE/NULL when implemented in the SDK, empty otherwise

Enum 5 char max

Attribution

Match Type

AF

Attribution method type. Possible values include: gp_referrer (Google Play referrer string), id_matching, fp (Ephemeral matching), srn (Self-Reporting Network), tv (TV attribution), preinstall String 50

Device location

Postal Code

AF

Using the device IP address reported by the SDK String - 10 char max

Device location

Region

AF

Using the device IP address reported by the SDK

String 100

Attribution

Retargeting Conversion Type

AF

UA: N/A

Re-targetingRe-engagement, Re-attribution

Enum 14 char max

Device location

State

AF

Using the device IP address reported by the SDK

String 100

Attribution

Keyword ID

Link

Keyword ID returned by the ad network. This is the ID of the af_keyword. String 100

Attribution

Keyword 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

Attribution

Network Account ID

Link

Advertiser's account ID with the partner

String 100

Targeting rules

Rejected Reason value

AF

Targeting validation rules reports: Ruleset ID that caused the rejection

String 100

Targeting rules

Rejected Reason AF In targeting validation rules reports - the type of rule that caused the rejection. Example, e.g.install-validation-rule String 100

Protect360

Blocked Reason AF Protect360: the reason the install is blocked. Example: install_hijacking, bots String 100

Protect360

Blocked Sub Reason AF

Protect 360: particular sub reason for a blocked install. Example: Reason: install_hijacking. Sub-reason: referer hijack, CTCT_anomalies

String 100

Protect360

Blocked Reason Value AF Protect 360 Additional information regarding the: block. Example: Site ID. String 100

Protect360

Blocked Reason Rule AF Scheduled for deprecation. The value is always null.  To be deprecated

Attribution

Google Play Click Time

Google Play field

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

Time source: Google API

Available from Android SDK version 4.8.5

Example: Compare install_time to gp_click time. This gives an insight into how much time passes between app download, until the user opens it.

Timestamp

Attribution

Google Play Install Begin Time

Google Play store

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

Available from Android SDK V4.8.5

Timestamp

Attribution

Google Play Referrer

Google Play store

The referrer URL of the installed package.

Available from Android SDK V4.8.5

String 1024

Attribution

Google Play Broadcast Referrer

Google Play store

Google Play Broadcast Referrer

String 1024

Ad revenue

Ad Unit

Ad revenue API

Ad revenue type of ad

String 1024

Ad revenue

Segment

Ad revenue API

Ad revenue ad segment name String 1024

Ad revenue

Placement Ad revenue API

Ad revenue placement

String 1024

Ad revenue

Monetization Network

Ad revenue API

Ad revenue network sending the ad

String 1024

Ad revenue

Impressions

Ad revenue API

Ad revenue number of times that the user saw the ad

String 1024

Ad revenue

Mediation Network

Ad revenue API

Ad revenue mediation network reporting the event to AppsFlyer

String 1024

Field availability

Field availability by reporting tool

  • The column export/Pull API lists all possible fields available.
    • In Pull API you may need to add the field to the report using the additional fields parameter.
    • There are some minor differences in field availability between the downloadable UA reports. 
    • To see the detailed description of the API name, search for the Data Locker name in the dictionary table.  For example, the API af_siteid is equivalent to Site ID. To get the full details of the field search for Site ID in the dictionary. 
Field group API name Data Locker name 
(N/A=not available) 
Export Data/Pull API name (N/A= not available)
App app_version App Version App Version
App sdk_version SDK Version SDK Version
App app_id App ID App ID
App app_name App Name App Name
App bundle_id Bundle ID Bundle ID
Attribution custom_data Custom Data

Custom Data

(Not available via Export data page)

Attribution network_account_id Network Account ID N/A
Attribution attributed_touch_time Attributed Touch Time Attributed Touch Time
Attribution attributed_touch_type Attributed Touch Type Attributed Touch Type
Attribution install_time Install Time Install Time
Attribution af_cost_model Cost Model Cost Model
Attribution af_cost_value Cost Value Cost Value
Attribution af_cost_currency Cost Currency Cost Currency
Attribution event_source Event Source Event Source
Attribution af_prt Partner Partner
Attribution media_source Media Source Media Source
Attribution af_channel Channel Channel
Attribution af_keywords Keywords Keywords
Attribution install_app_store Install App Store Install App Store
Attribution campaign Campaign Campaign
Attribution af_c_id Campaign ID Campaign ID
Attribution af_adset Adset Name Adset
Attribution af_adset_id Adset ID Adset ID
Attribution af_ad Ad Ad
Attribution af_ad_id Ad ID Ad ID
Attribution af_ad_type Ad Type Ad Type
Attribution af_siteid Site ID Site ID
Attribution af_sub_siteid Sub Site ID Sub Site ID
Attribution af_sub[n] (n=1-5) Sub Param [n] Sub Param [n]
Attribution contributor_n_touch_type Contributor[n] touch Type Contributor [n] Touch Type
Attribution contributor_n_touch_time Contributor[n] Touch Time Contributor [n] Touch Time
Attribution contributor_n_af_prt Contributor[n] Partner Contributor [n] Partner
Attribution contributor_n_match_type Contributor[n] Match Type Contributor [n] Match Type
Attribution contributor_n_media_source Contributor[n] Media Source Contributor [n] Media Source
Attribution contributor_n_campaign Contributor[n] Campaign Contributor [n] Campaign
Attribution is_retargeting Is Retargeting Is Retargeting
Attribution retargeting_conversion_type Retargeting Conversion Type Retargeting Conversion Type
Attribution is_primary_attribution Is Primary Attribution Is Primary Attribution
Attribution af_attribution_lookback Attribution Lookback Window Attribution Lookback
Attribution af_reengagement_window Reengagement Window Reengagement Window
Attribution match_type Match Type Match Type

Attribution

http_referrer HTTP Referrer HTTP Referrer
Attribution original_url Original URL Original URL
Attribution gp_referrer Google Play Referrer Google Play Referrer
Attribution gp_click_time Google Play Click Time Google Play Click Time
Attribution gp_install_begin Google Play Install Begin Time Google Play Install Begin Time
Attribution gp_broadcast_referrer Google Play Broadcast Referrer Google Play Broadcast Referrer 
Attribution keyword_match_type Keyword Match Type

Keyword Match Type

(Not available via Pull API)

Attribution keyword_id N/A Keyword ID
Device info wifi WIFI WIFI
Device info operator Operator Operator
Device info carrier Carrier Carrier
Device info language Language Language
Device info appsflyer_id AppsFlyer ID AppsFlyer ID
Device info customer_user_id Customer User ID Customer User ID
Device info android_id Android ID Android ID
Device info advertising_id Advertising ID for Android devices Advertising ID
Device info imei IMEI IMEI
Device info idfa IDFA for IOS devices IDFA
Device info idfv IDFV IDFV
Device info amazon_aid Amazon Fire ID

Amazon Fire ID

(Not availalble via Pull API)

Device info device_type Device Type Device Type
Device info device_category Device Category Device Category
Device info platform Platform Platform
Device info os_version OS Version OS Version
Device info user_agent User Agent User Agent
Device info device_download_time Device Download Time Device Download Time
Device info deeplink_url Deeplink URL Deeplink URL
Device info oaid OAID OAID
Device info is_lat

N/A

(Available via Push API)

N/A
Device info store_reinstall N/A Store Reinstall
Device location region Region Region
Device location country_code Country Code Country Code
Device location state State State
Device location city City City
Device location postal_code Postal Code Postal Code
Device location dma DMA DMA
Device location ip IP IP
Event event_time Event Time Event Time
Event event_name Event Name Event Name
Event event_value Event Value Event Value
Event event_revenue   Event Revenue  Event Revenue
Event event_revenue_currency Event Revenue Currency Event Revenue Currency
Event event_revenue_usd
(Via Pull API and Export Data the currency may be the app-specific currency in which case the currency code changes)
Event Revenue USD Event Revenue  USD
Event is_receipt_validated Is Receipt Validated Is Receipt Validated
Event event_revenue_selected_currency N/A
(Available via Push API)
N/A
Ad revenue placement Adrevenue Placement Placement
Ad revenue mediation_network Adrevenue Mediation Network Mediation Network
Ad revenue segment Adrevenue Segment Segment
Ad revenue ad_unit Adrevneue Unit Ad Unit
Ad revenue monetization_network Adrevenue Network Monetization Network
Ad revenue impressions Adrevenue Impressions Impressions

Protect360

blocked_reason Blocked Reason Blocked Reason

Protect360

blocked_reason_value Blocked Reason Value Blocked Reason Value

Protect360

blocked_reason_rule Blocked Reason Rule Blocked Reason Rule

Protect360

blocked_sub_reason Blocked Sub Reason Blocked Sub Reason

Targeting rules

rejected_reason N/A Rejected reason

Targeting rules

rejected_reason_value N/A Rejected reason value
PBA af_web_id Web ID -
PBA web_event_type Web Event Type -
PBA media_type Media Type -
PBA pid Pid -
PBA utm_source Utm Source -
PBA utm_medium Utm Medium -
PBA utm_term Utm Term -
PBA utm_content Utm Content -
PBA utm_campaign Utm Campaign -
PBA media_channel Media Channel -
PBA event_url Event URL -
PBA utm_id UTM ID -
API name and Display name/Data Locker name

Example in-app event raw data record

Sample_v5_in_app_event.csv

Example in-app event raw data record
Field name Value
WIFI TRUE
Ad 101548
Adset 18212447
Advertising ID 452c96af-7dc8-4d4c-9579-example
App ID abc.example
App Name Example: #1 Online Shopping App & Deals
App Version 4.0.11
AppsFlyer ID 1570515992667-612279933540example
Attributed Touch Time 2019-10-08 10:21.31
Attributed Touch Type click
Attribution Lookback 7d
Bundle ID abc.example
Campaign abc_ad_network_9999999
Carrier example-carrier
City Johannesburg
Cost Model CPI
Cost Value 1900-01-00 07:12.00
Country Code ZA
Customer User ID abc123xyz
Device Category phone
Device Download Time 2019-10-07 19:52.23
Device Type vivo-vivo 1727
DMA None
Event Name af_purchase
Event Revenue 100
Event Revenue Currency ZAR
Event Revenue USD 13
Event Source SDK
Event Time 2020-02-23 20:40.17
Event Value {"af_content":"[{\"id\":\"99988089\",\"item_price\":100,\"quantity\":2}]",
"af_price":[100],"appsflyer_device_id":"99999992667-279933540example",
"af_order_id":"99998496842","af_receipt_id":"99998496842"
,"af_content_id":"99998089"],"af_content_type":"product",
"af_currency":"ZAR","af_revenue":100"af_description":["00008"],"af_quantity":[1],"af_param_1":"999963"}
Field Value
Install Time 2019-10-08 13:26.41
IP 192.0.2.1.1
Is Primary Attribution FALSE
Is Retargeting FALSE
Language English
Match Type id_matching
Media Source abc_ad_network_int
Operator example-carrier
OS Version 9
Platform android
Postal Code 8100
Region AF 
SDK Version v5.1.1
Site ID abc.example_1099548_35281
State GAU
Sub Param 1 99999
Sub Site ID 99999
User Agent Dalvik/2.1.0 (Linux; U; Android 9; vivo 1727 Build/PKQ1.190118.001)
Was this article helpful?