ادغام i-mobile با واسطه

این راهنما به شما نشان می‌دهد که چگونه از SDK تبلیغات موبایل گوگل برای بارگذاری و نمایش تبلیغات از i-mobile با استفاده از AdMob Mediation استفاده کنید و ادغام‌های waterfall را پوشش می‌دهد. این راهنما نحوه اضافه کردن i-mobile به پیکربندی میانجیگری یک واحد تبلیغاتی و نحوه ادغام SDK و آداپتور i-mobile در یک برنامه اندروید را پوشش می‌دهد.

رابط کاربری داشبورد برای i-mobile از متن ژاپنی برای برچسب‌ها، دکمه‌ها و توضیحات خود استفاده می‌کند. تصاویر موجود در این راهنما ترجمه نشده‌اند. با این حال، در توضیحات و دستورالعمل‌های این راهنما، برچسب‌ها و دکمه‌ها با معادل‌های انگلیسی آنها در داخل پرانتز ترجمه شده‌اند.

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

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

الزامات

• اندروید API سطح ۲۳ یا بالاتر

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

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

مرحله ۱: تنظیمات را در رابط کاربری i-mobile انجام دهید

ثبت نام کنید یا وارد حساب کاربری i-mobile خود شوید .

با کلیک کردن روی تب (مدیریت سایت/برنامه) و دکمه پلت فرم برنامه خود، برنامه خود را به داشبورد i-mobile اضافه کنید.

فرم را پر کنید و روی دکمه新規登録 (ثبت نام) کلیک کنید.

برای ایجاد یک مکان تبلیغاتی جدید، برنامه خود را در زیر تبサイト／アプリ管理 (مدیریت سایت/برنامه) انتخاب کنید.

به تب広告スポット管理 (مدیریت مکان تبلیغات) بروید و روی دکمه新規広告スポット (نقطه تبلیغاتی جدید) کلیک کنید.

سپس، فرم را با ارائه広告スポットサイズ (اندازه آگهی) و سایر جزئیات، پر کنید. سپس، روی دکمه新規登録 (ثبت نام) کلیک کنید.

محل آگهی جدید شما آماده است. برای مشاهده جزئیات ادغام آن، روی دکمهアプリ設定取得 (دریافت تنظیمات برنامه) کلیک کنید.

به شناسه パブリッシャーشناسه (شناسه ناشر) ، شناسه (شناسه رسانه) و شناسه (شناسه نقطه ای) توجه داشته باشید. بعداً هنگام پیکربندی i-mobile برای میانجیگری در رابط کاربری AdMob به این پارامترها نیاز خواهید داشت.

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

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

برای پیاده‌سازی app-ads.txt برای i-mobile، به بخش سوالات متداول مراجعه کنید.

مرحله ۲: تنظیم تقاضای i-mobile در رابط کاربری AdMob

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

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

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

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

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

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

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

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

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

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

ادغام با اندروید استودیو (توصیه می‌شود)

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

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

سپس، در فایل build.gradle.kts سطح برنامه خود، وابستگی‌ها و پیکربندی‌های پیاده‌سازی زیر را اضافه کنید. از آخرین نسخه‌های i-mobile SDK و آداپتور استفاده کنید:

dependencies {
    implementation("com.google.android.gms:play-services-ads:24.7.0")
    implementation("com.google.ads.mediation:imobile:2.3.2.1")
}

ادغام دستی

1. آخرین نسخه i-mobile SDK را دانلود کنید و فایل android-ad-sdk.aar را از پوشه sdk استخراج کرده و به پروژه خود اضافه کنید.

2. به بخش مربوط به آداپتور i-mobile در مخزن Maven گوگل بروید. آخرین نسخه را انتخاب کنید، فایل .aar آداپتور i-mobile را دانلود کنید و آن را به پروژه خود اضافه کنید.

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

بارگذاری تبلیغ با زمینه فعالیت

هنگام بارگذاری قالب‌های تبلیغات بنری، بینابینی، پاداشی و بومی، زمینه Activity ارسال کنید. بدون زمینه فعالیت، بارگذاری تبلیغ با شکست مواجه خواهد شد.

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

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

