Biblioteka odsyłająca do instalacji z Play

Aby bezpiecznie pobierać treści, możesz używać interfejsu Install Referrer API w Sklepie Google Play. materiałów odsyłających z Google Play. Biblioteka klienta interfejsu Play Install Referrer API jest napisany w języku Java i stanowi otokę dla Androida Plik AIDL (Interface Definition Language) definiujący interfejs Zainstaluj usługę odsyłającą. Możesz użyć klienta interfejsu Play Install Referrer API Biblioteka, która upraszcza proces programowania.

Ten przewodnik zawiera podstawowe informacje o pobieraniu informacji o odsyłaniu z Google. Graj, korzystając z biblioteki odsyłającej do instalacji z Play.

Aktualizowanie zależności aplikacji

Dodaj poniższy wiersz do sekcji zależności pliku build.gradle dla Twojej aplikacji:

Odlotowe

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

Kotlin

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

Łączę z Google Play

Zanim zaczniesz korzystać z biblioteki interfejsu Play Install Referrer API, musisz: połączyć się z aplikacją Sklep Play za pomocą tych metod kroki:

  1. Wywołaj funkcję newBuilder() metody tworzenia instancji InstallReferrerClient zajęcia.

  2. Wywołaj funkcję startConnection() aby nawiązać połączenie z Google Play.

  3. startConnection() jest asynchroniczna, więc musisz zastąpić InstallReferrerStateListener aby otrzymać oddzwonienie po startConnection() .

  4. Zastąpienie onInstallReferrerSetupFinished() . Metoda ta nosi nazwę kodem odpowiedzi, którego należy użyć do obsługi różnych stanów. OK oznacza, że udało się nawiązać połączenie. Każda z pozostałych InstallReferrerResponse odnoszą się do różnych rodzajów błędów.

  5. Zastąpienie onInstallReferrerServiceDisconnected() do obsługi utraconych połączeń z Google Play. Dla: np. klient biblioteki stron odsyłających do instalacji z Play może utracić połączenie, jeśli Usługa Sklep Play jest aktualizowana w tle. Klient biblioteki musi wywołać startConnection() ponownego uruchomienia połączenia przed wysłaniem kolejnych żądań.

Poniższy kod pokazuje, jak uruchomić i przetestować połączenie z Aplikacja 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.
    }
});

Uzyskiwanie strony odsyłającej do instalacji

Po nawiązaniu połączenia z aplikacją Sklep Play sprawdź szczegóły ze strony odsyłającej do instalacji, wykonując te czynności:

  1. Użyj przycisku getInstallReferrer() do zwrócenia instancji ReferrerDetails

  2. Korzystaj z metod, które ReferrerDetails klasa udostępnia szczegółowe informacje o stronie odsyłającej do instalacji.

Poniższy kod ilustruje, jak uzyskać dostęp do strony odsyłającej do instalacji informacje:

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

Uwaga: informacje o stronie odsyłającej do instalacji będą dostępne przez 90 dni i nie zmieni się, chyba że wniosek zostanie zainstalowano ponownie. Aby uniknąć zbędnych wywołań interfejsu API w aplikacji, wywołuj metodę API tylko raz podczas pierwszego wykonania po instalacji.

Zamykam połączenie z usługą

Po uzyskaniu informacji o stronie odsyłającej wywołaj metodę endConnection() na InstallReferrerClient w celu zamknięcia połączenia. Zamknięcie połączenia pomoże Ci uniknąć wyciek danych i problemy z wydajnością.

Więcej informacji znajdziesz w bibliotece odsyłającej do instalacji z Play Plik referencyjny.