بدء استخدام "المراسلة داخل التطبيق من Firebase"

يوضّح لك دليل البدء السريع هذا كيفية إعداد 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.4.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.0")
    implementation("com.google.firebase:firebase-analytics:22.1.2")
}
هل تبحث عن وحدة مكتبة خاصة بلغة Kotlin؟ ستبدأ بعد تشرين الأول (أكتوبر) 2023 (Firebase BoM 32.5.0)، بإمكان مطوّري البرامج بلغة Kotlin وJava. تعتمد على وحدة المكتبة الرئيسية (لمزيد من التفاصيل، راجع الأسئلة الشائعة حول هذه المبادرة).

إرسال رسالة اختبار

الحصول على معرّف تثبيت تطبيقك

للحفاظ على الطاقة، لا يسترجع تطبيق 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. الإعداد من خلال إرسال رسالة اختبار:

  1. في وحدة تحكُّم Firebase، افتح صفحة "المراسلة".
  2. إذا كانت هذه هي حملتك الأولى، فانقر على إنشاء حملتك الأولى.
    1. اختَر الرسائل داخل التطبيق من Firebase وانقر على إنشاء.
  3. وبخلاف ذلك، في علامة التبويب الحملات، انقر على حملة جديدة.
    1. اختَر الرسائل داخل التطبيق.
  4. أدخِل عنوانًا لرسالتك الأولى.
  5. انقر على الاختبار على الجهاز.
  6. أدخِل رقم تعريف تثبيت Firebase لتطبيقك في حقل إضافة معرّف تثبيت.
  7. انقر على اختبار لإرسال الرسالة.

يرسل Firebase In-App Messaging رسالة الاختبار بعد النقر على اختبار. للاطلاع على عليك إغلاق التطبيق ثم إعادة فتحه على الجهاز الاختباري.

للتأكّد مما إذا كان جهازك جهاز اختبار، ابحث عن الرسالة التالية في ملف السجلّ: 

I/FIAM.Headless: Setting this device as a test device