شروع کنید

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

قبل از شروع

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

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

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

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

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

  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:23.6.0")
}

    شیار 

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

  3. شناسه برنامه 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="
/<network_code>~<application_id>"/>
  </application>
</manifest>

    در یک برنامه واقعی، شناسه برنامه نمونه را با شناسه برنامه Ad Manager واقعی خود جایگزین کنید. اگر فقط در حال آزمایش SDK در یک برنامه Hello World هستید، می توانید از شناسه نمونه استفاده کنید.

    همچنین، توجه داشته باشید که عدم اضافه کردن تگ <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 تبلیغات موبایل Google را راه اندازی کنید.

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

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

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

جاوا 

import com.google.android.gms.ads.MobileAds;
import com.google.android.gms.ads.initialization.InitializationStatus;
import com.google.android.gms.ads.initialization.OnInitializationCompleteListener;

public class MainActivity extends AppCompatActivity {
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

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

کاتلین 

import com.google.android.gms.ads.MobileAds
import kotlinx.coroutines.CoroutineScope
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.launch

class MainActivity : AppCompatActivity() {
  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)

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

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

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

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

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

بینابینی

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

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

بومی

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

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

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

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

پاداش داده شد

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

اجرای تبلیغات با پاداش

بینابینی با پاداش

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

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

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

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

برنامه باز شد

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

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

منابع اضافی

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