ادغام SDK تبلیغات BIGO با میانجیگری

انتخاب پلتفرم: اندرویدجدید اندروید iOS یونیتی

این راهنما به شما نشان می‌دهد که چگونه Google Mobile Ads Unity Plugin برای بارگذاری و نمایش تبلیغات از BIGO Ads SDK با استفاده از میانجیگری استفاده کنید و ادغام‌های پیشنهاد قیمت را پوشش می‌دهد. این راهنما نحوه اضافه کردن BIGO Ads SDK به پیکربندی میانجیگری یک واحد تبلیغاتی و نحوه ادغام BIGO Ads SDK و آداپتور آن در یک برنامه Unity را پوشش می‌دهد.

ادغام‌ها و قالب‌های تبلیغاتی پشتیبانی‌شده

آداپتور میانجیگری Ad Manager برای BIGO Ads SDK دارای قابلیت‌های زیر است:

ادغام
مناقصه ۱
آبشار
قالب‌ها
برنامه باز است
بنر
بینابینی
پاداش داده شده
تبلیغات بینابینی پاداش‌دار
بومی

۱- ادغام پیشنهاد قیمت در مرحله بتای بسته است، برای درخواست دسترسی با مدیر حساب خود تماس بگیرید.

الزامات

  • آخرین نسخه Google Mobile Ads Unity Plugin
  • یونیتی ۲۰۱۹.۴ یا بالاتر
  • برای نصب روی اندروید
    • اندروید API سطح ۲۳ یا بالاتر
  • برای استقرار در iOS
    • هدف استقرار iOS 13.3 یا بالاتر
  • یک پروژه یونیتی فعال که با Google Mobile Ads Unity Plugin پیکربندی شده است. برای جزئیات بیشتر به «شروع به کار» مراجعه کنید.
  • راه‌اندازی میانجیگری مدیر تبلیغات

مرحله ۱: تنظیمات را در رابط کاربری SDK BIGO Ads تنظیم کنید

وارد داشبورد BIGO Ads خود شوید .

یک برنامه ایجاد کنید

به برگه موجودی بروید و در زیر جدول برنامه‌ها و سایت‌ها ، دکمه + افزودن را انتخاب کنید.

افزودن برنامه

بقیه فرم را پر کنید و روی ارسال کلیک کنید.

فرم درخواست جدید

شناسه درخواست خود را یادداشت کنید.

اندروید

شناسه برنامه اندروید

آی‌او‌اس

شناسه برنامه iOS

ایجاد جایگاه تبلیغاتی

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

اضافه کردن جایگاه تبلیغات

برای نوع مزایده، گزینه پیشنهاد قیمت سرور (Server Bidding) را انتخاب کنید، بقیه فرم را پر کنید و روی ارسال کلیک کنید.

فرم جدید جایگاه تبلیغات

به شناسه اسلات توجه کنید

اندروید

شناسه جایگاه تبلیغات اندروید

آی‌او‌اس

شناسه جایگاه تبلیغاتی iOS

فایل app-ads.txt خود را به‌روزرسانی کنید.

فروشندگان مجاز برنامه‌ها app-ads.txt یک ابتکار آزمایشگاه فناوری IAB است که به شما کمک می‌کند تا موجودی تبلیغات برنامه خود را فقط از طریق کانال‌هایی که به عنوان مجاز شناسایی کرده‌اید، به فروش برسانید. برای جلوگیری از کاهش قابل توجه درآمد تبلیغات، باید یک فایل app-ads.txt پیاده‌سازی کنید. اگر قبلاً این کار را نکرده‌اید، یک فایل app-ads.txt برای Ad Manager ایجاد کنید .

برای پیاده‌سازی app-ads.txt برای BIGO Ads SDK، از داشبورد به برگه APP-ads.txt بروید و دستورالعمل‌های موجود در برگه را دنبال کنید.

متن تبلیغات اپلیکیشن

