راه‌اندازی افزایه «تبلیغات تلفن همراه Google» در Unity

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

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

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

پیش‌نیازها

• از Unity Editor نسخه ۲۰۱۹.۴ یا بالاتر استفاده کنید.
  • توصیه می‌کنیم از نسخه 2022.2 یا بالاتر استفاده کنید.
• برای استقرار در iOS
  • ‫Xcode 16.0 یا بالاتر
  • هدف‌یابی iOS 13.0 یا بالاتر
  • CocoaPods
• برای استقرار در Android
  • حداقل سطح میانای برنامه کاربردی Android برابر با ۲۴ یا بالاتر
  • هدف‌یابی سطح میانای برنامه‌سازی کاربردی Android 35 یا بالاتر

• توصیه می‌شود: حساب AdMob ایجاد کنید و برنامه Android یا iOS ثبت کنید

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

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

OpenUPM-CLI

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

openupm add com.google.ads.mobile

برداشتن .unitypackage دارایی افزایه

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

• دارایی‌ها/مدیر وابستگی خارجی
• دارایی‌ها/GoogleMobileAds
• Assets/Plugins/Android/googlemobileads-unity.aar
• Assets/Plugins/Android/GoogleMobileAdsPlugin
• Assets/Plugins/iOS/GADUAdNetworkExtras
• Assets/Plugins/iOS/unity-plugin-library.a

OpenUPM با واسط کاربر

1. با انتخاب گزینه منو Unity، تنظیمات مدیر بسته را باز کنید ویرایش > تنظیمات پروژه > مدیر بسته.

2. ‫OpenUPM را به‌عنوان ثبت‌کننده محدود به پنجره «مدیر بسته» اضافه کنید:

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

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

4. منوِ کرکره‌ای محدوده مدیر را روی ثبت‌های من تنظیم کنید.

   

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

برداشتن .unitypackage دارایی افزایه

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

• دارایی‌ها/مدیر وابستگی خارجی
• دارایی‌ها/GoogleMobileAds
• Assets/Plugins/Android/googlemobileads-unity.aar
• Assets/Plugins/Android/GoogleMobileAdsPlugin
• Assets/Plugins/iOS/GADUAdNetworkExtras
• Assets/Plugins/iOS/unity-plugin-library.a

OpenUPM

1. برچسب نسخه جدیدترین انتشار را واکشی کنید. برچسب برگشتی، به‌جز پیشوند v، نسخه Google Mobile Ads Unity Plugin است.

   • macOS و Linux

     curl -sS https://api.github.com/repos/googleads/googleads-mobile-unity/releases/latest | jq -r '.tag_name'

   • Windows PowerShell

     (Invoke-RestMethod -Uri "https://api.github.com/repos/googleads/googleads-mobile-unity/releases/latest").tag_name
     

2. فایل Packages/manifest.json را اصلاح کنید تا بااستفاده از نسخه به‌دست‌آمده از دستور قبلی، ثبت و وابستگی محدوده‌دار OpenUPM را اضافه کنید:

   {
     "scopedRegistries": [
       {
         "name": "google",
         "url": "https://package.openupm.com",
         "scopes": [
           "com.google"
         ]
       }
     ],
     "dependencies": {
       "com.google.ads.mobile": "11.5.0"
     }
   }
   

برداشتن .unitypackage دارایی افزایه

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

• دارایی‌ها/مدیر وابستگی خارجی
• دارایی‌ها/GoogleMobileAds
• Assets/Plugins/Android/googlemobileads-unity.aar
• Assets/Plugins/Android/GoogleMobileAdsPlugin
• Assets/Plugins/iOS/GADUAdNetworkExtras
• Assets/Plugins/iOS/unity-plugin-library.a

وارد کردن از GitHub

1. نسخه .unitypackage منتشرشده را از GitHub بارگیری کنید.
2. فایل .unitypackage را با انتخاب گزینه منو Unity دارایی‌ها > وارد کردن بسته > بسته سفارشی و وارد کردن همه موارد وارد کنید.

تنظیم شناسه برنامه AdMob

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

شناسه برنامه AdMob Android و iOS را در هر فیلد وارد کنید.

‫Google Mobile Ads Unity Plugin این تنظیمات را به‌صورت نوشتار در Assets/GoogleMobileAds/Resources/GoogleMobileAdsSettings.asset فایل پیکربندی ذخیره می‌کند.

مقداردهی اولیه کیت توسعه نرم‌افزار

پیش‌از بار کردن آگهی‌ها، برنامه شما باید Google Mobile Ads Unity Plugin را با فراخوانی MobileAds.Initialize() مقداردهی اولیه کند. این کار فقط یک‌بار باید انجام شود، ترجیحاً در زمان راه‌اندازی برنامه.

هشدار: آگهی‌ها می‌توانند توسط Google Mobile Ads Unity Plugin یا شریک واسطه‌گری «کیت‌های توسعه نرم‌افزار» هنگام فراخوانی MobileAds.Initialize() ازپیش بارگیری شوند. اگر باید از کاربران ساکن منطقه اقتصادی اروپا (EEA)، پادشاهی متحد (UK)، یا سوئیس رضایت بگیرید، پرچم‌های مختص درخواست، مثل tagForChildDirectedTreatment یا tag_for_under_age_of_consent، را تنظیم کنید یا قبل‌از بار کردن آگهی‌ها اقدام دیگری انجام دهید. قبل‌از راه‌اندازی Google Mobile Ads Unity Plugin، این کار را انجام دهید.

در اینجا نمونه‌ای از نحوه تماس با MobileAds.Initialize() آورده شده است:

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

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

    MobileAdsEventExecutor.ExecuteInUpdate(() =>
    {
        // Interact with UnityEngine objects on the main thread here.
    });
});
GoogleMobileAdsController.cs

تعامل با اشیای Unity در رشته اصلی

‫Google Mobile Ads Unity Plugin رویدادهای آگهی را در یک رشته پس‌زمینه افزایش می‌دهد. اگر بازخوان‌های آگهی با عناصر Unity، مثل UnityEngine، تعامل دارند، بااستفاده از روش MobileAdsEventExecutor.ExecuteInUpdate، این کار را به‌طور صریح در رشته اصلی Unity زمان‌بندی کنید. برای جزئیات پیاده‌سازی، به ایجاد رویدادهای آگهی در رشته اصلی Unity مراجعه کنید.

انتخاب قالب آگهی

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

برنما

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

پیاده‌سازی آگهی‌های برنمایی

بینابینی

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

پیاده‌سازی آگهی‌های بینابینی

بومی

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

پیاده‌سازی آگهی‌های بومی

پاداش

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

پیاده‌سازی آگهی‌های پاداش‌دار

بینابینی پاداش‌دار

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

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

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

پیاده‌سازی آگهی‌های بینابینی پاداش‌دار

صفحه باز شدن برنامه

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

پیاده‌سازی آگهی‌های در صفحه باز شدن برنامه