Google Play Store Direct Integration for Android

Insert Affiliate's direct Google Play Store integration is currently in beta.

Real-time Developer Notifications

Real-time Developer Notifications RTDN are required to enable Insert Affiliate to track purchase events.

1. Set Your Insert Affiliate Purchase Verification Method

Within the Insert Affiliate settings, set your In-App Purchase Verification Method to "I don't use a Receipt Validatior (Native App Store / Google Play Integration)."

  • After changing this setting, a new section will appear called "Google Play Store Pub/Sub Endpoint URL", containing a URL - you will need this later.

2. Enable the Google Cloud Pub/Sub for Your Project

  1. Go to the Google Cloud Console, logging in with the Google account associated with your app.
  2. Create a new project or select an existing project.
  3. Enable the Cloud Pub/Sub API which can be found here

3. Create a Pub/Sub Topic

  1. Create a new topic here, setting the Topic ID as insert-affiliate.
  2. Leave the default settings and click Create.

4. Create a Service Account

  1. Go to the Service Accounts page in the Google Cloud Console.
  2. Click Create Service Account, providing a name (e.g. insert-affiliate) and click Create.
  3. Copy the email address of the service account you just created.

5. Create a Key for the Service Account

  1. Click on the service account you just created.
  2. Click Add Key > Create new key.
  3. Select JSON and click Create.
  4. Upload the Service Key that was downloaded to the Insert Affiliate settings page under Google Service Account Key.
  5. Click Save.

5.1 Assign IAM Roles to the Service Account

Before proceeding, you need to grant the correct permissions to the service account in Google Cloud IAM.

  1. Go to Google Cloud IAM & Admin.
  2. Find the Service Account you just created, if one does not exist, select Grant Access and set the New Principal to the email address of the service account you created in step 4.
  3. Click Edit Permissions.
  4. Assign the following roles:
  • Pub/Sub Admin (for handling Google Play notifications)
  1. Click Save to apply the changes.

Now, your service account has the required permissions to interact with

6. Configure the Pub/Sub Permissions

  1. Go to the Topics section in the Google Cloud Console, selecting the insert-affiliate topic that you just created.
  2. In the Topic Settings, click Add Principal.
  3. Paste the email address of the service account you created in step 4.
  4. In the Role dropdown, select Pub/Sub Publisher and click Save.

7. Add Google Play Notification Account to the Pub/Sub Topic

  1. Go to the Topics section in the Google Cloud Console, selecting the insert-affiliate topic that you just created.
  2. In the Topic Settings, click Add Principal.
  3. Paste the email address google-play-developer-notifications@system.gserviceaccount.com
  4. In the Role dropdown, select Pub/Sub Publisher and click Save.

8. Create a Subscription

  1. Go to the Subscriptions section in the Google Cloud Console.
  2. Select the insert-affiliate topic.
  3. Click Edit.
  4. Change the Delivery Type to Push.
  5. Paste the Google Play Store Pub/Sub Endpoint URL from the Insert Affiliate settings, retrieved in Step 1, into the Push Endpoint field.
  6. Click Update to save the changes.

9. Enable the Google Play Android Developer API

Before granting permissions, ensure that the Google Play Android Developer API is enabled:

  1. Go to the Google Play Android Developer API page in the Google Cloud Console.
  2. Click Enable API.

10. Grant Permissions in the Google Play Console

  1. Go to Users and Permissions in the Google Play Console.
  2. Click Invite new users.
  3. Enter the email address of the service account you created in step 4.
  4. Select the app you want to grant permissions for
  • Grant the Financial Data: View Financial Data and Manage Orders and Subsciprtions permission.
  1. Press Apply to save the changes.

10.1 Refresh Active Subscriptions

If you previously used a different receipt validation method, you may need to deactivate and reactivate your subscriptions in Google Play to ensure they are correctly recognized by Insert Affiliate.

  1. Go to the Google Play Console.
  2. Select your app.
  3. Navigate to Monetise with Play > Subscriptions.
  4. Select each active subscription and temporarily deactivate it.
  5. After a few moments, reactivate the subscriptions.
  6. This forces Google Play to recognize the new Insert Affiliate integration.

11. Enable RTDN Within Your App in the Google Play Console

  1. Go to the Google Play Console.
  2. Select your app.
  3. In the left-hand navigation, select Monetise with Play > Monetisation Setup.
  4. Enable the *Real-time developer notifications checkbox.
  5. Add the Topic Name as projects/{{ProjectID}}/topics/{{TopicID}} (replace {{ProjectId}} and {{TopicID}} with the Google Cloud Project and Topic Id's set earlier.) For the example above, the Topic Name would be projects/insert-affiliate/topics/insert-affiliate.
  • You can find your Google Cloud Project ID here.
  • You can find your Google Cloud Topic ID here.
  1. Notification content should be set to Subscriptions, voided purchases and all one-time products.
  2. Click Save.

12. If You Previously Were Not Validating Receipts

If you previously were not validating receipts, you may need to deactivate and reactivate your subscriptions in Google Play to ensure they are correctly recognised by Insert Affiliate.

  1. Go to the Google Play Console.
  2. Select your app.
  3. Navigate to Monetise with Play > Subscriptions.
  4. Select each active subscription and temporarily deactivate it.
  5. After a few moments, reactivate the subscriptions.
  6. This forces Google Play to recognise the new Insert Affiliate integration.

Integrate the Insert Affiliate SDK

To complete the integration, follow the final integration steps detailed in the Insert Affiliate SDK for your specific platform: