بدء استخدام "المراسلة داخل التطبيق من 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:34.0.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متعدّدة في تطبيقك، ننصحك بشدة باستخدام 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:22.0.0")
    implementation("com.google.firebase:firebase-analytics:23.0.0")
}

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

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

للحفاظ على الطاقة، لا يسترد Firebase In-App Messaging الرسائل من الخادم إلا مرة واحدة في اليوم. قد يصعّب ذلك عملية الاختبار، لذا تتيح لك وحدة تحكّم Firebase تحديد جهاز اختبار يعرض الرسائل عند الطلب.

يتم تحديد جهاز الاختبار هذا من خلال FirebaseInstallations المعرّف أو FID. ابحث عن معرّف FID لتطبيق الاختبار من خلال التحقّق من Logcat في &quot;استوديو Android&quot; بحثًا عن سجلّ مستوى Info التالي:

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