مرحله ۲: درخواست SDK مربوط به BIGO Ads را در رابط کاربری Ad Manager تنظیم کنید

تنظیمات میانجیگری را برای واحد تبلیغاتی خود پیکربندی کنید

اندروید

برای دستورالعمل‌ها، به مرحله ۲ در راهنمای اندروید مراجعه کنید.

آی‌او‌اس

برای دستورالعمل‌ها، به مرحله ۲ در راهنمای iOS مراجعه کنید.

اضافه کردن BIGO TECHNOLOGY PTE LTD به فهرست شرکای تبلیغاتی GDPR و مقررات ایالتی ایالات متحده

برای افزودن BIGO TECHNOLOGY PTE LTD به فهرست شرکای تبلیغاتی مطابق با مقررات ایالتی اروپا و ایالات متحده در رابط کاربری Ad Manager، مراحل موجود در تنظیمات مقررات اروپا و تنظیمات مقررات ایالت ایالات متحده را دنبال کنید.

مرحله ۳: SDK و آداپتور BIGO Ads را وارد کنید

رابط خط فرمان OpenUPM

اگر OpenUPM-CLI را نصب کرده‌اید، می‌توانید افزونه‌ی Google Mobile Ads BIGO Ads SDK Mediation Plugin for Unity را با اجرای دستور زیر از دایرکتوری ریشه‌ی پروژه، روی پروژه‌ی خود نصب کنید:

openupm add com.google.ads.mobile.mediation.bigo

اوپن‌یو‌پی‌ام

در ویرایشگر پروژه یونیتی خود، گزینه Edit > Project Settings > Package Manager را انتخاب کنید تا تنظیمات Unity Package Manager باز شود.

در زیر تب Scoped Registries ، OpenUPM را به عنوان یک رجیستری Scoped با جزئیات زیر اضافه کنید:

  • نام: OpenUPM
  • آدرس اینترنتی: https://package.openupm.com
  • محدوده(ها): com.google

جزئیات OpenUPM

سپس، به مسیر Window > Package Manager بروید تا Unity Package Manager باز شود و از منوی کشویی، My Registrys را انتخاب کنید.

رجیستری‌های یونیتی

بسته Google Mobile Ads Bigo Mediation را انتخاب کرده و روی نصب کلیک کنید.

نصب از OpenUPM

بسته یونیتی

آخرین نسخه افزونه میانجیگری تبلیغات موبایلی گوگل برای BIGO Ads SDK را از لینک دانلود موجود در Changelog دانلود کنید و بسته GoogleMobileAdsBigoMediation.unitypackage را از فایل زیپ استخراج کنید.

در ویرایشگر پروژه Unity خود، Assets > Import Package > Custom Package را انتخاب کنید و فایل GoogleMobileAdsBigoMediation.unitypackage را که دانلود کرده‌اید، پیدا کنید. مطمئن شوید که همه فایل‌ها انتخاب شده‌اند و روی Import کلیک کنید.

وارد کردن از یونیتی

سپس، Assets > External Dependency Manager > Android Resolver > Force Resolve را انتخاب کنید. کتابخانه External Dependency Manager تجزیه و تحلیل وابستگی‌ها را از ابتدا انجام می‌دهد و وابستگی‌های اعلام شده را در پوشه Assets/Plugins/Android برنامه Unity شما کپی می‌کند.

عزم راسخ

مرحله ۴: تنظیمات حریم خصوصی را در SDK BIGO Ads پیاده‌سازی کنید

برای پیاده‌سازی تنظیمات حریم خصوصی برای SDK BIGO Ads و رعایت مقررات مربوط به حریم خصوصی، بخش‌های زیر را مطالعه کنید.

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

کیت توسعه نرم‌افزاری BIGO Ads به طور خودکار رضایت‌نامه GDPR تنظیم‌شده توسط پلتفرم‌های مدیریت رضایت‌نامه از جمله UMP SDK را می‌خواند. برای اطلاعات بیشتر، به راهنمای GDPR کیت توسعه نرم‌افزاری BIGO Ads برای اندروید و iOS مراجعه کنید.

