Play Install Referrer Kitaplığı

Google Play'den yönlendirme içeriğini güvenli bir şekilde almak için Google Play Store'un Install Referrer API'sini kullanabilirsiniz. Play Install Referrer API istemci kitaplığı, Java programlama dilinde yazılmıştır ve Install Referrer hizmetinin arayüzünü tanımlayan Android Arayüz Tanımlama Dili (AIDL) dosyası için bir sarmalayıcıdır. Geliştirme sürecinizi basitleştirmek için Play Install Referrer API istemci kitaplığını kullanabilirsiniz.

Bu kılavuzda, Play Install Referrer Kitaplığı'nı kullanarak Google Play'den yönlendiren bilgilerini almanın temel adımları açıklanmaktadır.

Uygulamanızın bağımlılıklarını güncelleme

Uygulamanızın build.gradle dosyasının bağımlılıklar bölümüne aşağıdaki satırı ekleyin:

Modern

dependencies {
    ...
    implementation "com.android.installreferrer:installreferrer:2.2"
}

Kotlin

dependencies {
    ...
    implementation("com.android.installreferrer:installreferrer:2.2")
}

Google Play'e bağlanılıyor

Play Install Referrer API kitaplığını kullanabilmek için aşağıdaki adımları uygulayarak Play Store uygulamasıyla bağlantı kurmanız gerekir:

  1. InstallReferrerClient sınıfının bir örneğini oluşturmak için newBuilder() yöntemini çağırın.
  2. Google Play ile bağlantı kurmak için startConnection() yöntemini çağırın.
  3. startConnection() eşzamansız olduğundan, startConnection() tamamlandıktan sonra geri çağırma almak için InstallReferrerStateListener yöntemini uygulayın.
  4. Geri çağırma tamamlandığında bildirim almak için onInstallReferrerSetupFinished() yöntemini geçersiz kılın. Bu yöntem, farklı durumları işlemek için kullanmanız gereken bir yanıt kodu iletir. OK, bağlantının başarılı olduğunu gösterir. Diğer InstallReferrerResponse sabitleri, farklı hata türlerini gösterir.
  5. Google Play ile bağlantı kesildiğinde yapılacak işlemleri belirlemek için onInstallReferrerServiceDisconnected() yöntemini geçersiz kılın. Örneğin, Play Store hizmeti arka planda güncelleniyorsa Play Install Referrer Library istemcisi bağlantıyı kaybedebilir. Kitaplık istemcisi, başka istekler göndermeden önce bağlantıyı yeniden başlatmak için startConnection() yöntemini çağırmalıdır.

Aşağıdaki kodda, Play Store uygulamasıyla bağlantının nasıl başlatılacağı ve test edileceği gösterilmektedir:

Kotlin

private lateinit var referrerClient: InstallReferrerClient

referrerClient = InstallReferrerClient.newBuilder(this).build()
referrerClient.startConnection(object : InstallReferrerStateListener {

    override fun onInstallReferrerSetupFinished(responseCode: Int) {
        when (responseCode) {
            InstallReferrerResponse.OK -> {
                // Connection established.
            }
            InstallReferrerResponse.FEATURE_NOT_SUPPORTED -> {
                // API not available on the current Play Store app.
            }
            InstallReferrerResponse.SERVICE_UNAVAILABLE -> {
                // Connection couldn't be established.
            }
        }
    }

    override fun onInstallReferrerServiceDisconnected() {
        // Try to restart the connection on the next request to
        // Google Play by calling the startConnection() method.
    }
})

Java

InstallReferrerClient referrerClient;

referrerClient = InstallReferrerClient.newBuilder(this).build();
referrerClient.startConnection(new InstallReferrerStateListener() {
    @Override
    public void onInstallReferrerSetupFinished(int responseCode) {
        switch (responseCode) {
            case InstallReferrerResponse.OK:
                // Connection established.
                break;
            case InstallReferrerResponse.FEATURE_NOT_SUPPORTED:
                // API not available on the current Play Store app.
                break;
            case InstallReferrerResponse.SERVICE_UNAVAILABLE:
                // Connection couldn't be established.
                break;
        }
    }

    @Override
    public void onInstallReferrerServiceDisconnected() {
        // Try to restart the connection on the next request to
        // Google Play by calling the startConnection() method.
    }
});

Yükleme yönlendirmesini alma

Play Store uygulamasıyla bağlantı kurduktan sonra aşağıdaki adımları tamamlayarak yükleme yönlendireninden ayrıntıları alın:

  1. ReferrerDetails örneği döndürmek için senkronize edilmiş getInstallReferrer() yöntemini kullanın.
  2. Yükleme yönlendireni hakkında ayrıntılı bilgi edinmek için ReferrerDetails sınıfının sağladığı yöntemleri kullanın.

Aşağıdaki kodda, yükleme yönlendiren bilgilerine nasıl erişebileceğiniz gösterilmektedir:

Kotlin

val response: ReferrerDetails = referrerClient.installReferrer
val referrerUrl: String = response.installReferrer
val referrerClickTime: Long = response.referrerClickTimestampSeconds
val appInstallTime: Long = response.installBeginTimestampSeconds
val instantExperienceLaunched: Boolean = response.googlePlayInstantParam

Java

ReferrerDetails response = referrerClient.getInstallReferrer();
String referrerUrl = response.getInstallReferrer();
long referrerClickTime = response.getReferrerClickTimestampSeconds();
long appInstallTime = response.getInstallBeginTimestampSeconds();
boolean instantExperienceLaunched = response.getGooglePlayInstantParam();

Hizmet bağlantısı kapatılıyor

Yönlendiren bilgilerini aldıktan sonra bağlantıyı kapatmak için InstallReferrerClient örneğinizde endConnection() yöntemini çağırın. Bağlantıyı kapatmak, sızıntıları ve performans sorunlarını önlemenize yardımcı olur.

Daha fazla bilgi için Play Install Referrer Kitaplığı Referansı'na bakın.