Play Install Referrer Library

Mit der Install Referrer API des Google Play Store können Sie von Google Play empfohlen. Clientbibliothek für die Play Install Referrer API ist in der Programmiersprache Java geschrieben und dient als Wrapper für die AIDL-Datei (Interface Definition Language), die die Schnittstelle zum Installieren Sie den Verweisdienst. Du kannst den Play Install Referrer API-Client verwenden, Bibliothek zur Vereinfachung des Entwicklungsprozesses.

In diesem Leitfaden werden die Grundlagen zum Abrufen von Verweisinformationen von Google behandelt. Verwende die Play Install Referrer Library zum Spielen.

Abhängigkeiten der Anwendung aktualisieren

Fügen Sie die folgende Zeile in den Abschnitt „Abhängigkeiten“ der Datei build.gradle ein für Ihre App:

Cool

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

Kotlin

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

Verbindung mit Google Play wird hergestellt

Bevor Sie die Play Install Referrer API-Bibliothek verwenden können, müssen Sie stellen Sie wie folgt eine Verbindung zur Play Store App her: Schritte:

  1. Rufen Sie die Methode newBuilder() eine Instanz von InstallReferrerClient .

  2. Rufen Sie die Methode startConnection() um eine Verbindung zu Google Play herzustellen.

  3. Die startConnection() ist asynchron, d. h., Sie müssen die InstallReferrerStateListener um einen Rückruf zu erhalten, startConnection() abgeschlossen wird.

  4. onInstallReferrerSetupFinished() überschreiben , um bei Abschluss des Callbacks benachrichtigt zu werden. Diese Methode wird als durch einen Antwortcode, mit dem Sie die verschiedenen Zustände verarbeiten müssen. OK zeigt an, dass die Verbindung erfolgreich hergestellt wurde. einander InstallReferrerResponse Konstanten gelten für verschiedene Fehlertypen.

  5. onInstallReferrerServiceDisconnected() überschreiben Methode zum Umgang mit verlorenen Verbindungen zu Google Play verwendet. Für kann der Play Install Referrer Library-Client die Verbindung verlieren, wenn der Der Play Store-Dienst wird im Hintergrund aktualisiert. Der Bibliotheksclient muss die startConnection() , um die Verbindung neu zu starten, bevor weitere Anfragen gestellt werden.

Der folgende Code zeigt, wie Sie eine Verbindung zum Play Store App:

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

Verweis-URL für Installationen abrufen

Nachdem Sie eine Verbindung zur Play Store App hergestellt haben, rufen Sie die Details ab. aus der Installations-Referrer-URL, indem Sie die folgenden Schritte ausführen:

  1. Synchronisiertes getInstallReferrer() , um eine Instanz von ReferrerDetails

  2. Verwenden Sie die Methoden, ReferrerDetails -Klasse zum Abrufen von Details zur Installations-Referrer-URL.

Der folgende Code zeigt, wie Sie auf die Installationsverweis-URL zugreifen können. Informationen:

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

Achtung:Die Informationen zur Verweis-URL für die Installation sind sind 90 Tage lang verfügbar und ändert sich nicht, es sei denn, noch einmal installiert. Um unnötige API-Aufrufe in Ihrer Anwendung zu vermeiden, sollten Sie die Methode Die API wird nur einmal während der ersten Ausführung nach der Installation verwendet.

Dienstverbindung wird geschlossen

Rufen Sie nach dem Abrufen der Verweisinformationen die Methode endConnection() auf Ihrem InstallReferrerClient Instanz zum Trennen der Verbindung. Wenn Sie die Verbindung beenden, und Leistungsproblemen.

Weitere Informationen finden Sie in der Play Install Referrer Library Referenz.