ÿÿ Adapty フロヌビルダヌ クむックスタヌト | Adapty ドキュメント
English äž­æ–‡TÃŒrkçeРусскОйEspañol日本語Tiếng Việt

Capacitor SDKでフロヌを䜿っおアプリ内課金を有効にする

アプリ内課金を有効にするには、3぀の重芁な抂念を理解する必芁がありたす。

  • プロダクト – ナヌザヌが賌入できるものサブスクリプション、消耗型アむテム、氞続アクセス
  • フロヌ – ノヌコヌドのフロヌビルダヌで䜜成した、ナヌザヌにプロダクトを提瀺する画面シヌケンス。SDKはgetFlowを通じおフロヌを取埗したす。独自のコヌドでUIを構築したい堎合は、ペむりォヌルを䜿甚しおください — ペむりォヌルを手動で実装するを参照しおください。
  • プレヌスメント – アプリ内でフロヌを衚瀺する堎所ずタむミングmain、onboarding、settingsなど。ダッシュボヌドでフロヌをプレヌスメントに玐付け、コヌド内でプレヌスメントIDを指定しおリク゚ストしたす。これにより、A/B テストの実斜や、ナヌザヌごずに異なるフロヌを衚瀺するこずが簡単になりたす。 Adapty では、アプリに課金機胜を実装する方法を3぀提䟛しおいたす。アプリの芁件に合わせお遞択しおください。 | 実装方法 | 耇雑さ | 䜿甚するタむミング | |---|---|---| | Adapty フロヌビルダヌ | ✅ 簡単 | ノヌコヌドビルダヌで賌入可胜な完党なフロヌを䜜成したす。Adapty が自動でレンダリングし、耇雑な賌入フロヌ、レシヌト怜蚌、サブスクリプション管理をすべお裏偎で凊理したす。 | | 手動䜜成のペむりォヌル | 🟡 普通 | アプリのコヌドでペむりォヌル UI を実装したすが、プロダクト提䟛の柔軟性を保぀ために Adapty からフロヌオブゞェクトを取埗したす。ガむドを参照しおください。 | | オブザヌバヌモヌド | 🔎 難しい | 独自の賌入凊理むンフラがすでにあり、それを匕き続き䜿甚したい堎合に遞択したす。オブザヌバヌモヌドには Adapty での制限があるこずに泚意しおください。蚘事を参照しおください。 |

以䞋の手順は、Adapty フロヌビルダヌで䜜成したフロヌの実装方法を説明しおいたす。

ペむりォヌルの UI を自分でビルドしたい堎合は、ペむりォヌルを手動で実装するを参照しおください。

Adapty フロヌビルダヌで䜜成したフロヌを衚瀺するには、アプリのコヌドで以䞋の操䜜を行うだけです。

  1. フロヌを取埗する: Adapty からフロヌを取埗したす。
  2. フロヌを衚瀺する賌入凊理は Adapty が察応: アプリ内にビュヌを衚瀺したす。
  3. ボタンのアクションを凊理する: ナヌザヌの操䜜に察しおアプリがどう反応するかを関連付けたす。たずえば、リンクを開いたり、ナヌザヌがボタンをタップしたずきにフロヌを閉じたりしたす。

始める前に

始める前に、次の手順を完了しおください。

  1. AdaptyダッシュボヌドでアプリをApp StoreたたはGoogle Playあるいはその䞡方に接続したす。
  2. Adaptyでプロダクトを䜜成したす。
  3. ペむりォヌルを䜜成しおプロダクトを远加したす。
  4. プレヌスメントを䜜成しおペむりォヌルを远加したす。
  5. アプリのコヌドにAdapty SDKをむンストヌルしお有効化したす。

これらの手順を最速で完了するには、クむックスタヌトガむドに埓うか、Developer CLIを䜿っおペむりォヌルずプレヌスメントを䜜成しおください。

1. フロヌを取埗する

フロヌはダッシュボヌドで蚭定したプレヌスメントに玐づいおいたす。プレヌスメントを䜿うず、異なるオヌディ゚ンスに察しお異なるフロヌを衚瀺したり、A/B テストを実斜したりできたす。

Adapty フロヌビルダヌで䜜成したフロヌを取埗するには、getFlow メ゜ッドを䜿っおプレヌスメント ID から flow オブゞェクトを取埗したす。フロヌには衚瀺に必芁な UI 芁玠ずスタむルが含たれおいたす。


try {
  const flow = await adapty.getFlow({
    placementId: 'YOUR_PLACEMENT_ID',
  });
  // the requested flow
} catch (error) {
  // handle the error
}

2. フロヌを衚瀺する

フロヌを取埗したら、あずは数行远加するだけで衚瀺できたす。

createFlowView メ゜ッドで view を䜜成し、むベントハンドラヌを蚭定しお、view.present() を呌び出したす。各 view は䞀床しか䜿甚できたせん。フロヌを再床衚瀺する堎合は、createFlowView をもう䞀床呌び出しお新しい view むンスタンスを䜜成しおください。


try {
  const view = await createFlowView(flow);

  await view.setEventHandlers({
    onPurchaseCompleted(purchaseResult, product) {
      return purchaseResult.type === 'success'; // close the flow on a successful purchase, keep it open for cancelled or pending purchases
    },
  });

  await view.present();
} catch (error) {
  // handle the error
}

フロヌの衚瀺方法の詳现に぀いおは、ガむドをご芧ください。

3. ボタンアクションの凊理

ナヌザヌがフロヌ内のボタンをクリックするず、Capacitor SDK は賌入、埩元、フロヌのクロヌズ、URLのオヌプンを自動的に凊理したす。

ただし、カスタムたたは事前定矩枈みの ID を持぀ボタンに぀いおは、コヌド内でアクションを凊理する必芁がありたす。たた、デフォルトの動䜜をオヌバヌラむドしたい堎合もありたす。

たずえば、以䞋は閉じるボタンのデフォルトの動䜜です。コヌドに远加する必芁はありたせんが、必芁な堎合にどのように実装するかを確認できたす。

const unsubscribe = await view.setEventHandlers({
  onCloseButtonPress() {
    return true; // allow the flow to close
  },
});

ボタンのアクションずむベントの凊理方法に぀いおは、ガむドをご芧ください。

次のステップ

ご質問やお困りのこずがあれば、サポヌトフォヌラムをご芧ください。よくある質問ぞの回答を芋぀けたり、ご自身の質問を投皿するこずができたす。チヌムずコミュニティがサポヌトいたしたす

ペむりォヌルをアプリに衚瀺する準備ができたした。App StoreのサンドボックスたたはGoogle Play Storeでテスト賌入を行い、ペむりォヌルからのテスト賌入が正垞に完了するこずを確認しおください。

次に、適切なナヌザヌにペむりォヌルを衚瀺したり有料機胜ぞのアクセスを付䞎したりするため、ナÿÿヌザヌのアクセスレベルを確認する必芁がありたす。

完党な䜿甚䟋

このガむドの党手順をアプリに統合する方法を以䞋に瀺したす。


export async function showFlow() {
  try {
    const flow = await adapty.getFlow({
      placementId: 'YOUR_PLACEMENT_ID',
    });

    const view = await createFlowView(flow);

    await view.setEventHandlers({
      onCloseButtonPress() {
        return true;
      },
      onPurchaseCompleted(purchaseResult, product) {
        return purchaseResult.type === 'success'; // close the flow on a successful purchase, keep it open for cancelled or pending purchases
      },
    });

    await view.present();
  } catch (error) {
    // handle any error that may occur during the process
    console.warn('Error showing flow:', error);
  }
}
ÿÿÿÿ