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

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

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

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

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

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

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

الزامات

• اندروید API سطح ۲۳ یا بالاتر

• جدیدترین Google Mobile Ads SDK

• راهنمای شروع میانجیگری را تکمیل کنید

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

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

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

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

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

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

مهم: پس از ایجاد درخواست جدید، آن در مرحله بررسی قرار می‌گیرد. قبل از اینکه بتوانید مراحل بعدی را ادامه دهید، درخواست باید بررسی شود.

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

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

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

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

فایل 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 تنظیم کنید

وارد حساب مدیر تبلیغات خود شوید.

اضافه کردن کیت توسعه نرم‌افزاری (SDK) BIGO Ads به شرکت‌ها

مناقصه

این مرحله برای ادغام‌های پیشنهاد قیمت لازم نیست.

آبشار

به بخش مدیریت > شرکت‌ها بروید، سپس در تب «همه شرکت‌ها» روی دکمه «شرکت جدید» کلیک کنید. شبکه تبلیغاتی را انتخاب کنید.

BIGO Ads SDK را به عنوان شبکه تبلیغاتی انتخاب کنید، یک نام منحصر به فرد وارد کنید و گزینه میانجیگری را فعال کنید.

نیازی به وارد کردن نام کاربری یا رمز عبور نیست. پس از اتمام، روی ذخیره کلیک کنید.

فعال کردن اشتراک‌گذاری امن سیگنال

مناقصه

به بخش مدیریت > تنظیمات کلی بروید. به برگه تنظیمات حساب Ad Exchange بروید و اشتراک‌گذاری امن سیگنال را بررسی و فعال کنید. روی ذخیره کلیک کنید.

آبشار

این مرحله برای ادغام‌های آبشاری لازم نیست.

سیگنال امن را در درخواست‌های پیشنهاد به اشتراک بگذارید

مناقصه

به بخش موجودی > سیگنال‌های امن بروید. در زیر سیگنال‌های امن ، BIGO TECHNOLOGY PTE LTD را جستجو کنید و گزینه فعال کردن ادغام برنامه را فعال کنید.

روی ذخیره کلیک کنید.

آبشار

این مرحله برای ادغام‌های آبشاری لازم نیست.

امکان اشتراک‌گذاری امن سیگنال برای مناقصه SDK

مناقصه

به بخش تحویل > تنظیمات کانال تقاضا بروید. در تب تنظیمات پیش‌فرض ، گزینه «اجازه اشتراک‌گذاری امن سیگنال برای پیشنهاد SDK» را فعال کنید.

روی ذخیره کلیک کنید.

آبشار

این مرحله برای ادغام‌های آبشاری لازم نیست.

پیکربندی پیشنهاد قیمت SDK BIGO Ads

مناقصه

به مسیر Delivery > Bidders بروید و روی Go to SDK Bidding کلیک کنید.

روی پیشنهاددهنده جدید کلیک کنید.

کیت توسعه نرم‌افزاری BIGO Ads را به عنوان پیشنهاد دهنده انتخاب کنید.

برای فعال کردن پیشنهاد قیمت SDK برای این پیشنهاد دهنده، روی ادامه کلیک کنید.

روی انجام شد کلیک کنید.

آبشار

این مرحله برای ادغام‌های آبشاری لازم نیست.

پیکربندی نگاشت واحد تبلیغات

مناقصه

به مسیر Delivery > Bidders بروید و روی Go to SDK Bidding کلیک کنید.

شرکت مربوط به BIGO Ads SDK را انتخاب کنید.

به برگه نگاشت واحد تبلیغات بروید و روی نگاشت واحد تبلیغات جدید کلیک کنید.

واحد تبلیغاتی خاص را انتخاب کنید. یک واحد تبلیغاتی و قالب آن، برنامه موبایل را به عنوان نوع موجودی و برنامه موبایل خود انتخاب کنید. سپس، شناسه اسلات (Slot ID) به دست آمده در بخش قبل را وارد کنید.

