دمج Google Play Install Referrer Library في تطبيقك

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

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

المتطلّبات الأساسية

• أكمِل إعداد حزمة تطوير البرامج (SDK).

الخطوة 1: إضافة رابط يؤدي إلى صفحة بطاقة بيانات المتجر

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

• id: اسم حزمة لعبتك على Play
• referrer: سلسلة تمثّل مصدر الإحالة ويمكن إجراء طلب بحث بشأن ذلك بعد تثبيت تطبيقك وتشغيله.

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

الخطوة 2: طلب تفاصيل المُحيل عند بدء تشغيل التطبيق

بعد أن يُكمل المستخدم عملية تثبيت اللعبة ويشغّلها، يمكن لتطبيقك تحديد مصدر الزيارات التي أدّت إلى عملية التثبيت باستخدام واجهات برمجة التطبيقات Install Referrer APIs.

ابحث عن تفاصيل المُحيل باستخدام InstallReferrerClient::GetInstallReferrer. في الردّ، يمكن استرداد السلسلة نفسها التي تم تمريرها إلى مَعلمة طلب البحث referrer في صفحة بطاقة بياناتك على المتجر. ويمكن بعد ذلك إرفاق تفاصيل المُحيل بالبيانات التحليلية التي تم جمعها، مثل حدث تثبيت التطبيق.

auto promise = std::make_shared<std::promise<GetInstallReferrerResult>>();
install_referrer_client.GetInstallReferrer(params, [promise](GetInstallReferrerResult result) {
   promise->set_value(std::move(result));
});

auto get_install_referrer_result = promise->get_future().get();
if (get_install_referrer_result.ok()) {
   auto install_referrer = get_install_referrer_result.value().install_referrer;
   // Attribute your game's installation to an acquisition channel by including
   // the install referrer. Typically this would be done by logging an app
   // install event with an analytics library of your choice that includes the
   // `install_referrer`.
}