این راهنما به شما نشان میدهد که چگونه از Google Mobile Ads Unity Plugin برای بار کردن و نمایش دادن آگهیهای BIGO Ads SDK بااستفاده از واسطهگری AdMob استفاده کنید و ادغامهای مزایده را پوشش میدهد. این راهنما نحوه افزودن کیت توسعه نرمافزار BIGO Ads به پیکربندی میانجی واحد آگهی و نحوه ادغام کردن کیت توسعه نرمافزار BIGO Ads و آداپتور در برنامه Unity را پوشش میدهد.
یکپارچهسازیها و قالبهای آگهی پشتیبانیشده
آداپتور واسطهگری AdMob برای کیت توسعه نرمافزار BIGO Ads قابلیتهای زیر را دارد:
| یکپارچهسازی | |
|---|---|
| پیشنهاد قیمت | |
| آبشار | |
| قالبها | |
| صفحه باز شدن برنامه | |
| برنما | |
| بینابینی | |
| پاداش | |
| بینابینی پاداشدار | |
| بومی | |
پیشنیازها
قبلاز ادامه دادن، موارد زیر را تأیید کنید:
- جدیدترین نسخه Google Mobile Ads Unity Plugin.
- Unity Editor نسخه ۲۰۱۹.۴ یا بالاتر.
- برای استقرار در Android
- Android API سطح ۲۴ یا بالاتر.
- برای استقرار در iOS
- هدف استقرار iOS نسخه ۱۳.۰ یا جدیدتر.
- یک پروژه Unity فعال که با Google Mobile Ads Unity Plugin پیکربندی شده باشد. برای جزئیات، شروع به کار را ببینید.
- «واسطهگری AdMob» را راهاندازی کنید.
مرحله ۱: راهاندازی پیکربندیها در میانای کاربر کیت توسعه نرمافزار BIGO Ads
وارد سیستم داشبورد BIGO Ads شوید.
ساختن برنامه
به برگه فهرستگان بروید و در جدول برنامهها و سایتها، دکمه + افزودن را انتخاب کنید.
بقیه فرم را تکمیل کنید و روی ارسال کلیک کنید.
شناسه درخواست خود را یادداشت کنید.
Android
iOS
ایجاد جایگاه آگهی
پساز بازبینی درخواستتان، به جدول جایگاههای آگهی بروید و دکمه + افزودن را انتخاب کنید.
پیشنهاد قیمت سرور را برای نوع مزایده انتخاب کنید، بقیه فرم را تکمیل کنید و روی ارسال کلیک کنید.
شناسه جایگاه را یادداشت کنید
Android
iOS
فایل app-ads.txt خود را بهروز کنید
Authorized Sellers for Apps app-ads.txt ابتکاری از IAB Tech Lab است که کمک میکند مطمئن شوید
فهرست آگهیهای برنامهتان فقط ازطریق کانالهایی که بهعنوان مجاز شناسایی کردهاید فروخته میشود. برای جلوگیری از
افت قابلتوجه در درآمد آگهی، باید فایل app-ads.txt را پیادهسازی کنید.
اگر قبلاً این کار را نکردهاید،
فایل app-ads.txt را برای برنامهتان راهاندازی کنید.
برای پیادهسازی app-ads.txt برای BIGO Ads SDK، به برگه APP-ads.txt
در داشبورد بروید و
دستورالعملهای موجود در برگه را دنبال کنید.
مرحله ۲: راهاندازی کردن تقاضای BIGO Ads SDK در میانای کاربر AdMob
پیکربندی تنظیمات میانجیگری برای واحد آگهی شما
Android
برای دستورالعملها، مرحله ۲ را در راهنمای Android ببینید.
iOS
برای دستورالعملها، به مرحله ۲ در راهنمای iOS مراجعه کنید.
افزودن BIGO TECHNOLOGY PTE LTD به فهرست شرکای آگهی مقررات ایالتی ایالات متحده و GDPR
مراحل موجود در تنظیمات مقررات اروپا و تنظیمات مقررات ایالتی ایالات متحده را دنبال کنید تا Empathy Technology Pte.Ltd. (BIGO Ads) را به فهرست شرکای آگهی مقررات اروپا و ** BIGOAds** را به فهرست شرکای آگهی مقررات ایالتی ایالات متحده در میانای کاربر AdMob اضافه کنید.
مرحله ۳: وارد کردن کیت توسعه نرمافزار و آداپتور BIGO Ads
OpenUPM-CLI
اگر OpenUPM-CLI را نصب کردهاید، میتوانید با اجرای فرمان زیر از دایرکتوری ریشه پروژهتان، «افزونه میانجی کیت توسعه نرمافزار آگهیهای BIGO» برای Unity را در پروژهتان نصب کنید:
openupm add com.google.ads.mobile.mediation.bigoOpenUPM
در ویرایشگر پروژه Unity، ویرایش > تنظیمات پروژه > مدیر بسته را انتخاب کنید تا تنظیمات مدیر بسته Unity باز شود.
در برگه Scoped Registries، OpenUPM را بهعنوان یک scoped registry با جزئیات زیر اضافه کنید:
- نام:
OpenUPM - نشانی وب:
https://package.openupm.com - حوزه(ها):
com.google
سپس، به Window > Package Manager بروید تا Unity Package Manager را باز کنید و My Registries را از منوِ کرکرهای انتخاب کنید.
بسته Google Mobile Ads Bigo Mediation را انتخاب کنید و روی نصب کلیک کنید.
بسته Unity
جدیدترین نسخه افزونه میانجیگری «تبلیغات Google Mobile» را برای
کیت توسعه نرمافزار BIGO Ads از پیوند بارگیری در
گزارش تغییرات بارگیری کنید
و
GoogleMobileAdsBigoMediation.unitypackage را از فایل zip
استخراج کنید.
در ویرایشگر پروژه Unity، داراییها > وارد کردن بسته >
بسته سفارشی را انتخاب کنید و
فایل GoogleMobileAdsBigoMediation.unitypackage
بارگیریشده را پیدا کنید. مطمئن شوید همه فایلها انتخاب شده باشند و روی
وارد کردن کلیک کنید.
سپس، Assets (داراییها) > External Dependency Manager (مدیر وابستگی خارجی) >
Android Resolver (حلکننده Android) > Force Resolve (حل اجباری) را انتخاب کنید. کتابخانه «مدیر وابستگی خارجی»
وضوح وابستگی را از ابتدا انجام خواهد داد و وابستگیهای اعلامشده را در دایرکتوری Assets/Plugins/Android برنامه Unity شما کپی خواهد کرد.
مرحله ۴: پیادهسازی تنظیمات حریم خصوصی در BIGO Ads SDK
برای پیادهسازی تنظیمات حریم خصوصی برای BIGO Ads SDK و رعایت مقررات حریم خصوصی مربوطه، بخشهای زیر را بخوانید.
کسب رضایت اتحادیه اروپا و مقررات کلی حفاظت از داده
برای رعایت کردن خطمشی Google درخصوص موافقت کاربر اتحادیه اروپا، باید شفافسازیهای خاصی را برای کاربران ساکن منطقه اقتصادی اروپا (EEA)، بریتانیا، و سوئیس انجام دهید و موافقت آنها را برای استفاده از کوکیها یا دیگر فضاهای ذخیرهسازی محلی در جاهایی که قانون الزام میکند، و برای جمعآوری، همرسانی، و استفاده از دادههای شخصی برای شخصیسازی آگهیها کسب کنید. این خطمشی منعکسکننده الزامات «آییننامه حریمخصوصی الکترونیکی» اتحادیه اروپا و «مقررات کلی حفاظت از داده» (GDPR) است. شما مسئولید که تأیید کنید رضایت به هر منبع آگهی در زنجیره میانجیگری شما منتقل شده است.
نسخه 1.0.0 و بالاتر آداپتور Unity کیت توسعه نرمافزار BIGO Ads از ارسال سیگنالهای کسب رضایت با مقررات کلی حفاظت از داده از پلاتفرمهای مدیریت کسب رضایت که با «چارچوب شفافسازی و کسب رضایت» (TCF) سازمان تبلیغات تعاملی ادغام میشوند به کیت توسعه نرمافزار BIGO Ads پشتیبانی میکند. برای اطلاعات بیشتر، به اسناد مقررات کلی حفاظت از دادههای BIGO Ads SDK برای Android و iOS مراجعه کنید.
قوانین حریم خصوصی ایالتی در ایالات متحده
قوانین حریم خصوصی ایالتهای امریکا ملزم میکند که به کاربران حق انصراف از «فروش» «اطلاعات شخصی» آنها (طبق تعریف قانون از این اصطلاحات) داده شود و این انصراف ازطریق پیوند برجسته «اطلاعات شخصی من فروخته نشود» در صفحه اصلی طرف «فروشنده» ارائه شود. راهنمای رعایت قوانین حریم خصوصی ایالتهای ایالات متحده امکان فعال کردن پردازش محدود داده را برای آگهیرسانی Google فراهم میکند، اما Google نمیتواند این تنظیم را برای هر شبکه آگهی در زنجیره میانجیگری شما اعمال کند. بنابراین، باید هر شبکه آگهی را در زنجیره میانجیگریتان که ممکن است در فروش اطلاعات شخصی مشارکت داشته باشد شناسایی کنید و از راهنماییهای هریک از آن شبکهها پیروی کنید تا از رعایت مقررات مطمئن شوید.
کد نمونه زیر نحوه ارسال پرچم موافقت به BIGO Ads SDK را نشان میدهد. این روش را قبلاز درخواست آگهی ازطریق Google Mobile Ads Unity Plugin فراخوانی کنید.
using GoogleMobileAds.Mediation.Bigo.Api;
// ...
Bigo.SetCcpaConsent(true);
مرحله ۵: افزودن کد الزامی
Android
برای ادغام کردن کیت توسعه نرمافزار BIGO Ads به کد دیگری نیاز نیست.
iOS
ادغام SKAdNetwork
سندگان BIGO Ads SDK را دنبال کنید
تا شناسههای SKAdNetwork را به فایل Info.plist پروژهتان اضافه کنید.
مرحله ۶: آزمایش کردن پیادهسازی
فعال کردن آگهیهای آزمایشی
مطمئن شوید دستگاه آزمایشیتان را برای AdMob ثبت کردهاید.
BIGO Ads برای کمک به آزمایش و ادغام، شناسههای برنامه و شناسههای جایگاه آگهی آزمایشی برای Android و iOS ارائه میدهد.
درستیسنجی آگهیهای آزمایشی
برای تأیید اینکه آگهیهای آزمایشی را از BIGO Ads SDK دریافت میکنید، آزمایش منبع آگهی تکی را در بازرس آگهی بااستفاده از منبع(های) آگهی BIGO Ads SDK (پیشنهاد قیمت) فعال کنید.
کدهای خطا
اگر آداپتور نتواند آگهی را از BIGO Ads SDK دریافت کند، میتوانید
خطای اساسی را از پاسخ آگهی بااستفاده از
ResponseInfo تحت
کلاسهای زیر بررسی کنید:
Android
sg.bigo.ads
com.google.ads.mediation.bigo.BigoMediationAdapter
iOS
GADMediationAdapterBigo
وقتی آگهی بار نمیشود، کدها و پیامهای همراه آنها توسط آداپتور کیت توسعه نرمافزار BIGO Ads ارائه میشوند:
Android
| کد خطا | دامنه | استدلال |
|---|---|---|
| ۱۰۱ | com.google.ads.mediation.bigo | شناسه جایگاه Bigo موجود نیست یا خالی است. |
| 102 | com.google.ads.mediation.bigo | شناسه برنامه برای مقداردهی اولیه Bigo SDK خالی است یا وجود ندارد. |
| 1000-1100 | ارسالشده توسط کیت توسعه نرمافزار BIGO Ads | کیت توسعه نرمافزار BIGO Ads خطایی برگرداند. برای جزئیات بیشتر، اسناد کیت توسعه نرمافزار BIGO Ads را ببینید. |
iOS
| کد خطا | دامنه | استدلال |
|---|---|---|
| ۱۰۱ | com.google.mediation.bigoadapter | پیکربندی سرور فاقد شناسه برنامه لازم است. |
| 102 | com.google.mediation.bigoadapter | پیکربندی آگهی نامعتبر است. |
| 103 | com.google.mediation.bigoadapter | خطا در ارائه آگهی. |
| 104 | com.google.mediation.bigoadapter | اندازه برنما پشتیبانی نمیشود. |
| ۱۰۵ | com.google.mediation.bigoadapter | Bigo آگهی برنمایی را باموفقیت بار کرد اما نمای آگهی ندارد. |
| 1000-1100 | ارسالشده توسط کیت توسعه نرمافزار BIGO Ads | کیت توسعه نرمافزار BIGO Ads خطایی برگرداند. برای جزئیات بیشتر، اسناد کیت توسعه نرمافزار BIGO Ads را ببینید. |
گزارش تغییرات افزونه میانجیگری Unity برای کیت توسعه نرمافزار BIGO Ads
نسخه بعدی
- افزودن پشتیبانی Swift Package Manager (SPM) برای آداپتور Unity کیت توسعه نرمافزار BIGO Ads.
- حداقل نسخه افزایه Unity موردنیاز به ۱۱.۷.۰ بهروزرسانی شد.
نسخه ۳.۱.۰
- از نسخه 6.1.0.0 آداپتور Android کیت توسعه نرمافزار BIGO Ads پشتیبانی میکند.
- از نسخه 6.1.0.0 آداپتور iOS کیت توسعه نرمافزار BIGO Ads پشتیبانی میکند.
- با «افزونه Unity تبلیغات تلفن همراه Google» نسخه ۱۱.۶.۰ ساخته و آزمایش شده است.
نسخه ۳.۰.۰
- از نسخه 6.0.0.1 آداپتور Android کیت توسعه نرمافزار BIGO Ads پشتیبانی میکند.
- از نسخه 6.0.0.0 آداپتور iOS کیت توسعه نرمافزار BIGO Ads پشتیبانی میکند.
- با نسخه ۱۱.۵.۰ «افزونه Unity تبلیغات Google در تلفن همراه» ساخته و آزمایش شده است.
نسخه ۲.۰.۰
- از نسخه 6.0.0.0 آداپتور Android کیت توسعه نرمافزار BIGO Ads پشتیبانی میکند.
- از نسخه 5.3.0.0 آداپتور iOS کیت توسعه نرمافزار BIGO Ads پشتیبانی میکند.
- با نسخه ۱۱.۴.۰ «افزونه Google Mobile Ads Unity» ساخته و آزمایش شده است.
نسخه ۱.۱.۰
- از نسخه 5.10.1.0 آداپتور Android کیت توسعه نرمافزار BIGO Ads پشتیبانی میکند.
- از نسخه 5.3.0.0 آداپتور iOS کیت توسعه نرمافزار BIGO Ads پشتیبانی میکند.
- بااستفاده از «افزونه Unity تبلیغات تلفن همراه Google» نسخه ۱۱.۳.۰ ساخته و آزمایش شده است.
نسخه ۱.۰.۰
- انتشار اولیه!
- از نسخه 5.8.0.0 آداپتور Android کیت توسعه نرمافزار BIGO Ads پشتیبانی میکند.
- از نسخه 5.1.2.0 آداپتور iOS کیت توسعه نرمافزار BIGO Ads پشتیبانی میکند.
- با «افزونه Google Mobile Ads Unity» نسخه ۱۱.۰.۰ ساخته و آزمایش شده است.