Android Integration

1. Gradle Integration:

Add the repository

maven { url '' }

Add the dependency to our sdk

compile 'com.instal:instal-advertiser-sdk:1.+'

2. Integration:

In your AndroidManifest.xml, add the following elements to define Instal receveir (in the last line insert your api key as value):


        <action android:name=""/>
<meta-data android:name="instal_api_key" android:value="{{ api_key|default:"API_KEY" }}" />

3. Multiple sources tracking support:

In case you are using Google Analytics for campaign tracking your AndroidManifest.xml should look like this:

<service android:name=""/>
<meta-data android:name="instal_delegate_receiver" android:value="" />

In your AndroidManifest.xml you need to remove existing CampaignTrackingReceiver receiver element to avoid conflicts, it will be called by instal receiver thanks to instal_delegate_receiver definition.

4. Advertising Id support

You need to add google play services to your project to use Advertising id. Instructions are available at

Proguard configuration

In case you are using Proguard in you project you must add the following rules to keep Google Play Services classes:

-keep public class * extends android.content.BroadcastReceiver
-keep class {
-keep class {
-keep class$Info {

5. Tracking Events

To track an event you need to call

InstalAnalyticsTracker.getInstance(<context>).trackEvent(String event);

If you want to add numeric value to your event use passing NSNubmer object as value.

InstalAnalyticsTracker.getInstance(<context>).trackEvent(String event, float value);

6. Test

For testing the android integration you have to fire the post installation signal using your adb console:

adb shell am broadcast -a -n {{ store_id|default:"com.instal.advertiser.sdk.demo" }}/com.instal.advertiser.sdk.CampaignReceiver --es "referrer" "{{store_id|default:"STORE_ID"}}" --ez "debug" true


For any question do not hesitate to contact