i-mobile را با Mediation ادغام کنید

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

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

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

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

الزامات

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

i-mobile را به عنوان شبکه تبلیغاتی انتخاب کنید، یک نام منحصر به فرد وارد کنید و گزینه میانجیگری را فعال کنید.

جمع‌آوری خودکار داده‌ها را فعال کنید و نام کاربری و رمز عبور API را وارد کنید.

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

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

مرحله ۳: 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 را ارسال کنید. بدون زمینه فعالیت، بارگذاری تبلیغ با شکست مواجه خواهد شد.

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

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

مطمئن شوید که دستگاه آزمایشی خود را برای Ad Manager ثبت کرده‌اید . 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 غیر صفر را برمی‌گرداند.

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

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

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

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