تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

بدء استخدام "المراسلة داخل التطبيق من 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 وإضافة Firebase SDK لخدمة "إحصاءات Google" إلى تطبيقك.

dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:35.0.1"))

    // 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:23.0.0")
    implementation("com.google.firebase:firebase-analytics:24.0.0")
}

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

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

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

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

I/FIAM.Headless: Starting InAppMessaging runtime with Installation ID YOUR_INSTALLATION_ID

إرسال رسالة إلى جهازك الاختباري

بعد تشغيل تطبيقك على جهاز الاختبار والحصول على رقم تعريف تثبيت Firebase (FID)، يمكنك تجربة إعداد Firebase In-App Messaging عن طريق إرسال رسالة اختبار:

في وحدة تحكّم Firebase، انتقِل إلى DevOps والتفاعل > المراسلة.
ابدأ سير العمل لإعداد حملة جديدة:
- إذا كانت هذه حملتك الأولى:
  1. انقر على إنشاء حملتك الأولى.
  2. اختَر ميزة "الرسائل داخل التطبيق" في Firebase وانقر على إنشاء.
- إذا سبق لك إنشاء حملات:
  1. في علامة التبويب الحملات، انقر على حملة جديدة.
  2. اختَر المراسلة داخل التطبيق.
أدخِل عنوانًا لرسالتك الأولى.
انقر على اختبار على الجهاز (Test on Device).
أدخِل رقم تعريف تثبيت تطبيقك على Firebase Firebase في حقل إضافة رقم تعريف تثبيت.
انقر على اختبار لإرسال الرسالة. سيتم إرسالها على الفور.
للاطّلاع على الرسالة على جهازك الاختباري، عليك إغلاق التطبيق ثم إعادة فتحه على جهازك الاختباري.

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

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

بدء استخدام "المراسلة داخل التطبيق من Firebase" تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.