قوانین حفظ حریم خصوصی ایالت‌های آمریکا

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

کد نمونه زیر نحوه ارسال پرچم رضایت به BIGO Ads SDK را نشان می‌دهد. قبل از درخواست تبلیغات از طریق Google Mobile Ads Unity Plugin ، این متد را فراخوانی کنید.

using GoogleMobileAds.Mediation.Bigo.Api;
// ...

Bigo.SetCcpaConsent(true);

مرحله ۵: اضافه کردن کد مورد نیاز

اندروید

برای ادغام SDK تبلیغات BIGO نیازی به کد اضافی نیست.

آی‌او‌اس

ادغام شبکه SKAd

برای افزودن شناسه‌های SKAdNetwork به فایل Info.plist پروژه خود ، مستندات BIGO Ads SDK را دنبال کنید.

مرحله ۶: پیاده‌سازی خود را آزمایش کنید

فعال کردن تبلیغات آزمایشی

مطمئن شوید که دستگاه آزمایشی خود را برای Ad Manager ثبت کرده‌اید .

BIGO Ads برای کمک به آزمایش و ادغام ، شناسه‌های برنامه آزمایشی و شناسه‌های جایگاه تبلیغات را برای اندروید و iOS ارائه می‌دهد.

تأیید تبلیغات آزمایشی

برای تأیید اینکه تبلیغات آزمایشی را از BIGO Ads SDK دریافت می‌کنید، آزمایش منبع تبلیغاتی واحد را در ad inspector با استفاده از منبع(های ) تبلیغاتی BIGO Ads SDK (پیشنهاد ) فعال کنید.

کدهای خطا

اگر آداپتور نتواند تبلیغی از BIGO Ads SDK دریافت کند، می‌توانید خطای اساسی را از پاسخ تبلیغ با استفاده ResponseInfo تحت کلاس‌های زیر بررسی کنید:

اندروید 

sg.bigo.ads
com.google.ads.mediation.bigo.BigoMediationAdapter

آی‌او‌اس 

GADMediationAdapterBigo

کدها و پیام‌های همراه آن توسط آداپتور SDK BIGO Ads زمانی که یک تبلیغ بارگذاری نمی‌شود، ارسال می‌شوند:

اندروید

کد خطا دامنه دلیل
۱۰۱ com.google.mediation.bigoadapter شناسه اسلات بیگو (Bigo Slot ID) موجود نیست یا خالی است.
۱۰۰۰-۱۱۰۰ ارسال شده توسط SDK تبلیغات BIGO کیت توسعه نرم‌افزار BIGO Ads خطایی را نشان داد. برای جزئیات بیشتر به مستندات BIGO Ads SDK مراجعه کنید.

آی‌او‌اس

کد خطا دامنه دلیل
۱۰۱ com.google.ads.mediation.bigo پیکربندی سرور فاقد شناسه برنامه مورد نیاز است.
۱۰۲ com.google.ads.mediation.bigo پیکربندی تبلیغات نامعتبر است.
۱۰۳ com.google.ads.mediation.bigo شکست در ارائه آگهی
۱۰۴ com.google.ads.mediation.bigo اندازه بنر پشتیبانی نشده.
۱۰۵ com.google.ads.mediation.bigo بیگو یک بنر تبلیغاتی را با موفقیت بارگذاری کرد اما نتوانست تبلیغ را ببیند.
۱۰۰۰-۱۱۰۰ ارسال شده توسط SDK تبلیغات BIGO کیت توسعه نرم‌افزار BIGO Ads خطایی را نشان داد. برای جزئیات بیشتر به مستندات BIGO Ads SDK مراجعه کنید.

تغییرات افزونه میانجیگری یونیتی برای تبلیغات BIGO SDK

نسخه ۱.۰.۰