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

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

iOS والإصدارات الأحدث Android Flutter

قبل البدء

قبل البدء، تأكَّد من إضافة Firebase إلى مشروعك على Apple.

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

استخدِم أداة Swift Package Manager لتثبيت تبعيات Firebase وإدارتها.

يمكنك الانتقال إلى دليل التثبيت للتعرّف على الطرق المختلفة التي يمكنك من خلالها إضافة حِزم تطوير البرامج (SDK) لنظام Firebase إلى مشروعك على Apple، بما في ذلك استيراد الإطارات مباشرةً واستخدام CocoaPods.

1. في Xcode، مع فتح مشروع تطبيقك، انتقِل إلى ملف > إضافة حِزم.
2. أضِف مستودع حزمة تطوير البرامج (SDK) لمنصّات Apple من Firebase عندما يُطلب منك ذلك:

  https://github.com/firebase/firebase-ios-sdk.git

ملاحظة: يجب أن تستخدم المشاريع الجديدة الإصدار التلقائي (أحدث) من حزمة SDK، ولكن يمكنك اختيار إصدار أقدم إذا لزم الأمر.
3. اختَر مكتبة In-App Messaging.
4. أضِف العلامة -ObjC إلى قسم رموز ربط أخرى في إعدادات الإنشاء الخاصة بالهدف.
5. لاستخدام In-App Messaging، عليك تفعيل Google Analytics في مشروعك على Firebase وإضافة حزمة تطوير البرامج (SDK) لمنصّة Firebase لخدمة "إحصاءات Google" إلى تطبيقك. يمكنك اختيار إما المكتبة بدون جمع معرّف IDFA أو مع جمع معرّف IDFA.
6. عند الانتهاء، سيبدأ Xcode تلقائيًا في حلّ ملفاتك المضمّنة وتنزيلها في الخلفية.

الآن، عليك إعداد حزمة SDK في تطبيقك:

1. استورِد وحدة Firebase في App struct أو UIApplicationDelegate، إذا لم يسبق لك إجراء ذلك:

   Swift

   import Firebase

   Objective-C

   @import Firebase;

2. يمكنك أيضًا ضبط مثيل مشترَك من FirebaseApp ، عادةً في دالة الإعداد الخاصة بـ App أو في application(_:didFinishLaunchingWithOptions:) الخاصة بوكيل التطبيق، إذا لم يسبق لك إجراء ذلك:

   Swift

   FirebaseApp.configure()

   Objective-C

   [FIRApp configure];

3. اجمع تطبيقك وشغِّله.

ملاحظة: تتطلّب Firebase In-App Messaging استخدام الإصدار 5.6.0 من Firebase أو إصدار أحدث. إذا كنت تواجه مشكلة في تجميع تطبيقك، جرِّب تشغيل pod update في دليل مشروع تطبيقك. يُرجى العِلم أنّ الأمر يعدّل جميع متطلّبات تطبيقك، وليس فقط متطلّبات Firebase.

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

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

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

يتم تحديد جهاز الاختبار هذا من خلال معرّف تثبيت Firebase المقدَّم من خدمة Firebase عمليات التثبيت. للعثور على رقم تعريف تثبيت تطبيق الاختبار، شغِّل التطبيق باستخدام وسيطة الأمر runtime‏ -FIRDebugEnabled:

1. مع فتح مشروع Xcode، اختَر المنتج > المخطّط > تعديل المخطّط... من أعلى شريط القوائم.
2. افتح علامة التبويب الوسيطات في مربّع الحوار المنبثق.
3. انقر على + إضافة عناصر ضمن الوسيطات التي تم تمريرها عند الإطلاق.
4. أدخِل "-FIRDebugEnabled" في الحقل الذي تم إنشاؤه حديثًا.
5. انقر على إغلاق، ثمّ شغِّل تطبيقك.

بعد بدء تشغيل تطبيقك، ابحث عن السطر التالي في سجلات وحدة تحكّم Xcode:

[Firebase/InAppMessaging][I-IAM180017] Starting InAppMessaging runtime with Firebase 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 رسالتك الاختبارية فور النقر على اختبار. للاطّلاع على الرسالة، عليك إغلاق التطبيق ثم إعادة فتحه على جهاز الاختبار.

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

[Firebase/InAppMessaging][I-IAM180017] Seeing test message in fetch response. Turn the current instance into a testing instance.