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

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

رابط داشبورد برای maio از متن ژاپنی برای برچسب‌ها، دکمه‌ها و توضیحات خود استفاده می‌کند و اسکرین‌شات‌های این راهنما ترجمه نشده‌اند. اما در توضیحات و دستورالعمل های این راهنما، برچسب ها و دکمه ها با معادل های زبان انگلیسی خود ارجاع داده شده اند. برای مثال "URL スキーム"، "URL Scheme" است.

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

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

یکپارچه سازی
مناقصه
آبشار
فرمت ها
بنر
بینابینی
پاداش داده شد
بومی

الزامات

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

  • جدیدترین SDK تبلیغات موبایل گوگل

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

مرحله 1: تنظیمات را در maio UI تنظیم کنید

ابتدا ثبت نام کنید یا وارد حساب کاربری maio خود شوید . روی دکمه مدیریت برنامه در نوار کناری سمت چپ کلیک کنید و روی برنامه جدید کلیک کنید.

برگه مربوط به نوع تبلیغ دلخواه خود را انتخاب کنید.

بینابینی

نام برنامه خود را وارد کنید، پلتفرم را انتخاب کنید و URL برنامه خود را ارائه دهید. Video interstitial را به عنوان نوع آگهی انتخاب کنید و سپس روی Update کلیک کنید.

پاداش داده شد

نام برنامه خود را وارد کنید، پلتفرم را انتخاب کنید و URL برنامه خود را ارائه دهید. Video Rewards را به عنوان نوع تبلیغ انتخاب کنید و سپس روی Update کلیک کنید.

در صفحه مدیریت برنامه ، شناسه رسانه را یادداشت کنید. برای راه‌اندازی واحد تبلیغات AdMob خود در بخش بعدی لازم است.

در صفحه مدیریت منطقه ، شناسه منطقه را یادداشت کنید. همچنین لازم است واحد تبلیغات AdMob خود را در بخش بعدی تنظیم کنید.

(فقط آبشار) علاوه بر شناسه رسانه و شناسه منطقه ، به شناسه API و API KEY برای تنظیم شناسه واحد تبلیغات خود برای میانجیگری نیاز دارید. در صفحه گزارش API ، شناسه API و کلید API را یادداشت کنید.

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

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

شما باید maio را به پیکربندی میانجی برای واحد تبلیغات خود اضافه کنید.

ابتدا وارد حساب AdMob خود شوید. سپس به تب Mediation بروید. اگر گروه میانجی موجودی دارید که می‌خواهید آن را تغییر دهید، روی نام آن گروه میانجی کلیک کنید تا آن را ویرایش کنید و به افزودن maio به عنوان منبع آگهی بروید.

برای ایجاد یک گروه میانجی جدید، Create Mediation Group را انتخاب کنید.

قالب و پلتفرم تبلیغ خود را وارد کنید، سپس روی Continue کلیک کنید.

به گروه میانجی خود یک نام بدهید و مکان‌هایی را برای هدف انتخاب کنید. سپس، وضعیت گروه میانجی را روی Enabled تنظیم کنید و سپس روی Add Units Ad Units کلیک کنید.

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

اکنون باید کارت واحدهای تبلیغاتی را با واحدهای تبلیغاتی که انتخاب کرده‌اید مشاهده کنید:

maio را به عنوان منبع تبلیغ اضافه کنید


در زیر کارت Waterfall در بخش Ad Sources ، Add Source Ad را انتخاب کنید. سپس maio را انتخاب کنید.

maio را انتخاب کرده و سوئیچ Optimize را فعال کنید. شناسه API و API KEY به دست آمده در بخش قبل را وارد کنید تا بهینه سازی منبع تبلیغات را برای maio تنظیم کنید. سپس یک مقدار eCPM برای maio وارد کنید و روی Continue کلیک کنید.



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

بعد Media ID و Zone ID بدست آمده در قسمت قبل را وارد کنید. سپس روی Done کلیک کنید.


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

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

    pod 'GoogleMobileAdsMediationMaio'

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

    pod install --repo-update

ادغام دستی

  • آخرین نسخه maio SDK را دانلود کنید.
  • آخرین نسخه آداپتور maio را از لینک دانلود در Changelog دانلود کنید و maioAdapter.framework در پروژه خود پیوند دهید.

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

ادغام SKAdNetwork

مستندات maio را دنبال کنید تا شناسه های SKAdNetwork را به فایل Info.plist پروژه خود اضافه کنید.

مرحله 5: اجرای خود را آزمایش کنید

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

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

ناشرانی که از نسخه 7.26.0 یا بالاتر از Google Mobile Ads SDK استفاده می‌کنند، هنگام درخواست، به‌طور خودکار آگهی‌های آزمایشی را از maio در تلفن‌ها و رایانه‌های لوحی ثبت‌شده به‌عنوان دستگاه‌های آزمایشی دریافت می‌کنند.

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

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

