Biblioteka odsyłająca do instalacji z Play

Za pomocą interfejsu Install Referrer API Sklepu Google Play możesz bezpiecznie pobierać treści odesłania z Google Play. Biblioteka klienta interfejsu Play Install Referrer API jest napisana w języku programowania Java i jest kodem otaczającym plik języka definiowania interfejsu Androida (AIDL), który definiuje interfejs usługi Install Referrer. Aby uprościć proces programowania, możesz użyć biblioteki klienta Play Install Referrer API.

Ten przewodnik zawiera podstawowe informacje o pobieraniu informacji o źródle odesłania z Google Play za pomocą biblioteki Play Install Referrer.

Aktualizowanie zależności aplikacji

Dodaj ten wiersz do sekcji zależności w pliku build.gradle aplikacji:

Dynamiczny

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

Kotlin

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

Łączenie z Google Play

Zanim zaczniesz korzystać z biblioteki interfejsu Play Install Referrer API, musisz połączyć się z aplikacją Sklep Play, wykonując te czynności:

  1. Wywołaj metodę newBuilder(), aby utworzyć instancję klasy InstallReferrerClient.
  2. Wywołaj metodę startConnection(), aby nawiązać połączenie z Google Play.
  3. Ponieważ startConnection() jest asynchroniczny, zaimplementuj InstallReferrerStateListener, aby otrzymać wywołanie zwrotne po zakończeniu startConnection().
  4. Zastąp metodę onInstallReferrerSetupFinished(), aby otrzymywać powiadomienia po zakończeniu wywołania zwrotnego. Ta metoda przekazuje kod odpowiedzi, którego musisz użyć do obsługi różnych stanów. OK oznacza, że połączenie zostało nawiązane. Inne stałe InstallReferrerResponse wskazują różne typy błędów.
  5. Zastąp metodę onInstallReferrerServiceDisconnected(), aby obsługiwać utracone połączenia z Google Play. Na przykład klient biblioteki Play Install Referrer może utracić połączenie, jeśli usługa Sklep Play jest aktualizowana w tle. Klient biblioteki musi wywołać metodę startConnection(), aby ponownie uruchomić połączenie przed wysłaniem kolejnych żądań.

Poniższy kod pokazuje, jak rozpocząć i przetestować połączenie z aplikacją Sklep Play:

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.
    }
});

Pobieranie informacji o źródle instalacji

Po nawiązaniu połączenia z aplikacją Sklep Play uzyskaj szczegółowe informacje z źródła odesłania do instalacji, wykonując te czynności:

  1. Użyj zsynchronizowanej metody getInstallReferrer(), aby zwrócić instancję ReferrerDetails.
  2. Aby uzyskać szczegółowe informacje o źródle odesłania, użyj metod udostępnianych przez klasę ReferrerDetails.

Poniższy kod pokazuje, jak uzyskać dostęp do informacji o źródle odesłania instalacji:

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();

Zamykam połączenie z usługą

Po uzyskaniu informacji o źródle odesłania wywołaj metodę endConnection() w instancji InstallReferrerClient, aby zamknąć połączenie. Zamknięcie połączenia pomaga uniknąć wycieków i problemów z wydajnością.

Więcej informacji znajdziesz w dokumentacji biblioteki Play Install Referrer.