Google Play Install Referrer

Buat keputusan pemasaran yang tepat dengan mengidentifikasi saluran akuisisi pengguna yang paling berharga untuk game Anda. Gunakan Google Play Install Referrer API untuk cara yang andal untuk melacak informasi rujukan aplikasi Anda.

Dengan melacak data rujukan, Anda dapat memahami sumber traffic mana yang mengirimkan paling banyak pengguna untuk mendownload aplikasi Anda dari Google Play Store. Insight ini dapat membantu Anda memanfaatkan pembelanjaan iklan secara maksimal dan memaksimalkan ROI.

Namespace: PlayPcSdkManaged.InstallReferrer

Class Klien: InstallReferrerClient

Menyediakan link ke halaman listingan Play Store Anda

Mulailah dengan menautkan pengguna ke halaman Play Store aplikasi Anda. Di URL, sertakan parameter kueri untuk:

  • id: Nama paket Play game Anda
  • referrer: String yang mewakili sumber rujukan. String ini dapat dikueri setelah aplikasi Anda diinstal dan berjalan.
https://play.google.com/store/apps/details?id=com.example.package&referrer=example_referrer_source

Buat klien

Selalu gunakan factory untuk membuat InstallReferrerClient. Hal ini memastikan bahwa callback yang kompatibel dengan Unity didaftarkan secara otomatis.

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

Mengkueri perujuk penginstalan

Setelah pengguna menginstal dan meluncurkan game, aplikasi Anda dapat menentukan sumber traffic yang menyebabkan penginstalan menggunakan Install Referrer API.

Buat kueri detail perujuk menggunakan GetInstallReferrerAsync. Respons berisi string yang sama yang diteruskan ke parameter kueri referrer halaman listingan Play Store Anda.

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