Play Install Referrer API
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
במסמך הזה מפורט מידע טכני על השימוש ב-Play Install Referrer API. Play Install Referrer API הוא ממשק שירות AIDL שמשמש בעיקר מפתחים שאינם משתמשים ב-Java.
הערה: Play Install Referrer Library היא ספרייה שמכילה את Play Install Referrer API, והיא נועדה לעזור למפתחי Java להשתמש ב-API.
השיטה getInstallReferrer()
השיטה הזו מחזירה את פרטי המקור להפניה של התקנת האפליקציה שתואם לשם החבילה שצוין, שנשלח דרך Bundle (מפתח שממופה בטבלה 1). בתגובה Bundle שנשלחת על ידי Google Play, פרטי ההפניה מאוחסנים בשדות שממופים למפתחות שמפורטים בטבלה 2.
טבלה 1. בקשה לנתוני חבילת getInstallReferrer().
|
פרמטר
|
סוג
|
תיאור
|
package_name
|
String
|
שם החבילה של מבצע הקריאה החוזרת, המשמש לצורך הסרת עמימות.
|
טבלה 2. נתוני התגובה מבקשת getInstallReferrer().
|
מפתח
|
סוג
|
תיאור
|
install_referrer
|
String
|
כתובת ה-URL של מקור ההפניה (referrer) של החבילה שהותקנה.
|
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 רק פעם אחת במהלך ההפעלה הראשונה אחרי ההתקנה.
דוגמאות התוכן והקוד שבדף הזה כפופות לרישיונות המפורטים בקטע רישיון לתוכן. Java ו-OpenJDK הם סימנים מסחריים או סימנים מסחריים רשומים של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-27 (שעון UTC).
[[["התוכן קל להבנה","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-27 (שעון UTC)."],[],[],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."]]
