این راهنما به شما نشان میدهد که چگونه از GMA Next-Gen SDK برای بار کردن و نمایش دادن آگهیهای BidMachine بااستفاده از میانجیگری AdMob استفاده کنید، و ادغامهای مزایده را پوشش میدهد. این راهنما نحوه افزودن BidMachine به پیکربندی میانجیگری واحد آگهی و نحوه ادغام کیت توسعه نرمافزار و آداپتور BidMachine در برنامه Android را پوشش میدهد.
یکپارچهسازیها و قالبهای آگهی پشتیبانیشده
آداپتور میانجیگری BidMachine قابلیتهای زیر را دارد:
| یکپارچهسازی | |
|---|---|
| پیشنهاد قیمت | |
| آبشار | ۱ |
| قالبها | |
| باز شدن برنامه | |
| برنما | |
| بینابینی | |
| پاداش | |
| بینابینی پاداشدار | |
| بومی | |
۱ ادغام آبشاری در نسخه بتا بسته است، برای درخواست دسترسی با مدیر حسابتان تماس بگیرید.
پیشنیازها
پیشاز ادامه دادن، موارد زیر را تأیید کنید:
- Android API سطح ۲۴ یا بالاتر.
- [برای پیشنهاد قیمت]: برای ادغام کردن همه قالبهای آگهی پشتیبانیشده در پیشنهاد قیمت، از
آداپتور BidMachine نسخه
3.4.0.1یا جدیدتر (جدیدترین نسخه توصیه میشود) استفاده کنید.
جدیدترین نسخه GMA Next-Gen SDK.
مرحله ۱: راهاندازی پیکربندیها در BidMachine UI
به داشبورد حساب BidMachine خود وارد شوید.
ایجاد جای آگهی جدید
به برگه منبع بروید و در جدول منابع، دکمه ویرایش را انتخاب کنید.
فهرستی از همه جایگاههای آگهیتان به شما نشان داده میشود. برای ایجاد جای آگهی جدید، روی دکمه افزودن جای آگهی در کادر گفتگو کلیک کنید.
پیشنهاد قیمت را بهعنوان نوع جای آگهی انتخاب کنید. فرم را پر کنید و روی ذخیره کلیک کنید.
درنهایت، شناسه جای آگهی را یادداشت کنید.
فایل app-ads.txt خود را بهروز کنید
Authorized Sellers for Apps app-ads.txt ابتکاری از IAB Tech Lab است که کمک میکند مطمئن شوید
فهرست آگهیهای برنامهتان فقط ازطریق کانالهایی که بهعنوان مجاز شناسایی کردهاید فروخته میشود. برای جلوگیری از
افت قابلتوجه در درآمد آگهی، باید فایل app-ads.txt را پیادهسازی کنید.
اگر قبلاً این کار را نکردهاید،
فایل app-ads.txt را برای برنامهتان راهاندازی کنید.
برای پیادهسازی app-ads.txt برای BidMachine، از داشبورد به برگه app-ads.txt بروید. سپس، فهرست را کپی کنید و
آن را به فایل app-ads.txt وبسایتتان اضافه کنید.
مرحله ۲: راهاندازی کردن تقاضای BidMachine در میانای کاربر AdMob
پیکربندی تنظیمات میانجیگری برای واحد آگهی شما
باید BidMachine را به پیکربندی میانجیگری برای واحد آگهیتان اضافه کنید.
ابتدا، به سیستم حساب AdMob خود وارد شوید. سپس، به برگه میانجیگری بروید. اگر گروه میانجیگری موجودی دارید که میخواهید آن را اصلاح کنید، روی نام آن گروه میانجیگری کلیک کنید تا آن را ویرایش کنید و به افزودن BidMachine بهعنوان منبع آگهی بروید.
برای ایجاد گروه میانجیگری جدید، ایجاد گروه میانجیگری را انتخاب کنید.

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

نامی برای گروه میانجیگریتان انتخاب کنید و مکانهای هدف را انتخاب کنید. سپس، وضعیت گروه میانجیگری را روی فعال تنظیم کنید و سپس روی افزودن واحدهای آگهی کلیک کنید.

این گروه میانجی را با یک یا چند واحد آگهی AdMob موجود مرتبط کنید. سپس روی تمام کلیک کنید.

