跳转到正文

Android Play Store IAP 审核指南

GitHub

要在 Google Play 上通过 Android 应用审核,必须符合 Google 的政策,尤其是包含应用内购买和订阅的应用。本指南涵盖了成功通过审核所需的所有内容。

  1. 构建已签名的 Android App Bundle

    新的 Google Play 应用应作为 Android App Bundle (.aab) 上传,而不是侧载调试 APK。

    确保您的 versionCode 在每次上传时递增,如果使用 Play App Signing,请妥善保管上传密钥。

    Android App Bundle 流程

  2. 在 Play Console 中创建应用记录

    如果您还没有开发者账号,请从 Play Console 注册。然后,在 首页 > 创建应用,选择语言、应用/游戏类型、免费/付费状态、支持邮箱,并接受必要的声明。

    请仔细选择免费/付费设置。Google 允许你之后将付费应用改为免费,但一旦应用曾以免费形式提供,就无法再切换为付费。

    在 Play Console 中创建应用

  3. 完成应用内容和商店信息

    在正式版审核前,请完成 Play Console 要求的各项声明:

    • 隐私政策
    • 广告
    • 应用访问权限
    • 目标受众和内容
    • 内容分级
    • 数据安全
    • 敏感权限声明(如适用)
  4. 运行 Play 安装版测试轨道

    从 内部测试 用于快速 QA。如果您的开发者账号是在 2023 年 11 月 13 日之后创建的个人账号,您还必须完成一次 封闭测试 在获得正式发布权限前,至少 12 名选择加入的测试人员需连续测试 14 天。

    Play Console 中的内部测试

  5. 验证端到端计费流程

    请从 Google Play 安装应用,不要用本地导出的 APK。然后确认:

    • 商品能从 Play 正确加载
    • 购买页显示一个 测试购买 面向许可证测试者的横幅
    • 购买后解锁权益
    • 恢复购买和订阅管理流程均正常工作

对于数字商品和服务,您 必须 使用 Google Play 的结算系统:

数字商品(必须使用 Play Billing):

  • 高级功能订阅
  • 应用内货币或积分
  • 数字内容(电子书、音乐、视频)
  • 游戏升级和强化道具
  • 应用解锁和高级套餐

实物商品(不能使用 Play Billing):

  • 实体商品
  • 线下服务
  • 向非营利组织的一次性捐赠

:::note 订阅设置 在 Play Console 中配置 Android 订阅,使用当前的 订阅 -> 基础套餐 -> 优惠 model. In native-purchases,传入 Base Plan ID planIdentifier,或传递 offerToken 来自同一 getProducts() 用于对单个特定优惠进行扣款的结果。详见 Android 订阅优惠. :::

使用 Native Purchases 实现

“使用 Native Purchases 实现”部分
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', // Android base plan id, required unless offerToken is passed; ignored on iOS
productType: PURCHASE_TYPE.SUBS,
});
console.log('Purchase token for server validation:', transaction.purchaseToken);

Google Play 要求在购买前明确披露所有费用:

必需元素:

  • 用户当地货币的准确价格
  • 计费周期(按月、按年等)
  • 订阅包含的内容
  • 首购优惠总费用
  • 何时扣费

UI 设计最佳实践

合规 UI 示例:

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?.unitString ?? 'period'}</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>
);
}

在订阅自动续费前,Google 要求:

  • 明确的续费通知
  • 价格提醒
  • 便捷的取消订阅入口

跨平台定价清晰度

“跨平台定价透明度”章节

如果您在多个平台上销售相同的权益,请保持产品命名、计费周期、包含权益及续订说明的一致性,以免用户产生困惑。

由于税费、当地货币或商店经济因素,价格存在合理差异,但购买 UI 绝不能隐藏这些差异,也不能暗示续订费用与 Google Play 实际扣费不同。

如果你的应用包含应用内购买,你必须:

  1. 在 Play Store 商品详情中提供链接

    • 在 Play Console 中添加隐私政策 URL
    • 必须可公开访问
    • 必须与应用语言一致
  2. 在应用内添加链接

    • 在应用设置中显示隐私政策
    • 在收集任何用户数据之前显示
    • 让用户容易找到

