Google Play Install Referrer

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

Wenn Sie Verweisdaten nachverfolgen, können Sie herausfinden, über welche Traffic-Quellen die meisten Nutzer Ihre App im Google Play Store herunterladen. Diese Informationen können Ihnen helfen, Ihre Werbeausgaben optimal zu nutzen und den ROI zu maximieren.

Namespace:PlayPcSdkManaged.InstallReferrer

Client-Klasse:InstallReferrerClient

Link zu Ihrer Store-Eintragsseite

Verlinken Sie zuerst Ihre Nutzer mit der Google Play Store-Seite Ihrer Anwendung. Fügen Sie in die URL Abfrageparameter für Folgendes ein:

  • id: Der 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 einen InstallReferrerClient zu erstellen. So wird sichergestellt, dass Unity-sichere Callbacks automatisch registriert werden.

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

Installationsverweis 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.

Fragen Sie die Verweisdetails mit GetInstallReferrerAsync ab. Die Antwort enthält denselben String, der an den Abfrageparameter referrer 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);
    }
}