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

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

قبل از اینکه شروع کنی

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

کیت توسعه Firebase In-App Messaging را به پروژه خود اضافه کنید.

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

در Xcode، با باز کردن پروژه برنامه خود، به File > Add Packages بروید.
وقتی از شما خواسته شد، مخزن SDK پلتفرم‌های اپل فایربیس را اضافه کنید:

  https://github.com/firebase/firebase-ios-sdk.git

کتابخانه In-App Messaging را انتخاب کنید.
پرچم -ObjC را به بخش Other Linker Flags در تنظیمات ساخت هدف خود اضافه کنید.
برای استفاده از In-App Messaging ، باید Google Analytics در پروژه Firebase خود فعال کنید و Firebase SDK مخصوص Google Analytics را به برنامه خود اضافه کنید. می‌توانید کتابخانه را بدون مجموعه IDFA یا با مجموعه IDFA انتخاب کنید. به سوالات متداول ما در مورد آخرین سازماندهی ماژول‌ها در Google Analytics مخصوص Firebase SDK مراجعه کنید.
پس از اتمام، Xcode به طور خودکار شروع به حل و دانلود وابستگی‌های شما در پس‌زمینه می‌کند.

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

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

توجه: Firebase In-App Messaging به نسخه ۵.۶.۰ یا بالاتر فایربیس نیاز دارد. اگر در کامپایل برنامه خود مشکل دارید، دستور pod update در دایرکتوری پروژه برنامه خود اجرا کنید. البته به خاطر داشته باشید که این دستور تمام وابستگی‌های برنامه شما را به‌روزرسانی می‌کند، نه فقط وابستگی‌های فایربیس.

ارسال پیام آزمایشی

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

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

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

با باز کردن پروژه Xcode خود، از نوار منوی بالا، گزینه Product > Scheme > Edit scheme... را انتخاب کنید.
برگه آرگومان‌ها را از کادر محاوره‌ای که ظاهر می‌شود، باز کنید.
روی «افزودن موارد» در زیر آرگومان‌های ارسالی هنگام اجرا کلیک کنید.
در فیلد تازه ایجاد شده، عبارت "-FIRDebugEnabled" را وارد کنید.
روی بستن کلیک کنید، سپس برنامه خود را اجرا کنید.

پس از شروع اجرای برنامه، در لاگ‌های کنسول Xcode به دنبال خط زیر بگردید:

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

ارسال پیام به دستگاه تست شما

پس از اینکه برنامه خود را روی دستگاه آزمایشی اجرا کردید و شناسه نصب Firebase (FID) آن را داشتید، می‌توانید با ارسال یک پیام آزمایشی، تنظیمات Firebase In-App Messaging خود را امتحان کنید:

در کنسول Firebase ، صفحه پیام‌رسانی (Messaging) را باز کنید.
اگر این اولین کمپین شماست، روی «ایجاد اولین کمپین» کلیک کنید.
1. پیام‌های درون‌برنامه‌ای فایربیس را انتخاب کنید و روی ایجاد کلیک کنید.
در غیر این صورت، در برگه کمپین‌ها ، روی کمپین جدید کلیک کنید.
1. پیام‌رسانی درون‌برنامه‌ای را انتخاب کنید.
برای اولین پیام خود یک عنوان وارد کنید.
روی تست روی دستگاه کلیک کنید
شناسه نصب Firebase برنامه خود را در فیلد «افزودن شناسه نصب» وارد کنید.
برای ارسال پیام، روی «تست» کلیک کنید.

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

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

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