APP INVITES FOR ANDROID - Droidcon tunisia

Let's your users share your App with Friends: APP INVITES
FOR ANDROID

Story Time!

1. Why Should I care ? 2. How do I
use it 3. Let's measure it

@ewilly1 Android Developer

Why Should I care ?

Word of mouth Legacy

We (USERS) care about “Happiness only real when shared.” Christopher
McCandless

Bad and Good Pattern Don’t be annoying

Bad and Good Pattern The smart way: be ready be
kind

Google App Invite API

How does it work ?

Let’s add it to our app Prepare Setup Configuration File
Code

Prepare

Setup gradle APP compile 'com.google.android.gms:play-services-appinvite:8.4.0' PROJECT classpath 'com.google.gms:google-services:1.5.0-beta2'

Configuration File Google developer console Enable App Invite API SHA-1
key Download your file

https://developers.google.com/mobile/add?platform=android

Code 1. Connect Google Client API with APP Invite Service
Enabled 2. Start App Invite Intent 3. handle the result in the callback 4. Check if someone installed the app from an invitation

mGoogleApiClient = new GoogleApiClient.Builder(this) .addApi(AppInvite.API) .enableAutoManage(this, this) .build(); Connection

mGoogleApiClient = new GoogleApiClient.Builder(this) .addApi(AppInvite.API) .enableAutoManage(this, this) .build();

public void onConnectionFailed(ConnectionResult connectionResult) { Log.d(TAG, "onConnectionFailed:" + connectionResult); showMessage(getString(R.string.google_play_services_error));
} Connection Failed Callback

private void onInviteClicked() { Intent intent = new AppInviteInvitation.IntentBuilder(getString(R.string.invitation_title)) .setMessage(getString(R.string.invitation_message))
.setDeepLink(Uri.parse(getString(R.string.invitation_deep_link))) .setCustomImage(Uri.parse(getString(R.string.invitation_custom_image))) .setCallToActionText(getString(R.string.invitation_cta)) .build(); startActivityForResult(intent, REQUEST_INVITE); } Send invitation

Intent intent = new AppInviteInvitation.IntentBuilder(getString(R.string. invitation_title)) ... .setOtherPlatformsTargetApplication( AppInviteInvitation.IntentBuilder.PlatformMode.PROJECT_PLATFORM_IOS, getString(R.string.ios_app_client_id))
... .build(); Send invitation to iOs phones

private void onInviteClicked() { Intent intent = new AppInviteInvitation.IntentBuilder(getString(R.string.invitation_title)) .setMessage(getString(R.string.invitation_message))
.setDeepLink(Uri.parse(getString(R.string.invitation_deep_link))) .setEmailHtmlContent("<html><body>" + "<h1>App Invites</h1>" + "<a href=\"%%APPINVITE_LINK_PLACEHOLDER%%\">Install Now!</a>" + "<body></html>") .setEmailSubject(getString(R.string.invitation_subject)) .build(); startActivityForResult(intent, REQUEST_INVITE); } Custom Email content with html

protected void onActivityResult(int requestCode, int resultCode, Intent data) { super.onActivityResult(requestCode,
resultCode, data); if (requestCode == REQUEST_INVITE) { if (resultCode == RESULT_OK) { String[] ids = AppInviteInvitation.getInvitationIds(resultCode, data); Log.d(TAG, getString(R.string.sent_invitations_fmt, ids.length)); } else { showMessage(getString(R.string.send_failed)); } } } Send Invitation Result

protected void onCreate(Bundle savedInstanceState) { boolean autoLaunchDeepLink = true; AppInvite.AppInviteApi.getInvitation(mGoogleApiClient,
this, autoLaunchDeepLink) .setResultCallback( new ResultCallback<AppInviteInvitationResult>() { @Override public void onResult(AppInviteInvitationResult result) { Log.d(TAG, "getInvitation:onResult:" + result.getStatus()); } }); } Receive an invitation

Let's measure it

Overview of Google Analytics API measure user activity Collection -
Configuration - Processing - Reporting

Integrating Google Analytics API to measure your invites Prepare Setup
Get tracking Id Configuration File Code

Prepare

Setup gradle PROJECT classpath 'com.google.gms:google-services:2.0.0-alpha6' APP apply plugin: 'com.google.gms.google-services' compile
'com.google.android.gms:play-services-analytics:8.4.0'

Setup manifest <uses-permission android:name="android.permission.INTERNET"/> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/> <application android:name="AnalyticsApplication"> ... </application>

Tracking ID Create Account Add a Mobile Project to track
-> Tracking ID Configure Analytics to process App Invites data Create App Invite DashBoard

Configuration File Google developer console Enable Analytics API Download your
file

https://developers.google.com/mobile/add?platform=android

Code 1. Create a Tracker 2. Generate Event (sent and
received invites)

Application level private Tracker mTracker; synchronized public Tracker getDefaultTracker() {
if (mTracker == null) { GoogleAnalytics analytics = GoogleAnalytics.getInstance(this); mTracker = analytics.newTracker(R.xml.global_tracker); } return mTracker; }

Invite sent // Get tracker. AnalyticsApplication application = (AnalyticsApplication) getApplication();
mTracker = application.getDefaultTracker(); // Build and send an Event. t.send(new HitBuilders.EventBuilder() .setCategory(getString(R.string.invitation)) .setAction(getString(R.string.sent)) .build());

Invite received AnalyticsApplication application = (AnalyticsApplication) getApplication(); mTracker = application.getDefaultTracker();
// Build and send an Event. t.send(new HitBuilders.EventBuilder() .setCategory(getString(R.string.invitation)) .setAction(getString(R.string.accepted)) .build());

Let's see some numbers

Show time

Code:goo.gl/btI6SN Thanks for your attention!

Q & A @ewilly1 Wilfried Mbouenda Mbogne Que le {
code } soit avec toi !

APP INVITES FOR ANDROID - Droidcon tunisia

APP INVITES FOR ANDROID - Droidcon tunisia

More Decks by WillyShakes

Other Decks in Programming

Featured

Transcript