Rich In-App Events - Android and iOS

Introduction

AppsFlyer’s rich in-app events provide advertisers with the ability to track any post-install event and attribute it to a media source and campaign.

An in-app event is comprised of an event name and event parameters (see below for the list of recommended event and parameter names). 

Syntax:

Android iOS
public static void trackEvent(Context context, String eventName, Map eventValues)

Context

Use getApplicationContext()
eventName
Any string to define the event name. You can find a list of recommended constant event names in Appendix A.
eventValues
A map of event parameters that comprise a rich event.

Example 1:

Android Level Achieved iOS Event Revenue
Map<String, Object> eventValue = new HashMap<String, Object>();
eventValue.put(AFInAppEventParameterName.LEVEL,9);
eventValue.put(AFInAppEventParameterName.SCORE,100);
AppsFlyerLib.trackEvent(context,AFInAppEventType.LEVEL_ACHIEVED,eventValue);


This generates an event of type “af_level_achieved” with the following event values:

{af_level: 9, af_score: 100}

Example 2: Android Purchase Event

Map<String, Object> eventValue = new HashMap<String, Object>();
eventValue.put(AFInAppEventParameterName.REVENUE,200);
eventValue.put(AFInAppEventParameterName.CONTENT_TYPE,"category_a");
eventValue.put(AFInAppEventParameterName.CONTENT_ID,"1234567");
eventValue.put(AFInAppEventParameterName.CURRENCY,"USD");
AppsFlyerLib.trackEvent(context,AFInAppEventType.PURCHASE,eventValue);


This generates an event of type “af_purchase” with the following event values:

{af_content_id: “1234567”, af_content_type: “category_a”, af_revenue: 200, af_currency: “USD”}

The purchase event above contains a $200 revenue, appearing as revenue in the dashboard.

Example 3:  Complex In-App Event

The following is an example of a complex In-App Event that can be sent.

{"af_revenue":"50.87","af_currency":"USD","af_receipt_id":"57601333","product":
[{"af_content_id":"1164_8186","af_price":"8.97","af_quantity":"1"},
{"af_content_id":"1164_8186","af_price":"8.97","af_quantity":"1"},
{"af_content_id":"1164_8186","af_price":"8.97","af_quantity":"1"},
{"af_content_id":"1177_8185","af_price":"8.97","af_quantity":"1"},
{"af_content_id":"0153_9077","af_price":"14.99","af_quantity":"1"}]}

In-App Event Types

The following section describes the recommended structure of each event type together with the parameter mappings to Facebook, Twitter, Criteo and Google Adwords.

 Note

The af_revenue parameter is the only parameter that collects revenue. Other parameters, although mapped to Facebook, such as af_price do NOT collect revenue.

AppsFlyer can provide customers with revenue that is less than a cent on In-App Events with precision of up to five decimal places.

For af_revenue events - do NOT format the revenue value in any way.  It should not contain comma separators.  A revenue event should be similar to 1234.56

Multiple Items

You can add multiple items to a single transaction.  Each item added to the same parameter must be separated by a comma.  For example, In the same transaction, Mr A. Flyer purchases two identical shirts, one pair of shoes and a hat from a US-based online store.  The sequence in which each item is listed must be identical for each parameter.

af_content_id: ["123","988","399"]
af_quantity: [2,1,1]
af_price: [25,50,10]
af_revenue: [110]
af_currency: USD

 Note

This is relevant for the following parameters:

af_add_to_cart, af_add_to_wishlist, af_tutorial_completion, af_initiated_checkout, af_purchase, af_rate, af_spent_credits, af_content_view, af_travel_booking, af_update


For Multiple Items, the code appears, as follows:

 Map<String,Object> eventData = new HashMap<>();
eventData.put(AFInAppEventParameterName.CONTENT_ID, new String[] {"123","988","399"});
eventData.put(AFInAppEventParameterName.QUANTITY, new int[] {2, 1, 1});
eventData.put(AFInAppEventParameterName.PRICE,new int[] {25, 50, 10});
eventData.put(AFInAppEventParameterName.CURRENCY,"USD");
eventData.put(AFInAppEventParameterName.REVENUE,110);
AppsFlyerLib.getInstance().trackEvent(AppsFlyerTestActivity.this, AFInAppEventType.PURCHASE,eventData);


