راه‌اندازی «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» (قدیمی)

انتخاب پلاتفرم: Android iOS Unity Flutter Android (قدیمی)

ادغام Google Mobile Ads SDK (Legacy) در برنامه اولین گام برای نمایش آگهی و کسب درآمد است. پس‌از ادغام کیت توسعه نرم‌افزار، می‌توانید قالب آگهی (مثل آگهی بومی یا ویدیویی پاداش‌دار) را انتخاب کنید و مراحل پیاده‌سازی آن را دنبال کنید.

قبل‌از شروع

برای آماده کردن برنامه‌تان، مراحل بخش‌های زیر را تکمیل کنید.

پیش‌نیازهای برنامه

  • مطمئن شوید که فایل ساخت برنامه شما از مقادیر زیر استفاده می‌کند:

    • حداقل نسخه کیت توسعه نرم‌افزار 24 یا بالاتر
    • نسخه کیت توسعه نرم‌افزار 35 یا بالاتر را کامپایل کنید

پیکربندی برنامه

  1. در فایل تنظیمات Gradle، مخزن Maven در Google و مخزن مرکزی Maven را اضافه کنید:

    Kotlin

    pluginManagement {
  repositories {
    google()
    mavenCentral()
    gradlePluginPortal()
  }
}

dependencyResolutionManagement {
  repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
  repositories {
    google()
    mavenCentral()
  }
}

rootProject.name = "My Application"
include(":app")

    Groovy

    pluginManagement {
  repositories {
    google()
    mavenCentral()
    gradlePluginPortal()
  }
}

dependencyResolutionManagement {
  repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
  repositories {
    google()
    mavenCentral()
  }
}

rootProject.name = "My Application"
include ':app'

  2. وابستگی‌های Google Mobile Ads SDK (Legacy) را به فایل ساخت سطح برنامه اضافه کنید:

    Kotlin

    dependencies {
  implementation("com.google.android.gms:play-services-ads:25.5.0")
}

    Groovy

    dependencies {
  implementation 'com.google.android.gms:play-services-ads:25.5.0'
}

  3. روی هم‌اکنون همگام‌سازی شود کلیک کنید. برای جزئیات همگام‌سازی، به همگام‌سازی پروژه‌ها با فایل‌های Gradle مراجعه کنید.

  4. شناسه برنامه Ad Manager خود را، همان‌طور که در رابط وب Ad Manager شناسایی شده است، به فایل AndroidManifest.xml برنامه‌تان اضافه کنید. برای انجام این کار، برچسب <meta-data> را با android:name="com.google.android.gms.ads.APPLICATION_ID" اضافه کنید. می‌توانید شناسه برنامه خود را در میانای وب Ad Manager پیدا کنید. برای android:value، شناسه برنامه Ad Manager خودتان را درون علامت نقل‌قول قرار دهید.

    <manifest>
  <application>
    <!-- Sample Ad Manager app ID: ca-app-pub-3940256099942544~3347511713 -->
    <meta-data
        android:name="com.google.android.gms.ads.APPLICATION_ID"
        android:value="SAMPLE_APP_ID"/>
  </application>
