API Install Referrer do Google Play

Tome decisões de marketing embasadas ao identificar os canais de aquisição de usuários mais valiosos para seu jogo. Use a API Install Referrer do Google Play para rastrear de forma confiável as informações de referência dos seus apps.

Ao rastrear dados de indicação, você entende quais fontes de tráfego enviam mais usuários para baixar seu app na Google Play Store. Esses insights ajudam você a aproveitar ao máximo seus gastos com publicidade e maximizar o ROI.

Namespace:PlayPcSdkManaged.InstallReferrer

Classe de cliente:InstallReferrerClient

Link para a página de detalhes do app

Comece vinculando os usuários à página do aplicativo na Google Play Store. No URL, inclua parâmetros de consulta para:

  • id: o nome do pacote do seu jogo no Google Play
  • referrer: uma string que representa a origem da indicação. Essa string pode ser consultada depois que o aplicativo for instalado e estiver em execução.
https://play.google.com/store/apps/details?id=com.example.package&referrer=example_referrer_source

Criar o cliente

Sempre use a fábrica para criar um InstallReferrerClient. Isso garante que os callbacks seguros para Unity sejam registrados 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();
    }
}

Consultar o referenciador de instalação

Depois que o usuário instala e inicia o jogo, seu app pode determinar a origem do tráfego que levou à instalação usando a API Install Referrer.

Consulte os detalhes do referenciador usando GetInstallReferrerAsync. A resposta contém a mesma string transmitida ao parâmetro de consulta referrer da página da ficha da loja.

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