FireOS

Before starting your application instrumentation, ensure that you have created an app and have an appKey

Install

We recommend using Gradle or Maven when installing the Pyze SDK as it is the easiest and ensures you are using the latest stable version.

Add the Pyze Repository in the Project build.gradle file

In Android Studio, add the Pyze repository to all projects in the Project build.gradle file:

allprojects {
    repositories {
        jcenter()
        maven {
            url  "http://pyze.bintray.com/pyze-android"
        }
    }
}

Add the Pyze Dependency in the App build.gradle file

Add the pyze library compile statement under dependencies in the App build.gradle:

dependencies {
    compile 'com.pyze:PyzeLibrary:---Latest-Version---'
    // Usage example: compile 'com.pyze:PyzeLibrary:4.+'
}

The latest version can always be obtained from Bintray here

minSdkVersion 15

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>

Initialize

Add the PyzeAppKey in the Application Tag in the AndroidManifest.xml:

<meta-data android:name="PyzeAppKey" android:value="PYZE_APP_KEY"/>

Import the pyze library in the Main Activity or Application file of the project.

import com.pyze.android.*;

Add the following Pyze.initialize statement in the Main Activity’s onCreate method or preferably add intiliaze call inside Application’s onCreate method.

public void onCreate(Bundle savedInstanceState) {
    ...
    Pyze.initialize(getApplication());
}

Custom Events

Custom events allow you to easily track unique user actions within your app.

Event

import com.pyze.android.PyzeEvents;
import java.util.HashMap;


PyzeEvents.postCustomEvent("Blog Read");

This allows you to track when a user executed an action, for a simple count of how often that event is occurring.

Event with Attributes

Attributes are any key-value pair that you can attach to an event. You can have up to 99 attributes with any event. It is highly recommended to follow our Best Practices and heavily rely on attributes to make your instrumentation as minimal and useful as possible. In a typical application, you should have many more attributes than events.

import com.pyze.android.PyzeEvents;
import java.util.HashMap;

// Create Hashmap with key value pairs of custom attributes and post with postCustomEventWithAttributes
HashMap <String, String> attributes = new HashMap<String, String>();
attributes.put("screen", "Home");
attributes.put("blog Id", 50);

PyzeEvents.postCustomEventWithAttributes("Blog Read", attributes);

Timed Events

Timing how long a user takes to complete an action is a common usecase for Pyze. The SDk has built-in handling for this, by allowing you to start a timer, and then send a custom event at the completion of that action.

• startTimerForEvent - Start the timer with a name
• postTimedEvent - End the timer by referencing the same name. The time in milliseconds will automatically be attached to this event.
• postTimedEventWithAttributes - End the timer by referencing the same name and attaching any attributes as well. The time in milliseconds will automatically be attached to this event.

import com.pyze.android.PyzeEvents;
import java.util.HashMap;

//Start timer for event
PyzeEvents.startTimerForEvent("Screen Load Time");

//Post timed event. 
//Note : The event name attribute for the `startTimerForEvent` and  `postTimedEvent` should match.
PyzeEvents.postTimedEvent("Screen Load Time");

//Post timed event with attributes
HashMap <String, String> attributes = new HashMap<String, String>();
attributes.put("device", "Nokia 4.2");
attributes.put("location", "CA");
PyzeEvents.postTimedEvent("Screen Load Time", attributes);

Profile

Profiles are a powerful way to add data about your users to Pyze. Use profiles to add data that is not specific to a point in time (events) and are attached to a specific user.

When a user logs in to your app, call setUserProfile to identify them to Pyze. Any events that happen after they are identified, will be attributed to this user. You should only call this method once upon the initial login of a session.

You can optionally include profile attributes.

Pyze built-in profile attributes get special handling in the pyze UI, and we will attempt to discern the data type for custom attributes based on the data recieved. There is no difference between the built-in attributes and custom ones outside of formatting applied.

//Create Pyze Profile Attributes object
HashMap <String, String> pyzeProfileAttributes = new HashMap<String, String>();
pyzeProfileAttributes.put("email_id", "xyz@abc.com");
pyzeProfileAttributes.put("date_of_birth", "1984-06-01");
pyzeProfileAttributes.put("first_name", "John");
pyzeProfileAttributes.put("last_name", "Jacobs");

