معرفی کننده نصب Google Play، معرفی کننده نصب Google Play، معرفی کننده نصب Google Play، معرفی کننده نصب Google Play

با شناسایی ارزشمندترین کانال‌های جذب کاربر برای بازی خود، تصمیمات بازاریابی آگاهانه‌ای بگیرید. از API معرف نصب گوگل پلی برای روشی مطمئن جهت ردیابی اطلاعات ارجاع برنامه‌های خود استفاده کنید.

با ردیابی داده‌های ارجاع، می‌توانید بفهمید کدام منابع ترافیکی بیشترین کاربران را برای دانلود اپلیکیشن شما از فروشگاه گوگل پلی ارسال می‌کنند. این بینش‌ها می‌توانند به شما کمک کنند تا از هزینه‌های تبلیغاتی خود نهایت استفاده را ببرید و بازگشت سرمایه (ROI) را به حداکثر برسانید.

فضای نام: PlayPcSdkManaged.InstallReferrer

کلاس کلاینت: InstallReferrerClient

به صفحه فهرست فروشگاه خود لینک دهید

با لینک دادن کاربران خود به صفحه فروشگاه گوگل پلی اپلیکیشن خود شروع کنید. در URL، پارامترهای کوئری زیر را وارد کنید:

• id : نام بسته‌ی Play بازی شما
• referrer : رشته‌ای که منبع ارجاع را نشان می‌دهد. این رشته را می‌توان پس از نصب و اجرای برنامه درخواست کرد.

https://play.google.com/store/apps/details?id=com.example.package&referrer=example_referrer_source

کلاینت را ایجاد کنید

همیشه از factory برای ایجاد InstallReferrerClient استفاده کنید. این کار تضمین می‌کند که callbackهای ایمن در 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 ارجاع‌دهنده نصب، منبع ترافیکی که منجر به نصب شده است را تعیین کند.

با استفاده از 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);
    }
}