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

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

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

قبل‌از شروع

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

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

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

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

برنامه‌تان را در حساب AdMob خود راه‌اندازی کنید

با تکمیل مراحل زیر، برنامه‌تان را به‌عنوان برنامه AdMob ثبت کنید:

1. به سیستم حساب AdMob وارد شوید یا برای آن ثبت‌نام کنید.

2. برنامه‌تان را در AdMob ثبت کنید. این مرحله یک برنامه AdMob با شناسه برنامه AdMob منحصربه‌فرد ایجاد می‌کند که بعداً در این راهنما به آن نیاز خواهید داشت.

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

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

   <manifest>
     <application>
       <!-- Sample AdMob 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 را با شناسه برنامه AdMob خودتان جایگزین کنید. هنگام آزمایش، از شناسه برنامه نمونه نشان‌داده‌شده در مثال قبلی استفاده کنید.

   همچنین توجه داشته باشید که عدم افزودن برچسب <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) و آداپتور، یا پس‌از اتمام مهلت ۳۰ ثانیه‌ای، شنونده تکمیل را فراخوانی می‌کند. این کار فقط یک‌بار باید انجام شود، ترجیحاً هنگام راه‌اندازی برنامه.

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

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

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

جاوا

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

Kotlin

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

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

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

برنما

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

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

بینابینی

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

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

بومی

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

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

پاداش

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

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

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

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

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

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

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

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

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

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

منابع بیشتر

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