The following in-app events are defined as part of the AFInAppEventType interface and are recommended: 

Level Achieved

Description:  Used to track game level events

Recommended Attributes:  af_level, af_score

Facebook Mapped Event:  fb_mobile_level_achieved

Twitter Mapped Event:  LEVEL_ACHIEVED

Criteo Mapped Event: userLevel

Google AdWords Remarketing: level_up 

Attributes Mapping:

AppsFlyer Facebook Twitter Criteo Google AdWords ReMarketing
af_level fb_level level ui_level level
af_score - - - score

Add Payment Info

Description:  Used to track payment info configuration status

Recommended Attributes:  af_success

Facebook Mapped Event:  fb_mobile_add_payment_info

Twitter Mapped Event:  ADDED_PAYMENT_INFO

Criteo Mapped Event:  None

Google AdWords Remarketing: add_payment_info

Attributes Mapping:

AppsFlyer Facebook Twitter Criteo Google AdWords ReMarketing
af_success fb_success user_payment_info - success

Add to Cart

Description:  Used to track add to cart events of specific items

Recommended Attributes:  af_price, af_content_type, af_content_id, af_currency, af_quantity

Facebook Mapped Event:  fb_mobile_add_to_cart

Twitter Mapped Event:  ADD_TO_CART

Criteo Mapped Event:  viewBasket

Google AdWords Remarketing: add_to_cart

Attributes Mapping:

AppsFlyer Facebook Twitter Criteo Google AdWords ReMarketing
af_price _valueToSum price_micro* price** value
af_content_type fb_content_type content_type - item_category
af_content_id fb_content_id content_id id item_id
af_currency fb_currency price_currency currency currency
af_quantity - number_items quantity quantity

*To report an event containing multiple items, click here

Add to Wishlist

Description: Used to track add to wishlist events of specific items.

Recommended Attributes:  af_price, af_content_type, af_content_id, af_currency, af_quantity

Facebook Mapped Event:  fb_mobile_add_to_wishlist

Twitter Mapped Event:  ADD_TO_WISHLIST

Criteo Mapped Event:  None

Google AdWords Remarketing:  add_to_wishlist

Attributes Mapping:

AppsFlyer Facebook Twitter Criteo Google AdWords ReMarketing
af_price _valueToSum price_micro* - value
af_content_type fb_content_type content_type - item category
af_content_id fb_content_id content_id - item_id
af_currency fb_currency price_currency - currency
af_quantity - number_items - quantity

*To report an event containing multiple items, click here

 

Complete Registration

Description: Used to track user registration methods

Recommended Attributes:  af_registration_method

Facebook Mapped Event:  fb_mobile_complete_registration

Twitter Mapped Event:  SIGN_UP

Criteo Mapped Event:  None

Google AdWords Remarketing:  None

Attributes Mapping:

AppsFlyer Facebook Twitter Criteo Google AdWords ReMarketing
af_registration_
method
fb_registration_
method
registration_method - registration_method

 

Tutorial Completion

Description: Used to track tutorial completions

Recommended Attributes:  af_success, af_content_id

Facebook Mapped Event:  fb_mobile_tutorial_completion

Twitter Mapped Event:  TUTORIAL_COMPLETE

Criteo Mapped Event:  None

Google AdWords Remarketing:  tutorial_completion

Attributes Mapping:

AppsFlyer Facebook Twitter Criteo Google AdWords ReMarketing
af_success fb_success - - success
af_content_id fb_content_id content_id - content_id

*To report an event containing multiple items, click here

Initiated Checkout

Description: Used to track checkout events

Recommended Attributes:  af_price, af_content_type, af_content_id, af_quantity, af_payment_info_available, af_currency

Facebook Mapped Event:  fb_mobile_initiated_checkout

Twitter Mapped Event:  CHECKOUT_INITIATED

Criteo Mapped Event:  None

Google AdWords Remarketing:  begin_checkout

Attributes Mapping:

