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

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


قبل البدء

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

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

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

  1. في Xcode، بعد فتح مشروع تطبيقك، انتقِل إلى ملف (File) > إضافة حِزم (Add Packages).
  2. عندما يُطلب منك ذلك، أضِف مستودع حزمة Firebase SDK لمنصات Apple:
    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). راجِع الأسئلة الشائعة حول أحدث تنظيم للوحدات في الـ ـGoogle Analytics لحزمة Firebase SDK.
  6. عند الانتهاء، سيبدأ Xcode تلقائيًا في حلّ تبعياتك وتنزيلها في الخلفية.

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

  1. استورِد وحدة Firebase في بنية App أو UIApplicationDelegate، إذا لم يسبق لك إجراء ذلك:
    Swift
    import Firebase
    Objective-C
    @import Firebase;
  2. عليك أيضًا إعداد نسخة مشترَكة من FirebaseApp ، عادةً في أداة تهيئة App's أو طريقة 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. انقر على + إضافة عناصر (Add items) ضِمن الوسيطات التي تم تمريرها عند التشغيل (Arguments Passed On Launch).
  4. أدخِل "-FIRDebugEnabled" في الحقل الذي تم إنشاؤه حديثًا.
  5. انقر على إغلاق (Close)، ثم شغِّل تطبيقك.

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

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

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

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

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

  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.