Referrer di installazione di Google Play

Prendi decisioni di marketing ponderate identificando i canali di acquisizione utenti più preziosi per il tuo gioco. Utilizza l'API Install Referrer di Google Play per un modo affidabile di monitorare le informazioni sui referral delle tue app.

Monitorando i dati sui referral, puoi capire quali fonti di traffico inviano il maggior numero di utenti a scaricare la tua app dal Google Play Store. Questi dati possono aiutarti a sfruttare al meglio la spesa pubblicitaria e a massimizzare il ROI.

Spazio dei nomi: PlayPcSdkManaged.InstallReferrer

Classe client: InstallReferrerClient

Link alla pagina della scheda dello Store

Inizia collegando gli utenti alla pagina del Google Play Store della tua applicazione. Nell'URL, includi i parametri di query per:

  • id: il nome del pacchetto Play del tuo gioco
  • referrer: una stringa che rappresenta la sorgente di referral. Questa stringa può essere sottoposta a query una volta che l'applicazione è installata ed è in esecuzione.
https://play.google.com/store/apps/details?id=com.example.package&referrer=example_referrer_source

Crea il client

Utilizza sempre la factory per creare un InstallReferrerClient. In questo modo, i callback sicuri per Unity vengono registrati automaticamente.

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

Esegui una query sul referrer di installazione

Dopo che l'utente ha installato e avviato il gioco, la tua app può determinare la fonte di traffico che ha portato all'installazione utilizzando l'API Install Referrer.

Esegui una query sui dettagli del referrer utilizzando GetInstallReferrerAsync. La risposta contiene la stessa stringa passata nel parametro di query referrer della pagina della scheda dello Store.

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