AppsFlyer Facebook Twitter Criteo Google AdWords ReMarketing
af_price _valueToSum price_micro* - value
af_content_type fb_content_type content_type - item_category
af_content_id fb_content_id content_id - item_id
af_currency fb_currency price_currency - currency
af_quantity fb_num_items number_items - quantity

af_payment_info_
available

fb_payment_info_
available
user_payment_
info
- payment_info_
available
af_content_list fb_content_id - - -
af_date_a fb_checkin_date - - -
af_date_b fb_checkout_date - - -
af_departing_
departure_date
fb_departing_
departure_date
- - -
af_returning_
departure_date
fb_returning_
departure_date
- - -
af_destination_a fb_origin_airport - - -
af_destination_b fb_destination_airport - - -
af_destination_list fb_destination_ids - - -
af_city fb_city - - -
af_region fb_region - - -
af_country fb_country - - -
af_departing_
arrival_date
fb_departing_arrival_
date
- - -
af_returning_
arrival_date
fb_returning_arrival_
date
- - -
af_suggested_
destinations
fb_suggested_
destinations
- - -
af_travel_start fb_travel_start - - -
af_travel_end fb_travel_end - - -
af_num_adults fb_num_adults - - -
af_num_children fb_num_children - - -
af_num_infants fb_num_infants - - -
af_class fb_travel_class - -
af_suggested_hotels fb_suggested_hotels - - -
af_user_score fb_user_score - - -
af_hotel_score fb_hotel_score - - -
af_price fb_purchase_value - - -
af_purchase_currency fb_purchase_currency - - -
af_preferred_star_
ratings
fb_preferred_star_
ratings
- - -
af_preferred_price_
range
fb_preferred_price_
range
- - -
af_preferred_
neighborhoods
fb_preferred_
neighborhoods
- - -
af_preferred_num_
stops
fb_preferred_num_
stops
- - -

*To report an event containing multiple items, click here

Purchase

Description: Used to track purchase events (and associate revenue to them)

Recommended Attributes:  af_revenue, af_content_type, af_content_id, af_price, af_quantity, af_currency, af_order_id

Facebook Mapped Event:  fb_mobile_purchase

Twitter Mapped Event:  PURCHASE

Criteo Mapped Event:  trackTransaction

Google AdWords Remarketing: ecommerce_purchase

Attributes Mapping:

AppsFlyer Facebook Twitter Criteo Google AdWords ReMarketing

af_revenue*

_valueToSum

price_micro**

-

value

af_content_type

fb_content_type

content_type

-

item_category

af_content_id

fb_content_id

content_id

id

item_id

af_price

-

-

price**

-

af_currency

fb_currency

price_currency

currency

currency

af_quantity

fb_num_items

number_items

quantity

quantity

af_validated

-

-

-

validated (optional)

af_receipt_id

-

-

transactionid

transaction_id

af_order_id

fb_order_id

-

-

e_id

af_content_list

fb_content_id

-

-

-

af_date_a

fb_checkin_date

- - -
af_date_b

fb_checkout_date

- - -
af_departing_
departure_date

fb_departing_
departure_date

- - -
af_returning_
departure_date

fb_returning_
departure_date

- - -
af_destination_a

fb_origin_airport

- - -
af_destination_b

fb_destination_
airport

- - -
af_destination_list

fb_destination_ids

- - -
af_city

fb_city

- - -
af_region

fb_region

- - -
af_country

fb_country

- - -
af_departing_arrival_
date

fb_departing_arrival_
date

- - -
af_returning_arrival_
date

fb_returning_arrival_
date

- - -
af_suggested_
destinations

fb_suggested_
destinations

- - -
af_travel_start

fb_travel_start

- - -
af_travel_end

fb_travel_end

- - -
af_num_adults

fb_num_adults

- - -
af_num_children

fb_num_children

- - -
af_num_infants

fb_num_infants

- - -
af_class

fb_travel_class

- - -
af_suggested_
hotels

fb_suggested_
hotels

- - -
af_user_score

fb_user_score

- - -
af_hotel_score

fb_hotel_score

- - -
af_price

fb_purchase_value

- - -
af_purchase_
currency

fb_purchase_
currency

- - -
af_preferred_star_
ratings

