The document provides a comprehensive guide on integrating the Google App Invite API into Android applications, emphasizing the importance of user sharing through invites. It details the setup, including necessary configurations, code snippets, and analytics tracking to measure user engagement with invites. The guide also includes specific technical instructions and troubleshooting tips for developers to effectively implement the functionality.

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

2. Story Time!

3. @ewilly1
Android Developer

4. Why Should I care ?

8. Word of mouth Legacy

9. Word of mouth Legacy

10. Word of mouth Legacy

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

12. Bad and Good Pattern
Please don’t stalk

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

14. Recap

15. Google App Invite API

16. How does it work ?

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

18. Prepare

19. Setup manifest
<meta-data
android:name="com.google.android.gms.version" android:
value="@integer/google_play_services_version" />

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

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

23. 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

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

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

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

27. @Override
protected void onStart() {
super.onStart();
mGoogleApiClient.connect();
}
@Override
protected void onStop() {
super.onStop();
mGoogleApiClient.disconnect();
}

28. @Override
protected void onStart() {
super.onStart();
mGoogleApiClient.connect();
}
@Override
protected void onStop() {
super.onStop();
mGoogleApiClient.disconnect();
}

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

30. 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);
}

31. 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);
}

32. protected void onActivityResult(int requestCode, int resultCode, Intent data) {
super.onActivityResult(requestCode, resultCode, data);
Log.d(TAG, "onActivityResult: requestCode=" + requestCode + ", resultCode=" + resultCode);
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));
}
}
}

33. 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());
}
});
}

34. 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());
}
});
}

35. 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());
}
});
}

36. Recap

37. Numbers matters
Let's measure it

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

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

40. Prepare

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

43. Setup gradle
APP
apply plugin: 'com.google.gms.google-services'
compile 'com.google.android.gms:play-services-analytics:8.3.0'

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

45. Configuration
File
Google developer
console
Enable Analytics API
Download your file

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

47. Application level
public static Tracker tracker() {
return tracker;
}
@Override
public void onCreate() {
super.onCreate();
analytics = GoogleAnalytics.getInstance(this);
tracker = analytics.newTracker(TRACKING-ID);
tracker.enableExceptionReporting(true);
tracker.enableAdvertisingIdCollection(true);
tracker.enableAutoActivityTracking(true);
}

48. Application level
public static Tracker tracker() {
return tracker;
}
@Override
public void onCreate() {
super.onCreate();
analytics = GoogleAnalytics.getInstance(this);
tracker = analytics.newTracker(TRACKING-ID);
tracker.enableExceptionReporting(true);
tracker.enableAdvertisingIdCollection(true);
tracker.enableAutoActivityTracking(true);
}

49. Invite sent
// Get tracker.
Tracker t = ((KitApplication) getApplication()).
tracker();
// Build and send an Event.
t.send(new HitBuilders.EventBuilder()
.setCategory(getString(R.string.category_id))
.setAction(getString(R.string.sent))
.build());

50. Invite sent
// Get tracker.
Tracker t = ((KitApplication) getApplication()).
tracker();
// Build and send an Event.
t.send(new HitBuilders.EventBuilder()
.setCategory(getString(R.string.category_id))
.setAction(getString(R.string.sent))
.build());

51. Invite received
Tracker t = ((MYApplication) getApplication()).
tracker();
// Build and send an Event.
t.send(new HitBuilders.EventBuilder()
.setCategory(getString(R.string.category_id))
.setAction(getString(R.string.accepted))
.build());

52. Let's see some numbers

53. Recap

54. Show time
(Live test)

55. Video
https://goo.gl/Gk0iMY

56. @ewilly1
mbouendaw@yahoo.fr
Code:goo.gl/POESae
Slides:goo.gl/PBkzVm
Thanks for your attention!

57. Q & A