Aller directement à la navigation

Directives de Revue de l'Android Play Store pour les IAP

GitHub

Pour obtenir votre application Android approuvée sur Google Play, il faut respecter les politiques de Google, en particulier pour les applications avec des achats en ligne et des abonnements. Cette guide couvre tout ce dont vous avez besoin pour passer la revue avec succès.

  1. Créez une Application Android Signée

    Les nouvelles applications Google Play doivent être chargées sous forme d'un Android App Bundle (.aab), et non sous forme d'un APK de débogage sideloadé.

    Gardez votre versionCode qui augmente à chaque chargement et stockez votre clé de chargement en toute sécurité si vous utilisez Play App Signing.

    Flux d'application Android App Bundle

  2. Créez l'enregistrement de l'application dans le console de Play

    Si vous n'avez pas encore de compte de développeur, commencez par l'inscription à la console de Play. Ensuite, dans Accueil > Créer une applicationChoisissez le langage, le type d'application/jeu, le statut gratuit/paiement, l'adresse e-mail de support et acceptez les déclarations requises.

    Choisissez soigneusement le statut gratuit/paiement. Google vous permet de changer une application payante en gratuite ultérieurement, mais une fois qu'une application a été proposée en gratuite, elle ne peut pas être convertie en paiement.

    Créer une application dans le console de Play

  3. Compléter le contenu de l'application et la liste de magasin

    Avant la revue de production, terminez les déclarations requises de la console de Play :

    • Politique de confidentialité
    • Publicités
    • Accès à l'application
    • Public cible et contenu
    • Notation de contenu
    • Sécurité des données
    • Déclarations de permissions sensibles, si pertinentes
  4. Démarrez une piste de test Play-Installé

    Démarrer avec les tests internes pour une QA rapide. Si votre compte développeur est un compte personnel créé après le 13 novembre 2023, vous devez également compléter un test fermé avec au moins 12 testeurs optés avec 14 jours consécutifs avant l'accès à la production.

    Les tests internes dans le console Play

  5. Vérifiez la facturation End-to-End

    Installez l'application à partir de Google Play, et non à partir d'un APK exporté localement. Confirmez ensuite que :

    • Les produits chargent correctement à partir de Play
    • La feuille de commande d'achat affiche un Acheter un test Pub pour les testeurs de licence
    • Les droits d'accès s'ouvrent après achat
    • Les flux de restauration et de gestion de l'abonnement fonctionnent

Pour les biens et services numériques, vous devez utiliser le système de facturation de Google Play : Biens numériques (Utilisation obligatoire de la facturation de Play):

Utilisez le système de facturation de Google Play pour les biens et services numériques :

  • Abonnements aux fonctionnalités premium
  • Monnaie ou crédits en application
  • Contenu numérique (livres numériques, musique, vidéos)
  • Améliorations et boosters de jeu
  • Désbloqueurs d'applications et niveaux premium

