این سند مرجعی فنی برای استفاده از Play Install Referrer API ارائه میدهد. Play Install Referrer API یک میانای سرویس زبان تعریف میانای Android (AIDL) برای توسعهدهندگانی است که از Kotlin یا زبان برنامهنویسی Java استفاده نمیکنند.
دریافت ارجاعدهنده نصب
روش getInstallReferrer() اطلاعات ارجاعدهنده نصب برنامه را که با نام بسته ارسالی ازطریق Bundle (کلید نگاشتشده در جدول ۱) مطابقت دارد برمیگرداند. در پاسخ Bundle ارسالشده توسط Google Play، اطلاعات ارجاع در فیلدهایی ذخیره میشود که به کلیدهای شرحدادهشده در جدول ۲ نگاشت شدهاند.
جدول ۱. درخواست دادههای بسته getInstallReferrer().
| پارامتر | نوع | شرح |
|---|---|---|
package_name
|
String
|
نام بسته تماسگیرنده، که برای ابهامزدایی استفاده میشود. |
جدول ۲. دادههای پاسخ از درخواست getInstallReferrer().
| کلید | نوع | شرح |
|---|---|---|
install_referrer
|
String
|
نشانی وب ارجاعدهنده بسته نصبشده. |
referrer_click_timestamp_seconds
|
long
|
مُهر زمان سمت کارخواه، به ثانیه، زمانی که کلیک ارجاعدهنده اتفاق افتاده است. |
install_begin_timestamp_seconds
|
long
|
مُهر زمان سمت کارخواه، به ثانیه، وقتی نصب برنامه شروع شد. |
referrer_click_timestamp_server_seconds
|
long
|
مُهر زمان سمت سرور، برحسب ثانیه، زمانی که کلیک ارجاعدهنده اتفاق افتاد. |
install_begin_timestamp_server_seconds
|
long
|
مُهر زمان سمت سرور، به ثانیه، هنگام شروع نصب برنامه. |
install_version
|
string
|
نسخه برنامه در زمانی که برنامه برای اولینبار نصب شده است. |
google_play_instant
|
boolean
|
نشان میدهد که آیا تجربه فوری برنامهتان در ۷ روز گذشته راهاندازی شده است یا نه. |