‫Google برای ترجمه محتوا به زبان ترجیحی شما از فناوری هوشواره استفاده می‌کند. ترجمه‌های هوشواره‌ای ممکن است اشتباه داشته باشند.

شروع به کار با «پیام‌رسانی درون‌برنامه‌ای Firebase»

این راهنمای شروع سریع به شما نشان می‌دهد چگونه 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 را برای Android اضافه کنید. توصیه می‌کنیم از Firebase Android BoM برای کنترل نسخه‌بندی کتابخانه استفاده کنید.

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

dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:34.19.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:22.0.3")
    implementation("com.google.firebase:firebase-analytics:23.2.0")
}

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

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

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

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

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

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

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

در کنسول Firebase، به DevOps و تعامل > پیام‌رسانی بروید.
گردش کار راه‌اندازی پویش جدید راه‌اندازی کنید:
- اگر این اولین پویش شما است:
  1. روی ایجاد اولین پویش کلیک کنید.
  2. پیام‌های درون‌برنامه‌ای Firebase را انتخاب کنید و روی ایجاد کردن کلیک کنید.
- اگر قبلاً پویش‌هایی ایجاد کرده‌اید:
  1. در برگه پویش‌ها، روی پویش جدید کلیک کنید.
  2. پیام‌رسانی درون‌برنامه‌ای را انتخاب کنید.
برای پیام اولتان عنوان وارد کنید.
روی آزمایش در دستگاه کلیک کنید.
شناسه نصب Firebase Firebase برنامه را در فیلد افزودن شناسه نصب وارد کنید.
برای ارسال پیام، روی آزمایش کلیک کنید. بلافاصله ارسال خواهد شد.
برای دیدن پیام در دستگاه آزمایشی، باید برنامه را در دستگاه آزمایشی ببندید و سپس دوباره باز کنید.

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

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

شروع به کار با «پیام‌رسانی درون‌برنامه‌ای Firebase» با مجموعه‌ها، منظم بمانید ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.