示例实现:

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 要求在数据安全部分中提供详细披露:

对于 IAP 应用,请声明:

  • 收集购买历史记录
  • 邮箱地址(用于收据)
  • 设备 ID(用于防欺诈)
  • 支付信息处理
  • 分析数据收集

数据安全部分具有法律约束力。声明不准确可能导致应用被下架。

Google Play 审核不只看二进制文件。正式发布前,请完成以下页面上的声明: 政策与计划 > 应用内容.

至少需要仔细检查的这几项:

  • 隐私政策:Play Console 中的公开 URL,以及需要时的应用内入口
  • 广告:声明应用是否包含广告
  • 应用访问权限:若有页面受限,请向审核人员提供可用的登录凭据或清晰的测试路径
  • 目标受众和内容:确保目标受众与应用实际受众一致
  • 内容分级:完成 IARC 问卷,避免应用被标记为“未评级”
  • 数据安全: 准确声明数据收集、共享及安全实践

失败原因:

  • 未使用 Google Play Billing 处理数字商品
  • 使用已弃用的 billing API
  • 为订阅实现自定义支付方案

预防措施:

// ✅ 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);

失败原因:

  • 点击购买后才显示价格
  • 未提前披露额外费用
  • 模糊的订阅条款

预防措施:

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>
);
}

失败原因:

  • 默认勾选高级选项
  • 隐藏更便宜的替代方案
  • 让取消变得困难
  • 虚假紧迫感(“仅剩 3 个名额!”)

描述最佳实践

营销指南

预防措施:

  • 同等展示所有订阅档位
  • 让取消流程清晰且易于操作
  • 避免使用倒计时或制造虚假紧迫感
  • 不要用欺骗性设计诱导用户选择高价选项

失败原因:

  • 购买时应用崩溃
  • 商品无法加载
  • 未显示购买确认信息
  • 购买后高级功能未解锁
  • 仅在侧载 build 上测试,而非通过 Play 安装的测试轨道

预防措施:

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);
}
}

失败原因:

  • 应用内缺少隐私政策链接
  • 隐私政策无法访问
  • 未披露数据收集情况
  • Data Safety 部分信息不准确

预防措施:

  • 在 Play Store 应用详情中添加隐私政策
  • 在应用设置中包含隐私政策链接
  • 准确填写 Data Safety 部分
  • 新增数据收集时更新政策

Google 的备选计费方案因地区而异,且可能发生变化。如果你需要标准 Google Play Billing 之外的方案,请在实施前立即在 Play Console 确认具体的市场资格、所需 API 和披露文案。

用户必须能够:

  • 轻松查看当前订阅
  • 无需联系客服即可取消
  • 了解取消生效时间

实现方式:

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>
);
}

必须披露的信息:

  • 取消何时生效?
  • 用户在期限结束前是否仍可使用?
  • 是否支持部分退款?
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>
);
}

提交前检查清单

  1. 验证计费实现

    • 使用 Google Play Billing(通过 native-purchases)
    • 所有订阅产品均已在 Play Console 中创建
    • 基础方案和优惠已正确配置
    • 产品已激活并发布
    • 已为所有目标国家设置价格
  2. 测试购买流程

    • 创建许可测试账号
    • 从 Play 测试轨道安装构建版本
    • 测试每个订阅档位
    • 验证产品是否正确加载
    • 测试购买完成流程
    • 确认 测试购买 横幅出现
    • 验证高级功能能否解锁
    • 测试订阅恢复
    • 在多台设备上测试
  3. 审核所有文案

    • 购买前清晰显示价格
    • 所有费用提前公开
    • 订阅条款清晰明确
    • 已说明取消流程
    • 无误导性陈述
  4. 应用内容与隐私

    • 已在 Play Console 关联隐私政策
    • 应用内可访问隐私政策
    • 已完成广告声明
    • 若应用有访问限制,已添加访问说明
    • 数据安全部分已准确填写
    • 权限已说明理由并记录
  5. 内容分级与受众

    • 完成内容分级问卷
    • 完成目标受众和内容部分
    • 确保评分与实际内容相符
    • 在问卷中声明应用内购买
  6. 准备商店信息

    • 应用描述准确
    • 简短描述不超过 80 个字符
    • 完整描述不超过 4000 个字符
    • 已上传至少 2 张手机截图
    • 已上传 1024x500 特色图片
    • 截图显示当前版本
    • 所有必需资源已上传

