Google Play の課金システムを使用して、1 回限りのアイテムと呼ばれる、ユーザーに 1 回限りの請求を行うアイテムを提供できます。アプリ内アイテムとしては、Google Play のアプリ内における仮想アイテム(ゲームのレベルやポーションなど)、有料サービスがあります。
- ユーザーに定期的に請求を行う定期購入を作成することもできます。
重要: アプリ内アイテム(1 回限りのアイテムと定期購入を含む)のすべてに、Google Play デベロッパー プログラム ポリシーと取引手数料が適用されます。
ご利用いただける国
Google Play の課金システムは、販売者の登録がサポートされている国や地域でご利用になれます。
サポートされている国や地域にお住まいで、ご自身のアプリで Google Play の課金システム機能を初めて使用する場合は、お支払いプロファイルを設定し、AIDL を通じて Google Play の課金システムを使用するをご確認ください。
作成したアプリ内アイテムは、Google Play ストアの最新版を使用しているユーザーが購入できるようになります。
必要な権限
アプリ内アイテムを提供するには、アプリの APK マニフェスト ファイルで com.android.vending.BILLING
権限を宣言する必要があります。アプリをグローバルに配信する場合、すべての国で com.android.vending.BILLING
権限を指定して、アプリを公開できます。
アプリ内アイテムを作成する
アプリ内アイテムを 1 つ作成する
- アイテム ID は、先頭を必ず数字または英小文字とし、全体を数字(0~9)、小文字(a~z)、アンダースコア(_)、ピリオド(.)のみで構成します。
- アイテムを作成した後でアイテム ID を変更したり再利用したりすることはできません。
- 注:
android.test
というアイテム ID や、android.test
で始まるアイテム ID はすべて使用できません。
アプリ内アイテムを作成するには:
- Google Play Console を開き、[アプリ内アイテム] ページ([収益化] > [商品] > [アプリ内アイテム])に移動します。
- [アイテムを作成] をクリックします。
- アイテムの詳細を入力します。
- アイテム ID: アプリ内アイテムの一意の ID。
- タイトル: 「睡眠薬」など、アイテムの短い名前(最大半角 55 文字(全角 27 文字)を入力できますが、常に正しく表示されるように半角 25 文字(全角 12 文字)以内にすることをおすすめします)。
- 説明: 「生き物を即時に眠らせる」など、アイテムの長い説明(半角 200 文字(全角 100 文字)以内)。
- アイコン: アイテムに固有で正確な画像。テキスト、プロモーション、ブランディングは含めないでください。アイテムのアイコンは、ストアの掲載情報と購入フローで表示されます。
- 32 ビット PNG
- 512 x 512 ピクセル
- 最大 1 MB
- 価格: デベロッパーの現地通貨で価格を入力するか、価格設定テンプレートを選択します。
- 複数数量: このアイテムについて、複数数量でご購入手続きを行えるようにします。ユーザーの国 / 地域のしきい値内で、複数数量を購入できます。次の点にご注意ください。
- Google Play Console で複数数量のご購入手続きを設定するには、アプリに Google Play Billing Library 4.0 が必要です。Google Play Billing Library をアプリに統合する方法については、Android デベロッパー サイトをご覧ください。
- 複数数量のご購入手続きは一部の国 / 地域ではご利用いただけません。
- 複数数量のご購入手続きが可能なほとんどの国 / 地域では、SKU の価格しきい値はおよそ US$100 です。複数数量のご購入手続きを行えるようにするには、各国 / 地域のしきい値を下回るように価格(税抜き)を調整する必要があります。
- Play Points 限定: Google Play Points でのみアイテムを利用可能にします。
- 変更を保存し、[有効にする] をクリックして、ユーザーがアプリ内アイテムを入手できるようにします。
- 購入できるようにするには、アイテムを有効にし、そのアプリを公開する必要があります。
- テスト アカウントを使用している場合は、有効にしたアイテムを未公開アプリで利用できます。詳しくは、Android デベロッパー サイトをご覧ください。
言語と翻訳
アプリ内アイテムは、アプリと同じデフォルト言語を使用します。特定の言語での翻訳を追加するには、アプリ内アイテムを選択して、[翻訳を管理] をクリックし、目的の言語を適用します。アプリの翻訳についての詳細をご確認ください。
複数のアプリ内アイテムを一括して作成する
アプリ内アイテムの CSV ファイルをアップロードする
- Google Play Console を開き、[アプリ内アイテム] ページ([収益化] > [商品] > [アプリ内アイテム])に移動します。
- [インポート] をクリックします。
- CSV ファイルをアップロードすることで複数のアイテムをインポートすると、CSV ファイル内の
Product ID
の値が、アプリ内アイテムリストの既存のProduct ID
と一致する場合にのみ、既存のアイテムが上書きされます。アイテムが上書きされる場合でも、CSV に含まれていないアプリ内アイテムが削除されることはありません。
- CSV ファイルをアップロードすることで複数のアイテムをインポートすると、CSV ファイル内の
- アップロードする CSV ファイルをドロップするか、[アップロード] をクリックします。
既存のアプリ内アイテムの CSV ファイルを書き出す
今まで Google Play Console でアプリ内アイテムを 1 つずつ作成していた場合、CSV ファイルを書き出すと、今後 CSV ファイルを使用して作成する場合に便利です。
- Google Play Console を開き、[アプリ内アイテム] ページ([収益化] > [商品] > [アプリ内アイテム])に移動します。
- [エクスポート] をクリックします。
CSV ファイルの例を確認する
- 最初の例では、タイトルと説明を 2 つの言語(
en_US
とes_ES
)で指定しています。アイテムの価格は価格設定テンプレートで定義しています。 - 2 番目の例では価格設定テンプレートを使用しません。代わりに、デフォルトの国(米国)の価格を指定しています。Google Play Console によって、現在の為替レートと現地の一般的な価格の付け方に基づき、アプリを配信する他のすべての国での価格が自動的に設定されます。
- 3 番目の例でも価格設定テンプレートを使用しません。アイテムの価格は、アプリを配信する国ごとに手動で指定します。
CSV 構文の例
Product ID,Published State,Purchase Type,Auto Translate,Locale; Title; Description,Auto Fill Prices,Price,Pricing Template ID
アプリ内アイテムの例
例 1
basic_sleeping_potion,published,managed_by_android,false,en_US; Basic Sleeping Potion; Puts small creatures to sleep.; es_ES; Poción básica de dormir; Causa las criaturas pequeñas ir a dormir.,false,,4637138456024710495
例 2
standard_sleeping_potion, published,managed_by_android,false,en_US; Standard Sleeping Potion; Puts all creatures to sleep for 2 minutes.,true, 1990000,
例 3
invisibility_potion,published, managed_by_android,false,en_US; Invisibility Potion; Invisible to all enemies for 5 minutes.,false, US; 1990000; BR; 6990000; RU; 129000000; IN; 130000000; ID; 27000000000; MX; 37000000,
CSV ファイルのデータ値
Product ID |
CSV ファイルでこの値を設定すると、新しいアプリ内アイテムの作成時にアイテム ID を入力するのと同じ働きになります。 すでにアイテムリストに存在するアプリ内アイテムに割り当てられている |
Publish State |
この値には published または unpublished を設定する必要があります。これは、アプリ内アイテムを [有効] または [無効] に設定することと同じです。 |
Purchase Type |
この値には |
Auto Translate |
アプリ内アイテムの詳細の自動翻訳はサポートされていないため、この値は アプリ内アイテムのタイトルや説明の翻訳を提供する場合は、該当する翻訳を |
|
アイテムの言語 / 地域を 1 つだけ含める場合は、以下のように、アプリのデフォルトの言語 / 地域と、アイテムのデフォルトのタイトルと説明を指定する必要があります。
注: アイテムのタイトルや説明の翻訳を含める場合は、デフォルトの言語 / 地域、タイトル、説明を指定した後で、翻訳ごとに言語 / 地域、タイトル、説明を指定する必要があります。次の例では、アプリ内アイテムのデフォルトの言語 / 地域として
注: アプリごとにデフォルト言語は 1 つですが、アプリ内アイテムの翻訳はそれぞれ独立して管理されます。各アイテムの |
Auto Fill Prices 、Country 、
Price |
注: CSV ファイルで指定するアイテムの価格は、マイクロ単位で指定します。その場合、1,000,000 マイクロ単位が実際の通貨の 1 単位に相当します。 価格の自動換算を使用する 以下のセクションでは、
たとえば、以下の条件があるとします。
この場合、CSV ファイルの行の最後で 国ごとに独自の価格を設定する
注: アプリを配信する国ごとに、国コードと価格を指定する必要があります。アプリを配信する国の一覧は、[製品版] ページの [国 / 地域] タブで確認、編集できます。
たとえば、他の国でアプリを以下の価格(すべて税込)で提供するとします。
この場合、CSV ファイルの行の最後で
|
Pricing Template ID |
アイテムが価格設定テンプレートにリンクしている場合は、 CSV ファイルをインポートする場合、アプリ内アイテムと価格設定テンプレートのリンクを更新できます。アイテムを特定の価格設定テンプレートにリンクするには、 各価格設定テンプレートに、最大 1,000 件までアプリの価格またはアプリ内アイテムの価格を設定できます。したがって、CSV ファイルで 1,000 を超える行に同じ |