Tweet
Tweet

Slide 1

Slide 1 text

Re:ゼロから始める Play Billing Library DroidKaigi 2020 2020/02/21 (Fri) @syarihu

Slide 2

Slide 2 text

Taichi Sato (@syarihu) ● Money Forward, Inc. ○ Android Engineer ● TechBooster

Slide 3

Slide 3 text

アジェンダ ● Play Billing Library概要 ● Play Billing Library 2.0新機能 ● Purchase Anywhere ● AACを利用したPlay Billing Libraryによる課金実装 ● 年額課金を実装したときに得ら れた知見

Slide 4

Slide 4 text

Play Billing Library

Slide 5

Slide 5 text

https://android-developers.googleblog.com/2017/09/google-play-billing-library-10-released.html https://youtu.be/y78ugwN4Obg

Slide 6

Slide 6 text

● AndroidではIn-app Billing APIを通じてPlay Billingと連携し、アプリ課金を実現する ● Play Billing Libraryの登場以前はAIDLを使っ てアプリ課金の実装を行っていた ● AIDLではアプリからサービスへの接続や通信 の管理をすべて行う AIDL

Slide 7

Slide 7 text

● 機能に必要なコードをたくさんプロジェクトにコ ピーする必要があったため、新しい機能を追 加することは困難だった ● AIDLのさまざまな課題を解決するために、 Play Billing Libraryが開発された AIDL

Slide 8

Slide 8 text

● PBLはPlay Billingと連携するためのAIDLを抽 象化した課金ライブラリ ● 接続の管理やPlay Billingとの通信などを行う ○ サービスとの接続を自分自身で管理する必 要はなくなった Play Billing Library

Slide 9

Slide 9 text

● いままでプロジェクトにコピーしていた定形コー ドはライブラリに埋め込まれている ● In-app Billing APIに機能が追加されるたびに ファイルを更新する必要はなくなった Play Billing Library

Slide 10

Slide 10 text

● このような背景があり、AIDLは今後更新され ず、PBLでしか新しい機能は提供されない ● AIDLからPBLへの移行は必須 Play Billing Library

Slide 11

Slide 11 text

Play Billing Library ロードマップ

Slide 12

Slide 12 text

● 各メジャーバージョンはリリースされてから２年 間サポートされる ● AIDLやPlay Billing Library 1.xは 2021年5月1日までのサポート Play Billing Library

Slide 13

Slide 13 text

● AIDLとPBL 1.xのサポート終了まで 2020年2月21日から数えると残り435日 ありますが、ギリギリまで待たずになるべく早 めに移行しましょう Play Billing Library

Slide 14

Slide 14 text

Play Billing Library 2.0

Slide 15

Slide 15 text

● acknowledge ● Pending transactions Play Billing Library 2.0

Slide 16

Slide 16 text

● PBL 2.0からPBLを介して行ったすべての購入 に対してacknowledge（承認）を行うことが必 須になった ● 購入後、3日以内に承認をしない場合はユー ザーは自動的に払い戻しを受ける acknowledge

Slide 17

Slide 17 text

● 承認する方法は2種類 ○ Google Play Developer APIを使ってサー バーから行う ○ PBLを使ってアプリから行う acknowledge

Slide 18

Slide 18 text

acknowledgeの支払いフロー

Slide 19

Slide 19 text

通常の支払いフロー ユーザー アプリ サーバー 支払いを行う レシート アイテムを渡す Google Play レシートを送信 レシート検証 購入情報を登録 購入結果

Slide 20

Slide 20 text

通常の支払いフロー ユーザー アプリ サーバー 支払いを行う レシート アイテムを渡す Google Play レシートを送信 レシート検証 購入情報を登録 購入結果

Slide 21

Slide 21 text

通常の支払いフロー ユーザー アプリ サーバー 支払いを行う レシート アイテムを渡す Google Play レシートを送信 レシート検証 購入情報を登録 購入結果

Slide 22

Slide 22 text

通常の支払いフロー ユーザー アプリ サーバー 支払いを行う レシート アイテムを渡す Google Play レシートを送信 レシート検証 購入情報を登録 購入結果

Slide 23

Slide 23 text

通常の支払いフロー ユーザー アプリ サーバー 支払いを行う レシート アイテムを渡す Google Play レシートを送信 レシート検証 購入情報を登録 購入結果

Slide 24

Slide 24 text

通常の支払いフロー ユーザー アプリ サーバー 支払いを行う レシート アイテムを渡す Google Play レシートを送信 レシート検証 購入情報を登録 購入結果 Google Playでの購入は正常にできているのに サービスは利用できない状態になってしまう

Slide 25

Slide 25 text

acknowledgeに対応した支払いフロー ユーザー アプリ サーバー 支払いを行う レシート 承認リクエスト 承認結果 アイテムを渡す Google Play レシートを送信 レシート検証 購入情報を登録 購入結果

Slide 26

Slide 26 text

acknowledgeに対応した支払いフロー ユーザー アプリ サーバー 支払いを行う レシート 承認リクエスト 承認結果 アイテムを渡す Google Play レシートを送信 レシート検証 購入情報を登録 購入結果

Slide 27

Slide 27 text

acknowledgeに対応した支払いフロー ユーザー アプリ サーバー 支払いを行う レシート 承認リクエスト 承認結果 アイテムを渡す Google Play レシートを送信 レシート検証 購入情報を登録 購入結果

Slide 28

Slide 28 text

acknowledgeに対応した支払いフロー ユーザー アプリ サーバー 支払いを行う レシート アイテムを渡す Google Play レシートを送信 レシート検証 購入情報を登録 購入結果 承認リクエスト 承認結果

Slide 29

Slide 29 text

acknowledgeに対応した支払いフロー ユーザー アプリ サーバー 支払いを行う レシート アイテムを渡す Google Play レシートを送信 レシート検証 購入情報を登録 購入結果 承認リクエスト 承認結果 購入情報の登録に失敗しても 3日以内に承認されない場合は払い戻されるので安心

Slide 30

Slide 30 text

acknowledgeに対応した支払いフロー（アプリ） ユーザー アプリ サーバー 支払いを行う レシート 承認リクエスト 承認結果 アイテムを渡す Google Play レシートを送信 レシート検証 購入情報を登録 購入結果

Slide 31

Slide 31 text

acknowledgeに対応した支払いフロー（アプリ） ユーザー アプリ サーバー 支払いを行う レシート 承認リクエスト 承認結果 アイテムを渡す Google Play レシートを送信 レシート検証 購入情報を登録 購入結果

Slide 32

Slide 32 text

acknowledgeに対応した支払いフロー（アプリ） ユーザー アプリ サーバー 支払いを行う レシート 承認リクエスト 承認結果 アイテムを渡す Google Play レシートを送信 レシート検証 購入情報を登録 購入結果

Slide 33

Slide 33 text

acknowledgeに対応した支払いフロー（アプリ） ユーザー アプリ サーバー 支払いを行う レシート 承認リクエスト 承認結果 アイテムを渡す Google Play レシートを送信 レシート検証 購入情報を登録 購入結果

Slide 34

Slide 34 text

