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:
InstallReferrerClientsınıfının bir örneğini oluşturmak içinnewBuilder()yöntemini çağırın.- Google Play ile bağlantı kurmak için
startConnection()yöntemini çağırın. startConnection()eşzamansız olduğundan,startConnection()tamamlandıktan sonra geri çağırma almak içinInstallReferrerStateListeneryöntemini uygulayın.- 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ğerInstallReferrerResponsesabitleri, farklı hata türlerini gösterir. - 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çinstartConnection()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:
ReferrerDetailsörneği döndürmek için senkronize edilmişgetInstallReferrer()yöntemini kullanın.- Yükleme yönlendireni hakkında ayrıntılı bilgi edinmek için
ReferrerDetailssı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.