Play Install Referrer API

این سند مرجعی فنی برای استفاده از 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 نشان می‌دهد که آیا تجربه فوری برنامه‌تان در ۷ روز گذشته راه‌اندازی شده است یا نه.