واجهة برمجة التطبيقات لمُحيل التثبيت في Play

توفّر هذه المستندات مرجعًا فنيًا لاستخدام 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 يومًا ولن تتغير ما لم تتم إعادة تثبيت التطبيق. لتجنُّب طلبات البيانات غير الضرورية من واجهة برمجة التطبيقات في تطبيقك، يجب استدعاء واجهة برمجة التطبيقات مرة واحدة فقط أثناء عملية التنفيذ الأولى بعد التثبيت.