メインコンテンツまでスキップ

インストーラーストアのリファラルディープリンク

概要​

アプリ内リファラル機能により、ユーザーは友達をシームレスに招待してアプリをインストールでき、パーソナライズされた共有可能なリファラルリンクを通じてユーザー獲得を強化します。

リファラルプログラム中、または評価を残す際に、ユーザーが元のアプリストアにリダイレクトされるようにすることは、一貫したユーザーエクスペリエンスにとって重要です。

このガイドでは、Android Billing SDK を使用してリファラルディープリンクを取得するために必要な基本情報とコードスニペットを提供します。

説明​

このガイドでは、リファラルディープリンクを取得する方法を示します。

アプリケーションでの実装に進むにあたって、まず最初の目標は、クライアントをインスタンス化して Billing SDK に接続することです。クライアントを取得した後、それを使用してメソッドを実行できます。

したがって、実装は 2 つのステップで構成されます。

  1. Android Billing SDK との接続をセットアップする。
  2. リファラルディープリンクをリクエストする。

ステップ 1: Android Billing SDK に接続する​

このためには、Android Billing SDK - Android Billing SDK との接続のセットアップのドキュメントに従ってください。

ステップ 2: リファラルディープリンクをリクエストする​

リファラルディープリンクを取得するには、getReferralDeeplink() メソッドを実行します。これにより ReferralDeeplink が取得されます。その後、受信した結果を処理し、ReferralDeeplink で利用可能なデータを使用します。

次のアプローチに従って実行してください。

private fun obtainReferralDeeplink() {
  val thread = Thread {
    val referralDeeplink = cab.referralDeeplink
    if (referralDeeplink.responseCode == ResponseCode.OK){
      // Referral Deeplink was retrieved successfully
    	...
    } else {
      // Failed to retrieve Referral Deeplink
      ...
    }
  }
  thread.start()
}
private void obtainReferralDeeplink() {
  Thread thread = new Thread(() -> {
    ReferralDeeplink referralDeeplink = cab.getReferralDeeplink();
    if (referralDeeplink.getResponseCode() == ResponseCode.OK){
      // Referral Deeplink was retrieved successfully
    	...
    } else {
      // Failed to retrieve Referral Deeplink
      ...
    }
  });
  thread.start();
}

このパラメータは、インストーラーストアへの直接ディープリンクを取得します。Android ネイティブディープリンクまたは Web リンクのいずれかになります。

このパラメータは、Aptoide ストアを指す Web リンクを取得します。

デバイスが Android ネイティブディープリンクをサポートしている場合は、パフォーマンス向上のために storeDeeplink パラメータを使用してください。ネイティブサポートが存在しない場合は、Aptoide ストアを指す fallbackDeeplink にフォールバックしてください。


ベストプラクティス​

ReferralDeeplink をリクエストする前に、デバイスにアクティブなネットワーク接続があることを確認してください。Android の ConnectivityManager などの API を使用して、ネットワークステータスを確認します。
例外やエラーを適切に処理し、必要に応じてフォールバックオプションやユーザーガイダンスを提供してください。