fb_preferred_star_
ratings

- - -
af_preferred_price_
range

fb_preferred_price_
range

- - -
af_preferred_
neighborhoods

fb_preferred_
neighborhoods

- - -
af_preferred_num_
stops

fb_preferred_num_
stops

- - -

* af_revenue is counted as revenue in AppsFlyer’s platform.

**af_price - You can use af_price as a monetary parameter that is not counted as revenue (such as in an “Add to Cart” event).  This parameter refers to the individual item price.  The total amount of all purchases appears under the af_revenue parameter.

*To report an event containing multiple items, click here

Rate

Description: Used to track app/item rating events.

Recommended Attributes:  af_rating_value, af_content_type, af_content_id, af_max_rating_value

Facebook Mapped Event:  fb_mobile_rate

Twitter Mapped Event:  RATED

Criteo Mapped Event:  None

Google AdWords Remarketing: None

Attributes Mapping:

AppsFlyer Facebook Twitter Criteo Google AdWords ReMarketing

_valueToSum

price_micro

-

value

af_content_type

fb_content_type

content_type

-

content_type

af_content_id

fb_content_id

content_id

-

content_id

af_max_rating_value

fb_max_rating_value

max_rated_value

-

max_value_rating

*To report an event containing multiple items, click here

Search

Description: Used to track search events

Recommended Attributes:  af_content_type, af_search_string, af_success

Facebook Mapped Event:  fb_mobile_search

Twitter Mapped Event:  SEARCH

Criteo Mapped Event:  viewSearch

Google AdWords Remarketing:  view_search_results

Attributes Mapping:

AppsFlyer Facebook Twitter Criteo Google AdWords ReMarketing

af_content_type

fb_content_type

content_type

-

item_category

af_search_string

fb_search_string

search_string

-

search_term

af_date_a

-

-

din

start_date

af_date_b

-

-

dout

end_date

af_destination_a

-

-

-

destination

af_destination_b

-

-

-

origin

af_success

fb_success

-

-

success

af_content_list

fb_content_id

-

-

-

af_date_a

fb_checkin_date - - -

af_date_b

fb_checkout_date - - -
af_departing_
departure_date

fb_departing_
departure_date

- - -
af_returning_
departure_date

fb_returning_
departure_date

- - -
af_destination_a

fb_origin_airport

- - -
af_destination_b

fb_destination_airport

- - -
af_destination_list

fb_destination_ids

- - -
af_city

fb_city 

- - -
af_region

fb_region

- - -
af_country

fb_country

- - -
af_departing_arrival_
date

fb_departing_arrival_
date

- - -
af_returning_arrival_
date

fb_returning_arrival_
date

- - -
af_suggested_
destinations

fb_suggested_
destinations

- - -
af_travel_start

fb_travel_start

- - -
af_travel_end-

fb_travel_end

- - -
af_num_adults

fb_num_adults

- - -
af_num_children

fb_num_children

- - -
af_num_infants

fb_num_infants

- - -
af_class

fb_travel_class

- - -
af_suggested_hotels

fb_suggested_hotels

- - -
af_user_score

fb_user_score

- - -
af_hotel_score

fb_hotel_score

- - -
af_price

fb_purchase_value

- - -
af_purchase_currency

fb_purchase_currency

- - -
af_preferred_star_
ratings

fb_preferred_star_
ratings

- - -
af_preferred_price_
range

fb_preferred_price_
range

- - -
af_preferred_
neighborhoods

fb_preferred_
neighborhoods

- - -
af_preferred_num_
stops

fb_preferred_num_
stops

- - -

 

Spent Credits

Description: Used to track credit spend events

Recommended Attributes:  af_price, af_content_type, af_content_id

Facebook Mapped Event:  fb_mobile_spent_credits

Twitter Mapped Event:  SPENT_CREDITS

Criteo Mapped Event:  trackTransaction

Google AdWords Remarketing:  None

Attributes Mapping:

AppsFlyer Facebook Twitter Criteo Google AdWords ReMarketing

af_price

_valueToSum

price_micro*

price**

price

af_content_type

fb_content_type

content_type

-

content_type

af_content_id

fb_content_id

content_id

item_id

