Directe integratie met Google Play Store voor Android

We ondersteunen abonnementen en eenmalige aankopen (in-app producten). In stap 11 hieronder zet je meldingen voor beide aan, en beide worden op dezelfde manier toegeschreven en leveren op dezelfde manier commissie op.

Realtime ontwikkelaarsmeldingen

Realtime ontwikkelaarsmeldingen RTDN zijn nodig zodat Insert Affiliate aankoopgebeurtenissen kan bijhouden.

1. Stel je methode voor aankoopverificatie in Insert Affiliate in

Stel in de instellingen van Insert Affiliate (tabblad Integraties) je Verificatiemethode voor in-app aankopen in op "Ik gebruik geen receipt validator (Native App Store / Google Play-integratie)."

  • Nadat je deze instelling hebt gewijzigd, verschijnt er een nieuwe sectie met de naam "Google Play Store Pub/Sub Endpoint URL" met daarin een URL. Die heb je later nodig.
Sectie Aankoopverificatie in de instellingen van het Insert Affiliate-dashboard met de keuzelijst voor de verificatiemethode gemarkeerd

Klik om op volledige grootte te bekijken

2. Schakel Google Cloud Pub/Sub in voor je project

  1. Ga naar de Google Cloud Console en log in met het Google-account dat aan je app is gekoppeld.
  2. Maak een nieuw project aan of selecteer een bestaand project.
  3. Schakel de Cloud Pub/Sub API in, die je hier vindt

3. Maak een Pub/Sub-topic aan

  1. Maak hier een nieuw topic aan en stel de Topic ID in op insert-affiliate.
  2. Laat de standaardinstellingen staan en klik op Create.

4. Maak een serviceaccount aan

  1. Ga naar de pagina Service Accounts in de Google Cloud Console.
  2. Klik op Create Service Account, geef een naam op (bijv. insert-affiliate) en klik op Create.
  3. Kopieer het e-mailadres van het serviceaccount dat je zojuist hebt aangemaakt.

5. Maak een sleutel aan voor het serviceaccount

  1. Klik op het serviceaccount dat je zojuist hebt aangemaakt.
  2. Klik op Add Key > Create new key.
  3. Selecteer JSON en klik op Create.
  4. Upload de gedownloade servicesleutel op de pagina instellingen van Insert Affiliate (tabblad Integraties) onder Google-serviceaccountsleutel.
  5. Klik op Opslaan.

5.1 Wijs IAM-rollen toe aan het serviceaccount

Voordat je verdergaat, moet je het serviceaccount de juiste rechten geven in Google Cloud IAM.

  1. Ga naar Google Cloud IAM & Admin.
  2. Zoek het Service Account dat je zojuist hebt aangemaakt. Bestaat het niet, selecteer dan Grant Access en stel de New Principal in op het e-mailadres van het serviceaccount dat je in stap 4 hebt aangemaakt.
  3. Klik op Edit Permissions.
  4. Wijs de volgende rollen toe:
  • Pub/Sub Admin (voor het verwerken van Google Play-meldingen)
  1. Klik op Save om de wijzigingen toe te passen.

Je serviceaccount heeft nu de benodigde rechten om te communiceren met

6. Configureer de Pub/Sub-rechten

  1. Ga naar de sectie Topics in de Google Cloud Console en selecteer het topic insert-affiliate dat je zojuist hebt aangemaakt.
  2. Klik in de Topic Settings op Add Principal.
  3. Plak het e-mailadres van het serviceaccount dat je in stap 4 hebt aangemaakt.
  4. Selecteer in de keuzelijst Role de optie Pub/Sub Publisher en klik op Save.

7. Voeg het Google Play-meldingsaccount toe aan het Pub/Sub-topic

  1. Ga naar de sectie Topics in de Google Cloud Console en selecteer het topic insert-affiliate dat je zojuist hebt aangemaakt.
  2. Klik in de Topic Settings op Add Principal.
  3. Plak het e-mailadres [email protected]
  4. Selecteer in de keuzelijst Role de optie Pub/Sub Publisher en klik op Save.

8. Maak een subscription aan

  1. Ga naar de sectie Subscriptions in de Google Cloud Console.
  2. Selecteer het topic insert-affiliate.
  3. Klik op Edit.
  4. Wijzig het Delivery Type in Push.
  5. Plak de Google Play Store Pub/Sub Endpoint URL uit de instellingen van Insert Affiliate, die je in stap 1 hebt opgehaald, in het veld Push Endpoint.
  6. Klik op Update om de wijzigingen op te slaan.

9. Schakel de Google Play Android Developer API in

Zorg er voordat je rechten toekent voor dat de Google Play Android Developer API is ingeschakeld:

  1. Ga naar de pagina Google Play Android Developer API in de Google Cloud Console.
  2. Klik op Enable API.

10. Ken rechten toe in de Google Play Console

  1. Ga naar Users and Permissions in de Google Play Console.
  2. Klik op Invite new users.
  3. Voer het e-mailadres in van het serviceaccount dat je in stap 4 hebt aangemaakt.
  4. Selecteer de app waarvoor je rechten wilt toekennen
  • Ken het recht Financial Data: View Financial Data and Manage Orders and Subsciprtions toe.
  1. Klik op Apply om de wijzigingen op te slaan.

10.1 Vernieuw actieve abonnementen

Als je eerder een andere methode voor receipt-validatie gebruikte, moet je mogelijk je abonnementen deactiveren en opnieuw activeren in Google Play, zodat Insert Affiliate ze correct herkent.

  1. Ga naar de Google Play Console.
  2. Selecteer je app.
  3. Ga naar Monetise with Play > Subscriptions.
  4. Selecteer elk actief abonnement en deactiveer het tijdelijk.
  5. Activeer de abonnementen na enkele ogenblikken opnieuw.
  6. Hierdoor herkent Google Play de nieuwe Insert Affiliate-integratie.

11. Schakel RTDN in voor je app in de Google Play Console

  1. Ga naar de Google Play Console.
  2. Selecteer je app.
  3. Selecteer in de navigatie aan de linkerkant Monetise with Play > Monetisation Setup.
  4. Vink het selectievakje *Real-time developer notifications aan.
  5. Voeg de Topic Name toe als projects/{{ProjectID}}/topics/{{TopicID}} (vervang {{ProjectId}} en {{TopicID}} door de ID's van het Google Cloud Project en het Topic die je eerder hebt ingesteld). Voor het voorbeeld hierboven is de Topic Name projects/insert-affiliate/topics/insert-affiliate.
  • Je Google Cloud Project ID vind je hier.
  • Je Google Cloud Topic ID vind je hier.
  1. Stel de inhoud van de meldingen in op Subscriptions, voided purchases and all one-time products.
  2. Klik op Save.

12. Als je eerder geen receipts valideerde

Als je eerder geen receipts valideerde, moet je mogelijk je abonnementen deactiveren en opnieuw activeren in Google Play, zodat Insert Affiliate ze correct herkent.

  1. Ga naar de Google Play Console.
  2. Selecteer je app.
  3. Ga naar Monetise with Play > Subscriptions.
  4. Selecteer elk actief abonnement en deactiveer het tijdelijk.
  5. Activeer de abonnementen na enkele ogenblikken opnieuw.
  6. Hierdoor herkent Google Play de nieuwe Insert Affiliate-integratie.

Integreer de Insert Affiliate SDK

Volg om de integratie af te ronden de laatste integratiestappen die beschreven staan in de Insert Affiliate SDK voor jouw platform: