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

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

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

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

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

The mediation adapter for maio has the following capabilities:

ادغام
مناقصه
آبشار
قالب‌ها
بنر
بینابینی
پاداش داده شده
بومی

الزامات

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

مرحله ۱: تنظیمات را در رابط کاربری maio تنظیم کنید

First, sign up or log in to your maio account. Click the Application management button on the left sidebar and click on New app .

Select the tab corresponding to your preferred Ad Type .

بینابینی

Enter the Name of your app, select the platform and provide your App URL . Select Video interstitial as the Ad Type , and then click Update .

پاداش داده شده

Enter the Name of your app, select the platform and provide your App URL . Select Video Rewards as the Ad Type , and then click Update .

In the Application Management page, make a note of the Media ID . It's needed to set up your AdMob ad unit in the next section.

In the Zone Management page, make a note of the Zone ID . It will also be needed to set up your AdMob ad unit in the next section.

(Waterfall only) In addition to Media ID and Zone ID , you will need API ID and API KEY to set up your ad unit ID for mediation. In Reporting API page , make a note of API ID and API KEY .

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

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

You need to add maio to the mediation configuration for your ad unit.

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

برای ایجاد یک گروه میانجیگری جدید، گزینه «ایجاد گروه میانجیگری» را انتخاب کنید.

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

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

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

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

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


در زیر کارت Waterfall در بخش Ad Sources ، گزینه Add Ad Source را انتخاب کنید.

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



If you already have a mapping for maio, you can select it. Otherwise, click Add mapping .

Next, enter the Media ID and Zone ID obtained in the previous section. Then click Done .


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

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

Before you continue, you must have the minimum supported adapter version 2.2.0.0.

To add a package dependency to your project, follow these steps:

  1. In Xcode, navigate to File > Add Package Dependencies... .

  2. In the prompt that appears, search the following package URL:

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

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

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

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

  • Add the following line to your project's Podfile:

    pod 'GoogleMobileAdsMediationMaio'

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

    pod install --repo-update

ادغام دستی

  • آخرین نسخه maio SDK را دانلود کنید.
  • Download the latest version of the maio adapter from the download link in the Changelog , and link maioAdapter.framework in your project.

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

پیاده‌سازی SKAdNetwork

Follow maio's documentation to add the SKAdNetwork identifiers to your project's Info.plist file.

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

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

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

Publishers using version 7.26.0 or higher of Google Mobile Ads SDK will automatically receive test ads from maio on phones and tablets registered as test devices when making requests.

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

To verify that you are receiving test ads from maio, enable single ad source testing in ad inspector using the maio (Waterfall) ad source(s).

کدهای خطا

If the adapter fails to receive an ad from maio, publishers can check the underlying error from the ad response using GADResponseInfo.adNetworkInfoArray under the following classes:

قالب نام کلاس
بینابینی آداپتور بینابینی GADMMaio
پاداش داده شده آداپتور پاداشی GADMMaio

Here are the codes and accompanying messages thrown by the maio adapter when an ad fails to load:

کد خطا دلیل
۰-۱۰ maio returned an SDK-specific error. See maio's code for more details.
۱۰۱ maio هنوز تبلیغی در دسترس ندارد.
۱۰۲ Invalid server parameters (eg missing Placement ID).
۱۰۳ The maio adapter does not support the ad format being requested.
۱۰۴ An ad is already loaded for this network configuration.

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

نسخه ۲.۲.۰.۳

  • پشتیبانی از بنرهای تبلیغاتی آبشاری اضافه شد.
  • Updated the Google Mobile Ads SDK dependency to version 13.0.0.

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

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

نسخه ۲.۲.۰.۲

  • Updated the CocoaPods minimum iOS version to 13.0 .

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

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

نسخه ۲.۲.۰.۱

  • Removed bidding implementation since Maio no longer supports bidding.
  • Update the adapter to use the GADMediationAdapter protocol.

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

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

نسخه ۲.۲.۰.۰

  • Verified compatibility with maio SDK version 2.2.0.

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

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

نسخه ۲.۱.۶.۱

  • Now requires Google Mobile Ads SDK version 12.0.0 or higher.

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

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

نسخه ۲.۱.۶.۰

  • Verified compatibility with maio SDK version 2.1.6.

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

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

نسخه ۲.۱.۵.۱

  • Updated CFBundleShortVersionString to have three components instead of four.

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

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

نسخه ۲.۱.۵.۰

  • Verified compatibility with maio SDK version 2.1.5.

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

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

نسخه ۲.۱.۴.۰

  • Verified compatibility with maio SDK version 2.1.4.

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

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

نسخه ۲.۱.۳.۰

  • Verified compatibility with maio SDK version 2.1.3.

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

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

نسخه ۲.۱.۲.۱

  • Now requires Google Mobile Ads SDK version 11.0 or higher.
  • Included Info.plist in the frameworks within MaioAdapter.xcframework .

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

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

نسخه ۲.۱.۲.۰

  • Verified compatibility with maio SDK version 2.1.2.

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

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

نسخه ۲.۱.۱.۰

  • Verified compatibility with maio SDK version 2.1.1.

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

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

نسخه ۲.۰.۰.۰

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

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

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

نسخه ۱.۶.۳.۱

  • Now requires Google Mobile Ads SDK version 10.0.0 or higher.

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

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

نسخه ۱.۶.۳.۰

  • Updated the adapter to use the didRewardUser API.
  • Now requires Google Mobile Ads SDK version 9.8.0 or higher.
  • Verified compatibility with maio SDK version 1.6.3 and maioOB SDK version 2.0.0-alpha.

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

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

