Verilerinizi güvenli bir şekilde almak için Google Play Store'un Install Referrer API'sini kullanabilirsiniz tavsiye içeriği. Play Install Referrer API İstemci Kitaplığı Java programlama dilinde yazılmıştır ve Android için bir sarmalayıcıdır Search Ads 360'ın arayüzünü tanımlayan Arayüz Tanımlama Dili (AIDL) Yönlendiren hizmetini yükleyin. Play Install Referrer API istemcisini kullanabilirsiniz Kitaplık.
Bu kılavuzda, Google'dan yönlendirme bilgileri almayla ilgili temel bilgiler yer almaktadır. Play Install Yönlendiren Kitaplığı'nı kullanarak oynayın.
Uygulamanızın bağımlılıklarını güncelleme
Aşağıdaki satırı build.gradle
dosyasının bağımlılıklar bölümüne ekleyin.
uygulamanız için:
Eski
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ğıdakini kullanarak Play Store uygulamasıyla bağlantı kurun: için şu adımları izleyin:
- Şunu çağırın:
newBuilder()
yöntemini kullanarakInstallReferrerClient
sınıfını kullanır. Şunu çağırın:
startConnection()
Google Play ile bağlantı kurun.startConnection()
yöntem eşzamansız olduğundanInstallReferrerStateListener
sonra geri aranmak içinstartConnection()
gerekir.onInstallReferrerSetupFinished()
ayarını geçersiz kıl yöntemini çağırın. Bu yöntem farklı durumları ele almak için kullanmanız gereken bir yanıt koduylaOK
bağlantının başarılı olduğunu gösterir. Birbirlerinin her biriInstallReferrerResponse
sabit değerleri farklı hata türleri için kullanılır.onInstallReferrerServiceDisconnected()
ayarını geçersiz kıl Google Play ile kaybedilen bağlantıları yönetme yöntemi. Örneğin, örneğin, Play Install Referrer Library istemcisi Play Store hizmeti arka planda güncelleniyor. Kitaplık istemcisi "the"startConnection()
yöntemini çağırın.
Aşağıdaki kod, Play Store uygulaması:
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önlendirenini alma
Play Store uygulamasıyla bağlantı kurduktan sonra ayrıntıları öğrenin şu adımları uygulayarak yükleme yönlendirenden kaldırın:
Senkronize edilmiş
getInstallReferrer()
yöntemini döndürmeReferrerDetails
.ReferrerDetails
class, yükleme yönlendirenle ilgili ayrıntıların alınmasını sağlar.
Aşağıdaki kod, yükleme yönlendirene nasıl erişebileceğinizi gösterir bilgi:
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();
Dikkat: Yükleme yönlendiren bilgisi 90 gün boyunca kullanılabilir ve uygulama şu anda değişmez yeniden yüklendi. Uygulamanızda gereksiz API çağrılarını önlemek için Yüklemeden sonraki ilk yürütme sırasında yalnızca bir kez API.
Hizmet bağlantısı kapatılıyor
Yönlendiren bilgilerini aldıktan sonra,
endConnection()
yöntemi üzerindeki
InstallReferrerClient
bağlantıyı kapatın. Bağlantıyı kapatmanız durumunda,
ve performans sorunlarını göz önünde bulundurun.
Daha fazla bilgi için bkz. Play Install Referrer Library Referans.