content_id

*To report an event containing multiple items, click here

 

Achievement Unlocked

Description: Used to track achievement unlocking events

Recommended Attributes:  af_description

Facebook Mapped Event:  fb_mobile_achievement_unlocked

Twitter Mapped Event:  ACHIEVEMENT_UNLOCKED

Criteo Mapped Event:  None

Google AdWords Remarketing: unlock_achievement

Attributes Mapping:

AppsFlyer Facebook Twitter Criteo Google AdWords ReMarketing

af_description

fb_description

description

-

description

 

Content View

Description: Used to track content view events

Recommended Attributes: af_price, af_content_type, af_content_id, af_currency

Facebook Mapped Event:  fb_mobile_content_view

Twitter Mapped Event:  CONTENT_VIEW

Criteo Mapped Event:  viewProduct/viewListing

Google AdWords Remarketing: view_item

Attributes Mapping:

AppsFlyer Facebook Twitter Criteo Google AdWords ReMarketing

af_price

_valueToSum

price_micro*

price

price

af_content_type

fb_content_type

content_type

-

item_category

af_content_id

fb_content_id

content_id

item_id

item_id

af_currency

fb_currency

price_currency

-

currency

af_content_list

fb_content_id

-

-

 
af_date_a

fb_checkin_date

- -  
af_date_b

fb_checkout_date

- -  
af_departing_
departure_date

fb_departing_
departure_date

- -  
af_returning_
departure_date

fb_returning_
departure_date

- - -
af_destination_a

fb_origin_airport

- -  
af_destination_b

fb_destination_
airport

- - -
af_destination_list

fb_destination_ids

- - -
af_city

fb_city

- - -
af_region

fb_region

- - -
af_country

fb_country

- - -
af_departing_arrival_
date

fb_departing_arrival_
date

- - -
af_returning_arrival_
date

fb_returning_arrival_
date

- - -
af_suggested_
destinations

fb_suggested_
destinations

- - -
af_travel_start

fb_travel_start

- - -
af_travel_end

fb_travel_end

- - -
af_num_adults

fb_num_adults

- - -
af_num_children

fb_num_children

- - -
af_num_infants

fb_num_infants

- - -
af_class

fb_travel_class

- - -
af_suggested_hotels

fb_suggested_hotels

- - -
af_user_score

fb_user_score

- - -
af_hotel_score

fb_hotel_score

- - -
af_price

fb_purchase_value

- - -
af_purchase_currency

fb_purchase_currency

- - -
af_preferred_star_
ratings

fb_preferred_star_
ratings

- - -
af_preferred_price_
range

fb_preferred_price_
range

- - -
af_preferred_
neighborhoods

fb_preferred_
neighborhoods

- - -
af_preferred_num_
stops

fb_preferred_num_
stops

- - -

 

List View

Description: Used to track listings view events

Recommended Attributes:  af_content_type, af_content_list

Facebook Mapped Event:

Twitter Mapped Event:

Criteo Mapped Event:  viewListing

Google AdWords Remarketing: view_item_list

Attributes Mapping:

AppsFlyer Facebook Twitter Criteo Google AdWords ReMarketing

af_content_type

-

-

-

item_Category

af_content_list

-

-

product

item_list

 

Travel Booking

Description: Used to track travel booking events (and associate revenue to them)

Recommended Attributes:  af_revenue, af_destination_a, af_destination_b, af_class, af_description, af_customer_user_id, af_content_type, af_content_id, af_date_a, af_date_b

Facebook Mapped Event:  fb_mobile_purchase

Twitter Mapped Event:  PURCHASE

Criteo Mapped Event:  trackTransaction

Google AdWords Remarketing:  ecommerce_purchase

Attributes Mapping:

AppsFlyer Facebook Twitter Criteo Google AdWords ReMarketing

af_revenue*

_valueToSum

price_micro**

price***

value

af_customer_user_id

-

-

cid

customer_user_
id

af_content_type

fb_content_type

content_type

-

item_category

af_content_id

fb_content_id

content_id

-

item_id

af_class

-

-

-

travel_class

af_date_a

-

-

din

start_date

af_date_b

-

-

dout

end_date

