شروع کنید

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

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

پیش نیازها

  • از Unity 2019.4 یا بالاتر استفاده کنید
  • برای استقرار در iOS
    • Xcode 15.3 یا بالاتر
    • iOS 12.0 یا بالاتر را هدف قرار دهید
    • CocoaPods
  • برای استقرار در اندروید
    • حداقل سطح API Android 21 یا بالاتر
    • 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 و وارد کردن همه موارد وارد کنید.

وابستگی های خارجی را شامل شود

افزونه Google Mobile Ads Unity با کتابخانه Unity Play Services Resolver توزیع شده است. این کتابخانه برای استفاده توسط هر افزونه یونیتی که نیاز به دسترسی به کتابخانه‌های مخصوص اندروید مانند AARs یا iOS CocoaPods دارد در نظر گرفته شده است. این افزونه‌های یونیتی توانایی اعلام وابستگی‌ها را فراهم می‌کند، که سپس به طور خودکار حل شده و در پروژه یونیتی شما کپی می‌شوند.

این مراحل را دنبال کنید تا مطمئن شوید که پروژه شما شامل تمام وابستگی ها می شود:

اندروید

به Project Settings > Player > Android > Publishing Settings > Build بروید و انتخاب کنید:

  • الگوی اصلی Gradle سفارشی
  • الگوی خصوصیات Gradle سفارشی

در ویرایشگر Unity، Assets > External Dependency Manager > Android Resolver > Resolve را انتخاب کنید تا کتابخانه Unity External Dependency Manager وابستگی های اعلام شده را در فهرست Assets/Plugins/Android برنامه Unity شما کپی کند.

iOS

Unity برای iOS از CocoaPods برای شناسایی و مدیریت وابستگی ها استفاده می کند. برای نیازهای خاص یا مراحل عیب‌یابی مربوط به وابستگی‌های iOS خود، با اسناد CocoaPods مشورت کنید.

وابستگی‌های افزونه Google Mobile Ads Unity در Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml فهرست شده‌اند.

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

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

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

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

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

در اینجا مثالی از نحوه فراخوانی Initialize() در متد Start() از یک اسکریپت متصل به GameObject آورده شده است:

...
using GoogleMobileAds.Api;
...
public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    public void Start()
    {
        // Initialize the Google Mobile Ads SDK.
        MobileAds.Initialize(initStatus => { });
    }
}

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

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

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

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

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

بینابینی

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

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

بومی

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

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

پاداش داده شد

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

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

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

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

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

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

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

برنامه باز شد

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

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

،

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

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

پیش نیازها

  • از Unity 2019.4 یا بالاتر استفاده کنید
  • برای استقرار در iOS
    • Xcode 15.3 یا بالاتر
    • iOS 12.0 یا بالاتر را هدف قرار دهید
    • CocoaPods
  • برای استقرار در اندروید
    • حداقل سطح API Android 21 یا بالاتر
    • 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 و وارد کردن همه موارد وارد کنید.

وابستگی های خارجی را شامل شود

افزونه Google Mobile Ads Unity با کتابخانه Unity Play Services Resolver توزیع شده است. این کتابخانه برای استفاده توسط هر افزونه یونیتی که نیاز به دسترسی به کتابخانه‌های مخصوص اندروید مانند AARs یا iOS CocoaPods دارد در نظر گرفته شده است. این افزونه‌های یونیتی توانایی اعلام وابستگی‌ها را فراهم می‌کند، که سپس به طور خودکار حل شده و در پروژه یونیتی شما کپی می‌شوند.

این مراحل را دنبال کنید تا مطمئن شوید که پروژه شما شامل تمام وابستگی ها می شود:

اندروید

به Project Settings > Player > Android > Publishing Settings > Build بروید و انتخاب کنید:

  • الگوی اصلی Gradle سفارشی
  • الگوی خصوصیات Gradle سفارشی

در ویرایشگر Unity، Assets > External Dependency Manager > Android Resolver > Resolve را انتخاب کنید تا کتابخانه Unity External Dependency Manager وابستگی های اعلام شده را در فهرست Assets/Plugins/Android برنامه Unity شما کپی کند.

iOS

Unity برای iOS از CocoaPods برای شناسایی و مدیریت وابستگی ها استفاده می کند. برای نیازهای خاص یا مراحل عیب‌یابی مربوط به وابستگی‌های iOS خود، با اسناد CocoaPods مشورت کنید.

وابستگی‌های افزونه Google Mobile Ads Unity در Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml فهرست شده‌اند.

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

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

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

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

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

در اینجا مثالی از نحوه فراخوانی Initialize() در متد Start() از یک اسکریپت متصل به GameObject آورده شده است:

...
using GoogleMobileAds.Api;
...
public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    public void Start()
    {
        // Initialize the Google Mobile Ads SDK.
        MobileAds.Initialize(initStatus => { });
    }
}

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

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

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

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

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

بینابینی

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

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

بومی

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

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

پاداش داده شد

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

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

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

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

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

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

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

برنامه باز شد

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

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