ادغام پیام‌های نصب درون برنامه‌ای

این راهنما نحوه ادغام اعلان‌های نصب درون برنامه‌ای را در برنامه شما با استفاده از کاتلین یا جاوا شرح می‌دهد.

محیط توسعه خود را تنظیم کنید

کتابخانه‌ی Play In-App Install Prompts بخشی از کتابخانه‌های Google Play Core است. برای استفاده از این کتابخانه، وابستگی Gradle زیر را اضافه کنید:

// In your app's build.gradle.kts file:
...
dependencies {
    implementation("com.google.android.play:crossdeviceprompt:0.0.1")
    ...
}

نمایش اعلان نصب بین دستگاهی

بهترین لحظه در جریان برنامه خود را برای ترغیب کاربر به نصب برنامه شما روی دستگاه دیگر تعیین کنید (مثلاً وقتی که ویدیویی را از تلفن خود به تلویزیون منتقل می‌کند). وقتی برنامه شما به یکی از این نقاط رسید، مراحل زیر را انجام دهید:

  1. یک CrossDevicePromptInstallationRequest ایجاد کنید.
  2. از CrossDevicePromptManager برای ایجاد یک وظیفه درخواست که درخواست را به عنوان پارامتر می‌پذیرد، استفاده کنید.
  3. از شیء CrossDevicePromptInfo حاصل به همراه launchPromptFlow() برای نمایش اعلان به کاربر استفاده کنید.

اگر خطایی در دریافت CrossDevicePromptInfo یا نمایش اعلان رخ دهد، یک استثنا ایجاد می‌شود.

val crossDevicePromptManager = CrossDevicePromptManagerFactory.create(activity)
val request = CrossDevicePromptInstallationRequest.create()

try {
    val info = crossDevicePromptManager.requestInstallationPromptFlow(request).await()
    crossDevicePromptManager.launchPromptFlow(activity, info).await()
} catch (e: CrossDevicePromptException) {
    Log.e(TAG, "Cross-device prompt failed with error: ${e.errorCode}", e)
}

برای تأیید پیاده‌سازی خود، به «آزمایش در برنامه» مراجعه کنید.