af_destination_a

-

-

-

destination

af_destination_b

-

-

-

origin

af_success

fb_success

-

-

success

af_content_list

fb_content_ids

-

-

 
af_date_a

fb_checkin_date

- -  
af_date_b

fb_checkout_date

- -  
af_departing_
departure_date

fb_departing_
departure_date

- -  
af_returning_
departure_date

fb_returning_
departure_date

- -  
af_destination_a

fb_origin_airport

- -  
af_destination_b

fb_destination_airport

- -  
af_destination_list

fb_destination_ids

- -  
af_city

fb_city

- - -
af_region

fb_region

- - -
af_country

fb_country

- - -
af_departing_arrival_
date

fb_departing_arrival_
date

- - -
af_returning_arrival_
date

fb_returning_arrival_
date

- - -
af_suggested_
destinations

fb_suggested_
destinations

- - -
af_travel_start

fb_travel_start

- - -
af_travel_end

fb_travel_end

- - -
af_num_adults

fb_num_adults

- - -
af_num_children

fb_num_children

- - -
af_num_infants

fb_num_infants

- - -
af_class

fb_travel_class

- - -
af_suggested_hotels

fb_suggested_hotels

- - -
af_user_score

fb_user_score

- - -
af_hotel_score

fb_hotel_score

- - -
af_price

fb_purchase_value

- - -
af_purchase_currency-

fb_purchase_currency

- - -
af_preferred_star_
ratings-

fb_preferred_star_
ratings

- - -
af_preferred_price_
range

fb_preferred_star_
ratings

- - -
af_preferred_
neighborhoods

fb_preferred_
neighborhoods

- - -
af_preferred_num_
stops-

fb_preferred_num_
stops

- - -
af_order_id

fb_order_id

- - -

 

Share

Description: Used to track sharing events

Recommended Attributes:  af_description

Facebook Mapped Event:  None

Twitter Mapped Event:  SHARE

Criteo Mapped Event:  None

Google AdWords Remarketing: share

Attributes Mapping:

AppsFlyer Facebook Twitter Criteo Google AdWords ReMarketing

AppsFlyer

Facebook

Twitter

Criteo

Google AdWords Remarketing

af_description

-

description

-

description

Invite

Description: Used to track invite (social) events

Recommended Attributes:  None

Facebook Mapped Event:  None

Twitter Mapped Event:  INVITE

Criteo Mapped Event:  None

Google AdWords Remarketing: invite

Attributes Mapping:

AppsFlyer Facebook Twitter Criteo Google AdWords ReMarketing

af_description

-

description

-

description

Login

Description: Used to track user login events

Recommended Attributes:  None

Facebook Mapped Event:  None

Twitter Mapped Event:  LOGIN

Criteo Mapped Event:  None

Google AdWords Remarketing: login

 

Re-Engage

Description:  Used to track user re-engagement events

Recommended Attributes:  None

Facebook Mapped Event:   None

Twitter Mapped Event:  RE_ENGAGE

Criteo Mapped Event:  None

Google AdWords Remarketing:  custom_event

Attributes Mapping:

AppsFlyer Facebook Twitter Criteo Google AdWords ReMarketing

af_description

-

description

-

custom_event

Opened From Push Notification

Description: Used to track app opens from push notification events

Recommended Attributes:  None

Facebook Mapped Event:  None

Twitter Mapped Event:  None

Criteo Mapped Event:  None

Google AdWords Remarketing: custom_event

 

Update

Description: Used to track update events

Recommended Attributes:  af_content_id

Facebook Mapped Event:  None

Twitter Mapped Event:  UPDATE

Criteo Mapped Event:  None

Google AdWords Remarketing:  custom_event

Attributes Mapping:

content_id
AppsFlyer Facebook Twitter Criteo Google AdWords ReMarketing

af_content_id

-

content_id

-

content_id

*To report an event containing multiple items, click here

Optional Parameters

In addition to the recommended parameters that can be passed with each event, the parameters below are defined as part of the AFInAppEventParameterName interface and can be sent as part of the event dictionary value: 

Parameter String Constant Parameter String Name Recommended Value Type

REVENUE

af_revenue*

Float