Biens physiques (Impossible d'utiliser Play Billing):

  • Articles promotionnels
  • Services du monde réel
  • Donations uniques à des organisations à but non lucratif

:::note Configuration de l'abonnement Dans le console Play, configurez les abonnements Android en utilisant le modèle actuel abonnement -> plan de base -> offre Modèle de l'abonnement native-purchasesPasser l'ID de la formule de base avec planIdentifier. :::

import { NativePurchases, PURCHASE_TYPE } from '@capgo/native-purchases';
// Ensure billing is available on the device
const { isBillingSupported } = await NativePurchases.isBillingSupported();
if (!isBillingSupported) throw new Error('Google Play Billing not available');
// Fetch subscription products (Store data is required—never hardcode pricing)
const { products } = await NativePurchases.getProducts({
productIdentifiers: ['premium_monthly', 'premium_yearly'],
productType: PURCHASE_TYPE.SUBS,
});
// Plan identifiers are the Base Plan IDs you create in Google Play Console
const transaction = await NativePurchases.purchaseProduct({
productIdentifier: 'premium_monthly',
planIdentifier: 'monthly-plan', // REQUIRED on Android, ignored on iOS
productType: PURCHASE_TYPE.SUBS,
});
console.log('Purchase token for server validation:', transaction.purchaseToken);

Google Play exige une divulgation claire de tous les coûts avant l'achat :

Éléments obligatoires :

  • Prix exact en devise locale de l'utilisateur
  • Fréquence de facturation (mensuelle, annuelle, etc.)
  • Qu'est-ce qui est inclus dans l'abonnement
  • Coût total pour les offres d'introduction
  • Quand les factures seront-elles émises

Meilleures pratiques de conception de l'interface utilisateur

Exemple de l'interface utilisateur conforme :

function SubscriptionCard({ product }) {
return (
<div className="subscription-card">
<h3>{product.title}</h3>
{/* Show intro offer if available */}
{product.introductoryPrice && (
<div className="intro-offer">
<p className="intro-price">{product.introductoryPriceString}</p>
<p className="intro-period">
for {product.introductoryPricePeriod}
</p>
</div>
)}
{/* Regular price */}
<div className="regular-price">
<p className="price">{product.priceString}</p>
<p className="period">per {product.subscriptionPeriod}</p>
</div>
{/* Clear description */}
<p>{product.description}</p>
{/* Renewal terms */}
<p className="terms">
Renews automatically. Cancel anytime in Google Play.
</p>
<button onClick={() => handlePurchase(product)}>
Subscribe Now
</button>
</div>
);
}

Avant qu'un abonnement ne se renouvelle automatiquement, Google exige :

  • Notification claire que le renouvellement aura lieu
  • Rappel du prix
  • Accès facile à l'annulation

Si vous vendez le même droit sur plusieurs plateformes, maintenez la cohérence dans la dénomination du produit, la période de facturation, les avantages inclus et le langage de renouvellement afin que les utilisateurs ne soient pas surpris.

Les prix peuvent différer légitimement en raison des taxes, de la monnaie locale ou de l'économie des magasins, mais l'interface de l'achat doit jamais cacher ces différences ou suggérer un coût de renouvellement différent de celui que Google Play facturera.

Si votre application inclut des achats en ligne, vous devez :

  1. Lien dans la liste de l'App Store

    • Ajouter l'URL de la politique de confidentialité dans le console de Play
    • Doit être accessible au public
    • Doit être dans la même langue que votre application
  2. Lien dans l'application

    • Afficher la politique de confidentialité dans les paramètres de l'application
    • Afficher avant de collecter les données de l'utilisateur
    • Faire facilement découvrir

Exemple d'implémentation :

function SettingsScreen() {
const openPrivacyPolicy = () => {
window.open('https://yourapp.com/privacy', '_blank');
};
const openTerms = () => {
window.open('https://yourapp.com/terms', '_blank');
};
return (
<div>
<h2>Settings</h2>
<button onClick={openPrivacyPolicy}>
Privacy Policy
</button>
<button onClick={openTerms}>
Terms of Service
</button>
<button onClick={() => NativePurchases.manageSubscriptions()}>
Manage Subscriptions
</button>
</div>
);
}

Google Play exige une disclosure détaillée dans la section Sécurité des données :

Pour les Apps IAP, déclarez :

  • Collecte du historique des achats
  • Adresses e-mail (pour les reçus)
  • Identifiants de dispositif (pour la prévention des fraudes)
  • Traitement des informations de paiement
  • Collecte des données d'analytique

La section Sécurité des données est contraignante. Les déclarations inexactes peuvent entraîner la suppression de l'application.

La revue de Google Play ne concerne pas seulement le binaire. Avant une mise en production, complétez les déclarations dans Politiques et programmes > Contenu de l'application.

Le minimum à réviser soigneusement :

  • Politique de confidentialité: URL publique dans le console de Play, plus un point d'entrée en application lorsque requis
  • Publicités: Déclarer si l'application contient des publicités
  • Accès à l'application: Fournir des informations de connexion ou un chemin de test clair si une écran est bloqué
  • Public cible et contenu: Correspondre à la vraie audience de l'application
  • Notes de contenu: Compléter le questionnaire IARC pour que l'application ne soit pas marquée non évaluée
  • Sécurité des données: Déclarez les pratiques de collecte, de partage et de sécurité avec précision

Pourquoi cela ne fonctionne pas :

  • En ne pas utilisant Google Play Billing pour les biens numériques
  • Utilisation d'APIs de facturation obsolètes
  • Mise en œuvre de solutions de paiement personnalisées pour les abonnements

Prévention :

// ✅ Correct: Use native-purchases (uses Google Play Billing)
await NativePurchases.purchaseProduct({
productIdentifier: 'premium_monthly',
planIdentifier: 'monthly-plan',
productType: PURCHASE_TYPE.SUBS,
});
// ❌ Wrong: Custom payment processor for subscriptions
// await CustomPayment.charge(user, 9.99);

Pourquoi cela ne réussit pas :

  • Le prix n'est visible qu'après avoir cliqué sur l'achat
  • Frais supplémentaires non divulgués à l'avance
  • Conditions d'abonnement vagues

Prévention :

function PurchaseScreen({ product }) {
return (
<div>
{/* Show ALL costs upfront */}
<h2>Premium Subscription</h2>
<div className="pricing">
<p className="price">{product.priceString}/month</p>
<p className="taxes">Taxes may apply based on location</p>
</div>
<div className="features">
<h3>Includes:</h3>
<ul>
<li>Ad-free experience</li>
<li>Unlimited cloud storage</li>
<li>Priority support</li>
</ul>
</div>
<div className="terms">
<p>
Subscription renews automatically unless cancelled at least
24 hours before the end of the current period.
</p>
<p>
Manage or cancel in Google Play Subscriptions.
</p>
</div>
<button onClick={handlePurchase}>
Start Subscription
</button>
</div>
);
}

Pourquoi cela ne fonctionne pas :

  • La sélection préalable d'options premium
  • Cacher des alternatives moins chères
  • Rendre la résiliation difficile
  • Urgence fausse (« Seulement 3 places disponibles ! »)

Pratiques de description recommandées

Lignes directrices de marketing

Prévention :

  • Afficher tous les niveaux de souscription de manière égale
  • Faciliter et rendre accessible la résiliation
  • Évitez les compteurs à rebondissement ou la fausse pénurie
  • N'utilisez pas de schémas sombres pour pousser des options coûteuses

Pourquoi cela ne fonctionne pas :

  • L'application s'effondre lors de l'achat
  • Les produits ne s'affichent pas
  • La confirmation d'achat ne s'affiche pas
  • Les fonctionnalités premium ne s'activent pas après achat
  • Les tests n'ont eu lieu que sur des builds sideloadés au lieu d'un parcours de test Play installé

Prévention :

import { NativePurchases, PURCHASE_TYPE } from '@capgo/native-purchases';
// Comprehensive testing before submission
async function testPurchaseFlow() {
try {
// 1. Test product loading
const { products } = await NativePurchases.getProducts({
productIdentifiers: ['premium_monthly', 'premium_yearly'],
productType: PURCHASE_TYPE.SUBS,
});
console.log('✓ Products loaded:', products.length);
// 2. Test purchase flow
const transaction = await NativePurchases.purchaseProduct({
productIdentifier: 'premium_monthly',
planIdentifier: 'monthly-plan',
productType: PURCHASE_TYPE.SUBS,
});
console.log('✓ Purchase completed', transaction.transactionId);
// 3. Verify entitlements
const { purchases } = await NativePurchases.getPurchases({
productType: PURCHASE_TYPE.SUBS,
});
if (
purchases.some(
(purchase) =>
purchase.productIdentifier === 'premium_monthly' &&
['PURCHASED', '1'].includes(purchase.purchaseState ?? '') &&
purchase.isAcknowledged,
)
) {
console.log('✓ Premium features unlocked');
}
// 4. Test restore
await NativePurchases.restorePurchases();
console.log('✓ Restore works');
} catch (error) {
console.error('✗ Test failed:', error);
}
}

Pourquoi cela ne fonctionne pas :

  • Aucun lien vers la politique de confidentialité dans l'application
  • La politique de confidentialité n'est pas accessible
  • La collecte de données n'est pas divulguée
  • La section Sécurité des données inexacte

Prévention :

  • Ajoutez la politique de confidentialité à la liste des applications sur Google Play
  • Incluez un lien dans les paramètres de l'application
  • Remplissez avec précision la section Sécurité des données
  • Mettez à jour la politique lors de l'ajout de nouvelles collectes de données

Les programmes de facturation alternatifs de Google sont spécifiques à la région et peuvent changer. Si vous souhaitez quelque chose d'autre que la facturation standard de Google Play, confirmez l'admissibilité du marché exacte, les API requises et le langage de divulgation dans le console Play immédiatement avant la mise en œuvre.

Les utilisateurs doivent être en mesure de :

  • Voir les abonnements actifs facilement
  • Annuler sans contacter le support
  • Comprendre quand la suppression prend effet

Implémentation :

import { NativePurchases } from '@capgo/native-purchases';
function ManageSubscriptionButton() {
const openManagement = async () => {
try {
// Opens Google Play subscription management
await NativePurchases.manageSubscriptions();
} catch (error) {
// Fallback to direct URL
const playStoreUrl = 'https://play.google.com/store/account/subscriptions';
window.open(playStoreUrl, '_blank');
}
};
return (
<button onClick={openManagement}>
Manage Subscription in Google Play
</button>
);
}

Déclaration requise :

  • Quand la suppression prend-elle effet ?
  • Les utilisateurs gardent-ils accès jusqu'à la fin de la période ?
  • Des remboursements partiels sont-ils disponibles ?
function CancellationInfo() {
return (
<div className="cancellation-info">
<h3>Cancellation Policy</h3>
<ul>
<li>Cancel anytime in Google Play</li>
<li>Access continues until end of billing period</li>
<li>No refunds for partial periods</li>
<li>Resubscribe anytime to regain access</li>
</ul>
<button onClick={() => NativePurchases.manageSubscriptions()}>
Manage in Google Play
</button>
</div>
);
}

Liste de vérification pré-submission

Étape de vérification avant soumission

Étape de vérification avant soumission

  1. Vérifier la mise en œuvre de la facturation

    • Utilisation de Google Play Billing (via native-purchases)
    • Tous les produits de souscription créés dans le console de Play
    • Les plans de base et les offres configurés correctement
    • Les produits sont activés et publiés
    • Les tarifs sont définis pour tous les pays cibles
  2. Test des flux d'achat

    • Créer un compte de test de licence
    • Installer la build à partir d'une piste de test de Play
    • Tester chaque niveau de souscription
    • Vérifiez que les produits chargent correctement
    • Testez la clôture de l'achat
    • Confirmez l'apparition du bannières d'achat de test Vérifiez que les fonctionnalités premium sont activées
    • Testez la restauration de l'abonnement
    • Testez sur plusieurs appareils
    • Révisez Tous les textes
  3. Le prix est affiché clairement avant l'achat

    • Toutes les frais sont divulgués à l'avance
    • Les termes de l'abonnement sont clairs
    • __CAPGO_KEEP_0__
    • Procédure d'annulation expliquée
    • Pas de déclarations trompeuses
  4. Contenu de l'application et vie privée

    • Politique de confidentialité liée dans le console de Play
    • Politique de confidentialité accessible dans l'application
    • Déclaration des publicités complétée
    • Instructions d'accès à l'application ajoutées si l'application est verrouillée
    • Section de sécurité des données complétée avec précision
    • Permissions justifiées et documentées
  5. Classification de contenu et public

    • Questionnaire de classification de contenu complété
    • Public cible et section de contenu complétés
    • Assurez-vous que le taux de notation correspond au contenu réel
    • Déclarez les achats en application dans le questionnaire
  6. Préparez la liste de magasin

    • La description de l'application est précise
    • La description courte est inférieure à 80 caractères
    • La description complète est inférieure à 4000 caractères
    • Au moins 2 captures d'écran de téléphone ont été téléchargées
    • Une image de feature de 1024x500 a été téléchargée
    • Les captures d'écran montrent la version actuelle
    • Tous les actifs requis ont été téléchargés

Accès à la production pour les nouveaux comptes personnels : D'habitude, 7 jours ou moins après votre demande Première revue de production : Souvent plusieurs jours, parfois plus longtemps si des questions sur les factures ou les politiques sont soulevées Mises à jour : Souvent plus rapides qu'une première mise en ligne, mais toujours revues Appels : Prévoyez plusieurs jours et fournissez des corrections exactes et des instructions pour le réviseur

:::tip Revues continues Contrairement à Apple, Google passe en revue les applications en continu. Votre application peut être mise en ligne à tout moment pendant la période de revue, et non à une heure fixe. :::

  1. Ajouter un compte de test :

    • Allez au console de jeu
    • Paramètres > Test de licence
    • Ajouter un compte Gmail pour le test
  2. Tester dans le Sandbox :

import { NativePurchases, PURCHASE_TYPE } from '@capgo/native-purchases';
// Test purchases with license test account
async function testInSandbox() {
const { isBillingSupported } = await NativePurchases.isBillingSupported();
if (!isBillingSupported) {
console.error('Billing not supported in this environment');
return;
}
// Fetch products (returns test pricing when using a license tester)
const { products } = await NativePurchases.getProducts({
productIdentifiers: ['premium_monthly'],
productType: PURCHASE_TYPE.SUBS,
});
console.log('Test products:', products);
// Make test purchase (no charge)
const transaction = await NativePurchases.purchaseProduct({
productIdentifier: 'premium_monthly',
planIdentifier: 'monthly-plan',
productType: PURCHASE_TYPE.SUBS,
});
console.log('Test purchase complete:', transaction.transactionId);
}
  1. Vérifier le bandeau de test :
    • Lors de l'achat avec un compte de test
    • Devoir voir la notification « Achat de test »
    • Aucune charge réelle n'a lieu

Avant la mise en production :

  1. Créez un chemin de test interne pour une QA rapide ou un chemin de test fermé pour un test plus large
  2. Publiez une version de test signée .aab et publiez la version de test
  3. Ajoutez les adresses e-mail des testeurs et partagez le lien d'opt-in
  4. Que les testeurs installent la version de build depuis Google Play
  5. Vérifiez que les flux d'achat fonctionnent de bout en bout sur la version de build Play-installée
  6. Si votre compte développeur personnel a été créé après le 13 novembre 2023, gardez au moins 12 testeurs optés pour une version fermée pendant 14 jours consécutifs avant de postuler pour une production

Un build de débogage sideloadé n'est pas un substitut pour un build de test Play-installé lors de la validation de Google Play Billing.

import { NativePurchases, PURCHASE_TYPE } from '@capgo/native-purchases';
async function handlePurchase(productId: string, planIdentifier?: string) {
try {
setLoading(true);
const transaction = await NativePurchases.purchaseProduct({
productIdentifier: productId,
planIdentifier,
productType: planIdentifier ? PURCHASE_TYPE.SUBS : PURCHASE_TYPE.INAPP,
});
console.log('Purchase token:', transaction.purchaseToken ?? transaction.receipt);
// Success - check entitlements from the store
const { purchases } = await NativePurchases.getPurchases({
productType: planIdentifier ? PURCHASE_TYPE.SUBS : PURCHASE_TYPE.INAPP,
});
const isOwned = purchases.some(
(purchase) =>
purchase.productIdentifier === productId &&
(purchase.purchaseState === 'PURCHASED' || purchase.purchaseState === '1') &&
purchase.isAcknowledged,
);
if (isOwned) {
unlockPremiumFeatures();
showSuccess('Premium activated!');
}
} catch (error: any) {
// Handle specific error cases
switch (error.code) {
case 'USER_CANCELLED':
// User backed out - no error needed
console.log('Purchase cancelled');
break;
case 'ITEM_ALREADY_OWNED':
// They already own it - restore instead
showInfo('You already own this! Restoring...');
await NativePurchases.restorePurchases();
break;
case 'ITEM_UNAVAILABLE':
showError('This subscription is currently unavailable. Please try again later.');
break;
case 'NETWORK_ERROR':
showError('Network error. Please check your connection and try again.');
break;
default:
showError('Purchase failed. Please try again.');
console.error('Purchase error:', error);
}
} finally {
setLoading(false);
}
}
import { NativePurchases, PURCHASE_TYPE } from '@capgo/native-purchases';
function RestorePurchasesButton() {
const [loading, setLoading] = useState(false);
const handleRestore = async () => {
setLoading(true);
try {
await NativePurchases.restorePurchases();
const { purchases } = await NativePurchases.getPurchases({
productType: PURCHASE_TYPE.SUBS,
});
const hasSubscription = purchases.some(
(purchase) => purchase.productType === 'subs' && purchase.isAcknowledged,
);
if (hasSubscription) {
unlockPremiumFeatures();
showSuccess('Subscriptions restored!');
return;
}
// Check one-time unlocks if needed
const { purchases: iaps } = await NativePurchases.getPurchases({
productType: PURCHASE_TYPE.INAPP,
});
const hasInApp = iaps.some((purchase) => purchase.productIdentifier === 'premium_unlock');
if (hasInApp) {
unlockPremiumFeatures();
showSuccess('Previous purchases restored!');
return;
}
showInfo('No previous purchases found.');
} catch (error) {
showError('Failed to restore purchases. Please try again.');
} finally {
setLoading(false);
}
};
return (
<button onClick={handleRestore} disabled={loading}>
{loading ? 'Restoring...' : 'Restore Purchases'}
</button>
);
}
import { NativePurchases, PURCHASE_TYPE } from '@capgo/native-purchases';
async function checkSubscriptionStatus() {
try {
const { purchases } = await NativePurchases.getPurchases({
productType: PURCHASE_TYPE.SUBS,
});
const subscription = purchases.find(
(purchase) =>
purchase.productIdentifier === 'premium_monthly' &&
(purchase.purchaseState === 'PURCHASED' || purchase.purchaseState === '1') &&
purchase.isAcknowledged,
);
if (!subscription) {
showPaywall();
return;
}
console.log('Subscription active:', {
productId: subscription.productIdentifier,
expiresAt: subscription.expirationDate,
willRenew: subscription.willCancel === false,
purchaseToken: subscription.purchaseToken,
});
unlockPremiumFeatures();
} catch (error) {
console.error('Failed to check subscription:', error);
}
}

Politique des paiements :

  • Non utilisation de Google Play Billing
  • Conditions de souscription trompeuses
  • Coûts cachés

Politique des données utilisateur :

  • Manque de politique de confidentialité
  • Déclarations de sécurité des données inexactes
  • Accès de permission excessive
  1. Examinez la notification de violation

    • Lisez la politique spécifique citée
    • Comprenez ce que Google a signalé
    • Vérifiez les exemples qu'ils ont fournis
  2. Corrigez le problème

    • Adressez la cause racine, et non seulement les symptômes
    • Testez soigneusement après la correction
    • Documentez toutes les modifications apportées
  3. Soumettez un recours (si applicable)

    Processus de clarification et d'appel

    Subject: Policy Violation Appeal - [App Name]
    Dear Google Play Review Team,
    I have received notification that my app violates [Policy X.Y].
    I have made the following changes to comply:
    1. [Specific change made]
    2. [Specific change made]
    3. [Specific change made]
    The updated version [version number] addresses all concerns raised.
    Test account for verification:
    Email: test@example.com
    Password: TestPass123
    Thank you for your consideration.

    Exemple de demande de documentation

  4. Résubmitter ou mettre à jour

    • Télécharger la version corrigée
    • Résubmitter pour examen
    • Suivre l'état dans le console de Play

La navigation de la revue de l'application Play peut être complexe, surtout lorsque vous devez combiner la conformité aux factures, les déclarations de contenu de l'application et la configuration de la piste de test. Si vous avez besoin d'une assistance personnalisée:

Réservez un appel de consultation avec notre équipe pour l'aide avec:

  • Préparation complète de la revue de l'application Play
  • Configuration de la piste de test et recrutement de testeurs
  • Examen de la mise en œuvre de la facturation intégrée
  • Conformité à la sécurité des données et à la vie privée
  • Résolution de problèmes de rejet et d'appels
  • Processus de soumission complète de l'application

Nos experts ont guidé des centaines d'applications à travers des soumissions réussies de Play Store et peuvent vous aider à naviguer les exigences actuelles.

Avez-vous besoin d'aide pour l'implémentation?

Continuez à partir des lignes directrices de la boutique Google Play pour les achats en ligne

Section intitulée « Continuez à partir des lignes directrices de la boutique Google Play pour les achats en ligne »

Si vous utilisez Lignes directrices de la boutique Google Play pour les achats en ligne pour planifier la sécurité et la conformité, connectez-le à En utilisant @capgo/native-purchases pour la capacité native en En utilisant @capgo/native-purchases, Chiffrement pour le détail d'implémentation en Chiffrement, Conformité pour le détail d'implémentation en Conformité, Capgo Scanner de sécurité pour le flux de produit dans Capgo Scanner de sécurité, et Capgo Sécurité pour le flux de produit dans Capgo Sécurité.