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

پلتفرم مورد نظر را انتخاب کنید: اندروید (بتا)جدید اندروید، iOS، یونیتی ، فلاتر

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

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

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

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

۱- ادغام پیشنهاد قیمت در مرحله بتای بسته است، برای درخواست دسترسی با مدیر حساب خود تماس بگیرید.

۲- فرمت تبلیغات بومی در مرحله آلفا است. سایر فرمت‌های تبلیغاتی پشتیبانی‌شده در مرحله بتا هستند. برای درخواست دسترسی با مدیر حساب خود تماس بگیرید.

الزامات

  • آخرین Google Mobile Ads Flutter Plugin
  • فلاتر ۳.۷.۰ یا بالاتر
  • برای نصب روی اندروید
    • اندروید API سطح ۲۳ یا بالاتر
  • برای استقرار در iOS
    • هدف استقرار iOS 13.0 یا بالاتر
  • یک پروژه Flutter فعال که با Google Mobile Ads Flutter Plugin پیکربندی شده است. برای جزئیات بیشتر به بخش «شروع به کار» مراجعه کنید.
  • راهنمای شروع میانجیگری را تکمیل کنید

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

وارد داشبورد حساب کاربری BidMachine خود شوید .

ایجاد جایگاه‌های جدید

به برگه منبع بروید و در زیر جدول منابع ، دکمه ویرایش را انتخاب کنید.

داشبورد منابع

لیستی از تمام جایگاه‌های موجود به شما نشان داده خواهد شد. برای ایجاد یک جایگاه جدید، روی دکمه «افزودن جایگاه» در پنجره گفتگو کلیک کنید.

ویرایش دیالوگ منبع

فرم را پر کنید و روی ذخیره کلیک کنید.

اندروید

ایجاد جایگاه اندروید

آی‌او‌اس

ایجاد جایگاه iOS

در نهایت، شناسه‌ی محل قرارگیری را یادداشت کنید.

اندروید

جزئیات قرارگیری اندروید

آی‌او‌اس

جزئیات قرارگیری در iOS

فایل app-ads.txt خود را به‌روزرسانی کنید.

فروشندگان مجاز برنامه‌ها app-ads.txt یک ابتکار آزمایشگاه فناوری IAB است که به شما کمک می‌کند تا موجودی تبلیغات برنامه خود را فقط از طریق کانال‌هایی که به عنوان مجاز شناسایی کرده‌اید، به فروش برسانید. برای جلوگیری از کاهش قابل توجه درآمد تبلیغات، باید یک فایل app-ads.txt پیاده‌سازی کنید. اگر قبلاً این کار را نکرده‌اید، یک فایل app-ads.txt برای برنامه خود تنظیم کنید .

برای پیاده‌سازی app-ads.txt برای BidMachine، از داشبورد به تب app-ads.txt بروید. سپس، لیست را کپی کرده و آن را به فایل app-ads.txt وب‌سایت خود اضافه کنید.

مرحله 2: تنظیم تقاضای BidMachine در رابط کاربری AdMob

تنظیمات میانجیگری را برای واحد تبلیغاتی خود پیکربندی کنید

اندروید

برای دستورالعمل‌ها، به مرحله ۲ در راهنمای اندروید مراجعه کنید.

آی‌او‌اس

برای دستورالعمل‌ها، به مرحله ۲ در راهنمای iOS مراجعه کنید.

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

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

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

ادغام از طریق pub.dev

وابستگی زیر را به همراه آخرین نسخه‌های SDK و آداپتور BidMachine در فایل pubspec.yaml پکیج خود اضافه کنید:

dependencies:
  gma_mediation_bidmachine: ^1.3.0

ادغام دستی

آخرین نسخه افزونه میانجیگری تبلیغات موبایلی گوگل را برای BidMachine دانلود کنید، فایل دانلود شده را استخراج کنید و پوشه افزونه استخراج شده (و محتویات آن) را به پروژه Flutter خود اضافه کنید. سپس با اضافه کردن وابستگی زیر، افزونه را در فایل pubspec.yaml خود ارجاع دهید:

dependencies:
  gma_mediation_bidmachine:
    path: path/to/local/package

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

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

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

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

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

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

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

اندروید

هیچ کد اضافی برای ادغام BidMachine لازم نیست.

آی‌او‌اس

ادغام شبکه SKAd

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

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

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

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

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

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

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

کدهای خطا

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

اندروید 

io.bidmachine
com.google.ads.mediation.bidmachine

آی‌او‌اس 

GADMediationAdapterBidMachine

در اینجا کدها و پیام‌های همراه که توسط آداپتور 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 ) برگرداند.

آی‌او‌اس

کد خطا دامنه دلیل
۱۰۱ 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 بارگیری یکی از منابع تصویر تبلیغات بومی ناموفق بود.

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

نسخه ۱.۳.۱ (در حال انجام)

نسخه ۱.۳.۰

نسخه ۱.۲.۰

نسخه ۱.۱.۰

نسخه ۱.۰.۰