این راهنما به شما نشان میدهد که چگونه از Google Mobile Ads SDK برای بارگذاری و نمایش تبلیغات از Unity Ads با استفاده از AdMob Mediation استفاده کنید، که شامل ادغامهای پیشنهاد قیمت و آبشاری میشود. این راهنما نحوه اضافه کردن Unity Ads به پیکربندی میانجیگری یک واحد تبلیغاتی و نحوه ادغام SDK و آداپتور Unity Ads در یک برنامه iOS را پوشش میدهد.
آداپتور میانجیگری برای Unity Ads دارای قابلیتهای زیر است:
| ادغام | |
|---|---|
| مناقصه | |
| آبشار | ۱ |
| قالبها | |
| بنر | |
| بینابینی | |
| پاداش داده شده | |
| بومی | |
هدف استقرار iOS 13.0 یا بالاتر
[برای پیشنهاد قیمت]: برای ادغام تمام قالبهای تبلیغاتی پشتیبانیشده در پیشنهاد قیمت، از آداپتور Unity 4.14.1.1 یا بالاتر استفاده کنید ( آخرین نسخه توصیه میشود )
جدیدترین Google Mobile Ads SDK
راهنمای شروع میانجیگری را تکمیل کنید
در 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 و انتخاب حالت تست اجباری (یعنی استفاده از تبلیغات آزمایشی) برای همه دستگاهها، حالت تست را برای برنامه خود اجباری کنید.
از طرف دیگر، میتوانید با کلیک روی «افزودن دستگاه آزمایشی»، حالت آزمایشی را برای دستگاههای خاص فعال کنید.
جزئیات دستگاه آزمایشی خود را وارد کنید، سپس روی ذخیره کلیک کنید.
شما باید Unity Ads را به پیکربندی میانجیگری برای واحد تبلیغاتی خود اضافه کنید.
ابتدا، وارد حساب کاربری AdMob خود شوید. سپس، به برگه Mediation بروید. اگر یک گروه میانجیگری موجود دارید که میخواهید آن را تغییر دهید، روی نام آن گروه میانجیگری کلیک کنید تا آن را ویرایش کنید و به Add Unity Ads as an ad source بروید.
برای ایجاد یک گروه میانجیگری جدید، گزینه «ایجاد گروه میانجیگری» را انتخاب کنید.
قالب و پلتفرم تبلیغ خود را وارد کنید، سپس روی ادامه کلیک کنید.
به گروه میانجیگری خود یک نام بدهید و مکانهایی را برای هدف قرار دادن انتخاب کنید. در مرحله بعد، وضعیت گروه میانجیگری را روی فعال (Enabled) تنظیم کنید و سپس روی افزودن واحدهای تبلیغاتی (Add Ad Units) کلیک کنید.
این گروه میانجی را با یک یا چند واحد تبلیغاتی AdMob موجود خود مرتبط کنید. سپس روی «انجام شد» کلیک کنید.
اکنون باید کارت واحدهای تبلیغاتی را ببینید که با واحدهای تبلیغاتی که انتخاب کردهاید پر شده است:
در قسمت «منابع تبلیغات» ، زیر کارت پیشنهاد قیمت ، گزینه «افزودن منبع تبلیغات» را انتخاب کنید. سپس «آگهیهای وحدت» را انتخاب کنید.
روی نحوه امضای قرارداد مشارکت و تنظیم قرارداد مشارکت در مناقصه با Unity Ads کلیک کنید.
روی تأیید و موافقت کلیک کنید، سپس روی ادامه کلیک کنید.
اگر از قبل نگاشتی برای Unity Ads دارید، میتوانید آن را انتخاب کنید. در غیر این صورت، روی افزودن نگاشت کلیک کنید.
سپس، شناسه بازی (Game ID) و شناسه مکان (Placement ID) که در بخش قبل به دست آوردهاید را وارد کنید. سپس روی «انجام شد» (Done) کلیک کنید.
در زیر کارت Waterfall در بخش Ad Sources ، گزینه Add Ad Source را انتخاب کنید.
Unity Ads را انتخاب کنید و سوئیچ Optimize را فعال کنید. کلید API و شناسه اصلی سازمان را که در بخش قبل به دست آوردهاید، وارد کنید تا بهینهسازی منبع تبلیغات برای Unity Ads تنظیم شود. سپس یک مقدار eCPM برای Unity Ads وارد کنید و روی Continue کلیک کنید.
اگر از قبل نگاشتی برای Unity Ads دارید، میتوانید آن را انتخاب کنید. در غیر این صورت، روی افزودن نگاشت کلیک کنید.
سپس، شناسه بازی (Game ID) و شناسه مکان (Placement ID) که در بخش قبل به دست آوردهاید را وارد کنید. سپس روی «انجام شد» (Done) کلیک کنید.
برای افزودن Unity Ads به فهرست شرکای تبلیغاتی مقررات ایالتی اروپا و ایالات متحده در رابط کاربری AdMob، مراحل موجود در تنظیمات مقررات اروپا و تنظیمات مقررات ایالت ایالات متحده را دنبال کنید.
قبل از ادامه، باید حداقل نسخه آداپتور پشتیبانیشده ۴.۱۶.۰.۰ را داشته باشید.
برای اضافه کردن یک وابستگی پکیج به پروژه خود، مراحل زیر را دنبال کنید:
در Xcode، به مسیر File > Add Package Dependencies... بروید.
در اعلانی که ظاهر میشود، آدرس بستهی زیر را جستجو کنید:
https://github.com/googleads/googleads-mobile-ios-mediation-unity.gitدر بخش «قانون وابستگی» ، شاخه (Branch) را انتخاب کنید.
در فیلد متن،
mainرا وارد کنید.
خط زیر را به Podfile پروژه خود اضافه کنید:
pod 'GoogleMobileAdsMediationUnity'از خط فرمان اجرا کنید:
pod install --repo-update
آخرین نسخه Unity Ads SDK را دانلود کنید و UnityAds.framework را در پروژه خود لینک کنید.
آخرین نسخه آداپتور تبلیغات یونیتی را از لینک دانلود موجود در Changelog دانلود کنید و UnityAdapter.framework را در پروژه خود لینک دهید.
برای رعایت سیاست رضایت کاربر اتحادیه اروپا گوگل ، شما باید اطلاعات خاصی را در اختیار کاربران خود در منطقه اقتصادی اروپا (EEA)، بریتانیا و سوئیس قرار دهید و رضایت آنها را برای استفاده از کوکیها یا سایر ذخیرهسازیهای محلی در صورت لزوم قانونی، و برای جمعآوری، اشتراکگذاری و استفاده از دادههای شخصی برای شخصیسازی تبلیغات، دریافت کنید. این سیاست منعکسکننده الزامات دستورالعمل حریم خصوصی الکترونیکی اتحادیه اروپا و مقررات عمومی حفاظت از دادهها (GDPR) است. شما مسئول تأیید انتشار رضایت به هر منبع تبلیغاتی در زنجیره واسطهگری خود هستید. گوگل قادر نیست رضایت کاربر را به طور خودکار به چنین شبکههایی منتقل کند.
در نسخه ۲.۰.۰ SDK، Unity Ads یک API برای پشتیبانی از تنظیمات حریم خصوصی اضافه کرد. نمونه کد زیر نحوه ارسال این اطلاعات رضایت به Unity Ads SDK را نشان میدهد. اگر تصمیم دارید اطلاعات رضایت را به صورت دستی به Unity Ads SDK ارسال کنید، توصیه میشود قبل از درخواست تبلیغات از طریق Google Mobile Ads SDK ، این کد فراخوانی شود.
let gdprMetaData = UADSMetaData()
gdprMetaData.set("gdpr.consent", value: true)
gdprMetaData.commit()
UADSMetaData *gdprMetaData = [[UADSMetaData alloc] init];
[gdprMetaData set:@"gdpr.consent" value:@YES];
[gdprMetaData commit];
برای جزئیات بیشتر و مقادیری که میتوان در هر روش ارائه داد، به بخش انطباق با GDPR در Unity Ads مراجعه کنید.
قوانین حفظ حریم خصوصی ایالتهای ایالات متحده ، به کاربران حق انصراف از «فروش» «اطلاعات شخصی» خود (همانطور که قانون این اصطلاحات را تعریف میکند) را میدهد، و این انصراف از طریق پیوند برجسته «اطلاعات شخصی من را نفروشید» در صفحه اصلی طرف «فروشنده» ارائه میشود. راهنمای انطباق با قوانین حفظ حریم خصوصی ایالتهای ایالات متحده ، امکان فعال کردن پردازش دادههای محدود برای سرویس تبلیغات گوگل را ارائه میدهد، اما گوگل قادر به اعمال این تنظیم برای هر شبکه تبلیغاتی در زنجیره واسطهگری شما نیست. بنابراین، شما باید هر شبکه تبلیغاتی را در زنجیره واسطهگری خود که ممکن است در فروش اطلاعات شخصی شرکت کند، شناسایی کنید و برای اطمینان از انطباق، از راهنماییهای هر یک از این شبکهها پیروی کنید.
در نسخه ۲.۰.۰ SDK، Unity Ads یک API برای پشتیبانی از تنظیمات حریم خصوصی اضافه کرد. نمونه کد زیر نحوه ارسال این اطلاعات رضایت به Unity Ads SDK را نشان میدهد. اگر تصمیم دارید اطلاعات رضایت را به صورت دستی به Unity Ads SDK ارسال کنید، توصیه میشود قبل از درخواست تبلیغات از طریق Google Mobile Ads SDK ، این کد فراخوانی شود.
let ccpaMetaData = UADSMetaData()
ccpaMetaData.set("privacy.consent", value: true)
ccpaMetaData.commit()
UADSMetaData *ccpaMetaData = [[UADSMetaData alloc] init];
[ccpaMetaData set:@"privacy.consent" value:@YES];
[ccpaMetaData commit];
برای جزئیات بیشتر و مقادیری که میتوان در هر روش ارائه داد، به بخش انطباق با قانون حفظ حریم خصوصی مصرفکنندگان Unity Ads مراجعه کنید.
برای افزودن شناسههای SKAdNetwork به فایل Info.plist پروژه خود ، مستندات Unity Ads را دنبال کنید.
برای ادغام با Swift نیازی به کد اضافی نیست.
برای آداپتور تبلیغات یونیتی نسخه ۴.۴.۰.۰ یا بالاتر، باید مراحل ادغام را در مستندات یونیتی دنبال کنید.
مطمئن شوید که دستگاه آزمایشی خود را برای AdMob ثبت کردهاید و حالت آزمایشی را در رابط کاربری Unity Ads فعال کردهاید . برای تأیید اینکه تبلیغات آزمایشی را از Unity Ads دریافت میکنید، تست منبع تبلیغات تکی را در Ad inspector با استفاده از منبع(های) تبلیغاتی Unity Ads (Bidding) و Unity Ads (Waterfall) فعال کنید. اگر آداپتور نتواند تبلیغی از Unity Ads دریافت کند، ناشران میتوانند خطای اساسی را از پاسخ تبلیغ با استفاده از در اینجا کدها و پیامهای همراه که توسط آداپتور UnityAds هنگام عدم بارگیری یک تبلیغ نمایش داده میشوند، آمده است: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با ساخته و آزمایش شده با ساخته و آزمایش شده با ساخته و آزمایش شده با ساخته و آزمایش شده با ساخته و آزمایش شده با ساخته و آزمایش شده با ساخته و آزمایش شده با ساخته و آزمایش شده با ساخته و آزمایش شده با ساخته و آزمایش شده با ساخته و آزمایش شده با ساخته و آزمایش شده با ساخته و آزمایش شده با ساخته و آزمایش شده با ساخته و آزمایش شده با ساخته و آزمایش شده باGADResponseInfo.adNetworkInfoArray تحت کلاسهای زیر بررسی کنند:GADMAdapterUnity
GADMediationAdapterUnity
کد خطا دلیل ۰-۹ UnityAds SDK خطایی را برگرداند. برای جزئیات بیشتر به مستندات Unity مراجعه کنید. ۱۰۱ پارامترهای سرور UnityAds که در رابط کاربری AdMob پیکربندی شدهاند، وجود ندارند/نامعتبر هستند. ۱۰۲ دستگاه توسط UnityAds پشتیبانی نمیشود. ۱۰۳ UnityAds ارائه را با حالت خطای kUnityAdsFinishStateError به پایان رساند. ۱۰۴ شیء ad در یونیتی پس از فراخوانی مقداردهی اولیهاش، تهی (nil) است. ۱۰۵ به دلیل آماده نبودن تبلیغ، نمایش تبلیغات Unity ناموفق بود. ۱۰۷ UnityAds یک تابع فراخوانی تغییر مکان را با وضعیت مکانیابی kUnityAdsPlacementStateDisabled فراخوانی کرد. ۱۰۸ یک تبلیغ قبلاً برای این مکان بارگذاری شده است. UnityAds SDK از بارگذاری چندین تبلیغ برای یک مکان پشتیبانی نمیکند. ۱۰۹ بنر تبلیغاتی برگردانده شده توسط UnityAds با اندازه درخواستی مطابقت ندارد. ۱۱۰ UnityAds خطای مقداردهی اولیه را نشان داد. ۱۱۱ قالب تبلیغاتی پشتیبانی نشده. tagForUnderAgeOfConsent برای SDK تبلیغات موبایل گوگل به SDK تبلیغات یونیتی اضافه شد.13.0 نیاز دارد.111: Unsupported ad format .-fobjc-arc و -fstack-protector-all فعال شدند.GADMediationAdapterUnity.testMode اضافه شد تا مشخص شود که آیا SDK مربوط به Unity Ads باید در حالت آزمایشی مقداردهی اولیه شود یا خیر. این پرچم باید قبل از مقداردهی اولیه SDK مربوط به Google Mobile Ads تنظیم شود.CFBundleShortVersionString بهروزرسانی شد تا به جای چهار جزء، سه جزء داشته باشد.Info.plist در چارچوبهای موجود در UnityAdapter.xcframework گنجانده شده است.GADMAdNetworkAdapter از آداپتور Unity حذف شد.unityAdsShowStart اضافه شد.armv7 حذف شد.didRewardUser بهروزرسانی شد..xcframework بهروزرسانی شد.unityAdsReady را ارسال نکند، برطرف شد.adapterDidCompletePlayingRewardBasedVideoAd: فراخوانی مجدد به آداپتور.interstitialWillLeaveApplication: و rewardBasedVideoAdWillLeaveApplication: بهرهمند میشوند.rewardBasedVideoAdDidOpen: Callback فراخوانی نشود، برطرف شد.