مُحيل تثبيت 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);
    }
}