acknowledgeに対応した支払いフロー（アプリ） ユーザー アプリ サーバー 支払いを行う レシート 承認リクエスト 承認結果 アイテムを渡す Google Play レシートを送信 レシート検証 購入情報を登録 購入結果 アプリで通信失敗したときなどの考慮は必要

Slide 35

Slide 35 text

Pending transactions

Slide 36

Slide 36 text

● 遅延支払いができる新しい支払い方法 ● 支払いは実店舗での現金払いや銀行振込 などを想定 Pending transactions

Slide 37

Slide 37 text

● 管理対象アイテムで利用できる ● 定期購入では利用できない ○ 支払い方法の選択肢には出てこない Pending transactions

Slide 38

Slide 38 text

Pending transactionsの コンビニでの利用例

Slide 39

Slide 39 text

What's New with Google Play Billing (Google I/O'19) より引用 https://youtu.be/N4004Set4F8

Slide 40

Slide 40 text

What's New with Google Play Billing (Google I/O'19) より引用 https://youtu.be/N4004Set4F8

Slide 41

Slide 41 text

What's New with Google Play Billing (Google I/O'19) より引用 https://youtu.be/N4004Set4F8

Slide 42

Slide 42 text

Google Playへの支払いリクエスト ユーザー アプリ サーバー 支払いリクエストを行う 支払いを促す Google Play 支払いコード レシート送信 レシート検証 購入情報を登録 購入結果 レシート（支払い保留状態）

Slide 43

Slide 43 text

Google Playへの支払いリクエスト ユーザー アプリ サーバー 支払いリクエストを行う 支払いを促す Google Play 支払いコード レシート送信 レシート検証 購入情報を登録 購入結果 レシート（支払い保留状態）

Slide 44

Slide 44 text

Google Playへの支払いリクエスト ユーザー アプリ サーバー 支払いリクエストを行う 支払いを促す Google Play 支払いコード レシート送信 レシート検証 購入情報を登録 購入結果 レシート（支払い保留状態）

Slide 45

Slide 45 text

Google Playへの支払いリクエスト ユーザー アプリ サーバー 支払いリクエストを行う 支払いを促す Google Play 支払いコード レシート送信 レシート検証 購入情報を登録 購入結果 レシート（支払い保留状態）

Slide 46

Slide 46 text

Google Playへの支払いリクエスト ユーザー アプリ サーバー 支払いリクエストを行う 支払いを促す Google Play 支払いコード レシート送信 レシート検証 購入情報を登録 購入結果 レシート（支払い保留状態）

Slide 47

Slide 47 text

Google Playへの支払いリクエスト ユーザー アプリ サーバー 支払いリクエストを行う 支払いを促す Google Play 支払いコード レシート送信 レシート検証 購入情報を登録 購入結果 レシート（支払い保留状態）

Slide 48

Slide 48 text

Google Playへの支払いリクエスト ユーザー アプリ サーバー 支払いリクエストを行う 支払いを促す Google Play 支払いコード レシート送信 レシート検証 購入情報を登録 購入結果 レシート（支払い保留状態）

Slide 49

Slide 49 text

コンビニへの支払い コンビニ ユーザー アプリ サーバー 支払いを行う 支払い完了通知 承認リクエスト 承認結果 アイテムを渡す Google Play 支払い完了通知 購入履歴をリクエスト レシート検証 購入情報を登録 購入結果 アプリを起動 購入履歴 レシートを送信

Slide 50

Slide 50 text

コンビニへの支払い コンビニ ユーザー アプリ サーバー 支払いを行う 支払い完了通知 承認リクエスト 承認結果 アイテムを渡す Google Play 支払い完了通知 購入履歴をリクエスト レシート検証 購入情報を登録 購入結果 アプリを起動 購入履歴 レシートを送信

Slide 51

Slide 51 text

コンビニへの支払い コンビニ ユーザー アプリ サーバー 支払いを行う 支払い完了通知 承認リクエスト 承認結果 アイテムを渡す Google Play 支払い完了通知 購入履歴をリクエスト レシート検証 購入情報を登録 購入結果 アプリを起動 購入履歴 レシートを送信

Slide 52

Slide 52 text

コンビニへの支払い コンビニ ユーザー アプリ サーバー 支払いを行う 支払い完了通知 承認リクエスト 承認結果 アイテムを渡す Google Play 支払い完了通知 購入履歴をリクエスト レシート検証 購入情報を登録 購入結果 アプリを起動 購入履歴 レシートを送信

Slide 53

Slide 53 text

コンビニへの支払い コンビニ ユーザー アプリ サーバー 支払いを行う 支払い完了通知 承認リクエスト 承認結果 アイテムを渡す Google Play 支払い完了通知 購入履歴をリクエスト レシート検証 購入情報を登録 購入結果 アプリを起動 購入履歴 レシートを送信

Slide 54

Slide 54 text

コンビニへの支払い コンビニ ユーザー アプリ サーバー 支払いを行う 支払い完了通知 承認リクエスト 承認結果 アイテムを渡す Google Play 支払い完了通知 購入履歴をリクエスト レシート検証 購入情報を登録 購入結果 アプリを起動 購入履歴 レシートを送信

Slide 55

Slide 55 text

コンビニへの支払い コンビニ ユーザー アプリ サーバー 支払いを行う 支払い完了通知 承認リクエスト 承認結果 アイテムを渡す Google Play 支払い完了通知 購入履歴をリクエスト レシート検証 購入情報を登録 購入結果 アプリを起動 購入履歴 レシートを送信

Slide 56

Slide 56 text

● 支払いリクエストを行ったときは保留状態にな る（Pending transactions） ● 支払いが終わったあとにアプリが3日以上起動 されないなど承認が行われないときは払い戻 しされる（acknowledge） コンビニでの現金払い

Slide 57

Slide 57 text

Purchase Anywhere

Slide 58

Slide 58 text

● Pending transactions ● アプリ外購入 Purchase Anywhere

Slide 59

Slide 59 text

● 現金購入（Cash purchases） ● リモート購入承認（Remote purchase approvals） Pending transactions

Slide 60

Slide 60 text

● コンビニなどの実店舗での支払いや 銀行振り込み ● 日本、インドネシア、メキシコで使える状態に なっている ○ 2020年2月現在は日本では実際に使える 店舗はまだ無い 現金購入

Slide 61

Slide 61 text

● Googleアカウントを子どもに提供する代わりに 子ども用のアカウントを作成できる ● 子どもが何かを購入すると、アプリやゲームに 表示される前に親が親のスマートフォンで承認 リモート購入承認

Slide 62

Slide 62 text

● リモート購入承認もPending transactionsの 仕組みを使って行われる ● まだリリースされていないが、もうすぐリリース される予定（と、Android Dev Summit 2019で 発表していた） リモート購入承認

Slide 63

Slide 63 text

アプリ外購入

Slide 64

Slide 64 text

● アプリが実行中でないときにアプリの外部で発 生する購入 アプリ外購入

Slide 65

Slide 65 text

● Promo Codes ● Gift Cards ● Google Play Points ● Subscribe and Install アプリ外購入

Slide 66

Slide 66 text

Promo Codes

Slide 67

Slide 67 text

Gift Cards

Slide 68

Slide 68 text

Google Play Points

Slide 69

Slide 69 text

