Nous mettons à jour notre documentation continuellement, mais certaines publications peuvent ne pas encore être disponibles dans votre langue. Pour accéder aux informations les plus récentes, utilisez la version en anglais.

Configurer la vérification des achats pour votre application

Pour commencer à travailler avec Purchase Verification, vous devez avoir configuré correctement le SDK Adjust dans votre application et avoir fourni à Adjust les identifiants nécessaires pour autoriser les achats à partir du store approprié.

Avant de commencer

Solution de croissance :

Purchase verification est proposée 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 Administrateur, Éditeur ou Éditeur personnalisé dans Adjust.
  • Pour créer et gérer les identifiants des stores d'applications :
    • Google Cloud : rôle Service Account Key Admin sur le projet ou le compte de service.
    • App Store Connect : droits Admin.

Ce que vous devez savoir

  • Purchase Verification s'adresse uniquement aux achats in-app réalisés dans le Google Play Store ou l'Apple App Store. Il ne fonctionne pas avec l'achat d'articles physiques.
  • Disponible pour les applications iOS, Android et Unity.

1. Configurer le SDK Adjust

Pour intégrer Adjust Purchase Verification dans votre application, assurez-vous d'installer la version minimale requise du SDK et de suivre les étapes d'implémentation pour envoyer les événements de revenus d'achats.

2. Trouver les identifiants de vos stores d'applications

Pour vérifier les achats auprès d'un store, vous devez fournir à Adjust certains identifiants qui nous permettent de faire correspondre votre compte.

Android :

Paramètre d'authentificationDéfinitionExemple
Clé JSONVotre clé JSON, téléchargée sur la page des comptes Service Dans Google Cloud Console.example_key_file

iOS :

Paramètre d'authentificationDéfinitionExemple
Issuer IDVotre issuer ID, tel qu'indiqué dans l'onglet Integrations de App Store Connect.57246542-96fe-1a63-e053-0824d011072a
ID de cléVotre private key ID, tel qu'indiqué dans l'onglet Integrations de App Store Connect.2X9R4HXF34
In-App Purchase API KeyVotre clé API P8, téléchargée depuis App Store Connect. Cette clé donne accès aux données de votre application depuis App Store Server API. -----BEGIN PRIVATE KEY-----
MIGTAgEAMBMGByqGSM49AgEGCCqGSM49AwEHBHkwdwIBAQQgNxUqm0R2vt4IrLAQr9gfDPixwSxH9wJZ6NV3X0ax4eWgCgYIKoZIzj0DAQehasda2ANCAAQx53AlofI4Of54lbR04A6D2QMbe0mt8+JtRHkJJCEUesUfySoZsm2jeh3qodLE0pZ2Rayv26qFMKuKEwemB2Op
-----END PRIVATE KEY-----

Suivez les instructions correspondant à votre plateforme de store pour trouver les identifiants nécessaires.

Pour Android

Pour créer une clé de compte de service pour un projet ou un compte de projet, votre compte utilisateur doit disposer du rôle Service Account Key Admin .

Activer Google Play Android Developer API

  1. Dans Google Play Console, accédez à APIs & Services .
  2. Sélectionnez + Enable APIs and Services .
  3. Sous la zone Mobile, sélectionnez Google Play Android Developer API .
  4. Sélectionnez Activer .
  5. Définissez les identifiants nécessaires pour l'API.
    1. Dans la zone Enabled APIs & Services , sélectionnez Google Play Android Developer API .
    2. Sélectionnez Create Credentials .
    3. Sous la zone Select an API, sélectionnez Google Play Android Developer API .
    4. Sous What data will you be accessing?, sélectionnez Application data .
    5. Sélectionnez Next.

Créer un compte de service

  1. Dans Google Cloud, accédez à Create service account

  2. Sélectionnez votre projet Google Cloud.

  3. Saisissez un nom de compte de service.

    • Un ID de compte de service est généré automatiquement.
  4. Facultatif : Indiquez une description du compte de service.

  5. Sélectionnez Create and Continue .

  6. Donnez au compte de service l'accès à un projet.

    1. Donnez au compte de service le rôle Pub/Sub Admin .
    2. Sélectionnez + Add another role .
    3. Assignez au compte de service le rôle Monitoring Viewer .
    4. Sélectionnez  Continue .
    5. Facultatif : Donnez aux utilisateurs l'accès à ce compte de service.
    6. Sélectionnez TERMINÉ .

