AppsFlyer PC/Console/CTV Events API

Appsflyer's platform is used by businesses to understand how users find and interact with their apps. Using this destination you can leverage AppsFlyer PC/Console/CTV Events API to measure first app opens and in-app events.

Key features

The AppsFlyer PC/Console/CTV Events API destination provides the following key features:

• Events structure: our Events reference supports AppsFlyer's event structure, meaning that your data is properly bridged to the expected fields in an optimized way.

• Prebuilt mappings: data mapping for event-based destinations happens automatically, which simplifies user inputs.

• Custom events and properties: you can freely push custom events and properties based on your specific needs.

• Smart mapping: data mapping can be readjusted using your datalayer defined fields.

• Support for multi-item data: information included in the item array is bridged to AppsFlyer.

Destination setup

Ensure your app is registered in AppsFlyer under My Apps .

Configuration

Settings	Description
Signature Secret Key	Required The developer key as the signature secret key. You can find its value in the AppsFlyer's dashboard under Settings → My Apps → click ⋮ next to your app → App settings → Dev key .
Application Id	Required Your application identifier (app-id). You can find its value in the AppsFlyer's dashboard under Settings → My Apps → mouse over just below your app name → click Copy app id .
Platform	Required Select your platform of the measured app from the provided list: roku , smartcast , tizen , webos , playstation , vidaa , steam , quest , battlenet , epic , switch , xbox , nativepc and vega .
First Open Event Name	Required see below The name of the event identifying app first opens. Default: first_open . This is required if your app does not integrate our mobile SDK.
Device Id Mapping	Required Map your device identifiers by selecting a type from the provided list, and a value . At least one entry is required.
Event Mapping	Change the standard mapping between AppsFlyer events and yours or add new mappings.
Param Mapping	Map your custom parameters by setting their field names in AppsFlyer parameter and adding the value in Your value.

Quick reference

Commanders Act Events	AppsFlyer Events
achievement_unlocked	af_achievement_unlocked
ad_click	af_ad_click
ad_view	af_ad_view
add_payment_info	af_add_payment_info
add_to_cart	af_add_to_cart
add_to_wishlist	af_add_to_wishlist
app_opened	af_app_opened
sign_up	af_complete_registration
view_item	af_content_view
begin_checkout	af_initiated_checkout
invite	af_invite
generate_lead	lead
level_achieved	af_level_achieved
view_item_list	af_list_view
login	af_login
notification_open	af_opened_from_push_notification
in_app_purchase purchase	af_purchase
submit_rating rate	af_rate
re_engage	af_re_engage
view_search_results search	af_search
share	af_share
spend_virtual_currency	af_spent_credits
spent_credits	af_spent_credits
start_trial	af_start_trial
subscribe	af_subscribe
travel_booking	af_travel_booking
ecommerce_purchase	af_travel_booking
tutorial_complete	af_tutorial_completion
app_update update	af_update

Field mappings

Properties can be remapped using our Smart Mapping feature.

