Google Play Install Referrer

Treffen Sie fundierte Marketingentscheidungen, indem Sie die wertvollsten Kanäle zur Nutzerakquisition für Ihr Spiel ermitteln. Mit der Google Play Install Referrer API können Sie die Empfehlungsdaten Ihrer Apps zuverlässig erfassen.

Wenn Sie Verweisdaten erfassen, können Sie nachvollziehen, über welche Traffic-Quellen die meisten Nutzer Ihre App im Google Play Store herunterladen. Mithilfe dieser Informationen können Sie Ihre Werbeausgaben optimal einsetzen und den ROI maximieren.

Namespace:PlayPcSdkManaged.InstallReferrer

Client-Klasse: InstallReferrerClient

Link zu Ihrem Store-Eintrag

Verlinken Sie Ihre Nutzer zuerst mit der Google Play Store-Seite Ihrer Anwendung. Geben Sie in der URL Suchparameter für Folgendes an:

  • id: Der Google Play-Paketname Ihres Spiels
  • referrer: Ein String, der die Verweisquelle darstellt. Dieser String kann abgefragt werden, sobald Ihre Anwendung installiert ist und ausgeführt wird.
https://play.google.com/store/apps/details?id=com.example.package&referrer=example_referrer_source

Client erstellen

Verwenden Sie immer die Factory, um ein InstallReferrerClient zu erstellen. So werden Unity-kompatible Rückrufe automatisch registriert.

using UnityEngine;
using System;
using System.Threading.Tasks;
// Required SDK Namespaces
using PlayPcSdkManaged.InstallReferrer;
using PlayPcSdkManaged.Unity;

public class InstallReferrerManager : MonoBehaviour
{
    private InstallReferrerClient _installReferrerClient;

    public void SetupInstallReferrer()
    {
        try
        {
            // Creates the client with the required UnityInstallReferrerCallbacksHandler
            _installReferrerClient = PlayPcSdkFactory.CreateInstallReferrerClient();
            Debug.Log("Install Referrer Client created successfully.");
        }
        catch (Exception ex)
        {
            Debug.LogError($"Failed to create Install Referrer Client: {ex.Message}");
        }
    }

    private void OnDestroy()
    {
        // Always dispose of the client to clean up native C++ resources
        _installReferrerClient?.Dispose();
    }
}

Installations-Referrer abfragen

Nachdem der Nutzer das Spiel installiert und gestartet hat, kann Ihre App mit der Install Referrer API die Traffic-Quelle ermitteln, die zur Installation geführt hat.

Rufen Sie die Details zum Empfehlenden mit GetInstallReferrerAsync ab. Die Antwort enthält denselben String, der in den referrer-Abfrageparameter Ihrer Store-Eintragsseite übergeben wurde.

public async Task GetInstallReferrerAsync()
{
    try
    {
        Debug.Log("Querying Install Referrer...");

        // Async call to retrieve referral information
        var result = await _installReferrerClient.GetInstallReferrerAsync();

        if (result.IsOk)
        {
            // On success, access the InstallReferrer and InstallTimeEpochSeconds
            var referrer = result.Value.InstallReferrer;
            var installTime = result.Value.InstallTimeEpochSeconds;

            Debug.Log($"Install Referrer: {referrer}");
            Debug.Log($"Install Time: {installTime}");

            // Attribute your game's installation to an acquisition channel
        }
        else
        {
            // Handle expected API errors (e.g., Error)
            Debug.LogError($"Query Failed: {result.Code} - {result.ErrorMessage}");
        }
    }
    catch (Exception ex)
    {
        Debug.LogException(ex);
    }
}