مطمئن شوید که دستگاه آزمایشی خود را برای AdMob ثبت کرده‌اید . i-mobile برای آزمایش، Test Spot ID ، Media ID و Publisher ID را ارائه می‌دهد که می‌توانید آنها را اینجا پیدا کنید.

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

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

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

استفاده از تبلیغات بومی

رندرینگ آگهی

آداپتور i-mobile توضیحات پیشرفته فیلد تبلیغات بومی زیر را برای یک NativeAd پر می‌کند.

^۱- برای تبلیغات بومی، کیت توسعه نرم‌افزار i-mobile آیکون برنامه را ارائه نمی‌دهد. در عوض، آداپتور i-mobile آیکون برنامه را با یک تصویر شفاف پر می‌کند.

کدهای خطا

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

در اینجا کدها و پیام‌های همراه آداپتور i-mobile که هنگام بارگیری ناموفق یک تبلیغ نمایش داده می‌شوند، آمده است:

تغییرات آداپتور میانجیگری اندروید i-mobile

نسخه ۲.۳.۲.۱

• حداقل سطح API اندروید مورد نیاز به ۲۳ ارتقا یافت.
• حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به ۲۴.۰.۰ به‌روزرسانی شد.

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

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

نسخه ۲.۳.۲.۰

• سازگاری تأیید شده با i-mobile SDK نسخه ۲.۳.۲.

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

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

نسخه ۲.۳.۱.۲

• حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به ۲۳.۰.۰ به‌روزرسانی شد.
• سازگاری تأیید شده با i-mobile SDK نسخه ۲.۳.۱.

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

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

نسخه ۲.۳.۱.۱

• آداپتور برای استفاده از کلاس VersionInfo جدید به‌روزرسانی شد.
• حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به ۲۲.۰.۰ به‌روزرسانی شد.

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

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

نسخه ۲.۳.۱.۰

• سازگاری تأیید شده با i-mobile SDK نسخه ۲.۳.۱.
• حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به ۲۱.۵.۰ به‌روزرسانی شد.

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

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

نسخه ۲.۳.۰.۰

• سازگاری تأیید شده با i-mobile SDK نسخه ۲.۳.۰.
• حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به ۲۱.۳.۰ به‌روزرسانی شد.

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

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

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

• compileSdkVersion و targetSdkVersion به API 31 به‌روزرسانی شدند.
• حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به ۲۱.۰.۰ به‌روزرسانی شد.
• حداقل سطح API اندروید مورد نیاز به ۱۹ ارتقا یافت.

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

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

نسخه ۲.۰.۲۳.۰

• سازگاری تأیید شده با i-mobile SDK نسخه ۲.۰.۲۳.
• حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به 20.5.0 به‌روزرسانی شد.

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

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

نسخه ۲.۰.۲۲.۲

• کدهای خطای استاندارد آداپتور و پیام‌ها اضافه شد.
• حداقل نسخه SDK مورد نیاز برای تبلیغات موبایلی گوگل به 20.1.0 به‌روزرسانی شد.

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

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

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

• حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به 20.0.0 به‌روزرسانی شد.

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

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

نسخه ۲.۰.۲۲.۰

• سازگاری تأیید شده با i-mobile SDK نسخه ۲.۰.۲۲.
• آداپتور به‌روزرسانی شد تا از درخواست‌های بنر تطبیقی ​​درون‌خطی پشتیبانی کند.

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

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

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

• سازگاری تأیید شده با i-mobile SDK نسخه ۲.۰.۲۱.
• حداقل نسخه SDK مورد نیاز برای تبلیغات موبایلی گوگل به ۱۹.۱.۰ به‌روزرسانی شد.
• پشتیبانی از مقیاس‌بندی تبلیغات بنری تطبیقی ​​اضافه شد.

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

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

نسخه ۲.۰.۲۰.۲

• پشتیبانی از اندازه‌های انعطاف‌پذیر بنرهای تبلیغاتی اضافه شد.
• حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به ۱۸.۳.۰ به‌روزرسانی شد.

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

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

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

• آداپتور اکنون نسبت ابعاد mediaContent غیر صفر را برمی‌گرداند.

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

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

نسخه ۲.۰.۲۰.۰

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