کدهای خطا

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

قالب نام کلاس
بینابینی GADMMaioInterstitialAdapter
پاداش داده شد GADMMaioRewardedAdapter

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

کد خطا دلیل
0-10 maio یک خطای خاص SDK را برگرداند. برای جزئیات بیشتر به کد maio مراجعه کنید.
101 maio هنوز تبلیغی در دسترس ندارد.
102 پارامترهای سرور نامعتبر (به عنوان مثال شناسه مکان وجود ندارد).
103 آداپتور maio از قالب آگهی درخواستی پشتیبانی نمی کند.
104 یک آگهی قبلاً برای این پیکربندی شبکه بارگیری شده است.

maio iOS Mediation Adapter Changelog

نسخه 2.1.5.1

  • CFBundleShortVersionString به‌روزرسانی کرد تا به جای چهار مؤلفه، سه مؤلفه داشته باشد.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 11.10.0.
  • Maio SDK نسخه 2.1.5.

نسخه 2.1.5.0

  • سازگاری تایید شده با maio SDK نسخه 2.1.5.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 11.6.0.
  • Maio SDK نسخه 2.1.5.

نسخه 2.1.4.0

  • سازگاری تایید شده با maio SDK نسخه 2.1.4.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 11.2.0.
  • Maio SDK نسخه 2.1.4.

نسخه 2.1.3.0

  • سازگاری تایید شده با maio SDK نسخه 2.1.3.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 11.1.0.
  • Maio SDK نسخه 2.1.3.

نسخه 2.1.2.1

  • اکنون به Google Mobile Ads SDK نسخه 11.0 یا بالاتر نیاز دارد.
  • شامل Info.plist در چارچوب های موجود در MaioAdapter.xcframework .

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 11.0.1.
  • Maio SDK نسخه 2.1.2.

نسخه 2.1.2.0

  • سازگاری تایید شده با maio SDK نسخه 2.1.2.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 10.14.0.
  • Maio SDK نسخه 2.1.2.

نسخه 2.1.1.0

  • سازگاری تایید شده با maio SDK نسخه 2.1.1.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 10.12.0.
  • Maio SDK نسخه 2.1.1.

نسخه 2.0.0.0

  • سازگاری تایید شده با maio SDK نسخه 2.0.0.
  • وابستگی به MaioOB SDK حذف شد.
  • پشتیبانی از معماری armv7 حذف شد.
  • اکنون به حداقل نسخه iOS 12.0 نیاز دارد.
  • اکنون به Google Mobile Ads SDK نسخه 10.4.0 یا بالاتر نیاز دارد.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 10.10.0.
  • Maio SDK نسخه 2.0.0.

نسخه 1.6.3.1

  • اکنون به Google Mobile Ads SDK نسخه 10.0.0 یا بالاتر نیاز دارد.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 10.0.0.
  • Maio SDK نسخه 1.6.3.
  • MaioOB SDK نسخه 2.0.0-alpha.

نسخه 1.6.3.0

  • آداپتور را برای استفاده از didRewardUser API به روز کرد.
  • اکنون به Google Mobile Ads SDK نسخه 9.8.0 یا بالاتر نیاز دارد.
  • سازگاری تأیید شده با maio SDK نسخه 1.6.3 و maioOB SDK نسخه 2.0.0-alpha.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 9.12.0.
  • Maio SDK نسخه 1.6.3.
  • MaioOB SDK نسخه 2.0.0-alpha.

نسخه 1.6.2.0

  • سازگاری تأیید شده با maio SDK نسخه 1.6.2 و maioOB SDK نسخه 2.0.0-alpha.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 9.5.0.
  • Maio SDK نسخه 1.6.2.
  • MaioOB SDK نسخه 2.0.0-alpha.

نسخه 1.6.1.0

  • سازگاری تایید شده با maio SDK نسخه 1.6.1 و maioOB SDK نسخه 2.0.0-alpha.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 9.2.0.
  • Maio SDK نسخه 1.6.1.
  • MaioOB SDK نسخه 2.0.0-alpha.

نسخه 1.6.0.1

  • سازگاری تأیید شده با Google Mobile Ads SDK نسخه 9.0.0.
  • اکنون به Google Mobile Ads SDK نسخه 9.0.0 یا بالاتر نیاز دارد.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 9.0.0.
  • Maio SDK نسخه 1.6.0.
  • MaioOB SDK نسخه 2.0.0-alpha.

نسخه 1.6.0.0

  • سازگاری تأیید شده با maio SDK نسخه 1.6.0 و maioOB SDK نسخه 2.0.0-alpha.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 8.13.0.
  • اکنون به حداقل نسخه iOS 10.0 نیاز دارد.
  • Maio SDK نسخه 1.6.0.
  • MaioOB SDK نسخه 2.0.0-alpha.

نسخه 1.5.8.0

  • سازگاری تأیید شده با maio SDK نسخه 1.5.8 و maioOB SDK نسخه 2.0.0-alpha.
  • قابلیت پیشنهاد قیمت به آداپتور برای قالب‌های تبلیغاتی بینابینی و پاداش اضافه شده است.
  • وابستگی آرام به Google Mobile Ads SDK نسخه 8.0.0 یا بالاتر.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 8.7.0.
  • Maio SDK نسخه 1.5.8.
  • MaioOB SDK نسخه 2.0.0-alpha.

نسخه 1.5.6.1

  • کدها و پیام های خطای استاندارد آداپتور اضافه شده است.
  • آداپتور را برای استفاده از قالب .xcframework . به روز کرد.
  • رفع اشکالی که در آن رویدادهای تبلیغاتی پاداش داده شده گاهی اوقات بازارسال نمی شدند.
  • اکنون به Google Mobile Ads SDK نسخه 8.3.0 یا بالاتر نیاز دارد.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 8.3.0.
  • Maio SDK نسخه 1.5.6.

نسخه 1.5.6.0

  • سازگاری تایید شده با maio SDK نسخه 1.5.6.
  • اکنون به Google Mobile Ads SDK نسخه 7.68.0 یا بالاتر نیاز دارد.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 7.68.0.
  • Maio SDK نسخه 1.5.6.

نسخه 1.5.5.0

  • سازگاری تایید شده با maio SDK نسخه 1.5.5.
  • اکنون به Google Mobile Ads SDK نسخه 7.64.0 یا بالاتر نیاز دارد.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 7.64.0.
  • Maio SDK نسخه 1.5.5.

نسخه 1.5.4.0

  • سازگاری تایید شده با maio SDK نسخه 1.5.4.
  • اکنون به Google Mobile Ads SDK نسخه 7.60.0 یا بالاتر نیاز دارد.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 7.60.0.
  • Maio SDK نسخه 1.5.4.

نسخه 1.5.3.1

  • برای محدود کردن زمان‌های زمانی، اگر maio آگهی آماده نمایش نداشته باشد، درخواست‌های تبلیغات فوراً با شکست مواجه می‌شوند.
  • پشتیبانی از معماری i386 حذف شد.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 7.58.0.
  • Maio SDK نسخه 1.5.3.

نسخه 1.5.3.0

  • سازگاری تایید شده با maio SDK نسخه 1.5.3.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 7.55.1.
  • Maio SDK نسخه 1.5.3.

نسخه 1.5.2.1

  • مشکلی را که در آن آداپتور -rewardedAdDidPresent: callback را فراخوانی نمی کرد، برطرف شد.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 7.53.1.
  • Maio SDK نسخه 1.5.2.

نسخه 1.5.2.0

  • سازگاری تایید شده با maio SDK نسخه 1.5.2.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 7.53.1.
  • Maio SDK نسخه 1.5.2.

نسخه 1.5.1.0

  • سازگاری تایید شده با maio SDK نسخه 1.5.1.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 7.52.0.
  • Maio SDK نسخه 1.5.1.

نسخه 1.5.0.0

  • سازگاری تایید شده با maio SDK نسخه 1.5.0.

ساخته و تست شده با

  • Google Mobile Ads SDK نسخه 7.51.0.
  • Maio Ads SDK نسخه 1.5.0.

نسخه 1.4.8.0

  • سازگاری تایید شده با maio SDK نسخه 1.4.8.

نسخه 1.4.6.0

  • سازگاری تایید شده با maio SDK نسخه 1.4.6.
  • آداپتور را برای استفاده از API جدید پاداش به روز کرد.
  • اکنون به Google Mobile Ads SDK نسخه 7.42.2 یا بالاتر نیاز دارد.

نسخه 1.4.2.0

  • سازگاری تایید شده با maio SDK نسخه 1.4.2.

نسخه 1.4.1.0

  • سازگاری تایید شده با maio SDK نسخه 1.4.1.
  • اگر چندین MediaId از AdMob ارائه شود، مشکلی برطرف شد که در آن آداپتور maio ممکن است از کار بیفتد.

نسخه 1.4.0.0

  • سازگاری تایید شده با maio SDK نسخه 1.4.0.

نسخه 1.3.2.0

  • سازگاری تایید شده با maio SDK نسخه 1.3.2.

نسخه 1.3.1.1

  • adapterDidCompletePlayingRewardBasedVideoAd: برگشت به آداپتور.

نسخه 1.3.1.0

  • سازگاری تایید شده با maio SDK نسخه 1.3.1.

نسخه 1.3.0.0

  • سازگاری تایید شده با maio SDK نسخه 1.3.0.

نسخه 1.2.19.0

  • سازگاری تایید شده با maio SDK نسخه 1.2.19.

نسخه 1.2.18.0

  • اولین انتشار!
  • پشتیبانی برای تبلیغات ویدیوهای بینابینی و پاداش اضافه شده است.