//Create Custom Profile Attributes object
HashMap <String, String> customProfileAttributes = new HashMap<String, String>();
customProfileAttributes.put("age", 29);
customProfileAttributes.put("picode", "23200");
customProfileAttributes.put("city", "XYZ");

//Call the setUserProfile API
PyzeIdentity.setUserProfile(userId,pyzeProfileAttributes,customProfileAttributes);

Pyze profile attributes

Updating an existing user Profile

To update user profile attributes which are already set, use the following api.

Note : Do not call this api before calling setUserProfile.

//Create Pyze Profile Attributes object
HashMap <String, String> pyzeProfileAttributes = new HashMap<String, String>();
pyzeProfileAttributes.put("email_id", "xyz@abc.com");
pyzeProfileAttributes.put("date_of_birth", "1984-06-01");
pyzeProfileAttributes.put("first_name", "John");
pyzeProfileAttributes.put("last_name", "Jacobs");

//Create Custom Profile Attributes object
HashMap <String, String> customProfileAttributes = new HashMap<String, String>();
customProfileAttributes.put("age", 29);
customProfileAttributes.put("picode", "23200");
customProfileAttributes.put("city", "XYZ");
//Call the updateUserProfileAttributes API
PyzeIdentity.updateUserProfile(pyzeProfileAttributes,customProfileAttributes);

Logging out a user

Call this api when a user logs out. Event sent after this call will have no identity attached, and will be attributed to an anonymous user.

PyzeIdentity.resetUserProfile(); 

User Privacy

Pyze provides APIs to allow end-users to Opt out of Data Collection and also instruct the Pyze system to forget a user’s data.

setUserOptOut

Allows end-users to opt out from data collection. Opt-out can be toggled true or false.

Pyze.setUserOptOut(true) 

To resume user data collection set value to false

deleteUser

Allows end-users to opt out from data collection and delete the user in the Pyze system. We recommend you confirm this action as once a user is deleted, this cannot be undone.

Pyze.deleteUser(true) 

In-App Notifications

In-app notifications allow app businesses to reach out to app users when they use your app. In-App notifications are built-in to the pyze sdk and have no additional dependecies.businesses to reach out to users from manually from Dynamic Funnels and Intelligence Explorer, and automatically based on workflows and campaigns from Growth Automation. In-App notifications can be sent from Campaigns Call the following methed, wherever you want to check for new messages and pop-up a modal with the notification:

Pyze.showInAppNotification(this); //`this` here is an activity context.

Attribution Tracking

Acquisition source attribution allows for app developers to understand the referring source to the Play Store for application installs.

The ref_id is a series of specific key / value pairs that must be included in the referring URL to Google Play. The keys you can use are

• Campaign Source (utm_source),
• Campaign Medium (utm_medium),
• Campaign Term (utm_term),
• Campaign Content (utm_content) and
• Campaign Name (utm_name).
• Campaign Source, Campaign Medium, and Campaign Name are required fields. You can build custom referral URLs using the URL form builder.

This is what a referring URL might look like:

http://play.google.com/details?id=your.package.name&utm_source=google&utm_medium=banner&utm_campaign=mycampaign

To enable install source tracking, add the following lines to the AndroidManifest.xml before the tag:

<receiver android:name="com.pyze.android.PlayRefReceiver" android:exported="true">
    <intent-filter>
        <action android:name="com.android.vending.INSTALL_REFERRER" />
    </intent-filter>
</receiver>

Debugging and Logging

Setting the log level

The Initialize API accepts an optional 2nd parameter to set the loglevel. To control the debug log level. The Default log level for the Pyze SDK is Minimal.

Following are the logging level options you could use.

PyzelogLevelMinimal
PyzelogLevelWarnings
PyzelogLevelErrors
PyzelogLevelAll

Example: Pyze.initialize(getApplication(), "PyzelogLevelMinimal");

Multidex support

When multidex is enabled, create multidex-config.pro file and add the following line inside it -keep class com.pyze.android.** { *; }. Update app/build.gradle as follows

android {
    buildTypes {
        release {
            multiDexKeepProguard file('multidex-config.pro')
            ...
        }
    }
}

More details can be found in the following link https://developer.android.com/studio/build/multidex#keep

API Reference

Full API reference available here