新个人账号的生产环境访问权限: 通常在申请后 7 天内 首次生产环境审核: 通常需要几天,如果涉及账单或政策问题,时间可能会更长 更新: 通常比首次发布更快,但仍需经过审核 申诉: 请预留几天时间,并提供准确的修复方案和给审核人员的说明

:::tip 滚动审核 与 Apple 不同,Google 会持续审核应用。您的应用可能会在审核期间的任何时间上线,而不是在固定时间。 :::

  1. 添加测试账户:

    • 前往 Play Console
    • 设置 > 许可测试
    • 添加用于测试的 Gmail 账户
  2. 在沙盒中测试:

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. 验证测试横幅:
    • 使用测试账户购买时
    • 应看到“测试购买”通知
    • 不会产生真实扣费

正式发布前:

  1. 创建一个 内部测试 用于快速 QA 的轨道或一个 封闭测试 用于更广泛的测试
  2. 上传已签名的 .aab 并发布测试版本
  3. 添加测试人员邮箱并分享加入链接
  4. 让测试人员从 Google Play 安装该构建
  5. 验证从 Play Store 安装的构建能否端到端跑通购买流程
  6. 如果您的个人开发者账号创建于 2023 年 11 月 13 日之后,在申请正式版前,请确保至少有 12 名测试人员连续 14 天参与封闭测试

在验证 Google Play Billing 时,侧载的 debug 构建不能替代从 Play Store 安装的测试构建。

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);
}
}

如果您的 App 被拒绝

“如果您的 App 被拒绝”章节

常见的政策违规行为

“常见的政策违规行为”章节

付款政策:

  • 未使用 Google Play Billing
  • 订阅条款具有误导性
  • 隐藏成本

用户数据政策:

  • 缺少隐私政策
  • 数据安全声明不准确
  • 权限申请过多
  1. 查看违规通知

    • 阅读引用的具体政策
    • 了解 Google 标记的问题
    • 查看他们提供的示例
  2. 修复问题

    • 解决根本原因,而非仅处理表象
    • 修复后彻底测试
    • 记录所有已做的更改
  3. 提交申诉(如适用)

    澄清与申诉流程

    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.

    请求文档示例

  4. 重新提交或更新

    • 上传修复版本
    • 重新提交审核
    • 在 Play Console 中监控状态

Play Store 审核流程可能比较复杂,尤其是当你需要同时处理结算合规、应用内容声明和测试轨道设置时。如果你需要针对性协助:

与我们的团队预约咨询通话 获取以下方面的帮助:

  • 完成 Play Store 审核准备
  • 测试轨道设置与测试人员招募
  • IAP 实现审核
  • 数据安全与隐私合规
  • 被拒排查与申诉
  • 完成 App 提交流程

我们的专家已帮助数百款应用成功提交至 Play Store,并可协助您应对当前的要求。

需要实施方面的帮助吗?

继续阅读:Android Play Store IAP 审核指南

章节标题为“继续阅读:Android Play Store IAP 审核指南”

如果你正在使用 Android Play Store IAP 审核指南 来规划安全与合规,请结合 使用 @capgo/native-purchases 关于“使用 @capgo/native-purchases”中的原生能力, 加密 了解 Encryption 的实现细节, 合规性 了解合规部分的实现细节, Capgo 安全扫描器 用于 Capgo Security Scanner 中的产品工作流,以及 Capgo 安全 用于 Capgo Security 中的产品工作流。