Kotlin Multiplatform SDK 概要

ようこそ！アプリ内課金をもっと簡単にするお手伝いをします 🚀

Adapty Kotlin Multiplatform SDKは、アプリ内課金の面倒な作業を肩代わりし、あなたが最も得意なこと——素晴らしいアプリを作ること——に集中できるよう設計されています。私たちが代わりに対応する内容はこちらです：

• 購入処理、レシート検証、サブスクリプション管理をすぐに利用可能
• アプリのアップデートなしにペイウォールを作成・テスト可能
• ゼロ設定で詳細な購入分析を取得 — コホート、LTV、チャーン、ファネル分析を標準搭載
• アプリセッションやデバイスをまたいでユーザーのサブスクリプション状態を常に最新に維持
• たった1行のコードでアプリをマーケティングアトリビューションや分析サービスと連携

はじめに

インテグレーションガイドで説明する内容は以下のとおりです。

1. SDKのインストールと設定: SDKをプロジェクトの依存関係として追加し、コードで有効化します。
2. フローを通じて購入を有効にする: ユーザーがプロダクトを購入できるよう購入フローを設定します。独自のUIを構築する場合は、代わりにペイウォールを手動で実装するを参照してください。
3. サブスクリプションステータスの確認: ユーザーのサブスクリプション状態を自動的に確認し、有料コンテンツへのアクセスを管理します。
4. ユーザーの識別（任意）: ユーザーをAdaptyのプロファイルに関連付けて、デバイスをまたいでデータが一貫して保存されるようにします。

実際に動作を確認する

全体の流れを確認したい方はこちらをご覧ください：

• サンプルアプリ: 完全なセットアップを示したサンプルをご確認ください
• ビデオチュートリアル: 以下のステップバイステップ実装動画をご参照ください

主要概念

コードに入る前に、Adapty を動かす主要な概念を把握しておきましょう。

Adapty のアプローチの優れた点は、アプリにハードコードするのはプレースメントだけという点です。それ以外のすべて（プロダクト、ペイウォールのデザイン、価格、オファー）は、アプリのアップデートなしに Adapty ダッシュボードから柔軟に管理できます。

1. プロダクト - アプリ内で購入可能なあらゆるもの（サブスクリプション、消耗型アイテム、永続アクセスなど）。

2. フローまたはペイウォール - プレースメントに紐付けられた、設定付きのプロダクトのまとまりです。2種類あります：

   • フロー - フロービルダーで作成するビジュアルなノーコードインターフェースです。AdaptyがUIをレンダリングし、購入処理も代行します。
   • ペイウォール - ビジュアル設定はなく、UIは自分のコードで構築し、makePurchase を自分で呼び出します。詳細はペイウォールの手動実装をご覧ください。

   SDKコードでは、どちらも同じ getFlow メソッドで取得します。

3. プレースメント - フローやペイウォールを表示したいユーザージャーニー上の戦略的なポイントです。プレースメントは、収益化戦略の「どこで」「いつ」を決めるものです。主なプレースメントの例：

   • main - 主要なペイウォールの表示場所
   • onboarding - ユーザーのオンボーディングフロー中に表示
   • settings - アプリの設定からアクセス可能

   最初の統合では main や onboarding といった基本的なものから始め、その後アプリ内でユーザーが購入を検討しそうな他の場所についても検討してみましょう。

4. プロファイル - ユーザーがプロダクトを購入すると、そのプロファイルにアクセスレベルが付与され、有料機能へのアクセスを管理できます。