این راهنما به شما نشان میدهد که چگونه Google Mobile Ads Unity Plugin برای بارگذاری و نمایش تبلیغات از Unity Ads با استفاده از میانجیگری استفاده کنید، که شامل ادغامهای پیشنهاد قیمت و آبشاری میشود. این راهنما نحوه اضافه کردن Unity Ads به پیکربندی میانجیگری یک واحد تبلیغاتی و نحوه ادغام SDK و آداپتور Unity Ads در یک برنامه Unity را پوشش میدهد.
آداپتور میانجیگری AdMob برای Unity Ads دارای قابلیتهای زیر است:
| ادغام | |
|---|---|
| مناقصه | |
| آبشار | ۱ |
| قالبها | |
| بنر | |
| بینابینی | |
| پاداش داده شده | |
- آخرین Google Mobile Ads Unity Plugin
- یونیتی ۴ یا بالاتر
- [برای پیشنهاد قیمت]: برای ادغام تمام قالبهای تبلیغاتی پشتیبانیشده در پیشنهاد قیمت، از افزونهی میانجیگری تبلیغات موبایلی گوگل برای تبلیغات یونیتی ۳.۱۱.۱ یا بالاتر استفاده کنید ( آخرین نسخه توصیه میشود )
- برای نصب روی اندروید
- اندروید API سطح ۲۳ یا بالاتر
- برای استقرار در iOS
- هدف استقرار iOS 13.0 یا بالاتر
- یک پروژه یونیتی فعال که با Google Mobile Ads Unity Plugin پیکربندی شده است. برای جزئیات بیشتر به بخش «راهاندازی Google Mobile Ads Unity Plugin مراجعه کنید.
- میانجیگری AdMob را راهاندازی کنید .
در Unity Ads ثبت نام کنید یا وارد شوید .
در داشبورد Unity Ads ، به بخش Projects بروید و روی New کلیک کنید.
فرم را پر کنید و برای افزودن پروژه خود، روی ایجاد کلیک کنید.
به بخش کسب درآمد از تبلیغات یونیتی بروید، سپس روی شروع به کار کلیک کنید.
در پنجره New Project ، گزینه I will use Mediation and Google Admob for Mediation Partner را انتخاب کنید، سپس روی Next کلیک کنید.
گزینه مربوط به تنظیمات تبلیغات را انتخاب کنید، سپس روی «بعدی» کلیک کنید.
تنظیمات قرارگیری خود را انتخاب کنید، سپس روی «بعدی» کلیک کنید.
فرم را پر کنید، سپس روی افزودن پروژه کلیک کنید.
به شناسه بازی (Game ID) توجه کنید.
به بخش کسب درآمد از تبلیغات یونیتی > مکانها بروید، سپس پروژه خود را انتخاب کنید و روی افزودن واحد تبلیغاتی کلیک کنید.
نام واحد تبلیغاتی خود را وارد کنید، سپس پلتفرم و قالب تبلیغاتی خود را انتخاب کنید.
برای تنظیمات، گزینه پیشنهاد قیمت (Bidding) را انتخاب کنید. در قسمت جایگذاری (Placement )، نام جایگذاری را وارد کنید.
شناسهی محل قرارگیری را یادداشت کنید.
برای تنظیمات، آبشار را انتخاب کنید. در قسمت جایگذاری ، نام جایگذاری ، برچسبگذاری جغرافیایی و هدف را وارد کنید.
شناسهی محل قرارگیری را یادداشت کنید.
در نهایت، برای ذخیره واحد تبلیغاتی و جایگاه آن، روی افزودن واحد تبلیغاتی کلیک کنید.
این مرحله برای ادغامهای پیشنهاد قیمت لازم نیست.
به Unity Ads Monetization > API management بروید و کلید API را در Monetization Stats API Access یادداشت کنید.
سپس، به مسیر Unity Ads Monetization > Organization Settings بروید و شناسه اصلی سازمان (Organization core ID) را یادداشت کنید.
فروشندگان مجاز برنامهها app-ads.txt یک ابتکار آزمایشگاه فناوری IAB است که به شما کمک میکند تا موجودی تبلیغات برنامه خود را فقط از طریق کانالهایی که به عنوان مجاز شناسایی کردهاید، به فروش برسانید. برای جلوگیری از کاهش قابل توجه درآمد تبلیغات، باید یک فایل app-ads.txt پیادهسازی کنید. اگر قبلاً این کار را نکردهاید، یک فایل app-ads.txt برای برنامه خود تنظیم کنید .
برای پیادهسازی app-ads.txt برای تبلیغات یونیتی، به بخش راهاندازی app-ads.txt برای اولین بار مراجعه کنید.
حالت آزمایشی را میتوان از داشبورد Unity Ads فعال کرد. به Unity Ads Monetization > Testing بروید.
شما میتوانید با کلیک بر روی دکمه ویرایش هر پلتفرم، فعال کردن حالت تست کلاینت Override و انتخاب حالت تست اجباری (یعنی استفاده از تبلیغات آزمایشی) برای همه دستگاهها، حالت تست را برای برنامه خود اجباری کنید.
از طرف دیگر، میتوانید با کلیک روی «افزودن دستگاه آزمایشی»، حالت آزمایشی را برای دستگاههای خاص فعال کنید.
جزئیات دستگاه آزمایشی خود را وارد کنید، سپس روی ذخیره کلیک کنید.
برای دستورالعملها، به مرحله ۲ در راهنمای اندروید مراجعه کنید.
برای دستورالعملها، به مرحله ۲ در راهنمای iOS مراجعه کنید.
برای افزودن Unity Ads به فهرست شرکای تبلیغاتی مقررات ایالتی اروپا و ایالات متحده در رابط کاربری AdMob، مراحل موجود در تنظیمات مقررات اروپا و تنظیمات مقررات ایالت ایالات متحده را دنبال کنید.
اگر OpenUPM-CLI را نصب کردهاید، میتوانید افزونهی Google Mobile Ads Unity Ads Mediation را برای Unity با اجرای دستور زیر از دایرکتوری ریشهی پروژهی خود نصب کنید:
openupm add com.google.ads.mobile.mediation.unityadsدر ویرایشگر پروژه یونیتی خود، گزینه Edit > Project Settings > Package Manager را انتخاب کنید تا تنظیمات Unity Package Manager باز شود.
در زیر تب Scoped Registries ، OpenUPM را به عنوان یک رجیستری Scoped با جزئیات زیر اضافه کنید:
- نام:
OpenUPM - آدرس اینترنتی:
https://package.openupm.com - محدوده(ها):
com.google
سپس، به مسیر Window > Package Manager بروید تا Unity Package Manager باز شود و از منوی کشویی، My Registrys را انتخاب کنید.
بسته Google Mobile Ads UnityAds Mediation را انتخاب کرده و روی نصب کلیک کنید.
آخرین نسخه افزونه میانجیگری تبلیغات موبایل گوگل برای Unity Ads را از لینک دانلود موجود در Changelog دانلود کنید و بسته GoogleMobileAdsUnityAdsMediation.unitypackage را از فایل زیپ استخراج کنید.
در ویرایشگر پروژه Unity خود، Assets > Import Package > Custom Package را انتخاب کنید و فایل GoogleMobileAdsUnityAdsMediation.unitypackage را که دانلود کردهاید، پیدا کنید. مطمئن شوید که همه فایلها انتخاب شدهاند و روی Import کلیک کنید.
سپس، Assets > External Dependency Manager > Android Resolver > Force Resolve را انتخاب کنید. کتابخانه External Dependency Manager تجزیه و تحلیل وابستگیها را از ابتدا انجام میدهد و وابستگیهای اعلام شده را در پوشه Assets/Plugins/Android برنامه Unity شما کپی میکند.
برای رعایت سیاست رضایت کاربر اتحادیه اروپا گوگل ، شما باید اطلاعات خاصی را در اختیار کاربران خود در منطقه اقتصادی اروپا (EEA)، بریتانیا و سوئیس قرار دهید و رضایت آنها را برای استفاده از کوکیها یا سایر ذخیرهسازیهای محلی در صورت لزوم قانونی، و برای جمعآوری، اشتراکگذاری و استفاده از دادههای شخصی برای شخصیسازی تبلیغات، دریافت کنید. این سیاست منعکسکننده الزامات دستورالعمل حریم خصوصی الکترونیکی اتحادیه اروپا و مقررات عمومی حفاظت از دادهها (GDPR) است. شما مسئول تأیید انتشار رضایت به هر منبع تبلیغاتی در زنجیره واسطهگری خود هستید. گوگل قادر نیست رضایت کاربر را به طور خودکار به چنین شبکههایی منتقل کند.
افزونه میانجیگری تبلیغات موبایل گوگل برای Unity Ads نسخه ۳.۳.۰ شامل متد UnityAds.SetConsentMetaData() است. نمونه کد زیر نحوه ارسال اطلاعات رضایت به Unity Ads SDK را نشان میدهد. اگر تصمیم به فراخوانی این متد دارید، توصیه میشود قبل از درخواست تبلیغات از طریق Google Mobile Ads Unity Plugin ، این کار را انجام دهید.
using GoogleMobileAds.Api.Mediation.UnityAds;
// ...
UnityAds.SetConsentMetaData("gdpr.consent", true);
برای جزئیات بیشتر و مقادیری که میتوان در هر روش ارائه داد، به APIهای رضایتنامه حریم خصوصی و دادههای Unity Ads و راهنماهای انطباق با قانون حریم خصوصی مصرفکننده مراجعه کنید.
قوانین حفظ حریم خصوصی ایالتهای ایالات متحده ، به کاربران حق انصراف از «فروش» «اطلاعات شخصی» خود (همانطور که قانون این اصطلاحات را تعریف میکند) را میدهد، و این انصراف از طریق پیوند برجسته «اطلاعات شخصی من را نفروشید» در صفحه اصلی طرف «فروشنده» ارائه میشود. راهنمای انطباق با قوانین حفظ حریم خصوصی ایالتهای ایالات متحده ، امکان فعال کردن پردازش دادههای محدود برای سرویس تبلیغات گوگل را ارائه میدهد، اما گوگل قادر به اعمال این تنظیم برای هر شبکه تبلیغاتی در زنجیره واسطهگری شما نیست. بنابراین، شما باید هر شبکه تبلیغاتی را در زنجیره واسطهگری خود که ممکن است در فروش اطلاعات شخصی شرکت کند، شناسایی کنید و برای اطمینان از انطباق، از راهنماییهای هر یک از این شبکهها پیروی کنید.
افزونه میانجیگری تبلیغات موبایل گوگل برای Unity Ads نسخه ۳.۳.۰ شامل متد UnityAds.SetConsentMetaData() است. نمونه کد زیر نحوه ارسال اطلاعات رضایت به Unity Ads SDK را نشان میدهد. اگر تصمیم به فراخوانی این متد دارید، توصیه میشود قبل از درخواست تبلیغات از طریق Google Mobile Ads Unity Plugin ، این کار را انجام دهید.
using GoogleMobileAds.Api.Mediation.UnityAds;
// ...
UnityAds.SetConsentMetaData("privacy.consent", true);
برای جزئیات بیشتر و مقادیری که میتوان در هر روش ارائه داد، به راهنماهای «رضایت از حریم خصوصی و APIهای داده» و «مطابق با CCPA» در Unity Ads مراجعه کنید.
برای ادغام تبلیغات یونیتی با اندروید، به هیچ کد اضافی نیاز نیست.
برای افزودن شناسههای SKAdNetwork به فایل Info.plist پروژه خود ، مستندات Unity Ads را دنبال کنید.
برای Unity Ads adapter نسخه ۳.۴.۰ یا بالاتر، باید مراحل ادغام موجود در مستندات Unity را دنبال کنید.
مطمئن شوید که دستگاه آزمایشی خود را برای AdMob ثبت کردهاید و حالت آزمایشی را در رابط کاربری Unity Ads فعال کردهاید . برای تأیید اینکه تبلیغات آزمایشی را از Unity Ads دریافت میکنید، تست منبع تبلیغات تکی را در Ad inspector با استفاده از منبع(های) تبلیغاتی Unity Ads (Bidding) و Unity Ads (Waterfall) فعال کنید. اگر آداپتور نتواند تبلیغی از Unity Ads دریافت کند، ناشران میتوانند خطای اساسی را از پاسخ تبلیغ با استفاده در اینجا کدها و پیامهای همراه که توسط آداپتور UnityAds هنگام عدم بارگیری یک تبلیغ نمایش داده میشوند، آمده است: ResponseInfo تحت کلاسهای زیر بررسی کنند: com.google.ads.mediation.unity.UnityAdapter
com.google.ads.mediation.unity.UnityMediationAdapter
GADMAdapterUnity
GADMediationAdapterUnity
کد خطا دلیل ۰-۱۰ UnityAds SDK خطایی را برگرداند. برای جزئیات بیشتر به کد مراجعه کنید. ۱۰۱ پارامترهای سرور UnityAds که در رابط کاربری Admob پیکربندی شدهاند، وجود ندارند/نامعتبر هستند. ۱۰۲ UnityAds یک موقعیت مکانی با حالت NO_FILL را برگرداند. ۱۰۳ UnityAds یک موقعیت مکانی را با وضعیت غیرفعال (DISABLED) برگرداند. ۱۰۴ UnityAds سعی کرد تبلیغی با متن تهی (null context) نمایش دهد. ۱۰۵ زمینهای که برای مقداردهی اولیه، بارگذاری و/یا نمایش تبلیغات از Unity Ads استفاده میشود، یک نمونه Activity نیست. ۱۰۶ UnityAds سعی کرد تبلیغی را نمایش دهد که آماده نمایش نبود. ۱۰۷ UnityAds روی این دستگاه پشتیبانی نمیشود. ۱۰۸ UnityAds فقط میتواند در هر بار نمایش، یک تبلیغ را بارگذاری کند. ۱۰۹ UnityAds با وضعیت خطا (ERROR) کار خود را به پایان رساند. ۲۰۰-۲۰۴ خطای خاصی در بنر UnityAds وجود دارد. برای جزئیات بیشتر به کد مراجعه کنید. ۰-۹ UnityAds SDK خطایی را برگرداند. برای جزئیات بیشتر به مستندات Unity مراجعه کنید. ۱۰۱ پارامترهای سرور UnityAds که در رابط کاربری AdMob پیکربندی شدهاند، وجود ندارند/نامعتبر هستند. ۱۰۲ دستگاه توسط UnityAds پشتیبانی نمیشود. ۱۰۳ UnityAds ارائه را با حالت خطای kUnityAdsFinishStateError به پایان رساند. ۱۰۴ شیء ad در یونیتی پس از فراخوانی مقداردهی اولیهاش، تهی (nil) است. ۱۰۵ به دلیل آماده نبودن تبلیغ، نمایش تبلیغات Unity ناموفق بود. ۱۰۷ UnityAds یک تابع فراخوانی تغییر مکان را با وضعیت مکانیابی kUnityAdsPlacementStateDisabled فراخوانی کرد. ۱۰۸ یک تبلیغ قبلاً برای این مکان بارگذاری شده است. UnityAds SDK از بارگذاری چندین تبلیغ برای یک مکان پشتیبانی نمیکند. ۱۰۹ بنر تبلیغاتی برگردانده شده توسط UnityAds با اندازه درخواستی مطابقت ندارد. ۱۱۰ UnityAds خطای مقداردهی اولیه را نشان داد. ۱۱۱ قالب تبلیغاتی پشتیبانی نشده. DummyClient به PlaceholderClient تغییر یافت.GoogleMobileAds/Mediation/UnityAds/ منتقل شد.GoogleMobileAds.Mediation.UnityAds بازسازی شده است.SetGDPRConsentMetaData(bool) از کلاس UnityAds به SetConsentMetaData(string, bool) بهروزرسانی شد.Assets/GoogleMobileAds/Editor/UnityMediationDependencies.xml مراجعه کنید.UnityAds.SetGdprConsentMetaData() برای درخواست دستی عضویت کاربر در تبلیغات هدفمند اضافه شد.