این مستندات مرجع فنی برای استفاده از Play Install Referrer API ارائه می دهد. Play Install Referrer API یک رابط سرویس AIDL است که عمدتاً توسط برنامه نویسان غیر جاوا استفاده می شود.
توجه: کتابخانه Play Install Referrer پوششی در اطراف Play Install Referrer API ارائه می دهد و برای کمک به برنامه نویسان جاوا در استفاده از API طراحی شده است.
متد getInstallReferrer()
این روش اطلاعات ارجاع دهنده نصب برنامه مربوط به نام بسته داده شده ارسال شده از طریق یک Bundle را برمی گرداند (کلید نشان داده شده در جدول 1). در Bundle پاسخ ارسال شده توسط Google Play، اطلاعات ارجاع در فیلدهایی ذخیره می شود که با کلیدهای تفصیلی در جدول 2 نگاشت شده اند.
جدول 1. درخواست داده بسته نرم افزاری getInstallReferrer() .
| پارامتر | تایپ کنید | توضیحات |
|---|---|---|
package_name | String | نام بسته تماس گیرنده که برای ابهام زدایی استفاده می شود. |
جدول 2. داده های پاسخ از یک درخواست 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 | نشان می دهد که آیا تجربه فوری برنامه شما در 7 روز گذشته راه اندازی شده است یا خیر. |
احتیاط: اطلاعات ارجاع دهنده نصب به مدت 90 روز در دسترس خواهد بود و تغییر نخواهد کرد مگر اینکه برنامه مجدداً نصب شود. برای جلوگیری از تماس های غیر ضروری API در برنامه خود، باید API را فقط یک بار در اولین اجرای پس از نصب فراخوانی کنید.