ادغام BidMachine با میانجیگری

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

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

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

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

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

^۱- یکپارچه‌سازی با Waterfall در مرحله بتای بسته است، برای درخواست دسترسی با مدیر حساب خود تماس بگیرید.

الزامات

• هدف استقرار iOS 13.0 یا بالاتر

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

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

مرحله 1: تنظیمات را در رابط کاربری BidMachine انجام دهید

وارد داشبورد حساب کاربری 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 با برنامه هدف مرتبط باشد.

آبشار

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

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

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

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

مهم: شناسه منبع باید مانند رابط کاربری BidMachine با برنامه هدف مرتبط باشد.

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

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

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

مرحله 3: SDK و آداپتور BidMachine را وارد کنید

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

استفاده از مدیر بسته Swift

قبل از ادامه، باید حداقل نسخه آداپتور پشتیبانی شده ۳.۶.۰.۰ را داشته باشید.

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

1. در Xcode، به مسیر File > Add Package Dependencies... بروید.

2. در اعلانی که ظاهر می‌شود، آدرس بسته‌ی زیر را جستجو کنید:

   https://github.com/googleads/googleads-mobile-ios-mediation-bidmachine.git
   

3. در بخش «قانون وابستگی» ، شاخه (Branch) را انتخاب کنید.

4. در فیلد متن، main را وارد کنید.

از کوکوپادز استفاده کنید

• خط زیر را به Podfile پروژه خود اضافه کنید:

  pod 'GoogleMobileAdsMediationBidMachine'
  

• از خط فرمان اجرا کنید:

  pod install --repo-update

ادغام دستی

1. آخرین نسخه BidMachine SDK را برای iOS دانلود کنید و تمام فایل‌ها و بسته‌های .xcframework را در پروژه خود پیوند دهید.

2. آخرین نسخه آداپتور BidMachine را از لینک دانلود موجود در Changelog دانلود کنید و BidMachineAdapter.xcframework را در پروژه خود لینک کنید.

مرحله 4: تنظیمات حریم خصوصی را در BidMachine SDK پیاده سازی کنید

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

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

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

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

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

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

پیاده‌سازی SKAdNetwork

برای افزودن شناسه‌های SKAdNetwork به فایل Info.plist پروژه خود ، مستندات BidMachine را دنبال کنید.

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

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

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

برای فعال کردن حالت آزمایشی برای BidMachine، دستورالعمل‌های موجود در مستندات BidMachine برای iOS را دنبال کنید.

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

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

برای تأیید اینکه تبلیغات آزمایشی را از BidMachine دریافت می‌کنید، با استفاده از منبع(های ) تبلیغاتی BidMachine (پیشنهاد ) گزینه آزمایش منبع تبلیغاتی واحد را در بازرس تبلیغات فعال کنید.

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

تبلیغات بومی

رندرینگ آگهی

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

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

کدهای خطا

اگر آداپتور نتواند تبلیغی از BidMachine دریافت کند، می‌توانید خطای اساسی را از پاسخ تبلیغ با استفاده از GADResponseInfo.adNetworkInfoArray تحت کلاس‌های زیر بررسی کنید:

GADMediationAdapterBidMachine

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

کد خطا	دامنه	دلیل
۱۰۱	com.google.mediation.bidmachine	پیکربندی سرور فاقد شناسه ناشر مورد نیاز است.
۱۰۲	com.google.mediation.bidmachine	درخواست جمع‌آوری سیگنال پیشنهاد قیمت ناموفق بود زیرا پارامترهای RTB شامل قالب تبلیغ نیستند یا قالب مشخص شده پشتیبانی نمی‌شود.
۱۰۳	com.google.mediation.bidmachine	پیکربندی تبلیغ نامعتبر برای بارگذاری یک تبلیغ.
۱۰۴	com.google.mediation.bidmachine	کیت توسعه نرم‌افزار BidMachine، تبلیغ غیر بنری را به متد نماینده BidMachineAdProtocol didLoadAd برمی‌گرداند. این اتفاق هرگز نباید رخ دهد.
۱۰۵	com.google.mediation.bidmachine	تبلیغ تمام صفحه برای نمایش آماده نیست.
۱۰۶	com.google.mediation.bidmachine	کیت توسعه نرم‌افزار Bid Machine، تبلیغ غیربومی را به متد نماینده BidMachineAdProtocol didLoadAd برمی‌گرداند. این اتفاق هرگز نباید رخ دهد.
۱۰۷	com.google.mediation.bidmachine	بارگیری یکی از منابع تصویر تبلیغات بومی ناموفق بود.

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

