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

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


قبل البدء

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

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

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

  1. في Xcode، بعد فتح مشروع تطبيقك، انتقِل إلى ملف > إضافة حِزم (File > Add Packages).
  2. عندما يُطلب منك ذلك، أضِف مستودع حزمة تطوير البرامج (SDK) لمنصات Apple على Firebase:
    3.   https://github.com/firebase/firebase-ios-sdk.git
  3. اختَر مكتبة In-App Messaging.
  4. أضِف العلامة -ObjC إلى قسم علامات الربط الأخرى (Other Linker Flags) في إعدادات الإنشاء الخاصة بالهدف.
  5. لاستخدام In-App Messaging، عليك تفعيل Google Analytics في مشروع Firebase وإضافة Firebase SDK لخدمة "إحصاءات Google" إلى تطبيقك. يمكنك اختيار إما المكتبة بدون جمع معرّف المعلِن أو مع جمع معرّف المعلِن. راجِع الأسئلة الشائعة حول أحدث تنظيم للوحدات في Google Analytics لحزمة تطوير البرامج (SDK) لمنصة Firebase.
  6. بعد الانتهاء، سيبدأ Xcode تلقائيًا في حلّ التبعيات وتنزيلها في الخلفية.

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

  1. استورِد وحدة Firebase في بنية App أو 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" الرسائل من الخادم إلا مرة واحدة في اليوم. قد يصعّب ذلك عملية الاختبار، لذا تتيح لك وحدة تحكّم Firebase تحديد جهاز اختبار يعرض الرسائل عند الطلب.

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

  1. بعد فتح مشروع Xcode، انقر على المنتج (Product) > المخطّط (Scheme) > تعديل المخطّط… (Edit scheme…‎) من شريط القوائم العلوي.
  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. انقر على إنشاء أول حملة.
      2. اختَر الرسائل داخل التطبيق من Firebase وانقر على إنشاء.

    • إذا سبق لك إنشاء حملات:

      1. في علامة التبويب الحملات، انقر على حملة جديدة.
      2. اختَر الرسائل داخل التطبيق.

  3. أدخِل عنوانًا لرسالتك الأولى.

  4. انقر على الاختبار على الجهاز.

  5. أدخِل رقم تعريف التثبيت Firebase في Firebase لتطبيقك في حقل إضافة رقم تعريف التثبيت.

  6. انقر على اختبار لإرسال الرسالة. سيتم إرسالها على الفور.

  7. للاطّلاع على الرسالة على جهاز الاختبار، عليك إغلاق التطبيق ثم إعادة فتحه على جهاز الاختبار.

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

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