Referencia de instalación de Google Play

Toma decisiones de marketing fundamentadas identificando los canales de adquisición de usuarios más valiosos para tu juego. Usa la API de Install Referrer de Google Play para obtener una forma confiable de hacer un seguimiento de la información de referencia de tus apps.

Si haces un seguimiento de los datos de referencia, puedes comprender qué fuentes de tráfico envían la mayor cantidad de usuarios para descargar tu app desde Google Play Store. Estas estadísticas pueden ayudarte a aprovechar al máximo tu inversión publicitaria y maximizar el ROI.

Espacio de nombres: PlayPcSdkManaged.InstallReferrer

Clase de cliente: InstallReferrerClient

Vínculo a la página de la ficha de Play Store

Para comenzar, vincula a los usuarios a la página de Google Play Store de tu aplicación. En la URL, incluye parámetros de consulta para lo siguiente:

  • id: Es el nombre del paquete de Play de tu juego.
  • referrer: Es una cadena que representa la fuente de la referencia. Se puede consultar esta cadena una vez que la aplicación esté instalada y en ejecución.
https://play.google.com/store/apps/details?id=com.example.package&referrer=example_referrer_source

Crea el cliente

Usa siempre la fábrica para crear un InstallReferrerClient. Esto garantiza que las devoluciones de llamada seguras de Unity se registren automáticamente.

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

Consulta la referencia de instalación

Después de que el usuario instala y ejecuta el juego, tu app puede determinar la fuente de tráfico que llevó a la instalación con la API de Install Referrer.

Consulta los detalles de la referencia con GetInstallReferrerAsync. La respuesta contiene la misma cadena que se pasó al parámetro de consulta referrer de la página de la ficha de Play 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);
    }
}