این راهنما به شما نشان میدهد که چگونه Google Mobile Ads SDK برای بارگذاری و نمایش تبلیغات از SDK تبلیغات BIGO با استفاده از میانجیگری استفاده کنید، که شامل ادغامهای پیشنهاد قیمت میشود. این راهنما نحوه اضافه کردن SDK تبلیغات BIGO به پیکربندی میانجیگری یک واحد تبلیغاتی و نحوه ادغام SDK و آداپتور BIGO Ads در یک برنامه iOS را پوشش میدهد.
ادغامها و قالبهای تبلیغاتی پشتیبانیشده
آداپتور میانجیگری برای BIGO Ads SDK دارای قابلیتهای زیر است:
| ادغام | |
|---|---|
| مناقصه | ۱ |
| آبشار | |
| قالبها | |
| برنامه باز است | |
| بنر | |
| بینابینی | |
| پاداش داده شده | |
| تبلیغات بینابینی پاداشدار | |
| بومی | |
۱- ادغام پیشنهاد قیمت در مرحله بتای بسته است، برای درخواست دسترسی با مدیر حساب خود تماس بگیرید.
الزامات
- هدف استقرار iOS 13.3 یا بالاتر
جدیدترین 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 ایجاد کردید، انتخاب کنید. در قسمت Integration type گزینه Mobile SDK mediation ، در قسمت Platform گزینه iOS و در قسمت Status گزینه Active را انتخاب کنید.
مقدار به دست آمده در بخش قبل و مقدار پیشفرض CPM را وارد کنید. روی ذخیره کلیک کنید.
اضافه کردن BIGO TECHNOLOGY PTE LTD به فهرست شرکای تبلیغاتی GDPR و مقررات ایالتی ایالات متحده
برای افزودن BIGO TECHNOLOGY PTE LTD به فهرست شرکای تبلیغاتی مطابق با مقررات ایالتی اروپا و ایالات متحده در رابط کاربری Ad Manager، مراحل موجود در تنظیمات مقررات اروپا و تنظیمات مقررات ایالت ایالات متحده را دنبال کنید.
مرحله ۳: 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 را دنبال کنید.
مرحله ۶: پیادهسازی خود را آزمایش کنید
فعال کردن تبلیغات آزمایشی
مطمئن شوید که دستگاه آزمایشی خود را برای Ad Manager ثبت کردهاید .
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) برای تبلیغات بیگوآدز.
نسخه ۵.۱.۲.۱
- آداپتور اکنون پرچم
ageRestrictedTreatmentGoogle 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) برای تبلیغات بیگوآدز.