این راهنما به شما نشان میدهد که چگونه از Google Mobile Ads SDK برای بارگذاری و نمایش تبلیغات از BidMachine با استفاده از میانجیگری استفاده کنید و ادغامهای پیشنهاد قیمت را پوشش میدهد. این راهنما نحوه اضافه کردن BidMachine به پیکربندی میانجیگری یک واحد تبلیغاتی و نحوه ادغام SDK و آداپتور BidMachine را در یک برنامه اندروید پوشش میدهد.
ادغامها و قالبهای تبلیغاتی پشتیبانیشده
آداپتور میانجیگری برای BidMachine دارای قابلیتهای زیر است:
| ادغام | |
|---|---|
| مناقصه | |
| آبشار | ۱ |
| قالبها | |
| برنامه باز است | |
| بنر | |
| بینابینی | |
| پاداش داده شده | |
| تبلیغات بینابینی پاداشدار | |
| بومی | |
۱- یکپارچهسازی با Waterfall در مرحله بتای بسته است، برای درخواست دسترسی با مدیر حساب خود تماس بگیرید.
الزامات
- اندروید API سطح ۲۳ یا بالاتر
- [برای پیشنهاد قیمت]: برای ادغام تمام قالبهای تبلیغاتی پشتیبانیشده در پیشنهاد قیمت، از آداپتور BidMachine
3.4.0.1یا بالاتر استفاده کنید ( آخرین نسخه توصیه میشود ).
جدیدترین Google Mobile Ads SDK
راهنمای شروع میانجیگری را تکمیل کنید
مرحله 1: تنظیمات را در رابط کاربری BidMachine انجام دهید
وارد داشبورد حساب کاربری BidMachine خود شوید .
ایجاد جایگاههای جدید
به برگه منبع بروید و در زیر جدول منابع ، دکمه ویرایش را انتخاب کنید.
لیستی از تمام جایگاههای موجود به شما نشان داده خواهد شد. برای ایجاد یک جایگاه جدید، روی دکمه «افزودن جایگاه» در پنجره گفتگو کلیک کنید.
فرم را پر کنید و روی ذخیره کلیک کنید.
در نهایت، شناسهی محل قرارگیری را یادداشت کنید.
فایل app-ads.txt خود را بهروزرسانی کنید.
فروشندگان مجاز برنامهها app-ads.txt یک ابتکار آزمایشگاه فناوری IAB است که به شما کمک میکند تا موجودی تبلیغات برنامه خود را فقط از طریق کانالهایی که به عنوان مجاز شناسایی کردهاید، به فروش برسانید. برای جلوگیری از کاهش قابل توجه درآمد تبلیغات، باید یک فایل app-ads.txt پیادهسازی کنید. اگر قبلاً این کار را نکردهاید، یک فایل app-ads.txt برای Ad Manager ایجاد کنید .
برای پیادهسازی app-ads.txt برای BidMachine، از داشبورد به تب app-ads.txt بروید. سپس، لیست را کپی کرده و آن را به فایل app-ads.txt وبسایت خود اضافه کنید.
مرحله ۲: تنظیم تقاضای BidMachine در رابط کاربری Ad Manager
وارد حساب مدیر تبلیغات خود شوید.
اضافه کردن BidMachine در شرکتها
مناقصه
این مرحله برای ادغامهای پیشنهاد قیمت لازم نیست.
آبشار
به بخش مدیریت > شرکتها بروید، سپس در تب «همه شرکتها» روی دکمه «شرکت جدید» کلیک کنید. شبکه تبلیغاتی را انتخاب کنید.
BidMachine را به عنوان شبکه تبلیغاتی انتخاب کنید، یک نام منحصر به فرد وارد کنید و Mediation را فعال کنید.
نیازی به وارد کردن نام کاربری یا رمز عبور نیست. پس از اتمام، روی ذخیره کلیک کنید.
فعال کردن اشتراکگذاری امن سیگنال
مناقصه
به بخش مدیریت > تنظیمات کلی بروید. به برگه تنظیمات حساب Ad Exchange بروید و اشتراکگذاری امن سیگنال را بررسی و فعال کنید. روی ذخیره کلیک کنید.
آبشار
این مرحله برای ادغامهای آبشاری لازم نیست.
سیگنال امن را در درخواستهای پیشنهاد به اشتراک بگذارید
مناقصه
به Inventory > Secure Signals بروید. در قسمت Secure signals ، عبارت BidMachineToken را جستجو کنید و گزینه Enable app integration را فعال کنید.
روی ذخیره کلیک کنید.
آبشار
این مرحله برای ادغامهای آبشاری لازم نیست.
امکان اشتراکگذاری امن سیگنال برای مناقصه SDK
مناقصه
به بخش تحویل > تنظیمات کانال تقاضا بروید. در تب تنظیمات پیشفرض ، گزینه «اجازه اشتراکگذاری امن سیگنال برای پیشنهاد SDK» را فعال کنید.
روی ذخیره کلیک کنید.
آبشار
این مرحله برای ادغامهای آبشاری لازم نیست.
پیکربندی پیشنهاد قیمت BidMachine
مناقصه
به مسیر Delivery > Bidders بروید و روی Go to SDK Bidding کلیک کنید.
روی پیشنهاددهنده جدید کلیک کنید.
BidMachine را به عنوان پیشنهاد دهنده انتخاب کنید.
برای فعال کردن پیشنهاد قیمت SDK برای این پیشنهاد دهنده، روی ادامه کلیک کنید.
روی انجام شد کلیک کنید.
آبشار
این مرحله برای ادغامهای آبشاری لازم نیست.
پیکربندی نگاشت واحد تبلیغات
مناقصه
به مسیر Delivery > Bidders بروید و روی Go to SDK Bidding کلیک کنید.
شرکت BidMachine را انتخاب کنید.
به برگه نگاشت واحد تبلیغات بروید و روی نگاشت واحد تبلیغات جدید کلیک کنید.
واحد تبلیغاتی خاص را انتخاب کنید. یک واحد تبلیغاتی و قالب، برنامه موبایل را به عنوان نوع موجودی و برنامه موبایل خود انتخاب کنید. سپس، شناسه منبع و شناسه قرارگیری به دست آمده در بخش قبل را وارد کنید.
در نهایت، روی ذخیره کلیک کنید.
آبشار
به بخش تحویل > گروههای بازده بروید و روی دکمهی گروه بازده جدید کلیک کنید. برنامهی موبایل خود را انتخاب کنید.
به پایین اسکرول کنید و روی «افزودن شریک عملکرد» کلیک کنید.
شرکتی که در بخش قبل برای BidMachine ایجاد کردید را انتخاب کنید. در قسمت Integration type گزینه Mobile SDK mediation ، در قسمت Platform گزینه Android و در قسمت Status گزینه Active را انتخاب کنید.
شناسهی جایگذاری (Placement ID) که در بخش قبل به دست آوردید و مقدار پیشفرض CPM را وارد کنید. روی ذخیره کلیک کنید.
اضافه کردن BidMachine به فهرست شرکای تبلیغاتی GDPR و مقررات ایالتی ایالات متحده
برای افزودن BidMachine به فهرست شرکای تبلیغاتی مقررات ایالتی اروپا و ایالات متحده در رابط کاربری Ad Manager، مراحل موجود در تنظیمات مقررات اروپا و تنظیمات مقررات ایالتی ایالات متحده را دنبال کنید.
مرحله 3: SDK و آداپتور BidMachine را وارد کنید
ادغام با اندروید استودیو (توصیه میشود)
در فایل gradle سطح برنامه خود، وابستگیهای پیادهسازی زیر را اضافه کنید:
کاتلین
dependencies { implementation("com.google.android.gms:play-services-ads:25.3.0") implementation("com.google.ads.mediation:bidmachine:3.7.0.0") }
گرووی
dependencies { implementation 'com.google.android.gms:play-services-ads:25.3.0' implementation 'com.google.ads.mediation:bidmachine:3.7.0.0' }
مرحله 4: تنظیمات حریم خصوصی را در BidMachine SDK پیاده سازی کنید
برای رعایت سیاست رضایت کاربر اتحادیه اروپا گوگل ، شما باید اطلاعات خاصی را در اختیار کاربران خود در منطقه اقتصادی اروپا (EEA)، بریتانیا و سوئیس قرار دهید و رضایت آنها را برای استفاده از کوکیها یا سایر ذخیرهسازیهای محلی در صورت لزوم قانونی، و برای جمعآوری، اشتراکگذاری و استفاده از دادههای شخصی برای شخصیسازی تبلیغات، دریافت کنید. این سیاست منعکسکننده الزامات دستورالعمل حریم خصوصی الکترونیکی اتحادیه اروپا و مقررات عمومی حفاظت از دادهها (GDPR) است. شما مسئول تأیید انتشار رضایت به هر منبع تبلیغاتی در زنجیره واسطهگری خود هستید. گوگل قادر نیست رضایت کاربر را به طور خودکار به چنین شبکههایی منتقل کند.
BidMachine به طور خودکار رضایت GDPR تنظیم شده توسط پلتفرمهای مدیریت رضایت، از جمله UMP SDK را میخواند. برای اطلاعات بیشتر، به GDPR مراجعه کنید.
قوانین حفظ حریم خصوصی ایالتهای آمریکا
قوانین حفظ حریم خصوصی ایالتهای ایالات متحده ، به کاربران حق انصراف از «فروش» «اطلاعات شخصی» خود (همانطور که قانون این اصطلاحات را تعریف میکند) را میدهد، و این انصراف از طریق پیوند برجسته «اطلاعات شخصی من را نفروشید» در صفحه اصلی طرف «فروشنده» ارائه میشود. راهنمای انطباق با قوانین حفظ حریم خصوصی ایالتهای ایالات متحده ، امکان فعال کردن پردازش دادههای محدود برای سرویس تبلیغات گوگل را ارائه میدهد، اما گوگل قادر به اعمال این تنظیم برای هر شبکه تبلیغاتی در زنجیره واسطهگری شما نیست. بنابراین، شما باید هر شبکه تبلیغاتی را در زنجیره واسطهگری خود که ممکن است در فروش اطلاعات شخصی شرکت کند، شناسایی کنید و برای اطمینان از انطباق، از راهنماییهای هر یک از این شبکهها پیروی کنید.
BidMachine به طور خودکار رضایتنامه GPP تنظیمشده توسط پلتفرمهای مدیریت رضایتنامه از جمله UMP SDK را میخواند. برای اطلاعات بیشتر، به GPP مراجعه کنید.
مرحله ۵: اضافه کردن کد مورد نیاز
هیچ کد اضافی برای ادغام BidMachine لازم نیست.
مرحله ۶: پیادهسازی خود را آزمایش کنید
فعال کردن تبلیغات آزمایشی
مطمئن شوید که دستگاه آزمایشی خود را برای Ad Manager ثبت کردهاید .
برای فعال کردن حالت آزمایشی برای BidMachine، دستورالعملهای موجود در مستندات BidMachine برای اندروید را دنبال کنید.
تأیید تبلیغات آزمایشی
برای تأیید اینکه تبلیغات آزمایشی را از BidMachine دریافت میکنید، با استفاده از منبع(های ) تبلیغاتی BidMachine (پیشنهاد ) گزینه آزمایش منبع تبلیغاتی واحد را در بازرس تبلیغات فعال کنید.
مراحل اختیاری
تبلیغات بومی
رندرینگ آگهی
آداپتور BidMachine تبلیغات بومی خود را به عنوان اشیاء NativeAd برمیگرداند. این آداپتور فیلدهای زیر را برای NativeAd پر میکند.
| میدان | داراییها همیشه توسط آداپتور BidMachine گنجانده میشوند |
|---|---|
| تیتر | |
| تصویر | |
| بدن | |
| آیکون | |
| فراخوان برای اقدام | |
| رتبهبندی ستارهای | |
| فروشگاه | |
| قیمت | |
| تبلیغ کننده |
کدهای خطا
اگر آداپتور نتواند تبلیغی از BidMachine دریافت کند، میتوانید خطای اساسی را از پاسخ تبلیغ با استفاده از ResponseInfo.getAdapterResponses() تحت کلاسهای زیر بررسی کنید:
io.bidmachine
com.google.ads.mediation.bidmachine
در اینجا کدها و پیامهای همراه که توسط آداپتور BidMachine هنگام عدم بارگیری یک تبلیغ نمایش داده میشوند، آمده است:
| کد خطا | دامنه | دلیل |
|---|---|---|
| ۱۰۰ | com.google.ads.mediation.bidmachine | شناسه جایگذاری نامعتبر یا خالی دریافت شد. |
| ۱۰۱ | com.google.ads.mediation.bidmachine | خطا در هنگام جمعآوری سیگنال: پیکربندی دادههای سیگنال یافت نشد. |
| ۱۰۲ | com.google.ads.mediation.bidmachine | فرمت تبلیغ نامعتبر هنگام جمعآوری سیگنال دریافت شد. |
| ۱۰۳ | com.google.ads.mediation.bidmachine | اندازه آگهی درخواستی را نمیتوان به bidmachine.BannerSize نگاشت کرد. |
| ۱۰۴ | com.google.ads.mediation.bidmachine | درخواست تبلیغ BidMachine بارگذاری شده منقضی شده است. |
| ۱۰۵ | com.google.ads.mediation.bidmachine | تبلیغ تمام صفحه نمایش داده نشد. |
| ۱۰۶ | com.google.ads.mediation.bidmachine | کیت توسعه نرمافزار BidMachine یک تابع فراخوانی onAdLoaded() را با دادههای تبلیغاتی null ) برگرداند. |
تغییرات آداپتور میانجیگری اندروید BidMachine
نسخه بعدی
- Maps
AgeRestrictedTreatmentبه COPPA API BidMachine.
نسخه ۳.۷.۰.۰
- سازگاری تأیید شده با BidMachine SDK نسخه ۳.۷.۰.
ساخته و آزمایش شده با:
- نسخه ۲۵.۱.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه ۱.۱.۰ کیت توسعه نرمافزاری نسل بعدی تبلیغات موبایلی گوگل.
- نسخه ۳.۷.۰ کیت توسعه نرمافزار BidMachine.
نسخه ۳.۶.۱.۰
- ویژگی برای ساخت آداپتور با وابستگی به GMA Next-Gen SDK اضافه شد.
- سازگاری تأیید شده با BidMachine SDK نسخه ۳.۶.۱.
ساخته و آزمایش شده با:
- نسخه ۲۵.۱.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه ۳.۶.۱ کیت توسعه نرمافزار BidMachine.
نسخه ۳.۵.۱.۲
- آداپتور BidMachine برای استفاده از AdPlacementConfig بهروزرسانی شد.
ساخته و آزمایش شده با:
- نسخه ۲۴.۹.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه ۳.۵.۱ کیت توسعه نرمافزار BidMachine.
نسخه ۳.۵.۱.۱
- پشتیبانی از ارسال پارامتر
tagForUnderAgeOfConsentبرای SDK تبلیغات موبایل گوگل به SDK مربوط به BidMachine اضافه شد.
ساخته و آزمایش شده با:
- نسخه ۲۴.۹.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه ۳.۵.۱ کیت توسعه نرمافزار BidMachine.
نسخه ۳.۵.۱.۰
- سازگاری تأیید شده با BidMachine SDK نسخه 3.5.1.
ساخته و آزمایش شده با:
- نسخه ۲۴.۹.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه ۳.۵.۱ کیت توسعه نرمافزار BidMachine.
نسخه ۳.۵.۰.۰
- سازگاری تأیید شده با BidMachine SDK نسخه 3.5.0.
ساخته و آزمایش شده با:
- نسخه ۲۴.۷.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه ۳.۵.۰ کیت توسعه نرمافزار BidMachine.
نسخه ۳.۴.۰.۱
- ارجاعات سطح کلاس به اشیاء
Contextحذف شد تا به مشکلات نشت حافظه کمک کند. - آداپتور بهروزرسانیشده برای پشتیبانی از درخواستهای بنر تبلیغاتی که اندازهای نزدیک به فرمتهای پشتیبانیشده دارند، به جای نیاز به تطابق دقیق اندازه.
ساخته و آزمایش شده با:
- نسخه ۲۴.۷.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه ۳.۴.۰ کیت توسعه نرمافزار BidMachine
نسخه ۳.۴.۰.۰
- پشتیبانی از قالبهای تبلیغات آبشاری (waterfall) برای بنر، بینابینی، پاداشی و بومی اضافه شد.
- آداپتور اکنون
onAdOpened()را باonAdImpression()برای تبلیغات تمام صفحه ارسال میکند. - سازگاری تأیید شده با BidMachine SDK نسخه ۳.۴.۰.
ساخته و آزمایش شده با:
- نسخه ۲۴.۶.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه ۳.۴.۰ کیت توسعه نرمافزار BidMachine.
نسخه ۳.۳.۰.۰
- انتشار اولیه.
ساخته و آزمایش شده با:
- نسخه ۲۴.۵.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه ۳.۳.۰ کیت توسعه نرمافزار BidMachine.