مُحيل تثبيت Google Play

اتّخِذ قرارات تسويقية مستنيرة من خلال تحديد قنوات اكتساب المستخدمين الأكثر قيمة للعبة. استخدِم واجهة برمجة التطبيقات Google Play Install Referrer API للحصول على طريقة موثوقة لتتبُّع معلومات الإحالة لتطبيقاتك.

من خلال تتبُّع بيانات الإحالة، يمكنك معرفة مصادر الزيارات التي تجذب أكبر عدد من المستخدمين لتنزيل تطبيقك من "متجر Google Play". يمكن أن تساعدك هذه الإحصاءات في تحقيق أقصى استفادة من إنفاقك على الإعلانات وزيادة عائد الاستثمار إلى أقصى حدّ.

مساحة الاسم: PlayPcSdkManaged.InstallReferrer

فئة العميل: InstallReferrerClient

رابط إلى صفحة بطاقة بيانات المتجر

ابدأ بربط المستخدمين بصفحة تطبيقك على "متجر Google Play". في عنوان URL، أدرِج مَعلمات طلب البحث لما يلي:

  • id: اسم حزمة Play للعبة
  • referrer: سلسلة تمثّل مصدر الإحالة. يمكن طلب هذه السلسلة بعد تثبيت تطبيقك وتشغيله.
https://play.google.com/store/apps/details?id=com.example.package&referrer=example_referrer_source

إنشاء العميل

استخدِم دائمًا المصنع لإنشاء InstallReferrerClient. يضمن ذلك تسجيل معاودة الاتصال الآمنة في 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();
    }
}

طلب بيانات مُحيل التثبيت

بعد أن يثبّت المستخدم اللعبة ويشغّلها، يمكن لتطبيقك تحديد مصدر الزيارات الذي أدّى إلى التثبيت باستخدام واجهة برمجة التطبيقات Install Referrer 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);
    }
}