Android Play StoreのIAPガイドライン

GitHub

__CAPGO_KEEP_0__

AndroidアプリのGoogle Playの承認に必要なのは、特にアプリ内課金やサブスクリプションがある場合のGoogleのポリシーへの準拠です。このガイドでは、レビューを通過するために必要なすべてのことをカバーしています。

Release Path That Works

署名済みAndroidアプリバンドルを作成する

新しいGoogle Playアプリは、Androidアプリバンドル (.aab) としてアップロードする必要があります。デバッグ用のsideloaded APKではありません。

Play App Signingを使用する場合、 versionCode が増加し、安全にアップロードキーを保存してください。
Play Consoleでアプリレコードを作成する

開発者アカウントがまだない場合は、 Play Consoleのサインアップから始めてください。次に、 ホーム > アプリ作成で言語、アプリ/ゲームの種類、無料/有料の設定、サポートメール、必要な申告を承認します。

無料/有料の設定を慎重に選択してください。Googleは有料アプリを無料に変更することができますが、無料で提供されたアプリは有料に変更することはできません。
__CAPGO_KEEP_1__

__CAPGO_KEEP_2__
- プライバシーポリシー
- 広告
- アプリへのアクセス
- 対象読者とコンテンツ
- コンテンツの評価
- データの安全性
- 必要な場合の敏感なパーミッションの申請
Play インストールテストトラックを実行

始める 内部テスト 迅速なQAのために。開発者アカウントが、2023年11月13日以降に作成された個人アカウントの場合、また、 閉鎖テスト 12名以上のテスターをオプティンさせた閉鎖テストを14日連続で実施する必要があります。
請求のエンドツーエンドの検証

Google Playからアプリをインストールせず、ローカルにエクスポートされたAPKからインストールしないでください。次に、確認してください:
- Playから正しく製品が読み込まれる
- ライセンステスター用のテスト購入 ライセンステスター用の購入表示 ライセンステスター用の購入表示バナー
- ライセンス購入後、エンタイトルメントがアンロックされる
- 購入とサブスクリプション管理フローは正常に動作します

Google Play Billing 要件

必須の請求システム

デジタル商品やサービスを利用する場合、 Google Play の請求システムを使用する必要があります。 デジタル商品 (必須の Play Billing を使用):

プレミアム機能のサブスクリプション

インアプリ通貨またはクレジット
デジタルコンテンツ (ebook、音楽、ビデオ)
Restore and subscription management flows work
ゲームアップグレードとパワーアップ
アプリのアンロックとプレミアム階層

Physical Goods (Cannot Use Play Billing):

実物の商品
現実世界のサービス
非営利団体への一時的な寄付

:::note サブスクリプションの設定 Play Consoleで、Androidサブスクリプションを設定するには、現在の サブスクリプション -> 基本プラン -> オファー モデルを使用します。 In native-purchases, 基本プランIDをパスする 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は購入前にすべてのコストを明確に開示することを義務付けます:

必要な要素:

ユーザーのローカル通貨での正確な価格
請求頻度（月額、年額など）
サブスクリプションに含まれるもの
導入オファーの合計コスト
課金が発生する時期

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}</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が請求する更新コストと異なる更新コストを暗示することはできません。

プライバシーポリシーの要件

必須のプライバシーポリシー

Playストアのリストにリンク

PlayコンソールにプライバシーポリシーURLを追加
- パブリックにアクセス可能である必要があります
- If your app includes in-app purchases, you must:__CAPGO_KEEP_0__
- __CAPGO_KEEP_0__
__CAPGO_KEEP_0__
- __CAPGO_KEEP_0__
- __CAPGO_KEEP_0__
- __CAPGO_KEEP_0__

__CAPGO_KEEP_0__

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 (不正防止用)
決済情報の取り扱い
分析データの収集

__CAPGO_KEEP_0__

アプリ内容の申告

Google Playレビューは、バイナリだけではありません。生産リリース前に、申告を完了してください。 ポリシーとプログラム > アプリ内容.

注意して確認する最小限の内容:

