توفّر هذه المستندات مرجعًا فنيًا لاستخدام Play Install Referrer API. واجهة برمجة التطبيقات Play Install Referrer API هي واجهة خدمة AIDL يستخدمها بشكل أساسي غير المبرمجين غير Java.
ملاحظة: توفّر مكتبة مُحيل التثبيت في Play برنامج تضمين حول واجهة برمجة تطبيقات مُحيل التثبيت في Play، وهي مصمَّمة لمساعدة مبرمجي Java على استخدام واجهة برمجة التطبيقات.
طريقة getInstallReferrer()
تعرض هذه الطريقة معلومات مُحيل تثبيت التطبيق المقابلة
لاسم الحزمة المحدد الذي تم إرساله من خلال Bundle (تم تحديد المفتاح في الجدول 1). في الرد Bundle المُرسَل من Google Play، يتم تخزين معلومات الإحالة في حقول تم ربطها بالمفاتيح المفصّلة في الجدول 2.
الجدول 1. طلب بيانات الحزمة getInstallReferrer().
| المَعلمة | Type | الوصف |
|---|---|---|
package_name
|
String
|
اسم حزمة المتصل، يُستخدم للتوضيح. |
الجدول 2. بيانات الاستجابة من طلب getInstallReferrer().
| المفتاح | Type | الوصف |
|---|---|---|
install_referrer
|
String
|
عنوان URL المُحيل للحزمة المثبَّتة. |
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 يومًا ولن تتغير ما لم تتم إعادة تثبيت التطبيق. لتجنُّب طلبات البيانات غير الضرورية من واجهة برمجة التطبيقات في تطبيقك، يجب استدعاء واجهة برمجة التطبيقات مرة واحدة فقط أثناء عملية التنفيذ الأولى بعد التثبيت.