ادغام InMobi با واسطه

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

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

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

¹ ادغام مناقصه در نسخه بتا باز است.

² فقط برای واسطه آبشار پشتیبانی می شود.

الزامات

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

مرحله 1: تنظیمات را در InMobi UI تنظیم کنید

برای یک حساب InMobi ثبت نام کنید . هنگام ایجاد حساب کاربری، گزینه Use InMobi SSP with Google Open Bidding را بدون علامت بگذارید.

پس از تأیید حساب شما، وارد شوید .

یک برنامه اضافه کنید

برای افزودن برنامه خود به داشبورد InMobi، روی Inventory > Inventory Settings کلیک کنید.

روی Add Inventory کلیک کنید و کانال Mobile App را از منوی کشویی انتخاب کنید.

شروع به تایپ URL فروشگاه برنامه منتشر شده خود در نوار جستجو کنید و برنامه را از نتایج تکمیل شده خودکار انتخاب کنید. روی Continue کلیک کنید.

اگر برنامه شما منتشر نشده است، روی پیوند دستی کلیک کنید و جزئیات مورد نیاز را وارد کنید. روی Continue کلیک کنید.

تنظیمات App & Website Compliance را مرور کنید و سپس روی Save and Create Placements کلیک کنید.

جایگذاری ها

پس از تنظیم موجودی خود، سیستم شما را به گردش کار ایجاد مکان هدایت می کند.

توجه: اگر سیستم شما را به گردش کار ایجاد مکان هدایت نکرد، به Inventory > Inventory Settings بروید. سپس، اپلیکیشن یا وب‌سایتی را که می‌خواهید برای آن مکان ایجاد کنید، جستجو کنید. روی افزودن مکان کلیک کنید.

مناقصه

توجه: برای دسترسی به پیکربندی پیشنهاد قیمت در داشبورد InMobi با مدیر حساب خود تماس بگیرید.

نوع واحد تبلیغات را انتخاب کنید. یک نام مکان وارد کنید، به ترتیب On و Google Open Bidding for Audience Bidding و Partner را انتخاب کنید و بقیه فرم را پر کنید. پس از اتمام روی Create Placement کلیک کنید.

آبشار

نوع واحد تبلیغات را انتخاب کنید. سپس یک نام مکان را وارد کنید، گزینه Off for Audience Bidding را انتخاب کنید و بقیه فرم را پر کنید. پس از اتمام روی Create Placement کلیک کنید.

پس از ایجاد مکان، جزئیات آن نشان داده می شود. شناسه مکان را که برای راه‌اندازی واحد تبلیغات AdMob شما استفاده می‌شود، یادداشت کنید.

توجه: شناسه قرارگیری InMobi در زیر نام مکان موجود است.

شناسه حساب

شناسه حساب InMobi شما در بخش امور مالی > تنظیمات پرداخت > اطلاعات پرداخت در دسترس است.

کلید API گزارش InMobi را پیدا کنید

مناقصه

این مرحله برای ادغام پیشنهادها لازم نیست.

آبشار

به حساب من > تنظیمات حساب بروید. به برگه API Key بروید و روی Generate API Key کلیک کنید.

ایمیل کاربر مورد نیاز کلید را انتخاب کنید و روی Generate API Key کلیک کنید. یک فایل حاوی کلید API و نام کاربری/نام ورود به سیستم تولید خواهد شد.

فقط سرپرست ناشر حساب می‌تواند یک کلید API برای همه کاربران ایجاد کند. اگر کلید API تولید شده قبلی را فراموش کرده اید، کلید API خود را با نگه داشتن نشانگر روی نامه خود در برگه API Key بازنشانی کنید.

حالت تست را روشن کنید

حالت تست را برای قرار دادن خود در همه نمایش‌های زنده یا فقط دستگاه‌های آزمایشی خاص فعال کنید.

توجه: حالت تست به طور پیش‌فرض برای همه مکان‌ها خاموش است. با این حال، حالت تست را می‌توان برای قرارگیری در همه نمونه‌های برنامه یا فقط برای دستگاه‌هایی که شما مشخص کرده‌اید فعال کرد.

مرحله 2: تقاضای InMobi را در آن تنظیم کنید Ad Manager UI

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

اندروید

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

iOS

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

اضافه کنید InMobi به لیست شرکای تبلیغاتی GDPR و مقررات ایالتی ایالات متحده

برای افزودن InMobi به فهرست شرکای آگهی GDPR و مقررات ایالتی ایالات متحده در رابط کاربری AdMob، مراحل تنظیمات GDPR و تنظیمات مقررات ایالتی ایالات متحده را دنبال کنید.

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

توجه: عدم ادغام نسخه‌های سازگار InMobi و Google Mobile Ads SDK ممکن است منجر به مشکلات ساخت شود.

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

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

dependencies:
  gma_mediation_inmobi: ^1.0.0

ادغام دستی

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

dependencies:
  gma_mediation_inmobi:
    path: path/to/local/package

،

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

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

dependencies:
  gma_mediation_inmobi: ^1.0.0

ادغام دستی

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

dependencies:
  gma_mediation_inmobi:
    path: path/to/local/package

مرحله 4: تنظیمات حریم خصوصی را در InMobi SDK اجرا کنید

رضایت اتحادیه اروپا و GDPR

تحت «خط‌مشی رضایت کاربر اتحادیه اروپا» Google، باید اطمینان حاصل کنید که اطلاعات مشخصی در رابطه با استفاده از شناسه‌های دستگاه و داده‌های شخصی به کاربران منطقه اقتصادی اروپا (EEA) داده می‌شود و از آنها رضایت گرفته می‌شود. این سیاست منعکس کننده الزامات دستورالعمل حریم خصوصی الکترونیک اتحادیه اروپا و مقررات عمومی حفاظت از داده ها (GDPR) است. هنگام درخواست رضایت، باید هر شبکه تبلیغاتی را در زنجیره میانجی خود شناسایی کنید که ممکن است داده‌های شخصی را جمع‌آوری، دریافت یا استفاده کند و اطلاعاتی درباره استفاده هر شبکه ارائه دهد. Google در حال حاضر نمی تواند رضایت کاربر را به طور خودکار به چنین شبکه هایی منتقل کند.

افزونه میانجی‌گری تبلیغات Google Mobile برای InMobi از انتقال اطلاعات رضایت به InMobi SDK پشتیبانی نمی‌کند.

قوانین حفظ حریم خصوصی ایالات متحده

قوانین حفظ حریم خصوصی ایالات متحده مستلزم دادن حق انصراف کاربران از "فروش" "اطلاعات شخصی" خود (همانطور که قانون آن شرایط را تعریف می کند)، با انصراف ارائه شده از طریق پیوند برجسته "اطلاعات شخصی من را نفروش" در "فروش" "صفحه اصلی حزب. راهنمای انطباق با قوانین حریم خصوصی ایالات ایالات متحده، امکان فعال کردن پردازش داده های محدود را برای ارائه تبلیغات Google ارائه می دهد، اما Google نمی تواند این تنظیم را برای هر شبکه تبلیغاتی در زنجیره میانجی شما اعمال کند. بنابراین، شما باید هر یک از شبکه‌های تبلیغاتی را در زنجیره میانجی خود که ممکن است در فروش اطلاعات شخصی شرکت کنند شناسایی کنید و از راهنمایی‌های هر یک از آن شبکه‌ها برای اطمینان از رعایت آن پیروی کنید.

افزونه میانجی‌گری تبلیغات Google Mobile برای InMobi از انتقال اطلاعات رضایت به InMobi SDK پشتیبانی نمی‌کند.

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

اندروید

هیچ کد اضافی مورد نیاز نیست ادغام InMobi.

iOS

ادغام SKAdNetwork

مستندات InMobi را دنبال کنید تا شناسه های SKAdNetwork را به فایل Info.plist پروژه خود اضافه کنید.

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

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

مطمئن شوید که دستگاه آزمایشی خود را برای AdMob ثبت کرده اید و حالت تست را در رابط کاربری InMobi فعال کرده اید .

مهم: قبل از انتشار برنامه، حالت تست AdMob و InMobi را غیرفعال کنید.

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

برای تأیید اینکه آگهی‌های آزمایشی را از InMobi دریافت می‌کنید، با استفاده از منبع(های) آگهی InMobi (مناقصه) و InMobi (آبشار) آزمایش منبع آگهی را در بازرس آگهی فعال کنید.

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

اندروید

مجوزها

برای عملکرد بهینه، InMobi توصیه می‌کند مجوزهای اختیاری زیر را به فایل AndroidManifest.xml برنامه خود اضافه کنید.

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />

می‌توانید به صورت اختیاری این مجوزها را به فایل Plugins/Android/GoogleMobileAdsInMobiMediation/AndroidManifest.xml اضافه کنید.

iOS

برای ادغام iOS نیازی به مراحل اضافی نیست.

کدهای خطا

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

اندروید

com.google.ads.mediation.inmobi.InMobiAdapter
com.google.ads.mediation.inmobi.InMobiMediationAdapter

iOS

GADMAdapterInMobi
GADMediationAdapterInMobi

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

اندروید

کد خطا	دلیل
0-99	خطاهای InMobi SDK. برای جزئیات بیشتر به کد مراجعه کنید.
100	پارامترهای سرور InMobi پیکربندی شده در Ad Manager رابط کاربری موجود نیست/نامعتبر است.
101	راه اندازی InMobi SDK ناموفق بود.
102	اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده InMobi مطابقت ندارد.
103	درخواست آگهی یک درخواست آگهی بومی یکپارچه نیست.
104	تلاش برای درخواست آگهی InMobi بدون مقداردهی اولیه InMobi SDK. این در تئوری هرگز نباید اتفاق بیفتد زیرا آداپتور InMobi SDK را قبل از درخواست تبلیغات InMobi مقداردهی اولیه می‌کند.
105	تبلیغ InMobi هنوز آماده نمایش نیست.
106	InMobi موفق به نمایش آگهی نشد.
107	InMobi یک آگهی بومی را که دارایی مورد نیاز را ندارد، برگرداند.
108	دارایی های تصویر تبلیغاتی بومی InMobi حاوی یک URL نادرست است.
109	آداپتور نتوانست دارایی های تصویر تبلیغاتی بومی InMobi را دانلود کند.

iOS

کد خطا	دلیل
101	پارامترهای سرور InMobi پیکربندی شده در Ad Manager رابط کاربری موجود نیست/نامعتبر است.
102	آداپتور InMobi از قالب آگهی درخواستی پشتیبانی نمی کند.
103	یک تبلیغ InMobi قبلاً برای این پیکربندی شبکه بارگیری شده است.
دیگر	InMobi SDK یک خطا برگرداند. برای جزئیات بیشتر به IMRequestStatus.h مراجعه کنید.

تغییرات آداپتور InMobi Flutter Mediation

نسخه بعدی

• ساخته و آزمایش شده با Google Mobile Ads Flutter Plugin نسخه 5.2.0.

1.1.0

• سازگاری تایید شده با آداپتور اندروید InMobi نسخه 10.7.5.0.
• سازگاری تأیید شده با آداپتور InMobi iOS نسخه 10.7.5.0.
• با افزونه Flutter Ads Google Mobile نسخه 5.1.0 ساخته و آزمایش شده است.

1.0.0

• انتشار اولیه
• سازگاری تایید شده با آداپتور اندروید InMobi نسخه 10.6.7.1.
• سازگاری تأیید شده با آداپتور InMobi iOS نسخه 10.7.2.0.
• با افزونه Flutter Ads Google Mobile نسخه 5.1.0 ساخته و آزمایش شده است.