Strona odsyłająca do instalacji z Google Play

Podejmuj świadome decyzje marketingowe, identyfikując najbardziej wartościowe kanały pozyskiwania użytkowników w swojej grze. Używaj interfejsu Google Play Install Referrer API, aby niezawodnie śledzić informacje o poleceniach aplikacji.

Dzięki śledzeniu danych o poleceniach możesz dowiedzieć się, które źródła ruchu kierują najwięcej użytkowników do pobrania Twojej aplikacji ze Sklepu Google Play. Te informacje pomogą Ci jak najlepiej wykorzystać wydatki na reklamę i zmaksymalizować zwrot z inwestycji.

Przestrzeń nazw: PlayPcSdkManaged.InstallReferrer

Klasa klienta: InstallReferrerClient

Link do strony z informacjami o aplikacji

Zacznij od przekierowania użytkowników na stronę Twojej aplikacji w Sklepie Google Play. W adresie URL uwzględnij parametry zapytania:

  • id: nazwa pakietu Twojej gry w Google Play.
  • referrer: ciąg znaków reprezentujący źródło polecenia. Ten ciąg znaków można wysłać jako zapytanie po zainstalowaniu i uruchomieniu aplikacji.
https://play.google.com/store/apps/details?id=com.example.package&referrer=example_referrer_source

Tworzenie klienta

Do tworzenia elementu InstallReferrerClient zawsze używaj fabryki. Dzięki temu automatycznie zarejestrujesz wywołania zwrotne bezpieczne dla 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();
    }
}

Wysyłanie zapytań o polecenia instalacji

Gdy użytkownik zainstaluje i uruchomi grę, Twoja aplikacja może określić źródło ruchu, które doprowadziło do instalacji, za pomocą interfejsu Install Referrer API.

Wysyłaj zapytania o szczegóły polecenia za pomocą GetInstallReferrerAsync. Odpowiedź zawiera ten sam ciąg znaków, który został przekazany do parametru zapytania referrer na stronie z informacjami o aplikacji.

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