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

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


قبل از شروع

اگر قبلاً این کار را نکرده‌اید، Firebase را به پروژه Android خود اضافه کنید .

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

در فایل Gradle ماژول (سطح برنامه) خود (معمولا <project>/<app-module>/build.gradle.kts یا <project>/<app-module>/build.gradle )، وابستگی را برای In-App Messaging اضافه کنید. کتابخانه 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:33.3.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 Android استفاده می‌کند.

(جایگزین) وابستگی های کتابخانه 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:21.0.0")
    implementation("com.google.firebase:firebase-analytics:22.1.0")
}
به دنبال یک ماژول کتابخانه خاص کاتلین هستید؟ از اکتبر 2023 ( Firebase BoM 32.5.0) ، توسعه دهندگان Kotlin و Java می توانند به ماژول کتابخانه اصلی وابسته باشند (برای جزئیات، به سؤالات متداول در مورد این ابتکار مراجعه کنید).

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

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

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

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

I/FIAM.Headless: Starting InAppMessaging runtime with 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، پیام آزمایشی شما را ارسال می‌کند. برای مشاهده پیام، باید آن را ببندید، سپس برنامه را در دستگاه آزمایشی خود دوباره باز کنید.

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

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