این راهنما به شما نشان میدهد که چگونه از Google Mobile Ads SDK برای بارگیری و نمایش تبلیغات از Unity Ads با استفاده از AdMob Mediation استفاده کنید که ادغامهای آبشار را پوشش میدهد. نحوه افزودن Unity Ads به پیکربندی میانجی واحد تبلیغات و نحوه ادغام Unity Ads SDK و آداپتور در یک برنامه Android را پوشش می دهد.
آداپتور میانجی برای Unity Ads دارای قابلیت های زیر است:
یکپارچه سازی | |
---|---|
مناقصه | |
آبشار | |
فرمت ها | |
بنر | |
بینابینی | |
پاداش داده شد | |
بومی |
- Android API سطح 23 یا بالاتر
- [برای مناقصه]: برای ادغام همه قالبهای تبلیغاتی پشتیبانی شده در مناقصه، از Unity adapter 4.16.0.1 یا بالاتر ( آخرین نسخه توصیه میشود ) استفاده کنید.
جدیدترین SDK تبلیغات موبایل گوگل
راهنمای شروع میانجیگری را کامل کنید
ثبت نام کنید یا وارد Unity Ads شوید.
در داشبورد Unity Ads ، به Projects بروید و روی New کلیک کنید.
فرم را پر کنید و روی Create کلیک کنید تا پروژه خود را اضافه کنید.
به Unity Ads Monetization بروید، سپس روی شروع به کار کلیک کنید.
در حالت New Project ، I will use Mediation و Google Admob for Mediation Partner را انتخاب کنید، سپس روی Next کلیک کنید.
گزینه تنظیمات تبلیغات را انتخاب کنید، سپس روی Next کلیک کنید.
تنظیم مکان خود را انتخاب کنید، سپس روی Next کلیک کنید.
فرم را پر کنید، سپس روی افزودن پروژه کلیک کنید.
به شناسه بازی توجه کنید.
به Unity Ads Monetization > Placements بروید، سپس پروژه خود را انتخاب کنید و روی Add unit ad کلیک کنید.
نام واحد تبلیغات را وارد کنید، سپس پلتفرم و قالب تبلیغ خود را انتخاب کنید.
Bidding را برای راه اندازی انتخاب کنید. در قسمت Placement ، نام مکان را وارد کنید.
شناسه مکان را یادداشت کنید.
برای راه اندازی، آبشار را انتخاب کنید. در قسمت Placement ، نام مکان ، GEO Tagging و Target را وارد کنید.
شناسه مکان را یادداشت کنید.
در نهایت، روی افزودن واحد تبلیغات کلیک کنید تا واحد تبلیغات و مکان شما ذخیره شود.
این مرحله برای ادغام پیشنهادها لازم نیست.
به Unity Ads Monetization > مدیریت API بروید و کلید API را در دسترسی به API Stats در کسب درآمد یادداشت کنید.
سپس، به Unity Ads Monetization > Organization Settings بروید و شناسه اصلی سازمان را یادداشت کنید.
فروشندگان مجاز برای برنامهها app-ads.txt یک ابتکار آزمایشگاه فناوری IAB است که به شما کمک میکند تا مطمئن شوید موجودی آگهیهای برنامه شما فقط از طریق کانالهایی که بهعنوان مجاز شناسایی کردهاید فروخته میشود. برای جلوگیری از ضرر قابل توجه در درآمد تبلیغات، باید فایل app-ads.txt
را پیاده سازی کنید. اگر قبلاً این کار را انجام نداده اید، یک فایل app-ads.txt برای برنامه خود تنظیم کنید .
برای پیاده سازی app-ads.txt
برای Unity Ads، برای اولین بار به راه اندازی app-ads.txt مراجعه کنید.
حالت تست را می توان از داشبورد Unity Ads فعال کرد. به Unity Ads Monetization > Testing بروید.
میتوانید با کلیک کردن روی دکمه ویرایش در کنار فروشگاه Google Play ، فعال کردن حالت تست مشتری لغو لغو ، و انتخاب حالت آزمایش اجباری روشن (یعنی استفاده از آگهیهای آزمایشی) برای همه دستگاهها، حالت آزمایش را برای برنامه خود اجبار کنید.
همچنین، میتوانید با کلیک روی افزودن دستگاه آزمایشی، حالت آزمایش را برای دستگاههای خاص فعال کنید.
جزئیات دستگاه آزمایشی خود را وارد کنید، سپس روی ذخیره کلیک کنید.
باید Unity Ads را به پیکربندی میانجی واحد تبلیغاتی خود اضافه کنید.
ابتدا وارد حساب AdMob خود شوید. سپس به تب Mediation بروید. اگر یک گروه میانجی موجود دارید که میخواهید آن را تغییر دهید، روی نام آن گروه میانجی کلیک کنید تا آن را ویرایش کنید، و به افزودن Unity Ads به عنوان منبع آگهی بروید.
برای ایجاد یک گروه میانجی جدید، Create Mediation Group را انتخاب کنید.
قالب و پلتفرم تبلیغ خود را وارد کنید، سپس روی Continue کلیک کنید.
به گروه میانجی خود یک نام بدهید و مکانهایی را برای هدف انتخاب کنید. سپس، وضعیت گروه میانجی را روی Enabled تنظیم کنید و سپس روی Add Units Ad Units کلیک کنید.
این گروه میانجی را با یک یا چند واحد تبلیغات AdMob موجود خود مرتبط کنید. سپس روی Done کلیک کنید.
اکنون باید کارت واحدهای تبلیغاتی را با واحدهای تبلیغاتی که انتخاب کردهاید مشاهده کنید:
روی نحوه امضای قرارداد مشارکت و راه اندازی یک مشارکت در مناقصه با Unity Ads کلیک کنید.
روی تأیید و موافقت کلیک کنید، سپس روی ادامه کلیک کنید.
اگر قبلاً نقشهای برای Unity Ads دارید، میتوانید آن را انتخاب کنید. در غیر این صورت، روی افزودن نقشه کلیک کنید.
سپس شناسه بازی و شناسه مکان به دست آمده در قسمت قبل را وارد کنید. سپس روی Done کلیک کنید.
در زیر کارت Waterfall در بخش Ad Sources ، Add Source Ad را انتخاب کنید.
Unity Ads را انتخاب کرده و سوئیچ Optimize را فعال کنید. برای تنظیم بهینهسازی منبع آگهی برای Unity Ads، کلید API و شناسه هسته سازمان را که در بخش قبل به دست آمدهاند وارد کنید. سپس یک مقدار eCPM را برای Unity Ads وارد کنید و روی Continue کلیک کنید.
اگر قبلاً نقشهای برای Unity Ads دارید، میتوانید آن را انتخاب کنید. در غیر این صورت، روی افزودن نقشه کلیک کنید.
سپس شناسه بازی و شناسه مکان به دست آمده در قسمت قبل را وارد کنید. سپس روی Done کلیک کنید.
برای افزودن Unity Ads به فهرست شرکای آگهی مقررات ایالتی اروپا و ایالات متحده در رابط کاربری AdMob، مراحل تنظیمات مقررات اروپا و تنظیمات مقررات ایالتی ایالات متحده را دنبال کنید.
در فایل build.gradle.kts
در سطح برنامه خود، وابستگی ها و پیکربندی های پیاده سازی زیر را اضافه کنید. از آخرین نسخه های Unity Ads SDK و آداپتور استفاده کنید:
dependencies {
implementation("com.google.android.gms:play-services-ads:24.6.0")
implementation("com.unity3d.ads:unity-ads:4.16.1")
implementation("com.google.ads.mediation:unity:4.16.1.0")
}
جدیدترین Unity Ads SDK (
unity-ads.aar
) را از مخزن GitHub آنها دانلود کرده و به پروژه خود اضافه کنید.به آرتیفکتهای آداپتور Unity Ads در مخزن Maven Google بروید. آخرین نسخه را انتخاب کنید، فایل aar
.aar
Unity Ads را دانلود کنید و آن را به پروژه خود اضافه کنید.
برای پیروی از خطمشی رضایت کاربر اتحادیه اروپا Google ، باید اطلاعات مشخصی را به کاربران خود در منطقه اقتصادی اروپا (EEA)، بریتانیا، و سوئیس ارائه کنید و رضایت آنها را برای استفاده از کوکیها یا سایر فضای ذخیرهسازی محلی در مواردی که از نظر قانونی لازم است، و برای جمعآوری، اشتراکگذاری و استفاده از دادههای شخصی برای شخصیسازی تبلیغات کسب کنید. این سیاست منعکس کننده الزامات دستورالعمل حریم خصوصی الکترونیک اتحادیه اروپا و مقررات عمومی حفاظت از داده ها (GDPR) است. شما مسئول تأیید انتشار رضایت به هر منبع آگهی در زنجیره میانجی شما هستید. Google نمی تواند رضایت کاربر را به طور خودکار به چنین شبکه هایی منتقل کند.
در SDK نسخه 2.0.0، Unity Ads یک API برای پشتیبانی از تنظیمات حریم خصوصی اضافه کرد. کد نمونه زیر نحوه انتقال این اطلاعات رضایت را به Unity Ads SDK نشان می دهد. اگر تصمیم بگیرید که اطلاعات رضایت را به صورت دستی به Unity Ads SDK ارسال کنید، توصیه می شود قبل از درخواست تبلیغات از طریق Google Mobile Ads SDK، این کد را فراخوانی کنید.
MetaData gdprMetaData = new MetaData(this);
gdprMetaData.set("gdpr.consent", true);
gdprMetaData.commit();
val gdprMetaData = MetaData(this)
gdprMetaData["gdpr.consent"] = true
gdprMetaData.commit()
برای جزئیات بیشتر و مقادیری که در هر روش می توان ارائه کرد، به انطباق GDPR Ads Unity مراجعه کنید.
قوانین حفظ حریم خصوصی ایالات ایالات متحده مستلزم اعطای حق انصراف به کاربران از "فروش" "اطلاعات شخصی" خود (همانطور که قانون آن شرایط را تعریف می کند)، با انصراف از طریق پیوند برجسته "اطلاعات شخصی من را نفروشید" در صفحه اصلی طرف "فروشنده" ارائه می شود. راهنمای انطباق با قوانین حریم خصوصی ایالات ایالات متحده، امکان فعال کردن پردازش داده های محدود را برای ارائه تبلیغات Google ارائه می دهد، اما Google نمی تواند این تنظیم را برای هر شبکه تبلیغاتی در زنجیره میانجی شما اعمال کند. بنابراین، شما باید هر یک از شبکههای تبلیغاتی را در زنجیره میانجی خود که ممکن است در فروش اطلاعات شخصی شرکت کنند شناسایی کنید و از راهنماییهای هر یک از آن شبکهها برای اطمینان از رعایت آن پیروی کنید.
در SDK نسخه 2.0.0، Unity Ads یک API برای پشتیبانی از تنظیمات حریم خصوصی اضافه کرد. کد نمونه زیر نحوه انتقال این اطلاعات رضایت را به Unity Ads SDK نشان می دهد. اگر تصمیم بگیرید که اطلاعات رضایت را به صورت دستی به Unity Ads SDK ارسال کنید، توصیه می شود قبل از درخواست تبلیغات از طریق Google Mobile Ads SDK، این کد را فراخوانی کنید.
MetaData ccpaMetaData = new MetaData(this);
ccpaMetaData.set("privacy.consent", true);
ccpaMetaData.commit();
val ccpaMetaData = MetaData(this)
ccpaMetaData["privacy.consent"] = true
ccpaMetaData.commit()
برای جزئیات بیشتر و مقادیری که در هر روش می توان ارائه کرد ، به مطابقت با قانون حریم خصوصی مصرف کننده Unity Ads مراجعه کنید.
هنگام بارگیری قالبهای تبلیغاتی بنر، بینابینی و بومی، زمینه Activity
را پاس کنید. بدون زمینه فعالیت، بارگیری آگهی با شکست مواجه خواهد شد.
مطمئن شوید که دستگاه آزمایشی خود را برای AdMob ثبت کرده اید و حالت تست را در رابط کاربری Unity Ads فعال کرده اید . برای تأیید اینکه آگهیهای آزمایشی را از Unity Ads دریافت میکنید، با استفاده از منبع (های) آگهی Unity Ads (مناقصه) و Unity Ads (Waterfall) آزمایش منبع آگهی را در ad inspector فعال کنید. اگر آداپتور نتواند تبلیغی را از Unity Ads دریافت کند، ناشران میتوانند با استفاده از در اینجا کدها و پیامهای همراهی هستند که توسط آداپتور UnityAds در هنگام بارگیری یک تبلیغ پرتاب میشوند: ساخته و تست شده با: ساخته و تست شده با: ساخته و تست شده با: ساخته و تست شده با: ساخته و تست شده با: ساخته و تست شده با: ساخته و تست شده با: ساخته و تست شده با: ساخته و تست شده با: ساخته و تست شده با: ساخته و تست شده با: ساخته و تست شده با: ساخته و تست شده با: ساخته و تست شده با: ساخته و تست شده با: ساخته و تست شده با: ساخته و تست شده با: ساخته و تست شده با: ساخته و تست شده با: ساخته و تست شده با: ساخته و تست شده با: ساخته و تست شده با: ساخته و تست شده با: ساخته و تست شده با: ساخته و تست شده با: ساخته و تست شده با: ساخته و تست شده با: ساخته و تست شده با: ساخته و تست شده با: ساخته و تست شده با: ساخته و تست شده با: ساخته و تست شده با: ساخته و تست شده با: ساخته و تست شده با: ساخته و تست شده با: ساخته و تست شده با: ساخته و تست شده با: ساخته و تست شده با: ساخته و تست شده با: ساخته و تست شده با: ساخته و تست شده با: ساخته و تست شده با: ساخته و تست شده با: ساخته و تست شده با: ساخته و تست شده با: ساخته و تست شده با: ساخته و تست شده با: ساخته و تست شده با: ساخته و تست شده با: ساخته و تست شده با: ساخته و تست شده با: ساخته و تست شده با: ساخته و تست شده با: ساخته و تست شده با: ساخته و تست شده با: ساخته و تست شده با: ساخته و تست شده با:ResponseInfo.getAdapterResponses()
در کلاسهای زیر، خطای اساسی از پاسخ آگهی را بررسی کنند:com.google.ads.mediation.unity.UnityAdapter
com.google.ads.mediation.unity.UnityMediationAdapter
کد خطا دلیل 0-10 UnityAds SDK یک خطا برگرداند. برای جزئیات بیشتر به کد مراجعه کنید. 101 پارامترهای سرور UnityAds پیکربندی شده در رابط کاربری AdMob وجود ندارد/نامعتبر است. 102 UnityAds یک مکان با حالت NO_FILL برگرداند. 103 UnityAds یک مکان را با وضعیت DISABLED برگرداند. 104 UnityAds سعی کرد تبلیغی را با زمینه پوچ نشان دهد. 105 زمینه مورد استفاده برای مقداردهی اولیه، بارگیری و/یا نمایش تبلیغات از Unity Ads یک نمونه Activity نیست. 106 UnityAds سعی کرد تبلیغی را نشان دهد که برای نمایش آماده نیست. 107 UnityAds در دستگاه پشتیبانی نمی شود. 108 UnityAds می تواند تنها 1 تبلیغ را در هر مکان بارگیری کند. 109 UnityAds با یک وضعیت ERROR به پایان رسید. 200-204 خطای خاص بنر UnityAds. برای جزئیات بیشتر به کد مراجعه کنید. Context
را حذف کرد.Activity
از آداپتور حذف شد.VersionInfo
.onAdOpened()
اکنون فوروارد می شود.compileSdkVersion
و targetSdkVersion
به API 31 به روز کرد.NullPointerException
که هنگام از بین رفتن بنر تبلیغاتی رخ می دهد.com.google.ads.mediation:unity-adapter-only:xyzp
به فایل build.gradle
سطح برنامه خود، از این مورد استفاده کنند.onAdOpened()
را فوروارد میکند.ConcurrentModificationException
که زمانی رخ داد که Unity Ads یک خطا را برمی گرداند، رفع شد.loadAd()
قبل از فراخوانی UnityAds.initialize()
رخ داده بود، برطرف کرد.onRewardedVideoComplete()
به روز کرد.compile 'com.google.ads.mediation:unity:2.0.5.0'