شروع کنید

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

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

پیش نیازها

• از Unity 2019 یا بالاتر استفاده کنید
• برای استقرار در iOS
  • Xcode 14.1 یا بالاتر
  • iOS 11.0 یا بالاتر را هدف قرار دهید
  • CocoaPods
• برای استقرار در اندروید
  • Google Play Services 18.1.0 یا بالاتر
  • Android API سطح 16 یا بالاتر را هدف قرار دهید
• توصیه می شود: یک حساب AdMob ایجاد کنید و یک برنامه Android و/یا iOS ثبت کنید

افزونه Mobile Ads Unity را دانلود کنید

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

برای دانلود بسته Unity برای افزونه یا نگاهی به کد آن در GitHub از لینک های زیر استفاده کنید.

منبع مشاهده پلاگین را دانلود کنید

افزونه Mobile Ads Unity را وارد کنید

پروژه خود را در ویرایشگر Unity باز کنید. Assets > Import Package > Custom Package را انتخاب کنید و فایل GoogleMobileAdsPlugin.unitypackage را که دانلود کرده اید پیدا کنید.

مطمئن شوید که همه فایل‌ها انتخاب شده‌اند و روی Import کلیک کنید.

شامل SDK تبلیغات موبایل

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

مراحل ذکر شده در زیر را دنبال کنید تا مطمئن شوید که پروژه شما دارای SDK تبلیغات موبایلی است.

اندروید

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

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

iOS

برای گنجاندن SDK تبلیغات موبایلی در پروژه Unity، هیچ مرحله اضافی لازم نیست.

توجه: وابستگی‌های iOS با استفاده از CocoaPods شناسایی می‌شوند. CocoaPods به عنوان یک مرحله فرآیند پس از ساخت اجرا می شود.

• هنگام استفاده از Unity 5.6 و بالاتر، یک xcworkspace ایجاد می شود که شامل کتابخانه های وابستگی مورد نیاز است. از xcworkspace تولید شده به جای پروژه استاندارد Xcode استفاده کنید.
• هنگام استفاده از نسخه‌های قدیمی‌تر Unity، وابستگی‌ها در پروژه استاندارد Xcode گنجانده می‌شوند.

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

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

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

رویدادهای تبلیغاتی را در موضوع اصلی Unity افزایش دهید

Google Mobile Ads SDK گاهی اوقات رویدادها را در رشته ای متفاوت از رشته اصلی Unity مطرح می کند. این می تواند هنگام تعامل با اشیاء Unity از رویدادهای ارسال شده از Google Mobile Ads SDK مشکلاتی ایجاد کند. شاید لازم باشد برای همگام سازی رویدادهای SDK تبلیغات موبایل با رشته اصلی Unity کد اضافه کنید.

اگر می‌خواهید SDK Ads Mobile این نگرانی را برای شما حل کند، MobileAds.RaiseAdEventsOnUnityMainThread را روی true تنظیم کنید. این کار SDK تبلیغات موبایل را مجبور می‌کند تا همه رویدادها و تماس‌ها را در رشته اصلی Unity افزایش دهد.

...
using GoogleMobileAds.Api;
...
public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    public void Start()
    {
        // When true all events raised by GoogleMobileAds will be raised
        // on the Unity main thread. The default value is false.
        MobileAds.RaiseAdEventsOnUnityMainThread = true;
    }
}

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

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

هشدار: تبلیغات را می توان با فراخوانی MobileAds.Initialize() توسط Mobile Ads SDK یا SDK های شریک واسطه بارگذاری کرد. اگر نیاز به کسب رضایت از کاربران در منطقه اقتصادی اروپا (EEA) دارید، هر گونه پرچم خاص درخواست را تنظیم کنید، مانند tagForChildDirectedTreatment یا tag_for_under_age_of_consent ، یا در غیر این صورت قبل از بارگیری تبلیغات اقدام کنید. مطمئن شوید که این کار را قبل از راه اندازی SDK تبلیغات موبایل انجام داده اید.

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

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

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

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

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

بنر

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

یک بنر پیاده سازی کنید

بینابینی

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

بینابینی را اجرا کنید

بومی

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

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

پاداش داده شد

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

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

درخواست مجوز شفافیت ردیابی برنامه

برای نمایش درخواست مجوز ردیابی شفافیت برنامه (ATT) برای دسترسی به IDFA، از بسته پشتیبانی تبلیغاتی یونیتی iOS 14 استفاده کنید.

همان کلید برنامه

پیش نیازها: افزونه Google Mobile Ads Unity نسخه 6.1.0 یا بالاتر

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

همان کلید برنامه به طور پیش فرض فعال است، اما می توانید آن را با API زیر غیرفعال کنید:

public void Start()
    {
        RequestConfiguration requestConfiguration =
            new RequestConfiguration.Builder()
            .SetSameAppKeyEnabled(true).build();
        MobileAds.SetRequestConfiguration(requestConfiguration);

        // Initialize the Google Mobile Ads SDK.
        MobileAds.Initialize(HandleInitCompleteAction);
    }