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:
- Wywołaj metodę
newBuilder(), aby utworzyć instancję klasyInstallReferrerClient. - Wywołaj metodę
startConnection(), aby nawiązać połączenie z Google Play. - Ponieważ
startConnection()jest asynchroniczny, zaimplementujInstallReferrerStateListener, aby otrzymać wywołanie zwrotne po zakończeniustartConnection(). - 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.OKoznacza, że połączenie zostało nawiązane. Inne stałeInstallReferrerResponsewskazują różne typy błędów. - 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:
- Użyj zsynchronizowanej metody
getInstallReferrer(), aby zwrócić instancjęReferrerDetails. - 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.