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

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

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

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

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

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

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

الزامات

  • هدف استقرار iOS 13.0 یا بالاتر

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

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

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

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

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

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

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

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

شناسه برنامه

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

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

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

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

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

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

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

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

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

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

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

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

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

شما باید BIGO Ads SDK را به پیکربندی میانجیگری برای واحد تبلیغاتی خود اضافه کنید.

ابتدا، وارد حساب کاربری AdMob خود شوید. سپس، به برگه Mediation بروید. اگر یک گروه میانجیگری موجود دارید که می‌خواهید آن را تغییر دهید، روی نام آن گروه میانجیگری کلیک کنید تا آن را ویرایش کنید و به مرحله بعد بروید و BIGO Ads SDK را به عنوان منبع تبلیغات اضافه کنید .

برای ایجاد یک گروه میانجیگری جدید، گزینه «ایجاد گروه میانجیگری» را انتخاب کنید.

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

به گروه میانجیگری خود یک نام بدهید و مکان‌هایی را برای هدف قرار دادن انتخاب کنید. در مرحله بعد، وضعیت گروه میانجیگری را روی فعال (Enabled) تنظیم کنید و سپس روی افزودن واحدهای تبلیغاتی (Add Ad Units) کلیک کنید.

این گروه میانجی را با یک یا چند واحد تبلیغاتی AdMob موجود خود مرتبط کنید. سپس روی «انجام شد» کلیک کنید.

اکنون باید کارت واحدهای تبلیغاتی را ببینید که با واحدهای تبلیغاتی که انتخاب کرده‌اید پر شده است:

اضافه کردن کیت توسعه نرم‌افزاری BIGO Ads به عنوان منبع تبلیغات


در قسمت «منابع تبلیغات» ، زیر کارت پیشنهاد قیمت ، گزینه «افزودن منبع تبلیغات» را انتخاب کنید. سپس «BIGO Ads SDK» را انتخاب کنید.

روی نحوه امضای قرارداد مشارکت و تنظیم مشارکت در مناقصه با BIGO Ads SDK کلیک کنید.



روی تأیید و موافقت کلیک کنید، سپس روی ادامه کلیک کنید.



اگر از قبل نگاشتی برای BIGO Ads SDK دارید، می‌توانید آن را انتخاب کنید. در غیر این صورت، روی افزودن نگاشت کلیک کنید.



سپس، شناسه اسلات (Slot ID) که در بخش قبل به دست آورده‌اید را وارد کنید. سپس روی «انجام شد» (Done) کلیک کنید.



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

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

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

کوکوپادز

  • خط زیر را به Podfile پروژه خود اضافه کنید:

    pod 'GoogleMobileAdsMediationBigo'

  • از خط فرمان اجرا کنید:

    pod install --repo-update

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

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

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

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

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

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

سویفت 

BigoAdSdk.setUserConsentWithOption(BigoConsentOptionsCCPA, consent: true)

هدف-سی 

[BigoAdSdk setUserConsentWithOption:BigoConsentOptionsCCPA consent:YES];

برای اطلاعات بیشتر، به راهنمای ادغام BIGO Ads SDK در CCPA مراجعه کنید.

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

پیاده‌سازی SKAdNetwork

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

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

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

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

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

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

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

مراحل اختیاری

تبلیغات بومی

رندرینگ آگهی

آداپتور SDK مربوط به BIGO Ads، تبلیغات بومی خود را به عنوان اشیاء GADNativeAd برمی‌گرداند. این آداپتور فیلدهای زیر را برای یک GADNativeAd پر می‌کند.

میدان دارایی‌هایی که همیشه در آداپتور SDK BIGO Ads گنجانده شده‌اند
تیتر
تصویر
بدن
آیکون
فراخوان برای اقدام
رتبه‌بندی ستاره‌ای
فروشگاه
قیمت
تبلیغ کننده

کدهای خطا

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

GADMediationAdapterBigo

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

کد خطا دامنه دلیل
۱۰۱ 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 مراجعه کنید.

تغییرات آداپتور میانجیگری iOS برای تبلیغات BIGO