PRICE

af_price**

Float

LEVEL

af_level

Int

SUCCESS

af_success

Boolean

CONTENT_TYPE

af_content_type

String

CONTENT_LIST

af_content_list

Array of strings

CONTENT_ID

af_content_id

String

CURRENCY

af_currency

String

REGISTRATION_METHOD

af_registration_method

String

QUANTITY

af_quantity

Int

PAYMENT_INFO_AVAILABLE

af_payment_info_available

Boolean

RATING_VALUE

af_rating_value

Float

MAX_RATING_VALUE

af_max_rating_value

Float

SEARCH_STRING

af_search_string

String

DESCRIPTION

af_description

String

SCORE

af_score

Int

DESTINATION_A

af_destination_a

String

DESTINATION_B

af_destination_b

String

CLASS

af_class

String

DATE_A

af_date_a

String

DATE_B

af_date_b

String

EVENT_START

af_event_start

Unixtime

EVENT_END

af_event_end

Unixtime

LATITUDE

af_lat

Int

LONGITUDE

af_long

Int

CUSTOMER_USER_ID

af_customer_user_id

String

CUSTOMER_SEGMENT

af_customer_segment

String

VALIDATED

af_validated

String

RECEIPT_ID

af_receipt_id

String

ORDER_ID

af_order_id

String

TUTORIAL_ID

af_tutorial_id

String

ACHIEVEMENT_ID

af_achievement_id

String

VIRTUAL_CURRENCY_NAME

af_virtual_currency_name

String

DEEP_LINK

af_deep_link

String

OLD_VERSION

af_old_version

String

NEW_VERSION

af_new_version

String

REVIEW_TEXT

af_review_text

String

COUPON_CODE

af_coupon_code

String

DEPARTING_DEPARTURE_DATE

af_departing_departure_date

String

RETURNING_DEPARTURE_DATE

af_returning_departure_date

String

DESTINATION_LIST

af_destination_list

String[]

CITY

af_city

String

REGION

af_region

String

COUNTRY

af_county

String

DEPARTING_ARRIVAL_DATE

af_departing_arrival_date

String

RETURNING_ARRIVAL_DATE

af_returning_arrival_date

String

SUGGESTED_DESTINATIONS

af_suggested_destinations

String[]

TRAVEL_START

af_travel_start

String

TRAVEL_END

af_travel_end

String

NUM_ADULTS

af_num_adults

Int

NUM_CHILDREN

af_num_children

Int

NUM_INFANTS

af_num_infants

Int

SUGGESTED_HOTELS

af_suggested_hotels

String[]

USER_SCORE

af_user_score

Float

HOTEL_SCORE

af_hotel_score

Float

PURCHASE_CURRENCY

af_purchase_currency

String

PREFERRED_STAR_RATINGS

af_preferred_star_ratings

Int[2]

PREFERRED_PRICE_RANGE

af_preferred_price_range

Int[2]

PREFERRED_NEIGHBORHOODS

af_preferred_neighborhoods

String[]

PREFERRED_NUM_STOPS

af_preferred_num_stops

Int

PARAM_1

af_param_1

String

PARAM_2

af_param_2

String

PARAM_3

af_param_3

String

PARAM_4

af_param_4

String

PARAM_5

af_param_5

String

PARAM_6

af_param_6

String

PARAM_7

af_param_7

String

PARAM_8

af_param_8

String

PARAM_9

af_param_9

String

PARAM_10

af_param_10

String

Revenue Reporting Parameters

af_revenue is the only parameter that is used for revenue calculations. Always use it with in-app events that represent actual revenue generation in your business logic.

af_currency represents the currency that is stated in af_revenue (or af_price). If af_currency is missing from the event's parameters AppsFlyer sends it with the default value "USD".

You can use af_price as a monetary parameter that is not counted as revenue (such as in an “Add to Cart” event). This parameter refers to the individual item price.  The total amount of all purchases appears under the af_revenue parameter.

 Note

For Google AdWords Remarketing, if your SDK event does not have a matching Google AdWords value name, then use the value custom_event. In this case, all the corresponding values are sent, as is.



 

Was this article helpful?
0 out of 1 found this helpful