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 przypadku Twojej gry. Używaj interfejsu Google Play Install Referrer API, aby niezawodnie śledzić informacje o poleceniach aplikacji.

Śledząc dane o odesłaniach, możesz sprawdzić, z których źródeł ruchu pochodzi najwięcej użytkowników, którzy pobierają Twoją aplikację ze Sklepu Google Play. Te informacje mogą pomóc Ci w pełni wykorzystać budżet na reklamę i zmaksymalizować zwrot z inwestycji.

Przestrzeń nazw: PlayPcSdkManaged.InstallReferrer

Klasa klienta: InstallReferrerClient

Link do strony aplikacji

Zacznij od przekierowywania użytkowników na stronę aplikacji w Google Play. W adresie URL uwzględnij parametry zapytania dotyczące:

  • id: nazwa pakietu Play Twojej gry
  • referrer: ciąg znaków reprezentujący źródło odesłania. 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

Zawsze używaj fabryki do tworzenia InstallReferrerClient. Dzięki temu bezpieczne wywołania zwrotne Unity są rejestrowane automatycznie.

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ń do narzędzia do śledzenia instalacji

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

Wysyłaj zapytania o szczegóły witryny odsyłającej za pomocą funkcji GetInstallReferrerAsync. Odpowiedź zawiera ten sam ciąg znaków, który został przekazany do parametru zapytania referrer na stronie informacji 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);
    }
}