يوضّح لك دليل البدء السريع هذا كيفية إعداد Firebase In-App Messaging وإرسال رسالتك الأولى.
قبل البدء
أضِف Firebase إلى مشروع Android، في حال لم يسبق لك إجراء ذلك.
إضافة حزمة تطوير البرامج (SDK) لمنصّة Firebase In-App Messaging إلى مشروعك
في ملف Gradle للوحدة (على مستوى التطبيق)
(عادةً <project>/<app-module>/build.gradle.kts
أو
<project>/<app-module>/build.gradle
)،
أضِف الاعتمادية لمكتبة In-App Messaging لنظام التشغيل Android. ننصحك باستخدام الرمز
Firebase Android BoM
للتحكّم في إصدارات المكتبة.
لاستخدام In-App Messaging، عليك تفعيل Google Analytics في مشروعك على Firebase وإضافة حزمة تطوير البرامج (SDK) لمنصّة Firebase الخاصة بخدمة "إحصاءات Google" إلى تطبيقك.
dependencies { // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:33.7.0")) // Add the dependencies for the In-App Messaging and Analytics libraries // When using the BoM, you don't specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-inappmessaging-display") implementation("com.google.firebase:firebase-analytics") }
باستخدام Firebase Android BoM، سيستخدم تطبيقك دائمًا إصدارات متوافقة من مكتبات Firebase لنظام التشغيل Android.
(بديل) إضافة تبعيات مكتبة Firebase بدون استخدام BoM
إذا اخترت عدم استخدام Firebase BoM، يجب تحديد كل إصدار من مكتبة Firebase في سطر التبعية الخاص به.
يُرجى العلم أنّه في حال استخدام مكتبات Firebase متعدّدة في تطبيقك، ننصحك بشدة باستخدام BoM لإدارة إصدارات المكتبة، ما يضمن توافق جميع الإصدارات.
dependencies { // Add the dependencies for the In-App Messaging and Analytics libraries // When NOT using the BoM, you must specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-inappmessaging-display:21.0.1") implementation("com.google.firebase:firebase-analytics:22.1.2") }
إرسال رسالة اختبار
الحصول على رقم تعريف تثبيت تطبيقك
للحفاظ على الطاقة، لا يسترجع تطبيق Firebase In-App Messaging الرسائل من المعالج إلا مرة واحدة في اليوم. وقد يصعِّب ذلك عملية الاختبار، لذا تتيح لك وحدة تحكّم Firebase تحديد جهاز اختبار يعرض الرسائل عند الطلب.
يتم تحديد جهاز الاختبار هذا من خلال رقم تعريف
FirebaseInstallations
أو FID.
ابحث عن رقم تعريف الجهاز (FID) لتطبيق الاختبار من خلال التحقّق من Logcat في
"استوديو Android" بحثًا عن السجلّ التالي على مستوى "المعلومات":
I/FIAM.Headless: Starting InAppMessaging runtime with Installation ID YOUR_INSTALLATION_ID
إرسال رسالة إلى جهاز الاختبار
بعد تشغيل تطبيقك على جهاز الاختبار والحصول على Firebase رقم تعريف التثبيت (FID)، يمكنك تجربة Firebase In-App Messaging إعداده من خلال إرسال رسالة اختبار:
- في وحدة تحكّم Firebase، افتح صفحة "الرسائل".
- إذا كانت هذه هي حملتك الأولى، انقر على إنشاء حملتك الأولى.
- اختَر رسائل Firebase داخل التطبيق وانقر على إنشاء.
- أمّا إذا لم يكن الأمر كذلك، فانقر على حملة جديدة في علامة التبويب الحملات.
- اختَر الرسائل داخل التطبيق.
- أدخِل عنوانًا لرسالتك الأولى.
- انقر على الاختبار على الجهاز.
- أدخِل معرّف عملية التثبيت Firebase لتطبيقك في الحقل إضافة معرّف عملية تثبيت.
- انقر على اختبار لإرسال الرسالة.
تُرسِل Firebase In-App Messaging رسالتك الاختبارية فور النقر على اختبار. للاطّلاع على الرسالة، عليك إغلاق التطبيق ثم إعادة فتحه على جهاز الاختبار.
للتأكّد مما إذا كان جهازك جهاز اختبار، ابحث عن الرسالة التالية في ملف السجلّ:
I/FIAM.Headless: Setting this device as a test device