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

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

این راهنما به شما نشان می‌دهد که چگونه از GMA Next-Gen SDK برای بارگذاری و نمایش تبلیغات از maio با استفاده از mediation استفاده کنید، و ادغام‌های waterfall را پوشش می‌دهد. این راهنما نحوه اضافه کردن maio به پیکربندی mediation یک واحد تبلیغاتی و نحوه ادغام maio SDK و آداپتور آن در یک برنامه اندروید را پوشش می‌دهد.

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

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

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

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

الزامات

  • اندروید API سطح ۲۴ یا بالاتر
  • مایو SDK نسخه ۱.۰.۷ یا بالاتر

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

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

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

بینابینی

نام برنامه خود را وارد کنید، پلتفرم را انتخاب کنید و آدرس اینترنتی برنامه خود را ارائه دهید. نوع تبلیغ را بینابینی ویدیویی انتخاب کنید و سپس روی به‌روزرسانی کلیک کنید.

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

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

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

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

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

مرحله ۲: تنظیم درخواست خرید در رابط کاربری مدیریت تبلیغات

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

وارد حساب مدیر تبلیغات خود شوید.

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

یک نام منحصر به فرد برای گروه yield خود وارد کنید، وضعیت را روی فعال تنظیم کنید، قالب تبلیغ خود را انتخاب کنید و نوع موجودی را روی برنامه موبایل تنظیم کنید. در قسمت Targeting > Inventory ، واحد تبلیغاتی را که می‌خواهید به آن واسطه‌گری اضافه کنید، در قسمت Inventory and Mobile application انتخاب کنید.

سپس، روی دکمه‌ی «افزودن شریک Yield» کلیک کنید.

اگر از قبل یک شریک Yield برای maio دارید، می‌توانید آن را انتخاب کنید. در غیر این صورت، گزینه Create a new yield partner را انتخاب کنید.

maio را به عنوان شبکه تبلیغاتی انتخاب کنید، یک نام منحصر به فرد وارد کنید و Mediation را فعال کنید.

جمع‌آوری خودکار داده‌ها را فعال کنید و شناسه API و کلید API که در بخش قبل به دست آورده‌اید را وارد کنید.

پس از انتخاب شریک Yield ، گزینه Mobile SDK Mediation را به عنوان نوع ادغام ، Android را به عنوان پلتفرم و Active را به عنوان وضعیت انتخاب کنید. شناسه رسانه (Media ID) و شناسه منطقه (Zone ID) که در بخش قبل به دست آورده‌اید را وارد کنید. سپس، یک مقدار CPM پیش‌فرض وارد کنید.

پس از اتمام کار، روی ذخیره در پایین صفحه کلیک کنید.

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

در فایل settings.gradle.kts در سطح پروژه، مخازن زیر را اضافه کنید:

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://imobile-maio.github.io/maven")
    }
  }
}

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

کاتلین 

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02")
    implementation("com.google.ads.mediation:maio:2.0.8.0")
}

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:0.24.0-beta02'
    implementation 'com.google.ads.mediation:maio:2.0.8.0'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

ادغام دستی

  • آخرین نسخه maio Android SDK را دانلود کرده و به پروژه خود اضافه کنید.
  • به بخش مربوط به آداپتور maio در مخزن Maven گوگل بروید. آخرین نسخه را انتخاب کنید، فایل `.aar` آداپتور maio را دانلود کنید و آن را به پروژه خود اضافه کنید.

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

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

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

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

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

ناشرانی که از نسخه ۱۱.۶.۰ یا بالاتر GMA Next-Gen SDK استفاده می‌کنند، هنگام درخواست، به‌طور خودکار تبلیغات آزمایشی را از maio روی تلفن‌ها و تبلت‌هایی که به‌عنوان دستگاه‌های آزمایشی ثبت شده‌اند، دریافت خواهند کرد.

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

برای تأیید اینکه تبلیغات آزمایشی را از maio دریافت می‌کنید، آزمایش منبع تبلیغاتی واحد را در ad inspector با استفاده از منبع(های ) تبلیغاتی maio (Waterfall ) فعال کنید.

کدهای خطا

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

قالب نام کلاس
بینابینی jp.maio.sdk.android.mediation.admob.adapter.interstitial
پاداش داده شده jp.maio.sdk.android.mediation.admob.adapter.Rewarded

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

کد خطا دلیل
۰-۱۰ maio یک خطای مختص SDK را برگرداند. برای جزئیات بیشتر به کد و مستندات maio مراجعه کنید.
۱۰۱ مایو هیچ تبلیغی در دسترس ندارد.
۱۰۲ پارامترهای سرور نامعتبر است (مثلاً شناسه قرارگیری وجود ندارد).
۱۰۳ زمینه‌ای که برای بارگذاری یک تبلیغ استفاده شده، نمونه‌ای از «فعالیت» نبوده است.