شروع کنید

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

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

قبل از شروع

برای آماده سازی اپلیکیشن خود، مراحل زیر را انجام دهید.

پیش نیازهای اپلیکیشن

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

    • حداقل نسخه SDK 23 یا بالاتر
    • نسخه SDK 34 یا بالاتر را کامپایل کنید
برنامه خود را در حساب AdMob خود تنظیم کنید

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

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

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

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

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

    کاتلین 
    pluginManagement {
  repositories {
    google()
    mavenCentral()
    gradlePluginPortal()
  }
}

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

rootProject.name = "My Application"
include(":app")
    شیار 
    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 را به فایل ساخت سطح برنامه خود اضافه کنید:

    کاتلین 
    dependencies {
  implementation("com.google.android.gms:play-services-ads:24.6.0")
}
    شیار 
    dependencies {
  implementation 'com.google.android.gms:play-services-ads:24.6.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>

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

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

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

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

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

    <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 را راه‌اندازی کنید قبل از بارگیری تبلیغات، با فراخوانی MobileAds.initialize() SDK Ads Google Mobile را مقداردهی کنید.

این روش SDK را مقداردهی اولیه می‌کند و یک شنونده تکمیل را پس از تکمیل مقداردهی اولیه SDK و آداپتور Google Mobile Ads یا پس از 30 ثانیه بازخوانی می‌کند. این کار باید فقط یک بار انجام شود، ایده آل در هنگام راه اندازی برنامه.

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

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

جاوا 
new Thread(
        () -> {
          // Initialize the Google Mobile Ads SDK on a background thread.
          MobileAds.initialize(this, initializationStatus -> {});
        })
    .start();
MyActivity.java
کاتلین 
CoroutineScope(Dispatchers.IO).launch {
  // Initialize the Google Mobile Ads SDK on a background thread.
  MobileAds.initialize(this@MainActivity) {}
}
MainActivity.kt

یک قالب تبلیغ را انتخاب کنید

Google Mobile Ads SDK اکنون وارد شده است و شما آماده اجرای یک تبلیغ هستید. AdMob فرمت‌های مختلف تبلیغاتی را ارائه می‌دهد، بنابراین می‌توانید یکی را انتخاب کنید که به بهترین وجه با تجربه کاربری برنامه‌تان مطابقت دارد.