Install Android Sdk

Use Growlytics Android SDK to track, analyze and engage user from native android apps.
Follow the guidelines to install the Growlytics Android SDK, track events, and see the event data within the Growlytics dashboard.
Step 1: Add Growlytics SDK to your project
Add growlytics-android-sdk dependency to your project.
For enable FCM support, you will need to add follwoing dependencies in your application’s build.gradle file. You will also have to add the FCM generated google-services.json file to your project.
build.grdle
1

{
2
    dependencies {
3
        implementation 'com.growlytics.android.sdk:growlytic-android-sdk:1.0.4'
4
        implementation 'com.google.firebase:firebase-messaging:17.3.3'
5
        implementation 'com.google.android.gms:play-services-base:16.0.1'
6
        implementation 'com.android.support:support-v4:28.0.0'
7
    }
8
    
9
    // at the end of the build.gradle file
10
    apply plugin: 'com.google.gms.google-services'
11
}
Copied!
Once you have added dependencies on your build.gradle file, sync your project by clicking on Tools > Android > Sync Project With Gradle Files button.
Step 2: Configure Growlytics credentials in AndroidManifest.xml
To  send data to your Growlytics account, you will need to add your Growlytics account's credentials in the AndroidManifest.xml file in your application.
As shown in snippet below, add your Growlytics project id and api key to your AndroidManifest.xml, within the  tags.
AndroidManifest.xml
1
<!-- Growlytics Project Id -->
2
<meta-data
3
    android:name="GROWLYTICS_PROJECT_ID"
4
    android:value="Growlytics Project Id"/>
5
​
6
<!-- Growlytics API Key -->
7
<meta-data
8
    android:name="GROWLYTICS_API_KEY"
9
    android:value="Growlytics Project Api Key"/>
10
    
11
<!-- Growlytics Project Env - Used for debugging integration -->
12
<meta-data
13
    android:name="GROWLYTICS_ENV"
14
    android:value="production"/>
15
​
16
<!-- Growlytics Enable/Disable - Enbled by default if not provided-->
17
<meta-data
18
    android:name="GROWLYTICS_DISABLED"
19
    android:value="1"/>
20
​
Copied!
Step 3: Add required permissions in AndroidManifest.xml
At the root of your manifest file inside <manifest> file, add following permissions.
AndroidManifest.xml
1
<!-- Required to allow the app to send events and user profile information -->
2
<uses-permission android:name="android.permission.INTERNET"/>
3
​
4
<!-- Recommended so that Growlytics knows when to attempt a network call -->
5
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
Copied!
Step 4: Enable Tracking by Adding Permissions
In your AndroidManifest.xml file, add the following snippet within the  tags.
1
<application
2
    android:label="@string/app_name"
3
    android:icon="@drawable/ic_launcher"
4
    android:name="com.growlytics.android.sdk.Application">
Copied!
Make sure you have specified android:name as com.growlytics.android.sdk.Application.
Step 5: Build & Run Your Application
Build and run your application.
Open your Growlytics dashboard. Goto People > Customers. If you successfully integrated the Growlytics SDK, you will see a new customer there.
Step 6: Setup Event Tracking
An Event is an action that user  takes in your mobile or web app. Growlytics records the event on the User Profile, using an Event Name and optional associated key:value-based Event Properties. You can then segment users, target and personalize messaging based on both the Event Name and specific Event Properties.
1
// Prepare Attributes
2
Map<String, Object> eventDetails = new HashMap<>();
3
eventDetails.put("Product Name", "Mens Polo T-shirt with Collor, Yellow");
4
eventDetails.put("Category", "Mens Accessories");
5
eventDetails.put("Sub Category", "Polo T-shirts");
6
eventDetails.put("Price", 999.99);
7
eventDetails.put("Date", new java.util.Date());
8
​
9
// Put them in growlytics user profile
10
Analytics.getInstance(this).track("Product Viewed", eventDetails);
Copied!
​
Step 7: User Profile Information
 A User is automatically created in Growlytics platrorm when user opens the app first time.
Initially, there are very few properties captured for User Profile like city, country, device info etc. Depending on your product purpose, You can add more information to user profile with Analytics.identify()  method. 
There are two ways you can do this 
1.If your customer has logged in with your system's user id, then you can pass customer's id which is in your system. This will help you keeping unified profile across web, mobile and other platforms. An example is given below.
1
// Prepare Attributes
2
Map<String, Object> userAttributes = new HashMap<>();
3
attributes.put("has_subscribed", true);
4
attributes.put("total_cart_visits", 12);
5
​
6
// Put them in growlytics user profile
7
Analytics.getInstance(this).identify(userAttributes);
Copied!
2.Another way, if user has not logged in yet but you still want to keep information as anonymous user, you can do that as well. An example is given below.
1
// Prepare Attributes
2
Map<String, Object> userAttributes = new HashMap<>();
3
attributes.put("has_subscribed", true);
4
attributes.put("total_cart_visits", 12);
5
​
6
// Put them in growlytics user profile
7
Analytics.getInstance(this).identify(userAttributes);
Copied!

Sdk Integrations - Previous

Android SDK (Coming Soon)

Identify Customers

Last modified 2yr ago

Copy link

Contents

Step 1: Add Growlytics SDK to your project

Step 2: Configure Growlytics credentials in AndroidManifest.xml

Step 3: Add required permissions in AndroidManifest.xml

Step 4: Enable Tracking by Adding Permissions

Step 5: Build & Run Your Application

Step 6: Setup Event Tracking

Step 7: User Profile Information