Subscribe and Install

Slide 70

Slide 70 text

● アプリ外購入は、アプリではないところで購入 されるため、アプリはどんな状態かは分からな い アプリ外購入

Slide 71

Slide 71 text

● アプリは動いていないかもしれない ● アプリはインストールされていないかもしれな い ● 何らかの状態で一時停止しているかもしれな い（分割画面やPicture in pictureなど） アプリ外購入

Slide 72

Slide 72 text

● アプリの外部で受け取ったアイテムを検出 ● 分割画面モードの最中に受け取ったアイテム を検出 ● アイテムを検出したときに、アプリ内で何らか のメッセージをユーザーに表示 アプリ外購入

Slide 73

Slide 73 text

● Play Billing Libraryは、Purchase Anywhere の一環で提供される機能が使えるというメリッ トも大きい ● これらの新機能を使うためにもなるべく 早めにPBLに移行しましょう Purchase Anywhere

Slide 74

Slide 74 text

AACとPBLを使った アプリ課金の実装例

Slide 75

Slide 75 text

● Google Playの課金サービスへの接続やリク エストはBillingClientのinterfaceから受け取れ る ● 課金を実装する画面は1つとは限らないため、 ActivityやFragmentなどではなくViewModel で実装する AACでBillingClientを扱う

Slide 76

Slide 76 text

dependencies { implementation 'com.android.billingclient:billing:2.1.0' } app/build.gradle

Slide 77

Slide 77 text

dependencies { implementation 'com.android.billingclient:billing:2.1.0' implementation 'androidx.lifecycle:lifecycle-livedata:2.2.0' implementation 'androidx.lifecycle:lifecycle-viewmodel:2.2.0' } app/build.gradle

Slide 78

Slide 78 text

class BillingViewModel(application: Application) : ViewModel(), PurchasesUpdatedListener { private val billingClient: BillingClient = BillingClient.newBuilder(application) .enablePendingPurchases() .setListener(this /* PurchasesUpdatedListener */) .build() } BillingViewModel.kt

Slide 79

Slide 79 text

class BillingViewModel(application: Application) : ViewModel(), PurchasesUpdatedListener { private val billingClient: BillingClient = BillingClient.newBuilder(application) .enablePendingPurchases() .setListener(this /* PurchasesUpdatedListener */) .build() } BillingViewModel.kt

Slide 80

Slide 80 text

class BillingViewModel(application: Application) : ViewModel(), PurchasesUpdatedListener { private val billingClient: BillingClient = BillingClient.newBuilder(application) .enablePendingPurchases() .setListener(this /* PurchasesUpdatedListener */) .build() } BillingViewModel.kt

Slide 81

Slide 81 text

class BillingViewModel(application: Application) : ViewModel(), PurchasesUpdatedListener { private val billingClient: BillingClient = BillingClient.newBuilder(application) .enablePendingPurchases() .setListener(this /* PurchasesUpdatedListener */) .build() } BillingViewModel.kt

Slide 82

Slide 82 text

class BillingViewModel(application: Application) : ViewModel(), PurchasesUpdatedListener { private val billingClient: BillingClient = BillingClient.newBuilder(application) .enablePendingPurchases() .setListener(this /* PurchasesUpdatedListener */) .build() } BillingViewModel.kt

Slide 83

Slide 83 text

class BillingViewModel(application: Application) : ViewModel(), PurchasesUpdatedListener { ...省略... /** 購入完了、購入キャンセルなどのコールバック */ override fun onPurchasesUpdated( billingResult: BillingResult, purchases: MutableList? ) { } } BillingViewModel.kt

Slide 84

Slide 84 text

class BillingViewModel(application: Application) : ViewModel(), PurchasesUpdatedListener { private val billingClient: BillingClient = BillingClient.newBuilder(application) .enablePendingPurchases() .setListener(this /* PurchasesUpdatedListener */) .build() ...省略... } BillingViewModel.kt

Slide 85

Slide 85 text

● BillingClientは課金サービスへの接続完了後 や購入完了後などさまざまな状態に応じたイ ベントを受け取れる ● 現在どのような状態なのかを知るため、各状 態をあらかじめ定義し、LiveDataで管理する LiveDataで課金の状態を管理する

Slide 86

Slide 86 text

sealed class BillingStatus { object SetupSuccess : BillingStatus() object BillingFlow : BillingStatus() object PendingPurchase : BillingStatus() object AcknowledgeSuccess : BillingStatus() object ServiceDisconnected : BillingStatus() object NoPreviousPlanPurchaseHistory : BillingStatus() data class Error(val billingResult: BillingResult) : BillingStatus() } BillingStatus.kt

Slide 87

Slide 87 text

sealed class BillingStatus { object SetupSuccess : BillingStatus() object BillingFlow : BillingStatus() object PendingPurchase : BillingStatus() object AcknowledgeSuccess : BillingStatus() object ServiceDisconnected : BillingStatus() object NoPreviousPlanPurchaseHistory : BillingStatus() data class Error(val billingResult: BillingResult) : BillingStatus() } BillingStatus.kt

Slide 88

Slide 88 text

sealed class BillingStatus { object SetupSuccess : BillingStatus() object BillingFlow : BillingStatus() object PendingPurchase : BillingStatus() object AcknowledgeSuccess : BillingStatus() object ServiceDisconnected : BillingStatus() object NoPreviousPlanPurchaseHistory : BillingStatus() data class Error(val billingResult: BillingResult) : BillingStatus() } BillingStatus.kt

Slide 89

Slide 89 text

class BillingViewModel(application: Application) : ViewModel(), PurchasesUpdatedListener { ...省略... /** 購入完了、購入キャンセルなどのコールバック */ override fun onPurchasesUpdated( billingResult: BillingResult, purchases: MutableList? ) { } } BillingViewModel.kt

Slide 90

Slide 90 text

sealed class BillingStatus { object SetupSuccess : BillingStatus() object BillingFlow : BillingStatus() object PendingPurchase : BillingStatus() object AcknowledgeSuccess : BillingStatus() object ServiceDisconnected : BillingStatus() object NoPreviousPlanPurchaseHistory : BillingStatus() data class Error(val billingResult: BillingResult) : BillingStatus() } BillingStatus.kt

Slide 91

Slide 91 text

sealed class BillingStatus { object SetupSuccess : BillingStatus() object BillingFlow : BillingStatus() object PendingPurchase : BillingStatus() object AcknowledgeSuccess : BillingStatus() object ServiceDisconnected : BillingStatus() object NoPreviousPlanPurchaseHistory : BillingStatus() data class Error(val billingResult: BillingResult) : BillingStatus() } BillingStatus.kt

Slide 92

Slide 92 text

class BillingViewModel(application: Application) : ViewModel(), PurchasesUpdatedListener { ...省略... private val _billingStatus = MutableLiveData() val billingStatus: LiveData = _billingStatus } BillingViewModel.kt

Slide 93

Slide 93 text

Google Playの課金サービスに接続する

Slide 94

Slide 94 text

● 課金を行うには、Google Playの課金サービス への接続が必要 ● 課金サービスへの接続は通常、課金したい画 面のonCreateなどのイベント発生時に実行す る Google Playの課金サービスに接続する

Slide 95

Slide 95 text

● AACのLifecycleObserverを使うとActivityや Fragmentのライフサイクルイベントを任意のメ ソッドで受け取れる ● ViewModelにLifecycleObserverを実装して onCreate時に課金サービスへ接続する Google Playの課金サービスに接続する

Slide 96

Slide 96 text

Google Playの課金サービスに接続する ViewModel BillingClient Google Play startConnection onServiceConnected bindService onBillingSetupFinished Fragment OnLifecycleEvent: onCreate LiveData: SetupSuccess

Slide 97

Slide 97 text

Google Playの課金サービスに接続する ViewModel BillingClient Google Play startConnection onServiceConnected bindService onBillingSetupFinished Fragment OnLifecycleEvent: onCreate LiveData: SetupSuccess

Slide 98

Slide 98 text

Google Playの課金サービスに接続する ViewModel BillingClient Google Play startConnection onServiceConnected bindService onBillingSetupFinished Fragment OnLifecycleEvent: onCreate LiveData: SetupSuccess

Slide 99

Slide 99 text

class BillingViewModel(application: Application) : ViewModel(), BillingClientStateListener, PurchasesUpdatedListener { ...省略... private fun startConnection() { billingClient.startConnection(this /* BillingClientStateListener */) } } BillingViewModel.kt

Slide 100

Slide 100 text

class BillingViewModel(application: Application) : ViewModel(), BillingClientStateListener, PurchasesUpdatedListener { ...省略... private fun startConnection() { billingClient.startConnection(this /* BillingClientStateListener */) } } BillingViewModel.kt

Slide 101

Slide 101 text

class BillingViewModel(application: Application) : ViewModel(), BillingClientStateListener, PurchasesUpdatedListener { ...省略... private fun startConnection() { billingClient.startConnection(this /* BillingClientStateListener */) } } BillingViewModel.kt

Slide 102

Slide 102 text

class BillingViewModel(application: Application) : ViewModel(), BillingClientStateListener, PurchasesUpdatedListener { ...省略... override fun onBillingSetupFinished(billingResult: BillingResult) { if (billingResult.responseCode == BillingClient.BillingResponseCode.OK) _billingStatus.postValue(BillingStatus.SetupSuccess) else _billingStatus.postValue(BillingStatus.Error(billingResult)) } override fun onBillingServiceDisconnected() = Unit } BillingViewModel.kt

Slide 103

Slide 103 text

class BillingViewModel(application: Application) : ViewModel(), BillingClientStateListener, PurchasesUpdatedListener { ...省略... override fun onBillingSetupFinished(billingResult: BillingResult) { if (billingResult.responseCode == BillingClient.BillingResponseCode.OK) _billingStatus.postValue(BillingStatus.SetupSuccess) else _billingStatus.postValue(BillingStatus.Error(billingResult)) } override fun onBillingServiceDisconnected() = Unit } BillingViewModel.kt

Slide 104

Slide 104 text

class BillingViewModel(application: Application) : ViewModel(), BillingClientStateListener, PurchasesUpdatedListener { ...省略... override fun onBillingSetupFinished(billingResult: BillingResult) { if (billingResult.responseCode == BillingClient.BillingResponseCode.OK) _billingStatus.postValue(BillingStatus.SetupSuccess) else _billingStatus.postValue(BillingStatus.Error(billingResult)) } override fun onBillingServiceDisconnected() = Unit } BillingViewModel.kt

Slide 105

Slide 105 text

class BillingViewModel(application: Application) : ViewModel(), BillingClientStateListener, PurchasesUpdatedListener { ...省略... override fun onBillingSetupFinished(billingResult: BillingResult) { if (billingResult.responseCode == BillingClient.BillingResponseCode.OK) _billingStatus.postValue(BillingStatus.SetupSuccess) else _billingStatus.postValue(BillingStatus.Error(billingResult)) } override fun onBillingServiceDisconnected() = Unit } BillingViewModel.kt

Slide 106

Slide 106 text

class BillingViewModel(application: Application) : ViewModel(), BillingClientStateListener, PurchasesUpdatedListener { ...省略... override fun onBillingSetupFinished(billingResult: BillingResult) { if (billingResult.responseCode == BillingClient.BillingResponseCode.OK) _billingStatus.postValue(BillingStatus.SetupSuccess) else _billingStatus.postValue(BillingStatus.Error(billingResult)) } override fun onBillingServiceDisconnected() = Unit } BillingViewModel.kt

Slide 107

Slide 107 text

class BillingViewModel(application: Application) : ViewModel(), BillingClientStateListener, PurchasesUpdatedListener { ...省略... override fun onBillingSetupFinished(billingResult: BillingResult) { if (billingResult.responseCode == BillingClient.BillingResponseCode.OK) _billingStatus.postValue(BillingStatus.SetupSuccess) else _billingStatus.postValue(BillingStatus.Error(billingResult)) } override fun onBillingServiceDisconnected() = Unit } BillingViewModel.kt

Slide 108

Slide 108 text

class BillingViewModel(application: Application) : ViewModel(), BillingClientStateListener, PurchasesUpdatedListener, LifecycleObserver { ...省略... @OnLifecycleEvent(Lifecycle.Event.ON_CREATE) fun onCreate() { startConnection() } } BillingViewModel.kt

Slide 109

Slide 109 text

class BillingViewModel(application: Application) : ViewModel(), BillingClientStateListener, PurchasesUpdatedListener, LifecycleObserver { ...省略... @OnLifecycleEvent(Lifecycle.Event.ON_CREATE) fun onCreate() { startConnection() } } BillingViewModel.kt

Slide 110

Slide 110 text

class BillingViewModel(application: Application) : ViewModel(), BillingClientStateListener, PurchasesUpdatedListener, LifecycleObserver { override fun onCleared() { super.onCleared() billingClient.endConnection() } } BillingViewModel.kt

Slide 111

Slide 111 text

class BillingViewModel(application: Application) : ViewModel(), BillingClientStateListener, PurchasesUpdatedListener, LifecycleObserver { override fun onCleared() { super.onCleared() billingClient.endConnection() } } BillingViewModel.kt

Slide 112

Slide 112 text

課金アイテムの情報を取得する

Slide 113

Slide 113 text

● Google Playの管理アイテムにはそれぞれアイ テムIDが振られている ● アイテムIDはPlay Console上でアイテムを追 加する際に自ら設定する ● PBL内ではSKUと呼ばれる アイテム情報を取得する

Slide 114

Slide 114 text

● アイテムの種類や金額などの情報がまとまっ たオブジェクトをSkuDetailsと呼び、アイテムID を使って取得できる ● SkuDetailsはアイテムを購入する際にも利用 する アイテム情報を取得する

Slide 115

Slide 115 text

アイテムの購入画面を表示するまでの流れ ユーザー アプリ Google Play アイテムの購入ボタンをタップ SkuDetails アイテムの購入画面を表示 SkuDetailsを元に 購入をリクエスト アイテムIDとアイテムの種類を元に アイテム情報をリクエスト

Slide 116

Slide 116 text

アイテムの購入画面を表示するまでの流れ ユーザー アプリ Google Play アイテムの購入ボタンをタップ SkuDetails アイテムの購入画面を表示 アイテムIDとアイテムの種類を元に アイテム情報をリクエスト SkuDetailsを元に 購入をリクエスト

Slide 117

Slide 117 text

アイテムの購入画面を表示するまでの流れ ユーザー アプリ Google Play アイテムの購入ボタンをタップ SkuDetails アイテムの購入画面を表示 アイテムIDとアイテムの種類を元に アイテム情報をリクエスト SkuDetailsを元に 購入をリクエスト

Slide 118

Slide 118 text

アイテムの購入画面を表示するまでの流れ ユーザー アプリ Google Play アイテムの購入ボタンをタップ SkuDetails アイテムの購入画面を表示 アイテムIDとアイテムの種類を元に アイテム情報をリクエスト SkuDetailsを元に 購入をリクエスト

Slide 119

Slide 119 text

アイテムの購入画面を表示するまでの流れ ユーザー アプリ Google Play アイテムの購入ボタンをタップ SkuDetails アイテムの購入画面を表示 アイテムIDとアイテムの種類を元に アイテム情報をリクエスト SkuDetailsを元に 購入をリクエスト

Slide 120

Slide 120 text

● アイテム情報を取得するにはアイテムIDとアイ テムの種類が必要 ● アプリで購入できるアイテムが複数ある場合 は、一箇所でまとめて定義しておくほうが便利 アイテムを管理する

Slide 121

Slide 121 text

● PBLではアプリ内のアイテムの種類を SkuTypeとして表す ○ SkuType.INAPP … 管理対象アイテム ○ SkuType.SUBS … 定期購入 アイテムを管理する

Slide 122

Slide 122 text

enum class BillingSkuType( @BillingClient.SkuType val skuType: String ) { /** 定期購読 */ Subscription(BillingClient.SkuType.SUBS), /** 消費不可のアプリ内アイテム */ InAppNonConsumable(BillingClient.SkuType.INAPP), /** 消費可能なアプリ内アイテム */ InAppConsumable(BillingClient.SkuType.INAPP), } BillingSkuType.kt

Slide 123

Slide 123 text

enum class BillingItem(val sku: String, val billingSkuType: BillingSkuType) { MonthlyPlan( "monthly_plan", BillingSkuType.Subscription), MonthlyPremiumPlan( "monthly_premium_plan", BillingSkuType.Subscription), NonConsumableItem( "non_consumable_item", BillingSkuType.InAppNonConsumable), ConsumableItem( "consumable_item", BillingSkuType.InAppConsumable), AndroidTestPurchased( "android.test.purchased", BillingSkuType.InAppNonConsumable); } BillingSkuType.kt

Slide 124

Slide 124 text

enum class BillingItem(val sku: String,val billingSkuType: BillingSkuType) { ...省略... fun skusList(): List = listOf(sku) companion object { fun findBySku(sku: String): BillingItem? = values().find { it.sku == sku } } } BillingSkuType.kt

Slide 125

Slide 125 text

private fun getSkuDetails( billingItem: BillingItem, onResponse: (skuDetails: SkuDetails) -> Unit ) { val skuDetailsParams = SkuDetailsParams.newBuilder() .setSkusList(billingItem.skusList()) .setType(billingItem.billingSkuType.skuType) .build() ...省略... BillingViewModel.kt

Slide 126

Slide 126 text

billingClient.querySkuDetailsAsync(skuDetailsParams ) { billingResult: BillingResult, skuDetailList: List -> if (billingResult.responseCode == BillingClient.BillingResponseCode.OK && skuDetailList.isNotEmpty() ) { onResponse(skuDetailList[0]) } else { _billingStatus.postValue(BillingStatus.Error(billingResult)) } } } BillingViewModel.kt

Slide 127

Slide 127 text

billingClient.querySkuDetailsAsync(skuDetailsParams ) { billingResult: BillingResult, skuDetailList: List -> if (billingResult.responseCode == BillingClient.BillingResponseCode.OK && skuDetailList.isNotEmpty() ) { onResponse(skuDetailList[0]) } else { _billingStatus.postValue(BillingStatus.Error(billingResult)) } } } BillingViewModel.kt

Slide 128

Slide 128 text

billingClient.querySkuDetailsAsync(skuDetailsParams ) { billingResult: BillingResult, skuDetailList: List -> if (billingResult.responseCode == BillingClient.BillingResponseCode.OK && skuDetailList.isNotEmpty() ) { onResponse(skuDetailList[0]) } else { _billingStatus.postValue(BillingStatus.Error(billingResult)) } } } BillingViewModel.kt

Slide 129

Slide 129 text

billingClient.querySkuDetailsAsync(skuDetailsParams ) { billingResult: BillingResult, skuDetailList: List -> if (billingResult.responseCode == BillingClient.BillingResponseCode.OK && skuDetailList.isNotEmpty() ) { onResponse(skuDetailList[0]) } else { _billingStatus.postValue(BillingStatus.Error(billingResult)) } } } BillingViewModel.kt

Slide 130

Slide 130 text

アイテムの購入画面を表示するまでの流れ ユーザー アプリ Google Play アイテムの購入ボタンをタップ SkuDetails アイテムの購入画面を表示 アイテムIDとアイテムの種類を元に アイテム情報をリクエスト SkuDetailsを元に 購入をリクエスト

Slide 131

Slide 131 text

アイテムの購入画面を表示するまでの流れ ユーザー アプリ Google Play アイテムの購入ボタンをタップ SkuDetails アイテムの購入画面を表示 アイテムIDとアイテムの種類を元に アイテム情報をリクエスト SkuDetailsを元に 購入をリクエスト

Slide 132

Slide 132 text

fun purchase(activity: Activity, billingItem: BillingItem) { getSkuDetails(billingItem) { skuDetails -> val flowParams = BillingFlowParams.newBuilder() .setSkuDetails(skuDetails) .build() _billingStatus.postValue(BillingStatus.BillingFlow) billingClient.launchBillingFlow(activity, flowParams) } } BillingViewModel.kt

Slide 133

Slide 133 text

class BillingFragment : Fragment(), View.OnClickListener { ...省略... override fun onClick(v: View?) { billingViewModel.purchase( requireActivity(), BillingItem.NonConsumableItem ) } } BillingFragment.kt

Slide 134

Slide 134 text

No content

Slide 135

Slide 135 text

支払いをしてからアイテムを受け取るまでの流れ ユーザー アプリ サーバー 支払いを行う レシート アイテムを渡す Google Play レシートを送信 レシート検証 購入情報を登録 購入結果

Slide 136

Slide 136 text

class BillingViewModel(application: Application) : ViewModel(), PurchasesUpdatedListener { ...省略... /** 購入完了、購入キャンセルなどのコールバック */ override fun onPurchasesUpdated( billingResult: BillingResult, purchases: MutableList? ) { } } BillingViewModel.kt

Slide 137

Slide 137 text

class BillingViewModel(application: Application) : ViewModel(), PurchasesUpdatedListener { ...省略... /** 購入完了、購入キャンセルなどのコールバック */ override fun onPurchasesUpdated( billingResult: BillingResult, purchases: MutableList? ) { } } BillingViewModel.kt

Slide 138

Slide 138 text

● Purchaseには注文IDや購入したアイテムのア イテムID、購入日時などの購入情報を含むレ シートが入っている ● レシートはユーザーが購入したことを証明する 唯一の手がかり レシートの取得、検証

Slide 139

Slide 139 text

● たとえば、ユーザーが購入している定期購入 の契約状況をサーバーが知りたい場合、レ シートに含まれる情報が無ければ契約情報を 取得できない レシートの取得、検証

Slide 140

Slide 140 text

● ユーザーのアイテム購入状況を取得するため にはレシートは必須 ● そのためレシートを受け取ったアプリは通常、 サービスのサーバーへレシートを送信する レシートの取得、検証

Slide 141

Slide 141 text

● Purchaseオブジェクトのsignatureというプロパ ティは購入情報を含むレシートデータを開発者 用の秘密鍵で署名しているため、これを送信 する レシートの取得、検証

Slide 142

Slide 142 text

● 署名されたレシートを受け取ったサーバーは 開発者用の公開鍵を使って復号化し、改ざん などを検証する ● 検証結果に問題がなければアプリに購入結果 を返却する レシートの取得、検証

Slide 143

Slide 143 text

● 結果を受け取ったアプリはユーザーに対して アイテム購入が完了したことを表示するなどし てアイテムの受け渡しが完了する レシートの取得、検証

Slide 144

Slide 144 text

定期購入を契約する

Slide 145

Slide 145 text

● 週、月、3ヶ月、6ヶ月、年間のいずれかの期間 で定期的に課金できるアイテム ● 新規の定期購入者に対して無料試用期間や お試し価格の設定もできる 定期購入

Slide 146

Slide 146 text

● ある定期購入アイテムから別の定期購入アイ テムへのプラン変更をする仕組みも提供され ている ● 初回購入以降の支払いは、アイテムに設定さ れている定期購入の期間に応じて自動的に支 払われる 定期購入

Slide 147

Slide 147 text

class BillingFragment : Fragment(), View.OnClickListener { ...省略... override fun onClick(v: View?) { billingViewModel.purchase( requireActivity(), BillingItem.MonthlyPlan ) } } BillingFragment.kt

Slide 148

Slide 148 text

class BillingFragment : Fragment(), View.OnClickListener { ...省略... override fun onClick(v: View?) { billingViewModel.purchase( requireActivity(), BillingItem.MonthlyPlan ) } } BillingFragment.kt

Slide 149

Slide 149 text

No content

Slide 150

Slide 150 text

定期購入のプランを変更する

Slide 151

Slide 151 text

● 定期購入の購入と同じくlaunchBillingFlowメ ソッドを使う ● BillingFlowParamsのsetOldSkuメソッドでプラ ン変更前の定期購入アイテムを指定する 定期購入のプラン変更

Slide 152

Slide 152 text

● 以前はsetOldSkuにSKUだけ渡せば良かった が、PBL 2.1.0からSKUだけを渡すメソッドは非 推奨となった ● SKUに加えて変更前のプランの PurchaseTokenが必要になった 定期購入のプラン変更

Slide 153

Slide 153 text

fun changePlan( activity: Activity, billingItem: BillingItem, oldBillingItem: BillingItem ) { billingClient.queryPurchaseHistoryAsync( BillingClient.SkuType.SUBS) { _, purchases -> val purchase: PurchaseHistoryRecord? = purchases.find { it.sku == oldBillingItem.sku } if (purchase == null) { _billingStatus.postValue( BillingStatus.NoPreviousPlanPurchaseHistory) return@queryPurchaseHistoryAsync } BillingViewModel.kt

Slide 154

Slide 154 text

fun changePlan( activity: Activity, billingItem: BillingItem, oldBillingItem: BillingItem ) { billingClient.queryPurchaseHistoryAsync( BillingClient.SkuType.SUBS) { _, purchases -> val purchase: PurchaseHistoryRecord? = purchases.find { it.sku == oldBillingItem.sku } if (purchase == null) { _billingStatus.postValue( BillingStatus.NoPreviousPlanPurchaseHistory) return@queryPurchaseHistoryAsync } BillingViewModel.kt

Slide 155

Slide 155 text

fun changePlan( activity: Activity, billingItem: BillingItem, oldBillingItem: BillingItem ) { billingClient.queryPurchaseHistoryAsync( BillingClient.SkuType.SUBS) { _, purchases -> val purchase: PurchaseHistoryRecord? = purchases.find { it.sku == oldBillingItem.sku } if (purchase == null) { _billingStatus.postValue( BillingStatus.NoPreviousPlanPurchaseHistory) return@queryPurchaseHistoryAsync } BillingViewModel.kt

Slide 156

Slide 156 text

fun changePlan( activity: Activity, billingItem: BillingItem, oldBillingItem: BillingItem ) { billingClient.queryPurchaseHistoryAsync( BillingClient.SkuType.SUBS) { _, purchases -> val purchase: PurchaseHistoryRecord? = purchases.find { it.sku == oldBillingItem.sku } if (purchase == null) { _billingStatus.postValue( BillingStatus.NoPreviousPlanPurchaseHistory) return@queryPurchaseHistoryAsync } BillingViewModel.kt

Slide 157

Slide 157 text

billingClient.queryPurchaseHistoryAsync( BillingClient.SkuType.SUBS) { _, purchases -> ...省略... getSkuDetails(billingItem) { skuDetails -> val flowParams = BillingFlowParams.newBuilder() .setSkuDetails(skuDetails) .setOldSku(purchase.sku, purchase.purchaseToken) .build() _billingStatus.postValue(BillingStatus.BillingFlow) billingClient.launchBillingFlow(activity, flowParams) } BillingViewModel.kt

Slide 158

Slide 158 text

billingClient.queryPurchaseHistoryAsync( BillingClient.SkuType.SUBS) { _, purchases -> ...省略... getSkuDetails(billingItem) { skuDetails -> val flowParams = BillingFlowParams.newBuilder() .setSkuDetails(skuDetails) .setOldSku(purchase.sku, purchase.purchaseToken) .build() _billingStatus.postValue(BillingStatus.BillingFlow) billingClient.launchBillingFlow(activity, flowParams) } BillingViewModel.kt

Slide 159

Slide 159 text

class BillingFragment : Fragment(), View.OnClickListener { ...省略... override fun onClick(v: View?) { billingViewModel.changePlan( requireActivity(), billingItem = BillingItem.MonthlyPremiumPlan, oldBillingItem = BillingItem.MonthlyPlan ) } } BillingFragment.kt

Slide 160

Slide 160 text

No content

Slide 161

Slide 161 text

アプリからacknowledgeする

Slide 162

Slide 162 text

acknowledgeに対応した支払いフロー ユーザー アプリ サーバー 支払いを行う レシート 承認リクエスト 承認結果 アイテムを渡す Google Play レシートを送信 レシート検証 購入情報を登録 購入結果

Slide 163

Slide 163 text

acknowledgeに対応した支払いフロー ユーザー アプリ サーバー 支払いを行う レシート 承認リクエスト 承認結果 アイテムを渡す Google Play レシートを送信 レシート検証 購入情報を登録 購入結果

Slide 164

Slide 164 text

private fun acknowledgePurchase(purchase: Purchase) { if (purchase.purchaseState == Purchase.PurchaseState.PURCHASED && purchase.isAcknowledged.not()) { val acknowledgePurchaseParams = AcknowledgePurchaseParams.newBuilder() .setPurchaseToken(purchase.purchaseToken) .build() billingClient.acknowledgePurchase( acknowledgePurchaseParams, this /* AcknowledgePurchaseResponseListener */ ) } BillingViewModel.kt

Slide 165

Slide 165 text

private fun acknowledgePurchase(purchase: Purchase) { if (purchase.purchaseState == Purchase.PurchaseState.PURCHASED && purchase.isAcknowledged.not()) { val acknowledgePurchaseParams = AcknowledgePurchaseParams.newBuilder() .setPurchaseToken(purchase.purchaseToken) .build() billingClient.acknowledgePurchase( acknowledgePurchaseParams, this /* AcknowledgePurchaseResponseListener */ ) } BillingViewModel.kt

Slide 166

Slide 166 text

private fun acknowledgePurchase(purchase: Purchase) { if (purchase.purchaseState == Purchase.PurchaseState.PURCHASED && purchase.isAcknowledged.not()) { val acknowledgePurchaseParams = AcknowledgePurchaseParams.newBuilder() .setPurchaseToken(purchase.purchaseToken) .build() billingClient.acknowledgePurchase( acknowledgePurchaseParams, this /* AcknowledgePurchaseResponseListener */ ) } BillingViewModel.kt

Slide 167

Slide 167 text

private fun acknowledgePurchase(purchase: Purchase) { if (purchase.purchaseState == Purchase.PurchaseState.PURCHASED && purchase.isAcknowledged.not()) { val acknowledgePurchaseParams = AcknowledgePurchaseParams.newBuilder() .setPurchaseToken(purchase.purchaseToken) .build() billingClient.acknowledgePurchase( acknowledgePurchaseParams, this /* AcknowledgePurchaseResponseListener */ ) } BillingViewModel.kt

Slide 168

Slide 168 text

class BillingViewModel(application: Application) : ViewModel(), BillingClientStateListener, PurchasesUpdatedListener, LifecycleObserver, AcknowledgePurchaseResponseListener { override fun onAcknowledgePurchaseResponse(billingResult: BillingResult) { if (billingResult.responseCode() == BillingClient.BillingResponseCode.OK) { _billingStatus.postValue(BillingStatus.AcknowledgeSuccess) } else { _billingStatus.postValue(BillingStatus.Error(billingResult)) } } } BillingViewModel.kt

Slide 169

Slide 169 text

プラン変更時の承認処理

Slide 170

Slide 170 text

● 購入アイテムの承認はプラン変更時も同様に 承認しなければならない ● プランを変更すると、Google Playの仕様上、 以前のプランがキャンセルされ、新たなプラン を契約するという形になる プラン変更時の承認処理

Slide 171

Slide 171 text

プラン変更時の支払いの流れ ユーザー アプリ Google Play 支払いを行う レシート プランを利用可能にする 以前のプランを解 約 新しいプランを契 約

Slide 172

Slide 172 text

プラン変更時の支払いの流れ ユーザー アプリ Google Play 支払いを行う レシート プランを利用可能にする 以前のプランを解 約 新しいプランを契 約

Slide 173

Slide 173 text

プラン変更時の支払いの流れ ユーザー アプリ Google Play 支払いを行う レシート プランを利用可能にする 以前のプランを解 約 新しいプランを契 約 プラン変更後3日以内に承認しなかった場合は？

Slide 174

Slide 174 text

プラン変更後3日以内に承認しなかった場合 ユーザー アプリ Google Play 支払いを行う レシート プランを利用可能にする 以前のプランを解 約 新しいプランを契 約 3日以内に承認 されていない 払い戻し

Slide 175

Slide 175 text

プラン変更後3日以内に承認しなかった場合 ユーザー アプリ Google Play 支払いを行う レシート プランを利用可能にする 以前のプランを解 約 新しいプランを契 約 3日以内に承認 されていない 払い戻し

Slide 176

Slide 176 text

プラン変更後3日以内に承認しなかった場合 ユーザー アプリ Google Play 支払いを行う レシート プランを利用可能にする 以前のプランを解 約 新しいプランを契 約 3日以内に承認 されていない 払い戻し ユーザーが新たにプランを契約し、 その契約が承認されない状態でプランを変更した場合は？

Slide 177

Slide 177 text

● テスト購入で確認したところ、以前購入したプ ランが承認されていない状態でもプラン変更は 可能 ● 承認されていない変更前のプランは払い戻さ れ、変更後のプランが承認されていれば問題 なく契約が継続される プラン変更時の承認処理

Slide 178

Slide 178 text

● 正しく承認しなければプラン契約中のユーザー が解約される事態になってしまう ● 確実に承認されるように慎重にフローを組む 必要がある プラン変更時の承認処理

Slide 179

Slide 179 text

Pending transactionsに対応する

Slide 180

Slide 180 text

● 購入後、通常のアプリ課金と同様に onPurchasesUpdatedメソッドに購入結果が 返却される ● 保留中の購入はpurchaseStateが PurchaseState.PENDINGになっている Pending transactionsに対応する

Slide 181

Slide 181 text

private fun acknowledgePurchase(purchase: Purchase) { if (purchase.purchaseState == Purchase.PurchaseState.PURCHASED && purchase.isAcknowledged.not()) { ...省略... } else if ( purchase.purchaseState == Purchase.PurchaseState.PENDING ) { _billingStatus.postValue(BillingStatus.PendingPurchase) } } BillingViewModel.kt

Slide 182

Slide 182 text

class BillingFragment : Fragment(), View.OnClickListener { override fun onViewCreated(view: View, savedInstanceState: Bundle?) { super.onViewCreated(view, savedInstanceState) billingViewModel.billingStatus.observe( viewLifecycleOwner, Observer { billingStatus -> when (billingStatus) { BillingStatus.SetupSuccess -> { // 購入履歴を取得して承認する } } }) } BillingFragment.kt

Slide 183

Slide 183 text

AIDLからPlay Billing Libraryに置 き換えた話

Slide 184

Slide 184 text

No content

Slide 185

Slide 185 text

● マネーフォワード MEでは2019年の3月に年額 プランの提供を開始した ● 年額プランを入れる前までは最初に課金が実 装されてからほぼ手が加えられていなかった ため、AIDLで実装されていた AIDLからPBLに置き換えた話

Slide 186

Slide 186 text

● 年額プランを実装する前にAIDLからPBLに置 き換えることにした AIDLからPBLに置き換えた話

Slide 187

Slide 187 text

1. aidlファイルを削除 2. Play Billing Libraryを導入 3. Play Billing Libraryによる課金実装 4. 古い定形コードを削除 AIDLからPBLに置き換えた話

Slide 188

Slide 188 text

● PBLにIInAppBillingServiceが含まれているた め、aidlはそのままにできないがaidlを削除す れば他はそのままにできる ● aidlを先に削除してPBLの実装を行うことでPR を分けてスムーズに移行ができた AIDLからPBLに置き換えた話

Slide 189

Slide 189 text

新しいアプリアイテムを追加するとき の注意点

Slide 190

Slide 190 text

● 管理対象アイテム ● 定期購入 ● 特典アイテム アプリアイテムの種類

Slide 191

Slide 191 text

● 管理対象アイテムと特典アイテムはステータス をいつでも切り替えられる ● 定期購入は一度有効にすると無効にはできな い 新しいアプリアイテム追加の注意点

Slide 192

Slide 192 text

● 各アイテムにはそれぞれ任意のアイテムIDを 割り当てる必要がある ● アイテムの作成後にアイテムIDを変更すること はできない 新しいアプリアイテム追加の注意点

Slide 193

Slide 193 text

● ステータスが無効であればアイテムを削除で きるが、削除したアイテムIDをもう一度使うこと はできない ● やり直しが効かない作業のため、アイテム作 成は十分に確認した上で行うべき 新しいアプリアイテム追加の注意点

Slide 194

Slide 194 text

● マネーフォワード MEではもともと月額のプレミ アムプランしか無かった ● 金額の違う新しいプランを追加すると金額が分 かってしまう MEで年額課金を追加したときの話

Slide 195

Slide 195 text

年額プラン追加前

Slide 196

Slide 196 text

年額プラン追加前

Slide 197

Slide 197 text

年額プラン追加後

Slide 198

Slide 198 text

年額プラン追加後

Slide 199

Slide 199 text

● アプリアイテムは、無効状態ではテスト購入で も購入はできないため、必ず有効にする必要 がある ○ しかし、有効にすると金額が分かってしまう … MEで年額課金を追加したときの話

Slide 200

Slide 200 text

● アイテム名だけ決めて金額は既存のアイテム と同じ金額にしてアイテムを追加 ● リリース直前くらいに年額プランの金額を変え ることでギリギリまで金額が見えないようにし た MEで年額課金を追加したときの話

Slide 201

Slide 201 text

定期購入のアップグレードと ダウングレードについて

Slide 202

Slide 202 text

● 定期購入はプランの変更ができるアップグ レードやダウングレードの機能が提供されてい る ● ユーザーは定期購入期間の終了を待たずに プランを変更できる 定期購入のアップグレードとダウングレード

Slide 203

Slide 203 text

● 無料期間を設定していて、すでに無料期間を 終えている場合はプラン変更をしても新たに無 料期間が発生することはない ● プラン変更を行うと有効な定期購入はただち にキャンセルされ、新たな定期購入が作成さ れる　 定期購入のアップグレードとダウングレード

Slide 204

Slide 204 text

● 最初の支払いは前の定期購入の未使用分を 使い切った後から始まる 定期購入のアップグレードとダウングレード

Slide 205

Slide 205 text

月額プラン 500円 / 月 プラン変更 2019年04月15日 年額プラン 5,500円 / 年 支払い日 2019年04月01日

Slide 206

Slide 206 text

月額プラン 500円 / 月 プラン変更 2019年04月15日 年額プラン 5,500円 / 年 支払い日 2019年04月01日 500円 / 30日 = 16.66円 / 日 250円分使用

Slide 207

Slide 207 text

月額プラン 500円 / 月 プラン変更 2019年04月15日 年額プラン 5,500円 / 年 支払い日 2019年04月01日 500円 / 30日 = 16.66円 / 日 250円分使用 前プランの残り = 250円

Slide 208

Slide 208 text

月額プラン 500円 / 月 プラン変更 2019年04月15日 年額プラン 5,500円 / 年 支払い日 2019年04月01日 500円 / 30日 = 16.66円 / 日 250円分使用 前プランの残り = 250円 5,500円 / 365日 = 15.07円 / 日

Slide 209

Slide 209 text

月額プラン 500円 / 月 プラン変更 2019年04月15日 年額プラン 5,500円 / 年 支払い日 2019年04月01日 500円 / 30日 = 16.66円 / 日 250円分使用 前プランの残り = 250円 5,500円 / 365日 = 15.07円 / 日 250円 / 15.07円 = 約16日分使用可能

Slide 210

Slide 210 text

月額プラン 500円 / 月 プラン変更 2019年04月15日 年額プラン 5,500円 / 年 支払い日 2019年04月01日 500円 / 30日 = 16.66円 / 日 250円分使用 前プランの残り = 250円 5,500円 / 365日 = 15.07円 / 日 250円 / 15.07円 = 約16日分使用可能 新プラン支払い開始 2019年05月02日

Slide 211

Slide 211 text

● 定期購入アイテム間のアップグレードやダウン グレードの関係性はPlay Consoleから何か紐 付け作業を行うわけではなく、実装をする際に 関連付けを行う 定期購入のアップグレードとダウングレード

Slide 212

Slide 212 text

● 月額のプレミアムプランから年額のプレミアム プランにアップグレードするなどの見せ方も開 発者が定義する 定期購入のアップグレードとダウングレード

Slide 213

Slide 213 text

アプリ課金の検証について

Slide 214

Slide 214 text

● テスト購入 ● 本購入 アプリ課金の購入の検証

Slide 215

Slide 215 text

● テスト購入は、アプリ内課金サンドボックスとも 呼ばれている ● 実際の課金をすることなく購入できるため、開 発中や販売準備期間にアプリ内課金のテスト を安全かつ手軽に実施できる テスト購入

Slide 216

Slide 216 text

● 請求権限を追加したAPKがアルファ版または ベータ版にすでにアップロードされていれば、 デバッグ中のアプリでもテスト購入が可能（※ パッケージは製品版の必要有） ● 特定のライセンステストユーザーが課金を伴 わずにアプリ内アイテムを購入できる テスト購入

Slide 217

Slide 217 text

No content

Slide 218

Slide 218 text

No content

Slide 219

Slide 219 text

No content

Slide 220

Slide 220 text

No content

Slide 221

Slide 221 text

● 通常のユーザーが正規の支払いプロセスを経 て実際の課金を伴ってアプリ内課金を購入す る方法 ● 購入するにはアルファ版またはベータ版として アプリをリリースする必要がある 本購入

Slide 222

Slide 222 text

● 実際のお金がかかるので、新しい課金アイテ ムを追加したときなどのリリース直前の最終 チェックなどで行うとよい 本購入

Slide 223

Slide 223 text

まとめ

Slide 224

Slide 224 text

● PBLのロードマップが発表された ○ AIDLとPBL 1.xは2021/05/01までにPBL 2.xに移行必須 ● PBL 2.xからはすべての購入に対して acknowledgeが必須 ○ 3日以内に払い戻しされてしまう まとめ

Slide 225

Slide 225 text

● Pending transactionsやアプリ外購入などを 考慮してどの画面からでも購入を検知し、ユー ザーに購入を伝えることが重要 ● アプリアイテムの追加や購入の検証は慎重に まとめ

Slide 226

Slide 226 text

● The “Purchase Anywhere” Paradigm Shift (Android Dev Summit '19) ○ https://youtu.be/L2aiHRD6Pfk ● Required Updates and New Functionality (Android Dev Summit '19) ○ https://youtu.be/Cj5vq1AOJeQ ● What's New with Google Play Billing (Google I/O'19) ○ https://youtu.be/N4004Set4F8 参考資料

Slide 227

Slide 227 text

ありがとうございました