By adding the Google+ Sign-In button to your web site, you can automatically prompt your users to download your Android app over the air to their Android devices. To enable this feature, you must use the same Google APIs Console project for your Web and Android clients, and configure your web app's sign-in button.
For your app to be eligible for this feature, it must be published in the Google Play store, be free, and it must meet a quality threshold. This threshold is determined by Google and is subject to change. New apps might take some time to surpass the quality threshold.
Configure your Google APIs Console project
Google uses the APIs Console to configure access for apps to communicate with the Google APIs. For direct app installs, you must use the same project for your Web and Android apps. This configuration also enables deep linking feature so you should include your iOS app in the same project.
- Launch the Google APIs Console .
- In the Services pane, enable the Google+ API and any other API that your apps require.
- In the API Access pane, you will create a client ID for each
supported platform that you want to integrate Google+ services, including
direct app installs and deep linking. If you have multiple Android apps, the
order that you define your client IDs determine which app is installed.
- For the Android app that you want your users to be prompted to download, create the OAuth 2.0 client ID. Choose Installed application and Android as the application type. Refer to the quick start for additional details about this step.
- For your web app, create another OAuth 2.0 client ID and select Web application as the type. Refer to the quick start for additional details about this step.
- If you have additional clients, such as a paid version of your Android app or an iOS app, create client IDs for those apps in this same project as well. This grouping enables deep linking to work across your mobile apps if you enable it for your client IDs.
Configure your web app
Your web app must use the Google+ Sign-In button to prompt your
web site users to download your app the first time that they sign in. This
feature is enabled by adding the
parameter to your sign-in
- Add a sign-in button to your app using either the
HTML button or programmatically using the
- Add the
data-apppackagenameparameter to your HTML button or the
apppackagenameparameter to your object parameters. Specify your Android app's package name as the value. This value should be the same as the value that you entered in the APIs Console for the Android app that you want your users to download.
- If you previously authorized the app for your account, you need to disconnect the app before you can try out the direct app install.
- Refresh your web app to pick up the change to the
- Test your automatic app install by visiting your web app and clicking the sign-in button. First, you should see the authorization dialog. After accepting the authorization dialog, you will see the direct app install prompt.
Testing Android app installs for your web site
If your app meets the eligibility requirements, you can test the over-the-air install feature by signing in to your app for the first time with your account. If you want to test subsequent app installs, you will need to follow these steps:
- Revoke your accounts access tokens for the app. The developer policies require that your app provide users with an option to revoke access from within your app. You can also manually disconnect and revoke tokens.
- Uninstall the app from all of the Android devices where you use the app and signed into it with this account.
- Wait for at least 30 minutes to test the sign-in flow from your web app to try to trigger the app install prompt.