با Firebase In-App Messaging شروع کنید

این شروع سریع به شما نشان می دهد که چگونه Firebase In-App Messaging راه اندازی کنید و اولین پیام خود را ارسال کنید.


قبل از شروع

قبل از شروع، مطمئن شوید که Firebase را به پروژه Apple خود اضافه کنید .

Firebase In-App Messaging SDK را به پروژه خود اضافه کنید

برای نصب و مدیریت وابستگی های Firebase از Swift Package Manager استفاده کنید.

  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 Analytics را به برنامه خود اضافه کنید. شما می توانید کتابخانه را بدون مجموعه IDFA یا با مجموعه IDFA انتخاب کنید.
  6. پس از اتمام، Xcode به طور خودکار شروع به حل و دانلود وابستگی های شما در پس زمینه می کند.

اکنون، SDK را در برنامه خود مقداردهی کنید:

  1. اگر هنوز این کار را نکرده‌اید، ماژول Firebase را در ساختار App یا UIApplicationDelegate خود وارد کنید:
    سویفت 
    import Firebase
    هدف-C 
    @import Firebase;
  2. همچنین یک نمونه اشتراک‌گذاری شده FirebaseApp معمولاً در روش اولیه App یا application(_:didFinishLaunchingWithOptions:) پیکربندی کنید، اگر هنوز این کار را نکرده‌اید:
    سویفت 
    FirebaseApp.configure()
    هدف-C 
    [FIRApp configure];
  3. برنامه خود را کامپایل و اجرا کنید.

یک پیام آزمایشی ارسال کنید

شناسه نصب برنامه خود را دریافت کنید

برای صرفه جویی در مصرف برق، Firebase In-App Messaging فقط یک بار در روز پیام ها را از سرور بازیابی می کند. این می تواند آزمایش را دشوار کند، بنابراین کنسول Firebase به شما امکان می دهد یک دستگاه آزمایشی را مشخص کنید که پیام ها را در صورت درخواست نمایش می دهد.

آن دستگاه آزمایشی توسط یک شناسه نصب Firebase ارائه شده توسط سرویس نصب Firebase تعیین می شود. برای پیدا کردن شناسه نصب برنامه آزمایشی خود، برنامه را با آرگومان دستور runtime -FIRDebugEnabled اجرا کنید:

  1. با باز بودن پروژه Xcode، محصول > طرح > طرح ویرایش... را از نوار منوی بالا انتخاب کنید.
  2. تب Arguments را در گفتگوی باز شده باز کنید.
  3. روی + افزودن موارد زیر 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 In-App Messaging را امتحان کنید:

  1. در کنسول Firebase ، صفحه پیام‌رسانی را باز کنید.
  2. اگر این اولین کمپین شما است، روی ایجاد اولین کمپین خود کلیک کنید.
    1. Firebase In-App messages را انتخاب کنید و روی ایجاد کلیک کنید.
  3. در غیر این صورت، در تب کمپین ها ، روی کمپین جدید کلیک کنید.
    1. پیام درون برنامه را انتخاب کنید.
  4. عنوانی را برای اولین پیام خود وارد کنید.
  5. روی Test on Device کلیک کنید
  6. شناسه نصب Firebase برنامه خود را در قسمت Add an install ID وارد کنید.
  7. برای ارسال پیام روی Test کلیک کنید.

Firebase In-App Messaging به محض کلیک روی Test، پیام آزمایشی شما را ارسال می‌کند. برای مشاهده پیام، باید آن را ببندید، سپس برنامه را در دستگاه آزمایشی خود دوباره باز کنید.

برای تأیید اینکه آیا دستگاه شما یک دستگاه آزمایشی است، به دنبال پیام گزارش زیر باشید: 

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