Google Play Install Referrer

Oyununuz için en değerli kullanıcı edinme kanallarınızı belirleyerek pazarlama konusunda bilinçli kararlar alın. Uygulamalarınızın tavsiye bilgilerini güvenilir bir şekilde izlemek için Google Play Install Referrer API'yi kullanın.

Tavsiye verilerini izleyerek hangi trafik kaynaklarının Google Play Store'dan uygulamanızı indiren en fazla kullanıcıyı gönderdiğini anlayabilirsiniz. Bu analizler, reklam harcamalarınızdan en iyi şekilde yararlanmanıza ve YG'yi en üst düzeye çıkarmanıza yardımcı olabilir.

Ad alanı: PlayPcSdkManaged.InstallReferrer

İstemci sınıfı: InstallReferrerClient

Mağaza girişi sayfanıza bağlantı verme

Kullanıcılarınızı uygulamanızın Google Play mağaza sayfasına bağlayarak başlayın. URL'ye şu sorgu parametrelerini ekleyin:

  • id: Oyununuzun Play paket adı
  • referrer: Yönlendirme kaynağını temsil eden bir dize. Bu dize, uygulamanız yüklendikten ve çalıştırıldıktan sonra sorgulanabilir.
https://play.google.com/store/apps/details?id=com.example.package&referrer=example_referrer_source

İstemciyi oluşturma

Her zaman InstallReferrerClient oluşturmak için fabrikayı kullanın. Bu, Unity'de güvenli geri çağırmaların otomatik olarak kaydedilmesini sağlar.

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

Yükleme yönlendireni sorgulama

Kullanıcı oyunu yükleyip başlattıktan sonra uygulamanız, yüklemeye yol açan trafik kaynağını Install Referrer API'yi kullanarak belirleyebilir.

Yönlendiren ayrıntılarını GetInstallReferrerAsync kullanarak sorgulayın. Yanıt, mağaza girişi sayfanızın referrer sorgu parametresine iletilen dizeyi içerir.

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