در نهایت، روی ذخیره کلیک کنید.

مهم: واحد تبلیغاتی انتخاب شده را حداقل توسط یک گروه بازده هدف قرار دهید و شناسه برنامه باید مانند رابط کاربری BIGO Ads SDK با برنامه هدف مرتبط باشد.

آبشار

به بخش تحویل > گروه‌های بازده بروید و روی دکمه‌ی گروه بازده جدید کلیک کنید. برنامه‌ی موبایل خود را انتخاب کنید.

به پایین اسکرول کنید و روی «افزودن شریک عملکرد» کلیک کنید.

شرکتی را که در بخش قبل برای BIGO Ads SDK ایجاد کردید، انتخاب کنید. در قسمت Integration type گزینه Mobile SDK mediation ، در قسمت Platform گزینه Android و در قسمت Status گزینه Active را انتخاب کنید.

مقدار به دست آمده در بخش قبل و مقدار پیش‌فرض CPM را وارد کنید. روی ذخیره کلیک کنید.

مهم: شناسه برنامه باید مانند رابط کاربری BIGO Ads SDK با برنامه هدف مرتبط باشد.

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

مهم: تأیید کنید که مجوز مدیریت حساب را برای تکمیل پیکربندی مربوط به رضایت اتحادیه اروپا و GDPR، مقررات ایالتی ایالات متحده و پلتفرم پیام‌رسانی کاربر دارید. برای جزئیات بیشتر به مدیریت دسترسی کاربر به حساب خود مراجعه کنید.

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

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

توجه: عدم ادغام نسخه‌های سازگار BIGO Ads SDK و Google Mobile Ads SDK ممکن است منجر به مشکلات ساخت شود.

ادغام با اندروید استودیو (توصیه می‌شود)

در فایل gradle سطح برنامه خود، وابستگی‌های پیاده‌سازی زیر را اضافه کنید:

کاتلین

dependencies {
    implementation("com.google.android.gms:play-services-ads:25.3.0")
    implementation("com.google.ads.mediation:bigo:5.9.0.0")
}

گرووی

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.3.0'
    implementation 'com.google.ads.mediation:bigo:5.9.0.0'
}

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

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

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

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

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

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

جاوا

BigoAdSdk.setUserConsent(context, ConsentOptions.CCPA, true);
BigoMediationSnippets.java

کاتلین

BigoAdSdk.setUserConsent(context, ConsentOptions.CCPA, true)
BigoMediationSnippets.kt

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

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

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

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

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

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

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

مهم: قبل از انتشار برنامه، حالت آزمایشی را برای Ad Manager و BIGO Ads SDK غیرفعال کنید.

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

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

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

تبلیغات بومی

رندرینگ آگهی

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

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

کدهای خطا

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

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

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

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

تغییرات آداپتور میانجیگری اندروید Bigo

نسخه بعدی

• Maps AgeRestrictedTreatment به API COPPA Bigo.

نسخه ۵.۹.۰.۰

• سازگاری تأیید شده با Bigo Ads SDK 5.9.0.

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

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

نسخه ۵.۸.۰.۰

• ویژگی برای ساخت آداپتور با وابستگی به GMA Next-Gen SDK اضافه شد.
• سازگاری تأیید شده با Bigo Ads SDK 5.8.0.

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

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

نسخه ۵.۷.۱.۰

• سازگاری تأیید شده با Bigo Ads SDK 5.7.1.

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

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

نسخه ۵.۷.۰.۰

• پشتیبانی از ارسال پارامتر tagForUnderAgeOfConsent برای SDK تبلیغات موبایل گوگل به SDK تبلیغات Bigo اضافه شد.
• سازگاری تأیید شده با Bigo Ads SDK 5.7.0.

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

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

نسخه ۵.۵.۲.۰

• پشتیبانی از قالب‌های تبلیغات بنری، بینابینی، پاداشی و بومی اضافه شد.
• سازگاری تأیید شده با Bigo Ads SDK 5.5.2.

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

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