Mobile AppsFlyer

The Mobile AppsFlyer implements mobile attribution for both Android and iOS.

It supports all essential mobile attribution features for games. To wit: event tracking, analytics, cross-promotion, open store tracking, device account management, device tracking, info tracking, etc.

It includes all Core SDK features and other essential additional features of AppsFlyer.

It supports Construct 3 and is designed to be optimal and efficient for games with c3runtime, designed for both Android and iOS.

 

Intstructions

1. The first step is to add the Mobile AppsFlyer addon into the project.

2. If the Debug Mode property is checked, it will log information and errors in the console. Set this unchecked for your production release.

3. The Mobile AppsFlyer SDK is now fully integrated into your project.

Features

The Mobile AppsFlyer is an addon that integrates the native mobile AppsFlyer SDK into an application made in Construct 3, with support for both android and ios.
It allows you to integrate AppsFlyer's mobile attribution features, all features from the Core SDK and all essential additional features.

Features :

  • Full native Android SDK integration.

  • Full native iOS SDK integration.

  • AppsFlyer Mobile Attribution.

  • C3 Scripting (JavaScript) support.

  • Easy to use and no programming required.

  • Well-supported and fully tested.

  • Full Event Tracking features.

  • Built-in device and info tracking.

  • Cross-promotion features.

  • Privacy compliance features.

  • AppsFlyer tools.

  • Asynchronous features.

  • Construct 3 editor support.

  • Construct 3 runtime.

  • Worker Mode support.

  • C3 Build Service & PhoneGap.

  • Android Studio & XCode.

  • Cordova CLI

Integration Tutorial

Tutorial Project

Tutorial.png
  • The tutorial project explains the proper workflow in using the Mobile AppsFlyer addon.

  • It explains all the basic features, the actions, conditions and expressions.

Track Events

  • The Mobile AppsFlyer's most important feature is the event tracking.

  • You can track events with parameters. You can also use the predefined event parameters from the official list (5.2.2).

Track Events.png
  • There is a JS Scripting counterpart of the Track Event action called the Track Event (JS) action.

  • Same as the one above, you can track events with parameters and also use the predefined event parameters from the official list (5.2.2).

Track Events (JS).png

AppsFlyer Events

Event Names:

  • af_level_achieved

  • af_add_payment_info

  • af_add_to_cart

  • af_add_to_wishlist

  • af_complete_registration

  • af_tutorial_completion

  • af_initiated_checkout

  • af_purchase

  • af_rate

  • af_search

  • af_spent_credits

  • af_achievement_unlocked

  • af_content_view

  • af_list_view

  • af_travel_booking

  • af_share

  • af_invite

  • af_login

  • af_re_engage

  • af_update

  • af_opened_from_push_notification

  • af_location_coordinates

  • af_customer_segment

  • af_subscribe

  • af_start_trial

  • af_ad_click

  • af_ad_view

Event Parameters

Event Parameters:

  • af_content

  • af_achievement_id

  • af_level

  • af_score

  • af_success

  • af_price

  • af_content_type

  • af_content_id

  • af_content_list

  • af_currency

  • af_quantity

  • af_registration_method

  • af_payment_info_available

  • af_max_rating_value

  • af_rating_value

  • af_search_string

  • af_date_a

  • af_date_b

  • af_destination_a

  • af_destination_b

  • af_description

  • af_class

  • af_event_start

  • af_event_end

  • af_lat

  • af_long

  • af_customer_user_id

  • af_validated

  • af_revenue

  • af_projected_revenue

  • af_receipt_id

  • af_tutorial_id

  • af_achievement_id

  • af_virtual_currency_name

  • af_deep_link

  • af_old_version

  • af_new_version

  • af_review_text

  • af_coupon_code

  • af_order_id

  • af_param_1

  • af_param_2

  • af_param_3

  • af_param_4

  • af_param_5

  • af_param_6

  • af_param_7

  • af_param_8

  • af_param_9

  • af_param_10

  • af_departing_departure_date

  • af_returning_departure_date

  • af_destination_list (scripting only)

  • af_city

  • af_region

  • af_country

  • af_departing_arrival_date

  • af_returning_arrival_date

  • af_suggested_destinations 
    (scripting only)

  • af_travel_start

  • af_travel_end

  • af_num_adults

  • af_num_children

  • af_num_infants

  • af_suggested_hotels (scripting only)

  • af_user_score

  • af_hotel_score

  • af_purchase_currency

  • af_adrev_ad_type

  • af_adrev_network_name

  • af_adrev_placement_id

  • af_adrev_ad_size

  • af_adrev_mediated_network_name