プライバシーポリシーPlay Consoleの公開URL、必要に応じてインアプリエントリポイント
広告: アプリが広告を含んでいるかどうかを宣言する
アプリへのアクセス: ゲートされたスクリーンがあれば、レビューアーにワークイングクレデンシャルまたは明確なテストパスを提供する
対象読者とコンテンツ: アプリの実際の読者に合わせる
コンテンツの評価: IARC の質問紙を完了して、アプリが未評価と表示されないようにする
データの安全性: 正確にデータの収集、共有、セキュリティの実践を宣言する

一般的な却下の理由

1. 請求実装の欠如または不正確さ

なぜ失敗するのか

デジタル商品のためにGoogle Play 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);

__CAPGO_KEEP_0__の価格設定が不明瞭または非公開コスト

なぜ失敗するのか:

購入ボタンをクリックするまで価格が表示されない
事前には非公開の追加料金
曖昧なサブスクリプションの条項

防止:

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

__CAPGO_KEEP_0__のデセプティブサブスクリプションパターン

なぜ失敗するのか:

高級オプションの事前選択
安い代替案を非表示にする
キャンセルを難しくする
「3つしか残っていない！」などの偽の緊急性

「説明のベストプラクティス」

「マーケティングガイドライン」

「防止」

すべてのサブスクリプション階層を等しく表示する
キャンセルを明確かつアクセス可能にする
カウントダウンタイマーや偽の不足を避ける
高価なオプションを押し付けるためにダークパターンを使わない

「4. 不完全なテスト」

失敗の理由:

購入時にアプリがクラッシュする
製品が読み込まれない
購入確認が表示されない
プレミアム機能が購入後にロックされる
テストはサイドロードされたビルドのみで行われ、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);
  }
}

5. プライバシーポリシーの違反

失敗の理由:

アプリ内にプライバシーポリシーへのリンクがない
プライバシーポリシーはアクセスできない
データ収集の公開がない
データセーフティセクションの正確性が不足している

防止:

プレイストアのリストにプライバシーポリシーを追加する
アプリの設定にリンクを含める
データセーフティセクションを正確に記入する
新しいデータ収集を追加する際にポリシーを更新する

代替課金プログラム

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

__CAPGO_KEEP_0__

必要な公開情報:

キャンセルが有効になる時期はいつですか?
利用者は期間終了までアクセスを維持することができますか?
部分的な返金は利用可能ですか?

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

提出前にチェックリスト

請求処理実装を確認する
- Google Play Billing (via native-purchases)を使用
- すべてのPlay Consoleで作成されたサブスクリプション製品
- Play Consoleで正しく設定された基本プランとオファー
- 製品が有効化され、公開されている
- すべての対象国に価格が設定されている
テスト購入フロー
- ライセンステストアカウントを作成
- Playテストトラックからビルドをインストール
- 各サブスクリプション階層をテスト
- 製品が正しくロードされていることを確認
- 購入完了をテスト
- 確認 購入テスト バナー表示
- プレミアム機能のアンロックを確認する
- サブスクリプションの復元テスト
- 複数のデバイスでテスト
すべてのコピーを確認する
- 購入前に価格が明確に表示される
- すべての手数料が事前に明示される
- サブスクリプションの条件が明確
- キャンセルプロセスが説明されている
- 誤解を招くような主張がない
アプリのコンテンツとプライバシー
- プライバシーポリシーはPlay Consoleにリンクされています。
- プライバシーポリシーはアプリ内でアクセス可能です。
- 広告の申告が完了しました。
- アプリがゲートされていれば、アプリへのアクセス方法が追加されます。
- データセーフティのセクションは正確に完了しました。
- 許可された権限は正当化され、文書化されています。
コンテンツの評価と対象読者
- コンテンツ評価の質問紙を完了してください。
- 対象読者とコンテンツのセクションを完了してください。
- 評価は実際のコンテンツと一致していることを確認してください。
- 質問紙でインアプリ購入を宣言してください。
ストアリストの準備
- アプリの説明が正確
- 短い説明は80文字以内
- フル説明は4000文字以内
- 少なくとも2つの電話画面のスクリーンショットがアップロードされている
- 1024x500の機能グラフィックがアップロードされている
- スクリーンショットは現在のバージョンを表示している
- 必要なすべてのアセットがアップロードされている

レビューのタイムライン