نسخه ۵.۲.۱.۰

  • سازگاری تأیید شده با نسخه ۵.۲.۱ کیت توسعه نرم‌افزاری BIGO Ads.
  • برای استفاده از APIهای جدید حریم خصوصی، حداقل وابستگی SDK تبلیغات موبایلی گوگل را به ۱۳.۳.۰ به‌روزرسانی کنید.

ساخته و آزمایش شده با:

  • نسخه ۱۳.۴.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۵.۲.۱ کیت توسعه نرم‌افزاری (SDK) برای تبلیغات بیگوآدز.

نسخه ۵.۲.۰.۰

  • سازگاری تأیید شده با نسخه ۵.۲.۰ کیت توسعه نرم‌افزاری BIGO Ads.

ساخته و آزمایش شده با:

  • نسخه ۱۳.۴.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۵.۲.۰ کیت توسعه نرم‌افزاری (SDK) برای تبلیغات بیگوآدز.

نسخه ۵.۱.۲.۱

  • آداپتور اکنون پرچم ageRestrictedTreatment Google Mobile Ads SDK را به COPPA API مربوط به BIGO Ads SDK ارسال می‌کند.

ساخته و آزمایش شده با:

  • نسخه ۱۳.۳.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۵.۱.۲ کیت توسعه نرم‌افزاری (SDK) برای تبلیغات بیگوآدز.

نسخه ۵.۱.۲.۰

  • سازگاری تأیید شده با نسخه ۵.۱.۲ کیت توسعه نرم‌افزاری BIGO Ads.

ساخته و آزمایش شده با:

  • نسخه ۱۳.۲.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۵.۱.۲ کیت توسعه نرم‌افزاری (SDK) برای تبلیغات بیگوآدز.

نسخه ۵.۱.۱.۰

  • سازگاری تأیید شده با نسخه ۵.۱.۱ کیت توسعه نرم‌افزاری BIGO Ads.

ساخته و آزمایش شده با:

  • نسخه ۱۳.۲.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۵.۱.۱ کیت توسعه نرم‌افزاری (SDK) تبلیغات بیگوآدز.

نسخه ۵.۱.۰.۱

  • آداپتور به‌روزرسانی شد تا از بروز خطا در درخواست تبلیغات، زمانی که یک بنر تبلیغاتی با اندازه تبلیغ پشتیبانی نشده بارگذاری می‌شود، جلوگیری شود.

ساخته و آزمایش شده با:

  • نسخه ۱۳.۱.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۵.۱.۰ کیت توسعه نرم‌افزاری (SDK) برای تبلیغات بیگوآدز.

نسخه ۵.۱.۰.۰

  • سازگاری تأیید شده با نسخه ۵.۱.۰ کیت توسعه نرم‌افزاری BIGO Ads.

ساخته و آزمایش شده با:

  • نسخه ۱۳.۱.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۵.۱.۰ کیت توسعه نرم‌افزاری (SDK) برای تبلیغات بیگوآدز.

نسخه ۵.۰.۶.۲

  • وابستگی SDK تبلیغات موبایل گوگل به نسخه ۱۳.۰.۰ به‌روزرسانی شد.

ساخته و آزمایش شده با:

  • نسخه ۱۳.۰.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۵.۰.۶ کیت توسعه نرم‌افزاری (SDK) برای تبلیغات بیگوآدز.

نسخه ۵.۰.۶.۱

  • حداقل نسخه iOS برنامه CocoaPods به 13.0 به‌روزرسانی شد.

ساخته و آزمایش شده با:

  • نسخه ۱۳.۰.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۵.۰.۶ کیت توسعه نرم‌افزاری (SDK) برای تبلیغات بیگوآدز.

نسخه ۵.۰.۶.۰

  • انتشار اولیه!
  • پشتیبانی از پیشنهاد قیمت برای قالب‌های تبلیغات باز برنامه، بنر (شامل MREC)، بینابینی، پاداشی و بومی اضافه شد.
  • سازگاری تأیید شده با نسخه ۵.۰.۶ کیت توسعه نرم‌افزاری BIGO Ads.

ساخته و آزمایش شده با:

  • نسخه ۱۲.۱۴.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۵.۰.۶ کیت توسعه نرم‌افزاری (SDK) برای تبلیغات بیگوآدز.