Skip to main content
info
This is non-stable documentation for Android SDK 3.2.0-beta version. For stable documentation, see the Android SDK 3.1.3.
All changes you can check in the changelog.
Version: 3.2.0-beta

Event Tracking

Introduction

Thanks to in-app events, you can track user activity inside your app. You can keep track of events such as registration, passing levels, purchases, etc., as in-app events. The implementation of in-app events is mandatory for all post-install analysis purposes.

Types Of Events

In-app events can be divided into two categories:

  • Basic in-app events are standard in-app events that help you understand user activity inside your app.

Examples:

level1_finished
level2_start
app_login
  • Rich in-app events are the same as basic in-app events but let you get more detailed information about the event through a number of parameters. You will learn more about them in step 1. Through parameters, you can send additional information about the event. For example, you can not only learn that app was opened but also the exact date and time.

Examples:

level1_finished (result)
level2_start (time)
app_login (date)

You need to select the events that best suit your application.

Recommendations
  • For better navigation through reports, we recommend using the same event names in your app across all platforms.
  • Create all kinds of events with a maximum number of details that describe user actions in your application.
  • We recommend using only lower-case alpha-numeric characters (a-z and 0-9) for your in-app event names.

Examples (for other apps):

appodeal_initialized
complete_registration
user_login
tutorial_completion
on_search
content_view
in_app_purchase

Examples (for games):

game_start
game_win
game_end
main_menu_open
game_lose
round_start
round_end
pause_menu_open
design_dialog_open
settings_dialog_open
design_application_changed
level1_complete
appodeal_consent_dialog_open
appodeal_consent_dialog_result

Step 1. How To Track In-app Events

Appodeal SDK allows you to send events to the following analytic services using a single method:

// Create map of event parameters if required
val params = mapOf(
"example_param_1" to "value",
"example_param_2" to 123
)
Appodeal.logEvent(eventName = "appodeal_sdk_test_event", params = params)

Please note

Event parameters can only be strings and numbers, they allow you to send additional information about the event in your app.

Step 2. Configure In-app Events

Some additional steps may be needed on the MMP side to complete events setup.

Appodeal Free Adjust Account

  • If you want to send events to Adjust, contact our support team via email [email protected] or in the live chat and send us the list with event names.

By default, Appodeal SDK sends s2s events to Adjust.

The list of s2s events :

  • dc_cpa_event_d0 - this event includes the ARPU of Day 0 after the app install;
  • dc_cpa_event_d2 - this event includes the ARPU of Day 2 after the app install;
  • dc_cpa_event_d7 - this event includes the ARPU of Day 7 after the app install;
  • dc_cpa_event_d30 - this event includes the ARPU of Day 30 after the app install.
info

If you want to target those s2s events in your UA campaigns, please contact our support team via email [email protected] or in the live chat so we can connect those events with your Traffic Source.

Own Adjust Account

If you want to send events to Adjust you need to create your events on Adjust side according to this guide and send their tokens to us via email [email protected] or in the live chat:

  • Find your app in the dashboard and select your app options caret (^);

  • Select All Settings > Events;

  • Find the Create New Event label at the bottom of the module and enter your event name;

  • Select Create;

  • Send us the token of each event specifying the event name(you can find the token right next to the event in All Settings > Events);

You also need to create some required SDK events presented below:

Required SDK events:

  • hs_sdk_purchase - in-app purchase was validated successfully;
  • hs_sdk_unknown - unknown event;
  • hs_sdk_purchase_error - in-app purchase wasn't validated, error occurred.

Own AppsFlyer Account

  • No additional steps are required.