Referrer di installazione di Google Play

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

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

Spazio dei nomi: PlayPcSdkManaged.InstallReferrer

Client Class: 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. È possibile eseguire query su questa stringa una volta installata ed eseguita l'applicazione.
https://play.google.com/store/apps/details?id=com.example.package&referrer=example_referrer_source

Crea il client

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

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 l'origine del traffico che ha portato all'installazione utilizzando l'API Install Referrer.

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

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