Générer une nouvelle clé API

  1. Dans Google Cloud, accédez à IAM & Admin .
  2. Sélectionnez Service Accounts pour afficher les comptes de service de votre projet.
  3. Pour le compte de service que vous avez créé, sélectionnez Actions (icône de trois points).
  4. Sélectionnez Manage keys .
  5. Sélectionnez Add Key > Create new key .
  6. Sous Key type, sélectionnez JSON .
  7. La clé privée est automatiquement téléchargée.

Pour iOS

Vous devez disposer de droits Admin dans App Store Connect pour créer et gérer des clés API.

Trouver votre Issuer ID

  1. Dans App Store Connect, sélectionnez l'icône Users and Access .
  2. Sélectionnez l'onglet Intégrations .
  3. Sous le menu Key Type à gauche, sélectionnez In-App Purchase .
  4. En haut de la page, à côté de Issuer ID, sélectionnez Copy.

Générer une nouvelle clé API

Nous vous conseillons de générer une clé API dédiée à la vérification des revenus in-app d'Adjust.

Sélectionnez + Generate API Key

1/4
  1. Sélectionnez Generate API Key ou l'icône + pour créer une clé.

    • Si vous n'avez pas encore demandé l'accès API dans votre compte App Store Connect, effectuez-en la demande.
  2. Dans le champ Name , saisissez un nom pour la clé.

  3. Sélectionnez Generate .

  4. Votre nouvelle clé API apparaît dans la liste des clés actives avec son Key ID.

  5. À partir de la clé que vous avez générée, survolez avec votre souris la valeur dans la colonne Key ID. Sélectionnez le lien Copy Key ID qui apparaît.

  6. Sélectionnez Download In-App Purchase Key .

  7. Sélectionnez Download pour continuer.

  8. Copiez l'intégralité de la clé API depuis le fichier téléchargé.

3. Pour iOS : Connecter Adjust à App Store Connect

Pour ajouter les identifiants App Store Connect dans le dashboard Adjust, procédez comme suit :

  1. Dans Adjust, accédez à DataWorks > Connexions .
  2. Sélectionnez + Nouvelle connexion .
  3. Dans la liste, sélectionnez App Store Connect (In-App Purchase) .
  4. Sous Services, sélectionnez Purchase Verification .
  5. Saisissez votre Issuer ID .
  6. Saisissez votre Key ID .
  7. Ouvrez le fichier .p8 dans un éditeur de texte et copiez l'intégralité de la clé privée. Collez-la dans le champ Clé privée.

4. Ajoutez Purchase Verification à votre application

Appliquez maintenant la vérification des achats à votre application :

  1. Dans Adjust, accédez à AppView et sélectionnez votre application.

  2. Accédez à l'onglet Protection .

  3. Sous Purchase Verfication , sélectionnez Éditer ().

  4. Activez la vérification des achats.

  5. Fournissez des informations spécifiques aux plateformes :

    • Pour les applications iOS : Si vous avez une application iOS, vous devez sélectionner le compte App Store Connect à utiliser.
    • Pour les applications Android : Chargez le fichier de clé JSON que vous avez téléchargé auparavant.
  6. Cliquez sur Enregistrer .

Et voilà, vous avez terminé !

Partager les données de revenus vérifiées avec les partenaires

La solution Adjust de vérification des achats garantit que seules les données de revenus vérifiées sont partagées avec vos partenaires. Vous pouvez donc avoir confiance dans les données que vous partagez et leur utilisation dans le cadre de l'optimisation des campagnes.

Si vous avez déjà configuré le partage des revenus in-app avec les partenaires dans le dashboard Adjust, vous n'avez besoin d'apporter aucune modification. Adjust transfère automatiquement et uniquement les données de revenus qui présentent le statut verified passed.

Pour configurer un nouveau partenaire et activer le partage des revenus in-app vérifiés, suivez les instructions données pour la configuration des réseaux publicitaires dans Campaign Lab. À l'étape du choix des options de partage des données, assurez-vous de sélectionner revenus in-app .

Remarque:

Veillez bien à ce que votre configuration soit correcte. En effet, des identifiants incorrects, un double encodage ou toute autre erreur de configuration empêcherait la vérification de se réaliser correctement.