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

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

این راهنما به شما نشان می‌دهد که چگونه از Google Mobile Ads SDK برای بارگذاری و نمایش تبلیغات از SDK تبلیغات BIGO با استفاده از AdMob Mediation استفاده کنید و ادغام‌های پیشنهاد قیمت را پوشش می‌دهد. این راهنما نحوه اضافه کردن 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 برای برنامه خود تنظیم کنید .

برای پیاده‌سازی 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 Ads SDK با برنامه هدف مرتبط باشد.

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

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

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

مرحله ۳: 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 نیازی به کد اضافی نیست.

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

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

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

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

مهم: قبل از انتشار برنامه، حالت آزمایشی را برای AdMob و 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) بیگوآدز.