شروع به کار

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

افزونه Google Mobile Ads Unity به توسعه دهندگان Unity این امکان را می دهد که تبلیغات تلفن همراه Google را در برنامه های Android و iOS بدون نیاز به نوشتن کد جاوا یا Objective-C ارائه دهند. این افزونه یک رابط C# برای درخواست تبلیغات ارائه می دهد که توسط اسکریپت های C# در پروژه Unity شما استفاده می شود.

این راهنما برای ناشرانی در نظر گرفته شده است که می‌خواهند از برنامه Unity کسب درآمد کنند.

پیش نیازها
  • از Unity Editor 2019.4 یا بالاتر استفاده کنید
  • برای استقرار در iOS
    • Xcode 16.0 یا بالاتر
    • iOS 12.0 یا بالاتر را هدف قرار دهید
    • CocoaPods
  • برای استقرار در اندروید
    • حداقل سطح Android API 23 یا بالاتر
    • Android API سطح 34 یا بالاتر را هدف قرار دهید

سطح API Android در تنظیمات پروژه > پخش کننده > اندروید > تنظیمات دیگر > تنظیمات دیگر تنظیم شده است.

افزونه Mobile Ads for Unity را وارد کنید
OpenUPM-CLI

اگر OpenUPM CLI را نصب کرده اید، می توانید رجیستری OpenUPM را با دستور زیر نصب کنید:

openupm add com.google.ads.mobile

دارایی های افزونه .unitypackage را حذف کنید

اگر از استفاده از .unitypackage به استفاده از OpenUPM مهاجرت می کنید، باید دارایی ها را به صورت دستی از مکان قدیمی حذف کنید. دایرکتوری های زیر را که از .unitypackage وارد شده اند حذف کنید:

  • Assets/ExternalDependencyManager
  • دارایی/GoogleMobileAds
  • Assets/Plugins/Android/googlemobileads-unity.aar
  • دارایی ها/افزونه ها/اندروید/افزونه GoogleMobileAds
  • دارایی ها / پلاگین ها / iOS / GADUAdNetwork Extras
  • Assets/Plugins/iOS/unity-plugin-library.a

OpenUPM
  1. تنظیمات مدیریت بسته را با انتخاب گزینه منوی Unity Edit > Project Settings > Package Manager باز کنید.

  2. OpenUPM را به عنوان یک رجیستری با محدوده به پنجره Package Manager اضافه کنید:

    Name: OpenUPM
URL: https://package.openupm.com
Scopes: com.google

  3. منوی مدیریت بسته را با انتخاب گزینه منوی Unity Window > Package Manager باز کنید.

  4. منوی کشویی مدیریت دامنه را برای انتخاب My Registries تنظیم کنید.

  5. بسته Google Mobile Ads for Unity را از لیست بسته انتخاب کنید و Install را فشار دهید.

دارایی های افزونه .unitypackage را حذف کنید

اگر از استفاده از .unitypackage به استفاده از OpenUPM مهاجرت می کنید، باید دارایی ها را به صورت دستی از مکان قدیمی حذف کنید. دایرکتوری های زیر را که از .unitypackage وارد شده اند حذف کنید:

  • Assets/ExternalDependencyManager
  • دارایی/GoogleMobileAds
  • Assets/Plugins/Android/googlemobileads-unity.aar
  • دارایی ها/افزونه ها/اندروید/افزونه GoogleMobileAds
  • دارایی ها / پلاگین ها / iOS / GADUAdNetwork Extras
  • Assets/Plugins/iOS/unity-plugin-library.a

واردات از GitHub
  1. آخرین نسخه .unitypackage را از GitHub دانلود کنید.
  2. فایل .unitypackage را با انتخاب گزینه منوی Unity Assets > Import package > Custom Package و وارد کردن همه موارد وارد کنید.
شناسه برنامه AdMob خود را تنظیم کنید

در ویرایشگر Unity، Assets > Google Mobile Ads > Settings را از منو انتخاب کنید.

شناسه برنامه AdMob Android و iOS خود را در هر قسمت وارد کنید.

SDK را راه اندازی کنید

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

در اینجا مثالی از نحوه فراخوانی MobileAds.Initialize() آورده شده است:

MobileAds.Initialize((InitializationStatus initstatus) =>
{
    if (initstatus == null)
    {
        Debug.LogError("Google Mobile Ads initialization failed.");
        return;
    }

    Debug.Log("Google Mobile Ads initialization complete.");

    // Google Mobile Ads events are raised off the Unity Main thread. If you need to
    // access UnityEngine objects after initialization,
    // use MobileAdsEventExecutor.ExecuteInUpdate(). For more information, see:
    // https://developers.google.com/admob/unity/global-settings#raise_ad_events_on_the_unity_main_thread
});
GoogleMobileAdsController.cs

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

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

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