</manifest>

    SAMPLE_APP_ID را با شناسه برنامه Ad Manager خود جایگزین کنید. هنگام آزمایش، از شناسه برنامه نمونه نشان‌داده‌شده در مثال قبلی استفاده کنید.

    همچنین توجه داشته باشید که اگر برچسب <meta-data> را دقیقاً همان‌طور که نشان داده شده است اضافه نکنید، برنامه ازکار می‌افتد و این پیام نشان داده می‌شود:

    Missing application ID.

    (اختیاری) اجازه AD_ID را برای نسخه‌های قبلی اعلام کنید تا با Android 13 کار کنند.

    اگر برنامه‌تان از Google Mobile Ads SDK (Legacy) نسخه 20.4.0 یا بالاتر استفاده می‌کند، می‌توانید از این مرحله صرف‌نظر کنید زیرا کیت توسعه نرم‌افزار به‌طور خودکار اجازه com.google.android.gms.permission.AD_ID را اعلام می‌کند و می‌تواند هر زمان که «شناسه تبلیغاتی» دردسترس باشد به آن دسترسی پیدا کند.

    برای برنامه‌هایی که از نسخه Google Mobile Ads SDK (Legacy) 20.3.0 یا پایین‌تر استفاده می‌کنند و Android 13 را هدف‌یابی می‌کنند، باید اجازه com.google.android.gms.permission.AD_ID را در فایل AndroidManifest.xml اضافه کنید تا Google Mobile Ads SDK (Legacy) بتواند به «شناسه تبلیغاتی» دسترسی پیدا کند:

    <manifest>
 <application>
   <meta-data
       android:name="com.google.android.gms.ads.APPLICATION_ID"
       android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>

   <!-- For apps targeting Android 13 or higher & GMA SDK version 20.3.0 or lower -->
   <uses-permission android:name="com.google.android.gms.permission.AD_ID"/>

 </application>
</manifest>

    برای کسب اطلاعات بیشتر درباره com.google.android.gms.permission.AD_ID اظهارنامه اجازه، ازجمله نحوه غیرفعال کردن آن، به این مقاله «کنسول Play» مراجعه کنید.

مقداردهی اولیه Google Mobile Ads SDK (Legacy)

قبل‌از بار کردن آگهی‌ها، Google Mobile Ads SDK (Legacy) را با فراخوانی MobileAds.initialize() مقداردهی اولیه کنید.

این روش «کیت توسعه نرم‌افزار» را مقداردهی اولیه می‌کند و پس‌از تکمیل مقداردهی اولیه Google Mobile Ads SDK (Legacy) و آداپتور، یا پس‌از اتمام مهلت ۳۰ ثانیه‌ای، شنونده تکمیل را فرا می‌خواند. این کار فقط یک‌بار باید انجام شود، ترجیحاً در زمان راه‌اندازی برنامه.

اگر از میانجی‌گری استفاده می‌کنید، قبل‌از بار کردن آگهی‌ها، منتظر بمانید تا کنترل‌کننده تکمیل فراخوانی شود. این کار تضمین می‌کند که همه آداپتورهای واسطه‌گری مقداردهی اولیه شوند.

آگهی‌ها ممکن است توسط Google Mobile Ads SDK (Legacy) یا کیت‌های توسعه نرم‌افزار شریک واسطه‌گری پس‌از مقداردهی اولیه پیش‌بارگیری شوند. اگر باید از کاربران ساکن منطقه اقتصادی اروپا (EEA)، پادشاهی متحد (UK)، یا سوئیس رضایت دریافت کنید، پرچم‌های مختص درخواست را تنظیم کنید، برای نمونه setTagForChildDirectedTreatment() یا setTagForUnderAgeOfConsent()، یا قبل‌از بار کردن آگهی‌ها اقدام دیگری انجام دهید، مطمئن شوید این کار را قبل‌از مقداردهی اولیه Google Mobile Ads SDK (Legacy) انجام دهید.

در اینجا نمونه‌ای از نحوه فراخوانی روش initialize() در یک رشته پس‌زمینه در یک «فعالیت» آورده شده است:

جاوا

new Thread(
        () -> {
          // Initialize the Google Mobile Ads SDK on a background thread.
          MobileAds.initialize(this, initializationStatus -> {});
        })
    .start();

Kotlin

CoroutineScope(Dispatchers.IO).launch {
  // Initialize the Google Mobile Ads SDK on a background thread.
  MobileAds.initialize(this@MyActivity) {}
}

انتخاب قالب آگهی

‫Google Mobile Ads SDK (Legacy) اکنون وارد شده است و برای پیاده‌سازی آگهی آماده‌اید. ‫Ad Manager قالب‌های آگهی مختلفی را ارائه می‌دهد، بنابراین می‌توانید قالبی را انتخاب کنید که بهترین تناسب را با تجربه کاربری برنامه‌تان داشته باشد.

