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

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

ادغام 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() در یک رشته پس‌زمینه در یک «فعالیت» آورده شده است:

جاوا

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» در GitHub نحوه استفاده از قالب‌های آگهی مختلفی را که این API ارائه می‌دهد نشان می‌دهد.