نسخه ۳.۷.۰.۰

• سازگاری تأیید شده با BidMachine SDK نسخه 3.7.0.

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

• نسخه ۱۳.۴.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• نسخه ۳.۷.۰ کیت توسعه نرم‌افزار BidMachine.

نسخه ۳.۶.۱.۱

• آداپتور اکنون پرچم ageRestrictedTreatment Google Mobile Ads SDK را به COPPA API مربوط به BidMachine SDK ارسال می‌کند.
• آداپتور BidMachine و تست‌های واحد را به Swift 6 ارتقا دهید.

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

• نسخه ۱۳.۳.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• نسخه ۳.۶.۱ کیت توسعه نرم‌افزار BidMachine.

نسخه ۳.۶.۱.۰

• سازگاری تأیید شده با BidMachine SDK نسخه ۳.۶.۱.

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

• نسخه ۱۳.۲.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• نسخه ۳.۶.۱ کیت توسعه نرم‌افزار BidMachine.

نسخه ۳.۶.۰.۰

• سازگاری تأیید شده با BidMachine SDK نسخه ۳.۶.۰.
• بارگذاری بنر تبلیغاتی BidMachine و مدیریت تصویر تبلیغات بومی اصلاح‌شده.

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

• نسخه ۱۳.۱.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• نسخه ۳.۶.۰ کیت توسعه نرم‌افزار BidMachine.

نسخه ۳.۵.۱.۲

• وابستگی SDK تبلیغات موبایل گوگل به نسخه ۱۳.۰.۰ به‌روزرسانی شد.

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

• نسخه ۱۳.۰.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• نسخه ۳.۵.۱ کیت توسعه نرم‌افزار BidMachine.

نسخه ۳.۵.۱.۱

• حداقل نسخه iOS برنامه CocoaPods به 13.0 به‌روزرسانی شد.
• پشتیبانی از ارسال پارامتر tagForUnderAgeOfConsent برای SDK تبلیغات موبایل گوگل به SDK مربوط به BidMachine اضافه شد.
• بخش‌های مربوط به انطباق BidMachineAdDelegate اصلاح شدند تا با رفتار فراخوانی BidMachine SDK همسو شوند.

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

• نسخه ۱۳.۰.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• نسخه ۳.۵.۱ کیت توسعه نرم‌افزار BidMachine.

نسخه ۳.۵.۱.۰

• سازگاری تأیید شده با BidMachine SDK نسخه 3.5.1.

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

• نسخه ۱۲.۱۴.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• نسخه ۳.۵.۱ کیت توسعه نرم‌افزار BidMachine.

نسخه ۳.۵.۰.۰

• سازگاری تأیید شده با BidMachine SDK نسخه 3.5.0.

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

• نسخه ۱۲.۱۲.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• نسخه ۳.۵.۰ کیت توسعه نرم‌افزار BidMachine.

نسخه ۳.۴.۰.۲

• پشتیبانی از قالب‌های تبلیغات آبشاری (waterfall) برای بنر، بینابینی، پاداشی و بومی اضافه شد.
• ویژگی استاتیک isTestMode از BidMachineAdapterExtras حذف شد.
• اعتبارسنجی اندازه بنر تبلیغاتی برای بنرهای آبشاری اضافه شد.

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

• نسخه ۱۲.۱۲.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• نسخه ۳.۴.۰ کیت توسعه نرم‌افزار BidMachine.

نسخه ۳.۴.۰.۱

• حالت تست اکنون در Objective-C از طریق ویژگی GADMediationAdapterBidMachineExtras.isTestMode در دسترس است.

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

• نسخه ۱۲.۰.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• نسخه ۳.۴.۰ کیت توسعه نرم‌افزار BidMachine.

نسخه ۳.۴.۰.۰

• انتشار اولیه.
• پشتیبانی از پیشنهاد قیمت برای قالب‌های تبلیغات بنری، بینابینی، پاداشی و بومی اضافه شد.
• سازگاری تأیید شده با BidMachine SDK نسخه ۳.۴.۰.

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

• نسخه ۱۲.۸.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• نسخه ۳.۴.۰ کیت توسعه نرم‌افزار BidMachine.