新しい個人アカウントの生産アクセス: 通常、申請後7日以内に 最初の生産レビュー: 数日、場合によっては請求やポリシーの質問が生じた場合、長くなることもあります。 アップデート: アピール: 数日間の計画を立て、正確な修正とレビュアーへの指示を提供してください。 :::tip Rolling Reviews Appleと異なり、Googleはアプリを連続してレビューします。アプリはレビュー期間中いつでも公開されることがあり、固定時間でない可能性があります。 :::

提出前にテスト

Play Consoleに移動
- protectedTokens
- 設定 > ライセンステスト
- テスト用にGmailアカウントを追加する
テスト環境でテストする:

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

テストバナーを検証する:
- テストアカウントで購入する場合
- 「テスト購入」通知を確認する
- 実際の料金は発生しません

内部テストとクローズドテスト

本番リリース前:

作成する 内部テスト __CAPGO_KEEP_0__ 閉鎖テスト __CAPGO_KEEP_0__
署名された__CAPGO_KEEP_0__をアップロードし、テストリリースを公開 .aab __CAPGO_KEEP_0__をテスト者に共有し、オプトインリンクを共有
Google Playからテストビルドをインストールするようにテスト者に指示
Playインストール済みビルドでGoogle Play Billingの購入フローがエンドツーエンドで機能することを確認
Google Play Billingの検証のために、Playインストール済みテストビルドが必要です。
2023年11月13日以降に個人開発者アカウントを作成した場合は、閉鎖テストに少なくとも12人のテスターを14日間連続でオプトインする必要があります。

Google Play Billingの検証のために、サイドロードされたデバッグビルドはPlayインストール済みテストビルドの代わりではありません。

ネイティブ購入のベストプラクティス

購入のすべての状態を処理する

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

アプリが却下された場合

一般的なポリシー違反

支払いポリシー:

Google Play Billingを使用していない
誤解を招くサブスクリプション条項
非表示のコスト

ユーザーデータポリシー:

プライバシーポリシーが欠落している
データセキュリティの正確性の不正確な宣言
過剰な権限

解決手順

__CAPGO_KEEP_0__を確認する
- __CAPGO_KEEP_0__に記載されている特定のポリシーを読む
- Googleがフラグした内容を理解する
- 提供された例を確認する
問題を修正する
- 根本的な原因を修正するのではなく、症状のみを修正する
- 修正後、徹底的にテストする
- 行われた変更をすべてドキュメント化する

適用可能な場合は申し立てを提出する

__CAPGO_KEEP_0__と申し立てのプロセス

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.

ドキュメントの例を要求する

再提出または更新
- 修正版をアップロード
- 再提出のためのレビュー
- Play Consoleでステータスを監視

追加リソース

Need Expert Help?

Play Storeのレビューをナビゲートすることは複雑です。特に、請求の準拠、Appのコンテンツの申告、テストトラックの設定を組み合わせる必要がある場合です。

専門的な助けが必要な場合 Capgoチームと電話会議を予約してください

Complete Play Store review preparation
Play Storeのレビュー準備の完了
テストトラックの設定とテスターの募集
IAPの実装のレビュー
データの安全性とプライバシーの準拠
拒否のトラブルシューティングとアピール

Play Storeへのアプリの提出の完了の手順の完了

サポート

実装に困っている場合のヘルプ

Native Purchasesドキュメントを確認 Androidサンドボックステストガイドを確認
Google Play Developerサポートを訪問 Android Play StoreレビューガイドラインのIAPから続ける
IAPから続けるためのAndroid Play Storeレビューガイドライン IAPから続けるためのAndroid Play Storeレビューガイドラインを使用している場合

__CAPGO_KEEP_0__

__CAPGO_KEEP_0__ Android Play StoreのIAPレビュー規定 セキュリティとコンプライアンスを計画するには、を接続してください。を使用して@capgo/native-purchases native capabilityの@capgo/native-purchasesのために暗号化暗号化の実装詳細のためにコンプライアンスコンプライアンスの実装詳細のために Capgo セキュリティスキャナー Capgo セキュリティスキャナーの製品ワークフロー Capgo セキュリティ Capgo セキュリティの製品ワークフロー