بدء استخدام "المراسلة داخل التطبيق من 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" إلى تطبيقك. يمكنك اختيار إما المكتبة التي لا تتضمّن جمع معرّف المعلِنين (IDFA) أو التي تتضمّن جمع معرّف المعلِنين (IDFA). يمكنك الاطّلاع على الأسئلة الشائعة حول أحدث تنظيم للوحدات في حزمة تطوير البرامج (SDK) لمنصّة Google Analytics لبرنامج 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. افتح علامة التبويب الوسيطات (Arguments) في مربّع الحوار المنبثق.
  3. انقر على + إضافة عناصر ضمن الوسيطات التي تم تمريرها عند التشغيل.
  4. أدخِل "-FIRDebugEnabled" في الحقل الذي تم إنشاؤه حديثًا.
  5. انقر على إغلاق (Close)، ثم شغِّل تطبيقك.

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

[Firebase/InAppMessaging][I-IAM180017] Starting InAppMessaging runtime with Firebase Installation ID YOUR_INSTALLATION_ID

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

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

  1. في وحدة تحكّم Firebase، انتقِل إلى DevOps والتفاعل > المراسلة.

  2. ابدأ سير العمل لإعداد حملة جديدة:

    • إذا كانت هذه حملتك الأولى:

      1. انقر على إنشاء حملتك الأولى.
      2. اختَر ميزة "الرسائل داخل التطبيق" في Firebase وانقر على إنشاء.

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

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

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

  4. انقر على اختبار على الجهاز (Test on Device).

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

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

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

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

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