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 Google Play Install Referrer para hacer un seguimiento confiable de la información de referencia de tus apps.

Si haces un seguimiento de los datos de referencias, puedes comprender qué fuentes de tráfico envían la mayor cantidad de usuarios para que descarguen 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 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

Siempre usa la fábrica para crear un InstallReferrerClient. Esto garantiza que las devoluciones de llamada seguras para 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 el referente de instalación

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

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