Actions, Conditions & Expressions

Actions

Pre-Initialization :

  • Collect IMEI - If checked, it will enable the collection of IMEI. Default is checked.

    • Collect IMEI - Check to enable the collection of IMEI.

  • Set User ID - Setting your own Custom ID enables you to cross-reference your own unique ID with AppsFlyer’s user ID and the other devices’ IDs. Must be set before initialization, preferably "On Loader Layout Complete".

    • Customer User ID - User's own customer id for this Mobile AppsFlyer application.

  • Collect Android ID - If checked, it will enable the collection of Android ID. Default is checked.

    • Collect Android ID - Check to enable the collection of Android ID.

Analytics :

  • Track Event - Send in-app events to AppsFlyer analytics. 
    These in-app events help you track how loyal users discover your app, and attribute them to specific campaigns/media-sources.
    Please take the time define the event/s you want to measure to allow you to track ROI (Return on Investment) and LTV (Lifetime Value).
    Kindly see the list of predefined
    event names and event parameters.

    • Event Name - The event name, this is presented in your dashboard.

  • Add Event Parameter - Add a tracking parameter to an event.

    • Parameter Name - The parameter name.

    • Parameter Value - The parameter value.

    • Event Name - The event name where this parameter will be added into the next "Track Event" action.

  • Remove Event Parameter - Remove a parameter from an event.

    • Parameter Name - The name of the parameter to remove.

    • Event Name - The event name where this parameter will be removed from the next "Track Event" action.

  • Clear Event Parameters - Clear all the parameters of an event.

    • Event Name - The event name where all the parameters will be removed.

  • Track Event (JS) - Send in-app events to AppsFlyer analytics.
    This is similar to the
    Track Event action, but with Construct 3's JS Scripting support. You can declare here the event parameters using JavaScript or JSON.

    • Event Name - The event name, this is presented in your dashboard.

    • Parameter JS - The parameters in JSON string. [For the Scripting Feature.]

General :

  • Initialize - Initialize the Mobile AppsFlyer SDK.

    • DevKey - The AppsFlyer Dev key.

    • AppID - The Apple Application ID (for iOS only).

    • Debug Mode - If checked, the Mobile AppsFlyer SDK will enter debug mode.

  • Set Currency - Set the currency in ISO4217 Currency Code. For example: 'USD', 'GBP' or 'PHP'.\

    • Currency Code - Currency in ISO4217. For example: 'USD', 'GBP' or 'PHP'.

 

Tools :​​

  • Set Device Tracking - AppsFlyer provides you a method to opt‐out specific users from AppsFlyer analytics.
    Mobile AppsFlyer provides you a method to opt-out specific users from AppsFlyer Analytics. This method complies with the latest privacy requirements and complies with Facebook data and privacy policies.

    • Tracking - Default is checked, meaning tracking is enabled by default.

  • Set Tracking - In some extreme cases you might want to shut down all SDK tracking due to legal and privacy compliance. If "False", the SDK will no longer communicate with the servers and stop functioning.

    • Tracking - Default is checked, meaning the SDK is enabled and functional.

  • Get AppsFlyer UID - Get AppsFlyer’s proprietary Device ID. The AppsFlyer Device ID is the main ID used by AppsFlyer in Reports and APIs.

  • Get SDK Version - Get the current SDK version.

