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

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

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

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

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

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

الزامات

  • جدیدترین SDK تبلیغات موبایل گوگل
  • فلاتر 3.7.0 یا بالاتر
  • برای استقرار در اندروید
    • Android API سطح 23 یا بالاتر
  • برای استقرار در iOS
    • هدف استقرار iOS 12.0 یا بالاتر
  • یک پروژه Flutter در حال کار که با Google Mobile Ads SDK پیکربندی شده است. برای جزئیات بیشتر به شروع به کار مراجعه کنید.
  • راهنمای شروع میانجیگری را کامل کنید

مرحله 1: تنظیمات را در i-mobile UI تنظیم کنید

ثبت نام کنید یا به حساب آی موبایل خود وارد شوید .

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

اندروید

iOS

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

اندروید

iOS

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

اندروید

iOS

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

create_ad_spot

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

new_ad_spot_form

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

ad_spot_list

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

اندروید

iOS

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

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

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

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

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

اندروید

برای دستورالعمل‌ها، به مرحله 2 در راهنمای Android مراجعه کنید.

iOS

برای دستورالعمل‌ها، مرحله 2 را در راهنمای iOS ببینید.

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

ادغام از طریق pub.dev

وابستگی زیر را با آخرین نسخه های i-mobile SDK و آداپتور در فایل pubspec.yaml بسته خود اضافه کنید:

dependencies:
  gma_mediation_imobile: ^

ادغام دستی

آخرین نسخه افزونه میانجی گری تبلیغات موبایل گوگل را برای i-mobile دانلود کنید، فایل دانلود شده را استخراج کنید و پوشه افزونه استخراج شده (و محتویات آن) را به پروژه Flutter خود اضافه کنید. سپس با افزودن وابستگی زیر به پلاگین موجود در فایل pubspec.yaml خود مراجعه کنید:

dependencies:
  gma_mediation_imobile:
    path: path/to/local/package

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

اندروید

هیچ کد اضافی مورد نیاز برای ادغام i-mobile نیست.

iOS

ادغام SKAdNetwork

برای افزودن شناسه های SKAdNetwork به فایل Info.plist پروژه خود ، مستندات i-mobile را دنبال کنید.

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

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

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

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

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

کدهای خطا

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

اندروید

قالب نام کلاس
بنر com.google.ads.mediation.imobile.IMobileAdapter
بینابینی com.google.ads.mediation.imobile.IMobileAdapter
بومی com.google.ads.mediation.imobile.IMobileMediationAdapter

iOS

قالب نام کلاس
بنر آداپتور IMobile
بینابینی آداپتور IMobile
بومی GADMediationAdapterIMmobile

در اینجا کدها و پیام‌های همراهی که توسط آداپتور i-mobile پرتاب می‌شود، در صورت عدم بارگیری آگهی آمده است:

اندروید

کد خطا دلیل
0-99 i-mobile SDK یک خطا را نشان داد. برای جزئیات بیشتر به کد مراجعه کنید.
101 i-mobile برای بارگیری تبلیغات به یک زمینه Activity نیاز دارد.
102 پارامترهای سرور i-mobile پیکربندی شده در رابط کاربری Ad Manager وجود ندارد یا نامعتبر است.
103 اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده از i-mobile مطابقت ندارد.
104 پاسخ به تماس موفقیت آمیز بارگیری آگهی بومی i-mobile یک لیست تبلیغات بومی خالی را برگرداند.

iOS

کد خطا دلیل
0-10 i-mobile SDK یک خطا را نشان داد. برای جزئیات بیشتر به کد مراجعه کنید.
101 پارامترهای سرور i-mobile پیکربندی شده در رابط کاربری Ad Manager وجود ندارد یا نامعتبر است.
102 اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده از i-mobile مطابقت ندارد.
103 i-mobile موفق به ارائه آگهی نشد.
104 i-mobile یک آرایه تبلیغاتی بومی خالی را برگرداند.
105 i-mobile در دانلود دارایی های تبلیغاتی بومی شکست خورد.
106 i-mobile از درخواست چندین آگهی بینابینی با استفاده از همان Spot ID پشتیبانی نمی کند.

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

نسخه 1.0.1

نسخه 1.0.0