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

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


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

اگر هنوز Firebase را به پروژه اندروید خود اضافه نکرده‌اید، آن را اضافه کنید.

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

در فایل Gradle ماژول (سطح برنامه) خود (معمولاً <project>/<app-module>/build.gradle.kts یا <project>/<app-module>/build.gradle )، وابستگی مربوط به کتابخانه In-App Messaging برای اندروید را اضافه کنید. توصیه می‌کنیم برای کنترل نسخه‌بندی کتابخانه Firebase Android BoM استفاده کنید.

برای استفاده از In-App Messaging ، باید Google Analytics در پروژه Firebase خود فعال کنید و Firebase SDK را برای Google Analytics به برنامه خود اضافه کنید.

dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:34.4.0"))

    // Add the dependencies for the In-App Messaging and Analytics libraries
    // When using the BoM, you don't specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-inappmessaging-display")
    implementation("com.google.firebase:firebase-analytics")
}

با استفاده از Firebase Android BoM ، برنامه شما همیشه از نسخه‌های سازگار کتابخانه‌های اندروید Firebase استفاده خواهد کرد.

(جایگزین) اضافه کردن وابستگی‌های کتابخانه Firebase بدون استفاده از BoM

اگر تصمیم به استفاده از Firebase BoM ندارید، باید هر نسخه از کتابخانه Firebase را در خط وابستگی آن مشخص کنید.

توجه داشته باشید که اگر از چندین کتابخانه Firebase در برنامه خود استفاده می‌کنید، اکیداً توصیه می‌کنیم از BoM برای مدیریت نسخه‌های کتابخانه استفاده کنید، که تضمین می‌کند همه نسخه‌ها سازگار هستند.

dependencies {
    // Add the dependencies for the In-App Messaging and Analytics libraries
    // When NOT using the BoM, you must specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-inappmessaging-display:22.0.1")
    implementation("com.google.firebase:firebase-analytics:23.0.0")
}

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

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

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

دستگاه تست توسط یک شناسه FirebaseInstallations یا FID تعیین می‌شود. FID برنامه تست خود را با بررسی Logcat در اندروید استودیو برای گزارش سطح «اطلاعات» زیر پیدا کنید: 

I/FIAM.Headless: Starting InAppMessaging runtime with Installation ID YOUR_INSTALLATION_ID

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

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

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

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

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

I/FIAM.Headless: Setting this device as a test device