Реферер установки Google Play

Принимайте обоснованные маркетинговые решения, определяя наиболее ценные каналы привлечения пользователей для вашей игры. Используйте API Google Play Install Referrer для надежного отслеживания информации о реферальных ссылках ваших приложений.

Отслеживая данные о переходах по ссылкам, вы можете понять, какие источники трафика приводят к загрузке вашего приложения из магазина Google Play. Эти данные помогут вам максимально эффективно использовать рекламный бюджет и максимизировать рентабельность инвестиций.

Пространство имен: PlayPcSdkManaged.InstallReferrer

Класс клиента: InstallReferrerClient

Ссылка на страницу с информацией о вашем магазине

Для начала направьте пользователей на страницу вашего приложения в Google Play. В URL-адресе укажите следующие параметры запроса:

  • id : Название Play-пакета вашей игры
  • referrer : Строка, представляющая источник перехода. Эту строку можно запросить после установки и запуска вашего приложения. 
https://play.google.com/store/apps/details?id=com.example.package&referrer=example_referrer_source

Создайте клиента

Всегда используйте фабрику для создания объекта InstallReferrerClient . Это гарантирует автоматическую регистрацию безопасных для 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();
    }
}

Запросите информацию о реферере установки.

После того, как пользователь установит и запустит игру, ваше приложение сможет определить источник трафика, приведший к установке, используя API Install Referrer.

Запросите данные о реферере с помощью GetInstallReferrerAsync . В ответе будет содержаться та же строка, что и в параметре запроса referrer на странице вашего магазина.

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