واحدهای آگهی برنمایی آگهی‌های مستطیلی را نمایش می‌دهند که بخشی از چیدمان برنامه را اشغال می‌کنند. می‌توانند پس‌از یک دوره زمانی مشخص به‌طور خودکار بازآوری شوند. این یعنی کاربران در فواصل زمانی منظم آگهی جدیدی را مشاهده می‌کنند، حتی اگر در همان صفحه برنامه شما بمانند. همچنین ساده‌ترین قالب آگهی برای پیاده‌سازی هستند.

پیاده‌سازی آگهی‌های برنمایی

بینابینی

واحدهای آگهی بینابینی آگهی‌های تمام‌صفحه‌ای را در برنامه شما نشان می‌دهند. آن‌ها را در وقفه‌ها و گذرهای طبیعی در رابط برنامه خود قرار دهید، مانند پس‌از تکمیل سطح در یک برنامه بازی.

پیاده‌سازی آگهی‌های بینابینی

بومی

آگهی‌های بومی آگهی‌هایی هستند که در آن‌ها می‌توانید روش ارائه دارایی‌ها مثل عنوان‌ها و دعوت‌ها به اقدام در برنامه‌هایتان را سفارشی‌سازی کنید. با سبک‌دهی کردن آگهی خودتان، می‌توانید ارائه آگهی طبیعی و نامحسوسی ایجاد کنید که می‌تواند به تجربه کاربری غنی بیفزاید.

‫Google Ad Manager دو روش برای پیاده‌سازی آگهی‌های بومی ارائه می‌دهد: سبک‌های بومی و آگهی‌های بومی استاندارد ازطریق پردازنده سفارشی.

سبک‌های بومی برای ساده کردن پیاده‌سازی آگهی‌های بومی طراحی شده است، و اگر با این قالب آشنایی ندارید، انتخاب بسیار خوبی است. پرداز زدن سفارشی برای به حداکثر رساندن آزادی شما در ایجاد ارائه‌هایتان طراحی شده است.

پیاده‌سازی سبک‌های بومی پیاده‌سازی آگهی‌های بومی (پرداز سفارشی)

پاداش

واحدهای آگهی دارای پاداش به کاربران امکان می‌دهند بازی کنند، در نظرسنجی شرکت کنند، یا ویدیو تماشا کنند تا پاداش‌های درون‌برنامه‌ای مثل سکه، جان اضافی، یا امتیاز کسب کنند. می‌توانید پاداش‌های مختلفی برای واحدهای آگهی مختلف تنظیم کنید و مقادیر پاداش و مواردی را که کاربر دریافت می‌کند مشخص کنید.

پیاده‌سازی آگهی‌های پاداش‌دار

بینابینی پاداش‌دار

آگهی میان‌ویدیویی پاداش‌دار نوع جدیدی از قالب آگهی انگیزشی است که به شما امکان می‌دهد برای آگهی‌هایی که به‌طور خودکار درطول انتقال‌های طبیعی برنامه نمایش داده می‌شوند، پاداش‌هایی مثل سکه یا جان اضافه ارائه دهید.

برخلاف آگهی‌های دارای پاداش، کاربران ملزم به موافقت برای مشاهده آگهی بینابینی دارای پاداش نیستند.

به‌جای پیام‌واره موافقت در آگهی‌های دارای پاداش، میان‌آگهی‌های دارای پاداش به صفحه مقدماتی نیاز دارند که پاداش را اعلام کند و به کاربران فرصت دهد درصورت تمایل انصراف دهند.

پیاده‌سازی آگهی‌های بینابینی پاداش‌دار

صفحه باز شدن برنامه

آگهی باز کردن برنامه قالب آگهی‌ای است که وقتی کاربران برنامه شما را باز می‌کنند یا به آن برمی‌گردند نمایش داده می‌شود. آگهی روی صفحه بارگیری قرار می‌گیرد.

پیاده‌سازی آگهی‌های در صفحه باز شدن برنامه

منابع بیشتر

مخزن «آگهی‌های تلفن همراه Google» در GitHub نحوه استفاده از قالب‌های آگهی مختلفی را که این API ارائه می‌دهد نشان می‌دهد.