Smart Mapping Fields	Commanders Act Default Properties	AppsFlyer Properties
Device IP	context.device.ip	ip [*]
-	Device Id Mapping	device_ids [*]
Event Timestamp	context.event_timestamp	timestamp
Request Id	context.event_id	request_id
Device User Agent	context.device.user_agent	user_agent
Device OS Version	context.device.os.version	device_os_version
Device Model	context.device.model	device_model
Ad Tracking Enabled	context.device.ad_tracking_enabled	limit_ad_tracking
User Id	user.id	customer_user_id af_customer_user_id
App Version	context.app.version	app_version
Sharing Filters	partners.appsflyer.sharing_filters	sharing_filter
-	event_name	event_name [1][4]
Value	value	af_revenue [2][4]
Currency	currency	af_currency [2][4]
Ad Type	ad_format	af_adrev_ad_type [3][4]
City Ride	partners.appsflyer.af_city	af_city [3][4]
Travel Class	partners.appsflyer.af_class	af_class [3][4]
Item Name	items.0.product.name	af_content [3][4]
Item Id	items.0.id	af_content_id [3][4]
Item Id	items.X.id	af_content_list [3][4]
Item List	items.length	af_quantity [3][4]
Item Category 1	items.0.product.category_1	af_content_type [3][4]
Country Ride	partners.appsflyer.af_country	af_country [3][4]
Currency	currency	af_currency [3][4]
Check-in date	partners.appsflyer.af_date_a	af_date_a [3][4]
Check-out date	partners.appsflyer.af_date_b	af_date_b [3][4]
Departing Arrival Date	partners.appsflyer.af_departing_arrival_date	af_departing_arrival_date [3][4]
Departing Departure Date	partners.appsflyer.af_departing_departure_date	af_departing_departure_date [3][4]
Returning Arrivial Date	partners.appsflyer.af_returning_arrival_date	af_returning_arrival_date [3][4]
Returning Departure Date	partners.appsflyer.af_returning_departure_date	af_returning_departure_date [3][4]
Description	partners.appsflyer.af_description	af_description [3][4]
First Destination	partners.appsflyer.af_dest_a	af_destination_a [3][4]
Second Destination	partners.appsflyer.af_dest_b	af_destination_b [3][4]
Destination List	partners.appsflyer.af_dest_list	af_destination_list [3][4]
Hotel Score	partners.appsflyer.af_hotel_score	af_hotel_score [3][4]
User Level	partners.appsflyer.af_level	af_level [3][4]
Max Rating Value	partners.appsflyer.af_max_rating_value	af_max_rating_value [3][4]
Adults Number	partners.appsflyer.af_num_adults	af_num_adults [3][4]
Childrens Number	partners.appsflyer.af_num_children	af_num_children [3][4]
Infants Number	partners.appsflyer.af_num_infants	af_num_infants [3][4]
Transaction Id	id	af_order_id [3][4]
Payment Method	payment_method	af_payment_info_available [3][4]
Hotel Area	partners.appsflyer.af_hotel_area	af_preferred_neighborhoods [3][4]
User Stops Number	partners.appsflyer.af_preferred_num_stops	af_preferred_num_stops [3][4]
Hotel Price Range	partners.appsflyer.af_preferred_price_range	af_preferred_price_range [3][4]
Hotel Star Rating	partners.appsflyer.af_preferred_star_ratings	af_preferred_star_ratings [3][4]
Projected Revenue	partners.appsflyer.af_projected_revenue	af_projected_revenue [3][4]
Max Rating Value	partners.appsflyer.af_max_rating_value	af_rating_value [3][4]
Receipt Id	partners.appsflyer.af_receipt_id	af_receipt_id [3][4]
Region Ride	partners.appsflyer.af_region	af_region [3][4]
Registration Method	method	af_registration_method [3][4]
Score	partners.appsflyer.score	af_score [3][4]
Search Term	search_term	af_search_string [3][4]
Subscription Id	partners.appsflyer.af_subscription_id	af_subscription_id [3][4]
Success	partners.appsflyer.af_success	af_success [3][4]
Suggested Destinations	partners.appsflyer.af_suggested_destinations	af_suggested_destinations [3][4]
Suggested Hotels	partners.appsflyer.af_suggested_hotels	af_suggested_hotels [3][4]
Travel End	partners.appsflyer.af_travel_end	af_travel_end [3][4]
Travel Start	partners.appsflyer.af_travel_start	af_travel_start [3][4]
User Score	partners.appsflyer.af_user_score	af_user_score [3][4]
Validated	partners.appsflyer.af_validated	af_validated [3][4]
Achievement Id	partners.appsflyer.af_achievement_id	af_achievement_id [3][4]
Coupon	partners.appsflyer.af_coupon_code	af_coupon_code [3][4]
Customer Segment	partners.appsflyer.af_customer_segment	af_customer_segment [3][4]
Deep Link	partners.appsflyer.af_deep_link	af_deep_link [3][4]
Event End	partners.appsflyer.af_event_end	af_event_end [3][4]
Event Start	partners.appsflyer.af_event_start	af_event_start [3][4]
Latitude	partners.appsflyer.af_lat	af_lat [3][4]
Longtitude	partners.appsflyer.af_long	af_long [3][4]
New Version	partners.appsflyer.af_new_version	af_new_version [3][4]
Old Version	partners.appsflyer.af_old_version	af_old_version [3][4]
Review Text	partners.appsflyer.af_review_text	af_review_text [3][4]
Tutorial Id	partners.appsflyer.af_tutorial_id	af_tutorial_id [3][4]
Virtual Currency Name	partners.appsflyer.af_virtual_currency_name	af_virtual_currency_name [3][4]
Duration Seconds	partners.appsflyer.af_duration_seconds	af_duration_seconds [3][4]

* Mandatory property. 1. See Quick reference for more details on the standard mapping. 2. Set in the property event_parameters . 3. Set in the property event_custom_parameters . 4. This property is not present for first app opens.