نسخه ۱.۶.۲.۰

  • Verified compatibility with maio SDK version 1.6.2 and maioOB SDK version 2.0.0-alpha.

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

  • نسخه ۹.۵.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۱.۶.۲ کیت توسعه نرم‌افزاری مایو.
  • نسخه ۲.۰.۰-آلفا از MaioOB SDK.

نسخه ۱.۶.۱.۰

  • Verified compatibility with maio SDK version 1.6.1 and maioOB SDK version 2.0.0-alpha.

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

  • نسخه ۹.۲.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۱.۶.۱ کیت توسعه نرم‌افزار مایو.
  • نسخه ۲.۰.۰-آلفا از MaioOB SDK.

نسخه ۱.۶.۰.۱

  • Verified compatibility with Google Mobile Ads SDK version 9.0.0.
  • Now requires Google Mobile Ads SDK version 9.0.0 or higher.

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

  • نسخه ۹.۰.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۱.۶.۰ کیت توسعه نرم‌افزار مایو.
  • نسخه ۲.۰.۰-آلفا از MaioOB SDK.

نسخه ۱.۶.۰.۰

  • Verified compatibility with maio SDK version 1.6.0 and maioOB SDK version 2.0.0-alpha.

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

  • نسخه ۸.۱۳.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • اکنون به حداقل نسخه iOS 10.0 نیاز دارد.
  • نسخه ۱.۶.۰ کیت توسعه نرم‌افزار مایو.
  • نسخه ۲.۰.۰-آلفا از MaioOB SDK.

نسخه ۱.۵.۸.۰

  • Verified compatibility with maio SDK version 1.5.8 and maioOB SDK version 2.0.0-alpha.
  • Added bidding capability to the adapter for interstitial and rewarded ad formats.
  • Relaxed dependency to Google Mobile Ads SDK version 8.0.0 or higher.

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

  • نسخه ۸.۷.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۱.۵.۸ کیت توسعه نرم‌افزاری مایو.
  • نسخه ۲.۰.۰-آلفا از MaioOB SDK.

نسخه ۱.۵.۶.۱

  • Added standardized adapter error codes and messages.
  • Updated the adapter to use the .xcframework format.
  • Fixed a bug where rewarded ad events were sometimes not forwarded.
  • Now requires Google Mobile Ads SDK version 8.3.0 or higher.

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

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

نسخه ۱.۵.۶.۰

  • Verified compatibility with maio SDK version 1.5.6.
  • Now requires Google Mobile Ads SDK version 7.68.0 or higher.

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

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

نسخه ۱.۵.۵.۰

  • Verified compatibility with maio SDK version 1.5.5.
  • Now requires Google Mobile Ads SDK version 7.64.0 or higher.

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

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

نسخه ۱.۵.۴.۰

  • Verified compatibility with maio SDK version 1.5.4.
  • Now requires Google Mobile Ads SDK version 7.60.0 or higher.

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

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

نسخه ۱.۵.۳.۱

  • To limit timeouts, ad requests will now immediately fail if maio does not have an ad ready to be shown.
  • پشتیبانی از معماری i386 حذف شد.

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

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

نسخه ۱.۵.۳.۰

  • Verified compatibility with maio SDK version 1.5.3.

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

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

نسخه ۱.۵.۲.۱

  • Fixed an issue where the adapter was not invoking the -rewardedAdDidPresent: callback.

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

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

نسخه ۱.۵.۲.۰

  • Verified compatibility with maio SDK version 1.5.2.

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

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

نسخه ۱.۵.۱.۰

  • Verified compatibility with maio SDK version 1.5.1.

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

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

نسخه ۱.۵.۰.۰

  • Verified compatibility with maio SDK version 1.5.0.

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

  • نسخه ۷.۵۱.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۱.۵.۰ کیت توسعه نرم‌افزاری (SDK) مایو ادز.

نسخه ۱.۴.۸.۰

  • Verified compatibility with maio SDK version 1.4.8.

نسخه ۱.۴.۶.۰

  • Verified compatibility with maio SDK version 1.4.6.
  • آداپتور را به‌روزرسانی کردیم تا از API پاداش‌دهی‌شده جدید استفاده کند.
  • Now requires Google Mobile Ads SDK version 7.42.2 or higher.

نسخه ۱.۴.۲.۰

  • Verified compatibility with maio SDK version 1.4.2.

نسخه ۱.۴.۱.۰

  • Verified compatibility with maio SDK version 1.4.1.
  • Fixed an issue where maio adapter might fail if multiple MediaIds are provided from AdMob.

نسخه ۱.۴.۰.۰

  • Verified compatibility with maio SDK version 1.4.0.

نسخه ۱.۳.۲.۰

  • Verified compatibility with maio SDK version 1.3.2.

نسخه ۱.۳.۱.۱

  • Added adapterDidCompletePlayingRewardBasedVideoAd: callback to the adapter.

نسخه ۱.۳.۱.۰

  • Verified compatibility with maio SDK version 1.3.1.

نسخه ۱.۳.۰.۰

  • Verified compatibility with maio SDK version 1.3.0.

نسخه ۱.۲.۱۹.۰

  • Verified compatibility with maio SDK version 1.2.19.

نسخه ۱.۲.۱۸.۰

  • اولین انتشار!
  • Added support for interstitials and rewarded videos ads.