Configuration des abonnements pour les applications Android
Pour que Adjust communique avec Google, vous devez fournir plusieurs identifiants de service. Dans cet article, découvrez comment lier votre projet Google Cloud à Google Play Console et comment l'autoriser à l'aide d'un compte de service.
- Configurez les notifications de développement en temps réel pour Android dans votre compte Google Play. Lorsque vous configurez les notifications de serveur, le Google Play Store notifie Adjust des mises à jour des abonnements à votre application. Cela permet à Adjust de déclencher les événements d'abonnement en temps voulu.
- Créez votre clé publique JSON pour votre compte de service Google. Vous avez besoin de la clé JSON pour connecter votre compte de service Google à Adjust.
- Donnez un accès financier à votre compte de service.
- Connectez votre compte de service Google dans Adjust.
Avant de commencer
Voici ce que vous devez savoir avant de commencer.
Abonnements est proposé sous la forme d'une Solution de croissance Adjust. Contactez votre représentant Adjust ou sales@adjust.com pour l'ajouter à votre forfait.
Prérequis
- Autorisations
Account owner
dans Google Play Console - Autorisations de créer des sujets, des abonnements et d'attribuer des rôles dans Google Cloud Console
- Autorisations Administrateur, Éditeur ou Éditeur personnalisé dans Adjust pour connecter les identifiants de votre compte de service Google à Adjust.
Configurer des notifications de développement en temps réel
Créer une notification push
Ouvrez Topics dans Google Cloud console.
Sélectionnez votre projet.
Sélectionnez Create topic .
Indiquez un Topic ID et sélectionnez Create .
Maintenant, dans le panneau de navigation gauche, sous Pub/Sub, sélectionnez Subscriptions .
Sélectionnez Create subscription .
Indiquez un Subscription ID .
Dans la liste Select a Cloud Pub/Sub topic , sélectionnez le sujet que vous avez créé à l'étape 4.
Sous Delivery type , sélectionnez Push .
Dans le champ Endpoint URL , saisissez
https://subscription.adjust.com/v3/playstore
.Sous Retry policy , sélectionnez Retry after exponential backoff delay et saisissez ce qui suit :
- Minimum backoff time - 10
- Maximum backoff time - 600
Sélectionnez CRÉER .
Ajouter une entité à votre abonnement
- Sélectionnez l'abonnement que vous avez créé, puis sélectionnez Add prinicipal .
- Dans le champ New principals , saisissez
google-play-developer-notifications@system.gserviceaccount.com
. - Dans la liste Assign roles , sélectionnez Pub/Sub Publisher .
- Cliquez sur Enregistrer .
Copier la valeur du nom de l'entité
- Ouvrez Topics dans Google Cloud console.
- Sélectionnez le sujet que vous avez ajouté lors de la création d'une notification push, puis copiez la valeur du nom du sujet.
- Vous devrez peut-être sélectionner (icône de flèche vers le bas) pour afficher le nom complet du sujet. Sélectionnez ensuite (icône de copie) pour copier la valeur du nom du sujet.
Vous aurez besoin de cette valeur à l'étape suivante.
Activer les notifications de développement en temps réel pour vos applications
- Ouvrez Google Play Console.
- Sélectionnez votre application.
- Sous Monetize , sélectionnez Monetization setup .
- Faites défiler vers le bas jusqu'à la section Google Play Billing .
- Dans Manage notifications , sélectionnez Enable real-time notifications .
- Dans le champ Topic name , collez le nom de sujet que vous avez copié à l'étape précédente.
- Sélectionnez ENREGISTRER MODIFICATIONS .
Répétez les étapes 2-7 pour chaque application pour laquelle vous souhaitez configurer des abonnements.
Créer votre clé publique JSON
Activer Google Play Android Developer API
- Ouvrez Google Play Console.
- Sélectionnez un projet existant ou créez-en un nouveau.
- Ouvrez APIs & Services > Enabled APIs and services .
- Sélectionnez + Enable APIs and Services .
- Recherchez et sélectionnez Google Play Android Developer API , puis sélectionnez Enable .
- Sélectionnez Create Credentials .
- Sous Which API are you using? , sélectionnez Google Play Android Developer API .
- Sous What data will you be accessing? , sélectionnez Application data et Next .
Vos identifiants peuvent exiger jusqu'à 36 heures pour fonctionner correctement avec l'API Google Play Developer.
Créer un compte de service
Pour créer un compte de service, procédez comme suit.
Ouvrez Google Cloud Console.
Sélectionnez le projet que vous avez choisi à l'étape précédente.
Ouvrez IAM & Admin > Service Accounts .
Sélectionnez Create Service Account .
Sous Service account details , indiquez le nom de votre compte de service.
- Cela permet de renseigner le champ Service account ID . Il s'agit de l'adresse email du compte de service.
Sélectionnez Create and Continue .
Sous Grant this service account access to project (optional) , choisissez les rôles suivants et sélectionnez Continue .
- Service Account Key Admin - Permet de créer et de gérer les clés des comptes de service.
- Pub/Sub Admin - Active les notifications serveur des plateformes.
- Monitoring Viewer - Permet de surveiller la file d'attente des notifications.
Sélectionnez Done pour revenir à la page des comptes de service.
Générer vos identifiants de clé publique
Pour générer vos identifiants de clé publique, procédez comme suit.
- Ouvrez Google Cloud Console.
- Sélectionnez le projet que vous avez choisi à l'étape précédente.
- Ouvrez IAM & Admin > Service Accounts .
- Pour le compte de service que vous avez créé, sous Actions , sélectionnez Manage keys .
- Sélectionnez Add Key > Create new key .
- Pour Key type , sélectionnez JSON , puis Create .
- Un fichier JSON commence à se télécharger. Il contient les identifiants requis pour la communication entre Adjust et Google. Vous avez besoin de ce fichier JSON pour connecter votre compte de service Google à Adjust.
Accorder l'accès financier
Pour autoriser l'accès financier à votre compte de service, procédez comme suit.
Dans Google Cloud Console
- Dans Google Cloud Console, sélectionnez le projet que vous avez choisi à l'étape précédente.
- Ouvrez IAM & Admin > Service Accounts .
- Pour le compte de service que vous avez créé, copiez la valeur de Email .
- Vous aurez besoin de cette adresse email à l'étape suivante.
Dans Google Play Console
Ouvrez Google Play Console.
Sélectionnez Users and permissions > Invite new users .
Saisissez l'adresse email du compte de service que vous avez récupérée à l'étape précédente.
Sous App permissions , ajoutez votre application.
Sous Account permissions , sélectionnez les autorisations suivantes :
- Afficher les informations de l'application (lecture seule)
- Afficher les données financières
- Gérer les commandes et les abonnements
Sélectionnez Invite user , puis Send invite .
Si ces options ne sont pas disponibles, vous ne disposez peut-être pas des autorisations de compte adéquates. Contactez le propriétaire ou l'administrateur de votre compte.
Connecter votre compte de service Google dans Adjust
Suivez les étapes suivantes pour connecter les identifiants de votre compte de service Google dans Adjust.
- Sous DataWorks , sélectionnez Connexions .
- Sélectionnez + Nouvelle connexion .
- Sous Partenaire , sélectionnez Compte de service Google .
- Sous Services , sélectionnez Abonnement .
- Dans le champ Fichiers d'identifiants , chargez le fichier JSON que vous avez téléchargé à l'étape Générer vos identifiants de clé publique.
- Sélectionnez Connecter .
➡️ Prochaine étape : Activer les abonnements pour votre application dans Adjust.