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

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

يوضّح لك هذا الدليل السريع كيفية إعداد Firebase In-App Messaging وإرسال أول رسالة لك.

قبل البدء

أضِف Firebase إلى مشروع Android الخاص بك، في حال لم يسبق لك إجراء ذلك.

إضافة حزمة تطوير البرامج Firebase In-App Messaging (SDK) إلى مشروعك

في ملف 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:34.18.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:22.0.3")
    implementation("com.google.firebase:firebase-analytics:23.2.0")
}

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

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

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

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

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

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

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

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

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

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

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