Cross Promotion :

  • Track Cross Promotion - Call to track an impression. Make sure to use the promoted App ID as it appears within the AppsFlyer dashboard.
    For more details about Cross-Promotion tracking, kindly click here.

    • App ID - The promoted application id. For example: "com.myandroid.app".

    • Campaign - The promoted campaign.

  • Add Open Store Parameter - Add an additional parameter to the next "Track and Open Store" action.

    • Parameter Name - The name of the parameter.

    • Parameter Value - The value of the parameter.

  • Track and Open Store - Call to track the click and launch the app store's app page.
    Use this call to track the click and launch the app store's app page (via the Mobile Browser).

    • App ID - The promoted application id. For example: "com.myandroid.app".

    • Campaign - The promoted campaign.

  • Track and Open Store (JS) - Call to track the click and launch the app store's app page.
    Use this call to track the click and launch the app store's app page (via the Mobile Browser).
    This is similar to the Track and Open Store action, but with Construct 3's JS Scripting support. You can declare here the cross-promotion parameters using JavaScript or JSON.

    • App ID - The promoted application id. For example: "com.myandroid.app".

    • Campaign - The promoted campaign.

    • Parameter JS - The parameters in JSON string. [For the Scripting Feature.]​​

Conditions

General :

  • On Initialize Success - Trigger fires if the initialization of the Mobile AppsFlyer SDK succeeded.

  • On Initialize Failure - Trigger fires if the initialization of the Mobile AppsFlyer SDK failed.

  • Is Initialized - Checks if the Mobile AppsFlyer SDK is fully initialized.

  • Is SDK Ready - Checks if the Mobile AppsFlyer SDK is ready to initialize.


Tools :

  • On Get AppsFlyer UID - Trigger fires if the retrieval of the AppsFlyer UID is completed.

  • On Get SDK Version - Trigger fires if the retrieval of the SDK version is completed.

Expressions

Expressions.png

General :

  • Response - The response of any trigger, in JSON string.

Tools :

  • GetAppsFlyerUID - Retrieve the AppsFlyer UID after the completion of the "Get AppsFlyer UID" action.

  • GetSDKVersion - Retrieve the AppsFlyer SDK version after the completion of the "Get SDK Version" action.

Properties

Properties.png

Configuration - The object configuration section of the addon.

  • Debug Mode - Check to enable debug logs in the console.

Tutorial Project

Sample Setup Project

Specifications

  • Instructions - The sample project has comments and instructions on how to use the addon and its features.

  • A.C.E. Coverage - It covers the implementation of each action, condition and expression.

  • Tips and Tricks - It provides some tips and tricks to a better use of the addon and of the event-sheet system alongside it.

Supporters

Only

Sample IAP Tracking

Sample Setup Project

Specifications

  • Instructions - The sample project has comments and instructions on how to use the addon and its features.

  • A.C.E. Coverage - It covers the implementation of each action, condition and expression.

  • Tips and Tricks - It provides some tips and tricks to a better use of the addon and of the event-sheet system alongside it.

Supporters

Only

Test Project

Sample Setup Project

Specifications

  • Instructions - The sample project has comments and instructions on how to use the addon and its features.

  • A.C.E. Coverage - It covers the implementation of each action, condition and expression.

  • Tips and Tricks - It provides some tips and tricks to a better use of the addon and of the event-sheet system alongside it.

Supporters

Only

 
 
 
 
 
 
 
 

Additional Notes

Sample IAP Project

Parameters.png
  • The AppsFlyer SDK does not accept number parameter values. Although, in Construct 3, the addon simplifies the process.

  • You can input numbers, then is automatically converted into a string in the background.

  • The AppsFlyer SDK accepts boolean values, but in Construct 3 events, you can input "true" or "false" in string to set the same parameter value.

  • The AppsFlyer SDK also accepts list (array) values, but at the moment the addon doesn't support that via events. You can still use the JS Scripting feature to set a list parameter value.

Sample IAP Project (JS)

Parameters (JS).png
  • The Mobile AppsFlyer supports the Scripting Feature, you can input the parameter values here.

  • It supports strings, booleans and lists (array) as event parameter values.

 
 

Get the tools

for your pro games!

Constuct Master Collection - Itch.io
Constuct Master Collection - Discord
Constuct Master Collection - Construct 3

© Construct Master Collection 2020 • All rights reserved

Contact Information: