Play Install Referrer API
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
این مستندات مرجع فنی برای استفاده از 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 را فقط یک بار در اولین اجرای پس از نصب فراخوانی کنید.
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Play Install Referrer API\n\nThis documentation provides technical reference for using the\nPlay Install Referrer API. The Play Install Referrer API is an\n[AIDL Service Interface](https://developer.android.com/guide/components/aidl.html)\nprimarily used by non-Java programmers.\n\n\n**Note:** The\n[Play Install Referrer Library](/google/play/installreferrer/library)\nprovides a wrapper around the Play Install Referrer API and is designed to help Java\nprogrammers use the API.\n\nThe getInstallReferrer() method\n-------------------------------\n\nThis method returns the app install referrer information corresponding to the\ngiven package name sent through a `Bundle` (key mapped in table 1). In the\nresponse `Bundle` sent by Google Play, the referral information is stored in\nfields mapped to the keys detailed in table 2.\n\n\n**Table 1.** `getInstallReferrer()` bundle data\nrequest.\n\n| Parameter | Type | Description |\n|----------------|----------|----------------------------------------------------------|\n| `package_name` | `String` | The package name of the caller, used for disambiguation. |\n\n\n**Table 2.** Response data from a `getInstallReferrer()`\nrequest.\n\n| Key | Type | Description |\n|-------------------------------------------|-----------|--------------------------------------------------------------------------------------|\n| `install_referrer` | `String` | The referrer URL of the installed package. |\n| `referrer_click_timestamp_seconds` | `long` | The client-side timestamp, in seconds, when the referrer click happened. |\n| `install_begin_timestamp_seconds` | `long` | The client-side timestamp, in seconds, when app installation began. |\n| `referrer_click_timestamp_server_seconds` | `long` | The server-side timestamp, in seconds, when the referrer click happened. |\n| `install_begin_timestamp_server_seconds` | `long` | The server-side timestamp, in seconds, when app installation began. |\n| `install_version` | `string` | The app's version at the time when the app was first installed. |\n| `google_play_instant` | `boolean` | Indicates whether your app's instant experience was launched within the past 7 days. |\n\n**Caution:** The install referrer information will be\navailable for 90 days and **won't change** unless the application is\nreinstalled. To avoid unnecessary API calls in your app, you should invoke the\nAPI **only once** during the first execution after install."]]