اکنون باید کارت واحدهای آگهی را ببینید که با واحدهای آگهی انتخابی شما پر شده است:

افزودن BidMachine بهعنوان منبع آگهی
پیشنهاد قیمت
در بخش منابع آگهی، کارت پیشنهاد قیمت را پیدا کنید و افزودن منبع آگهی را انتخاب کنید. سپس BidMachine را انتخاب کنید.
روی نحوه امضای قرارداد مشارکت و راهاندازی مشارکت مناقصه با BidMachine کلیک کنید.
روی تأیید و موافقت کلیک کنید، سپس روی ادامه کلیک کنید.
اگر ازقبل نگاشتی برای BidMachine دارید، میتوانید آن را انتخاب کنید. درغیراینصورت، روی افزودن نگاشت کلیک کنید.
سپس، شناسه منبع و شناسه جای آگهی را که در بخش قبلی بهدست آوردید وارد کنید. سپس روی تمام کلیک کنید.

آبشار
در زیر کارت آبشاری در بخش منابع آگهی، افزودن منبع آگهی را انتخاب کنید.
BidMachine را انتخاب کنید. سپس مقدار eCPM را برای BidMachine وارد کنید و روی ادامه کلیک کنید.

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

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

افزودن BidMachine به فهرست شرکای آگهی «مقررات کلی حفاظت از داده» و مقررات ایالتی ایالات متحده
مراحل موجود در تنظیمات مقررات اروپا و تنظیمات مقررات ایالتی ایالات متحده را دنبال کنید تا BidMachine را به فهرست شرکای آگهی مقررات ایالتی ایالات متحده و اروپا در میانای کاربر AdMob اضافه کنید.
مرحله ۳: وارد کردن BidMachine SDK و آداپتور
یکپارچهسازی «استودیو Android» (توصیهشده)
در فایل settings.gradle (یا settings.gradle.kts) سطح پروژه،
مخازن زیر را اضافه کنید:
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://artifactory.bidmachine.io/bidmachine")
}
}
}
در فایل gradle سطح برنامه، وابستگیهای پیادهسازی و پیکربندیهای زیر را اضافه کنید:
Kotlin
dependencies { implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.6.0") implementation("com.google.ads.mediation:bidmachine:3.8.0.1") } configurations.configureEach { exclude(group = "com.google.android.gms", module = "play-services-ads") exclude(group = "com.google.android.gms", module = "play-services-ads-lite") }
شیک
dependencies { implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.6.0' implementation 'com.google.ads.mediation:bidmachine:3.8.0.1' } configurations.configureEach { exclude group: 'com.google.android.gms', module: 'play-services-ads' exclude group: 'com.google.android.gms', module: 'play-services-ads-lite' }
مرحله ۴: پیادهسازی تنظیمات حریم خصوصی در BidMachine SDK
برای رعایت کردن خطمشی Google درخصوص موافقت کاربر اتحادیه اروپا، باید شفافسازیهای خاصی را برای کاربران ساکن منطقه اقتصادی اروپا (EEA)، بریتانیا، و سوئیس انجام دهید و موافقت آنها را برای استفاده از کوکیها یا دیگر فضاهای ذخیرهسازی محلی در جاهایی که قانون الزام میکند، و برای جمعآوری، همرسانی، و استفاده از دادههای شخصی برای شخصیسازی آگهیها کسب کنید. این خطمشی منعکسکننده الزامات «آییننامه حریمخصوصی الکترونیکی» اتحادیه اروپا و «مقررات کلی حفاظت از داده» (GDPR) است. شما مسئولید که تأیید کنید رضایت به هر منبع آگهی در زنجیره میانجیگری شما منتقل شده است.
BidMachine Android adapter version 3.3.0.0 and later supports passing GDPR consent signals from consent management platforms that integrate with IAB's Transparency and Consent Framework (TCF) to BidMachine SDK. برای اطلاعات بیشتر، به مقررات کلی حفاظت از داده مراجعه کنید.
قوانین حریم خصوصی ایالتی در ایالات متحده
قوانین حریم خصوصی ایالتهای امریکا ملزم میکند که به کاربران حق انصراف از «فروش» «اطلاعات شخصی» آنها (طبق تعریف قانون از این اصطلاحات) داده شود و این انصراف ازطریق پیوند برجسته «اطلاعات شخصی من فروخته نشود» در صفحه اصلی طرف «فروشنده» ارائه شود. راهنمای رعایت قوانین حریم خصوصی ایالتهای ایالات متحده امکان فعال کردن پردازش محدود داده را برای آگهیرسانی Google فراهم میکند، اما Google نمیتواند این تنظیم را برای هر شبکه آگهی در زنجیره میانجیگری شما اعمال کند. بنابراین، باید هر شبکه آگهی را در زنجیره میانجیگریتان که ممکن است در فروش اطلاعات شخصی مشارکت داشته باشد شناسایی کنید و از راهنماییهای هریک از آن شبکهها پیروی کنید تا از رعایت مقررات مطمئن شوید.
BidMachine بهطور خودکار رضایت GPP را که توسط پلاتفرمهای مدیریت رضایت ازجمله UMP SDK تنظیم شده است میخواند. برای اطلاعات بیشتر، به GPP مراجعه کنید.
مرحله ۵: افزودن کد الزامی
برای ادغام BidMachine به کد دیگری نیاز نیست.
مرحله ۶: آزمایش کردن پیادهسازی
فعال کردن آگهیهای آزمایشی
مطمئن شوید دستگاه آزمایشیتان را برای AdMob ثبت کردهاید.
برای فعال کردن حالت آزمایشی BidMachine، دستورالعملهای موجود در اسناد BidMachine را برای Android دنبال کنید.
درستیسنجی آگهیهای آزمایشی
برای تأیید اینکه آگهیهای آزمایشی را از BidMachine دریافت میکنید، آزمایش منبع آگهی تکی را در بازرس آگهی بااستفاده از منبع(های) آگهی BidMachine (مناقصه) فعال کنید.
مراحل اختیاری
آگهیهای بومی
پرداز آگهی
آداپتور BidMachine آگهیهای بومی خود را بهعنوان
NativeAd
شیء برمیگرداند. این مورد
فیلدهای
زیر را برای
NativeAd
پر میکند.
| فیلد | داراییهایی که همیشه توسط آداپتور BidMachine گنجانده میشوند |
|---|---|
| Headline | |
| تصویر | |
| بدن | |
| نماد | |
| دعوت به اقدام | |
| ردهبندی با ستاره | |
| فروشگاه | |
| قیمت | |
| آگهیدهنده |
کدهای خطا
اگر آداپتور نتواند آگهی را از BidMachine دریافت کند، میتوانید خطای اساسی را از پاسخ آگهی بااستفاده از
ResponseInfo.getAdSourceResponses()
تحت کلاسهای زیر بررسی کنید:
io.bidmachine
com.google.ads.mediation.bidmachine
در اینجا کدها و پیامهای همراهی که توسط آداپتور BidMachine ارسال میشوند وقتی آگهی بارگیری نمیشود، آورده شده است:
| کد خطا | دامنه | استدلال |
|---|---|---|
| 100 | com.google.ads.mediation.bidmachine | شناسه جای آگهی نامعتبر یا خالی دریافت شد. |
| ۱۰۱ | com.google.ads.mediation.bidmachine | خطا درحین جمعآوری سیگنال: «پیکربندی دادههای سیگنال» پیدا نشد. |
| 102 | com.google.ads.mediation.bidmachine | قالب آگهی نامعتبر درطول جمعآوری سیگنال دریافت شد. |
| 103 | com.google.ads.mediation.bidmachine | اندازه آگهی درخواستشده با bidmachine.BannerSize مطابقت داده نشد |
| 104 | com.google.ads.mediation.bidmachine | درخواست آگهی BidMachine بارشده منقضی شده است. |
| ۱۰۵ | com.google.ads.mediation.bidmachine | آگهی تمامصفحه نشان داده نشد. |
| 106 | com.google.ads.mediation.bidmachine | کیت توسعه نرمافزار BidMachine یک onAdLoaded() برگشت فراخوانی با دادههای آگهی null برگرداند. |
| 107 | com.google.ads.mediation.bidmachine | شناسه منبع موجود نیست یا خالی است. |
BidMachine Android Mediation Adapter Changelog
نسخه بعدی
- آداپتور برای استفاده از میانای برنامهسازی کاربردی
InitializationCompleteCallback.onInitializationFailed(AdError)بهروز شد. - حداقل سطح میانای برنامهسازی کاربردی Android موردنیاز به ۲۴ بهروز شد.
نسخه ۳.۸.۰.۱
- وابستگی Kotlin آداپتور را به ۱.۹.۰ (حداقل نسخه Kotlin پشتیبانیشده توسط کیت توسعه نرمافزار GMA NextGen) سنجاق کنید.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۵.۴.۰.
- نسخه ۱.۴.۰ کیت توسعه نرمافزار نسل بعدی آگهیهای تلفن همراه Google.
- BidMachine SDK نسخه ۳.۸.۰.
نسخه ۳.۸.۰.۰
- سازگاری با BidMachine SDK نسخه ۳.۸.۰ تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۵.۴.۰.
- نسخه ۱.۴.۰ کیت توسعه نرمافزار نسل بعدی آگهیهای تلفن همراه Google.
- BidMachine SDK نسخه ۳.۸.۰.
نسخه ۳.۷.۱.۱
- با COPPA API مربوط به BidMachine
AgeRestrictedTreatmentمطابقت دارد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۵.۴.۰.
- نسخه ۱.۲.۱ کیت توسعه نرمافزار تبلیغات تلفن همراه Google نسل بعدی.
- BidMachine SDK نسخه ۳.۷.۱.
نسخه ۳.۷.۰.۰
- سازگاری با BidMachine SDK نسخه ۳.۷.۰ تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۵.۱.۰.
- نسخه ۱.۱.۰ کیت توسعه نرمافزار نسل بعدی آگهیهای تلفن همراه Google.
- BidMachine SDK نسخه ۳.۷.۰.
نسخه ۳.۶.۱.۰
- ویژگیای برای ساختن آداپتور با وابستگی کیت توسعه نرمافزار GMA Next-Gen اضافه شد.
- سازگاری با BidMachine SDK نسخه ۳.۶.۱ تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۵.۱.۰.
- BidMachine SDK نسخه ۳.۶.۱.
نسخه ۳.۵.۱.۲
- آداپتور BidMachine برای استفاده از AdPlacementConfig بهروز شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۴.۹.۰.
- BidMachine SDK نسخه ۳.۵.۱.
نسخه ۳.۵.۱.۱
- پشتیبانی از بازارسال پارامتر
tagForUnderAgeOfConsentGoogle Mobile Ads SDK به BidMachine SDK اضافه شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۴.۹.۰.
- BidMachine SDK نسخه ۳.۵.۱.
نسخه ۳.۵.۱.۰
- سازگاری با BidMachine SDK نسخه ۳.۵.۱ تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۴.۹.۰.
- BidMachine SDK نسخه ۳.۵.۱.
نسخه ۳.۵.۰.۰
- سازگاری با BidMachine SDK نسخه ۳.۵.۰ تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۴.۷.۰.
- BidMachine SDK نسخه ۳.۵.۰.
نسخه ۳.۴.۰.۱
- برای کمک به رفع مشکلات نشت حافظه، ارجاعهای سطح کلاس به اشیای
Contextبرداشته شد. - آداپتور بهروزرسانی شد تا از درخواستهای آگهی برنمای نزدیک به اندازه قالبهای پشتیبانیشدهاش پشتیبانی کند، بهجای اینکه به مطابقت دقیق اندازه نیاز داشته باشد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۴.۷.۰.
- BidMachine SDK نسخه ۳.۴.۰
نسخه ۳.۴.۰.۰
- پشتیبانی آبشاری برای قالبهای آگهی بومی، پاداشدار، بینابینی، و برنما اضافه شد.
- اکنون آداپتور
onAdOpened()را باonAdImpression()برای آگهیهای تمامصفحه بازارسال میکند. - سازگاری با BidMachine SDK نسخه ۳.۴.۰ تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۴.۶.۰.
- BidMachine SDK نسخه ۳.۴.۰.
نسخه ۳.۳.۰.۰
- نسخهٔ پخش اولیه.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۴.۵.۰.
- BidMachine SDK نسخه ۳.۳.۰.