اتّخِذ قرارات تسويقية مستنيرة من خلال تحديد قنوات اكتساب المستخدمين الأكثر قيمة للعبة. استخدِم واجهة برمجة التطبيقات 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); } }