AppInviteApi

public interface AppInviteApi

The main entry point for interacting with AppInvite invitations. This class provides a method to update invitation status after receiving an invitation id after app installation.

Public Method Summary

abstract PendingResult<Status>
convertInvitation(GoogleApiClient client, String invitationId)
Update the invitation to indicate that the user has taken a key "conversion" action in your app.
abstract PendingResult<AppInviteInvitationResult>
getInvitation(GoogleApiClient client, Activity currentActivity, boolean launchDeepLink)
Get the invitation and optionally use the invitation deep link to launch an activity.
abstract PendingResult<Status>
updateInvitationOnInstall(GoogleApiClient client, String invitationId)
This method was deprecated. Use getInvitation(GoogleApiClient, Activity, boolean) to access AppInvite referrer data rather than implementing a Play Store broadcast receiver.

Public Methods

public abstract PendingResult<Status> convertInvitation (GoogleApiClient client, String invitationId)

Update the invitation to indicate that the user has taken a key "conversion" action in your app. It is up to you to decide what constitutes a user conversion. Common conversion events include a user completing registration, accepting an offer, or sharing an item. Required API: API

Parameters
client The GoogleApiClient to service the call.
invitationId Invitation id received from the play store.
Returns
  • The pending result that indicates if the update succeeded.

public abstract PendingResult<AppInviteInvitationResult> getInvitation (GoogleApiClient client, Activity currentActivity, boolean launchDeepLink)

Get the invitation and optionally use the invitation deep link to launch an activity.

This method should be called in any activity that may be launched from an invitation, either the main activity or for already installed apps any activity with an intent filter matching the deep link.

When the user accepts an invitation and installs the app, getInvitation(GoogleApiClient, Activity, boolean) will update the invitation state to installed and return the invitation data in an intent accessed from AppInviteInvitationResult using getInvitationIntent(). This intent includes the invitation id and a deep link if set when creating the invitation. If launchDeepLink is true, the app is also be re-launched using the deep link, possibly launching into a different activity if there is an intent filter that matches the deep link. If launchDeepLink is false, the returned intent from getInvitationIntent() can alternatively be used to launch the deep link activity when appropriate for the app. Use startActivity(Intent) where the intent supplied is from getInvitationIntent(). Any activity launched while the app is already running should set its launch mode appropriate for the application.

If the app was already installed then AppInviteInvitationResult would also include the invitation data. The activity provided as currentActivity must be the first activity started when the app was launched since it includes the current launch intent. Installed apps will not be re-launched even if launchDeepLink is true since the app would have been initially launched using the deep link.

Alternatively, for already installed apps only, the intent returned from getIntent() in the launched activity already has the invitation data. If hasReferral(Intent) returns true, then the app is already installed and the invitation data can be accessed directly from this intent without calling getInvitation(GoogleApiClient, Activity, boolean).

Parameters
client Connected GoogleApiClient built with AppInvite API.
currentActivity The activity launched in the currently running app.
launchDeepLink If true, launch the app with the deep link set as the data of the launch intent if initial install.
Returns

public abstract PendingResult<Status> updateInvitationOnInstall (GoogleApiClient client, String invitationId)

This method was deprecated.
Use getInvitation(GoogleApiClient, Activity, boolean) to access AppInvite referrer data rather than implementing a Play Store broadcast receiver.

Update an invitation to indicate that your application has been installed after the user accepted the invitation. Your app will receive the invitation id via a broadcast receiver implemented by you. Learn more about processing the broadcast in AppInviteReferral and see sample application for an example of how to implement the broadcast receiver.

Required API: API

Parameters
client The GoogleApiClient to service the call.
invitationId Invitation id received from the play store.
Returns
  • The pending result that indicates if the update succeeded.

Send feedback about...

Need help? Visit our support page.