API Install Referrer do Google Play

Tome decisões de marketing informadas identificando os canais de aquisição de usuários mais valiosos para seu jogo. Use a API Install Referrer do Google Play para uma maneira confiável de acompanhar as informações de referência dos seus apps.

Ao acompanhar os dados de referência, você pode entender quais fontes de tráfego enviam mais usuários para baixar seu app na Google Play Store. Esses insights podem ajudar você a aproveitar ao máximo seus gastos com publicidade e maximizar o ROI.

Namespace:PlayPcSdkManaged.InstallReferrer

Classe do cliente:InstallReferrerClient

Link para a página Detalhes do app

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

  • id: o nome do pacote do jogo no Google Play
  • referrer: uma string que representa a origem de referência. 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 do 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, o app pode determinar a fonte de 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 para o parâmetro de consulta referrer da página de detalhes do app.

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