شروع کنید

پلتفرم مورد نظر: اندروید، اندروید (بتا)، iOS، یونیتی ، فلاتر

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

قبل از اینکه شروع کنی

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

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

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

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

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

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

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

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

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

  1. در فایل تنظیمات Gradle خود، مخزن Maven گوگل و مخزن مرکزی 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. وابستگی‌های SDK تبلیغات موبایلی گوگل را به فایل ساخت سطح برنامه خود اضافه کنید:

    کاتلین 

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

    گرووی 

    dependencies {
  implementation 'com.google.android.gms:play-services-ads:24.8.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 را برای نسخه‌های قبلی جهت کار با اندروید ۱۳ اعلام کنید.

    اگر برنامه شما از نسخه ۲۰.۴.۰ یا بالاتر SDK تبلیغات موبایل گوگل استفاده می‌کند، می‌توانید از این مرحله صرف نظر کنید زیرا SDK به طور خودکار مجوز com.google.android.gms.permission.AD_ID را اعلام می‌کند و می‌تواند هر زمان که شناسه تبلیغات در دسترس باشد به آن دسترسی داشته باشد.

    برای برنامه‌هایی که از SDK تبلیغات موبایل گوگل نسخه ۲۰.۳.۰ یا پایین‌تر استفاده می‌کنند و اندروید ۱۳ را هدف قرار می‌دهند، باید مجوز com.google.android.gms.permission.AD_ID را در فایل AndroidManifest.xml برای دسترسی 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 مراجعه کنید.

مقداردهی اولیه SDK تبلیغات موبایلی گوگل

قبل از بارگذاری تبلیغات، با فراخوانی MobileAds.initialize() ‎، کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل (Google Mobile Ads SDK) را راه‌اندازی کنید.

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

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

در اینجا مثالی از نحوه فراخوانی متد 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

انتخاب قالب تبلیغ

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

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

اجرای تبلیغات بنری

بینابینی

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

تبلیغات بینابینی را پیاده‌سازی کنید

بومی

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

تبلیغات بومی را پیاده سازی کنید

پاداش داده شده

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

تبلیغات جایزه‌دار (Rewarded Ads) را پیاده‌سازی کنید

تبلیغات بینابینی پاداش‌دار

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

برخلاف تبلیغات جایزه‌دار، کاربران برای مشاهده‌ی تبلیغات بینابینی جایزه‌دار ملزم به انتخاب نیستند.

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

تبلیغات بینابینی پاداش‌دار را پیاده‌سازی کنید

برنامه باز است

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

تبلیغات باز برنامه را پیاده سازی کنید

منابع اضافی

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