ابدأ باستخدام Firebase In-App Messaging

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

قبل ان تبدأ

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

قم بإضافة Firebase In-App Messaging SDK إلى مشروعك

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

  1. في Xcode، مع فتح مشروع التطبيق الخاص بك، انتقل إلى File > Add Packages .
  2. عندما يُطلب منك ذلك، قم بإضافة مستودع Firebase Apple الأساسي لـ SDK:
  3.   https://github.com/firebase/firebase-ios-sdk.git
  4. اختر مكتبة المراسلة داخل التطبيق.
  5. أضف علامة -ObjC إلى قسم إشارات الرابط الأخرى في إعدادات إنشاء هدفك.
  6. لاستخدام المراسلة داخل التطبيق، يجب عليك تمكين Google Analytics في مشروع Firebase الخاص بك وإضافة Firebase SDK لبرنامج Google Analytics إلى تطبيقك. يمكنك تحديد المكتبة بدون مجموعة IDFA أو مع مجموعة IDFA.
  7. عند الانتهاء، سيبدأ Xcode تلقائيًا في حل وتنزيل تبعياتك في الخلفية.

الآن، قم بتهيئة SDK في تطبيقك:

  1. قم باستيراد وحدة Firebase في بنية App أو UIApplicationDelegate ، إذا لم تقم بما يلي بعد:
    سويفت
    import Firebase
    ج موضوعية
    @import Firebase;
  2. قم أيضًا بتكوين مثيل FirebaseApp مشترك، عادةً في مُهيئ App أو طريقة application application(_:didFinishLaunchingWithOptions:) لمفوض التطبيق، إذا لم تقم بما يلي بعد:
    سويفت
    FirebaseApp.configure()
    ج موضوعية
    [FIRApp configure];
  3. تجميع وتشغيل التطبيق الخاص بك.

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

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

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

ويتم تحديد جهاز الاختبار هذا من خلال معرف تثبيت Firebase الذي توفره خدمة عمليات تثبيت Firebase. للعثور على معرف تثبيت تطبيق الاختبار، قم بتشغيل التطبيق باستخدام وسيطة أمر وقت التشغيل -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 In-App ، ثم انقر فوق "إنشاء" .
  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.