Play Install Referrer Kitaplığı

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:

  1. Şunu çağırın: newBuilder() yöntemini kullanarak InstallReferrerClient sınıfını kullanır.

  2. Şunu çağırın: startConnection() Google Play ile bağlantı kurun.

  3. startConnection() yöntem eşzamansız olduğundan InstallReferrerStateListener sonra geri aranmak için startConnection() gerekir.

  4. 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 koduyla OK bağlantının başarılı olduğunu gösterir. Birbirlerinin her biri InstallReferrerResponse sabit değerleri farklı hata türleri için kullanılır.

  5. 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:

  1. Senkronize edilmiş getInstallReferrer() yöntemini döndürme ReferrerDetails.

  2. 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.