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

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

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

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

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

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

الزامات

  • اندروید API سطح ۲۴ یا بالاتر
  • [برای پیشنهاد قیمت]: برای ادغام تمام قالب‌های تبلیغاتی پشتیبانی‌شده در پیشنهاد قیمت، از آداپتور InMobi نسخه ۱۰.۶.۳.۰ یا بالاتر استفاده کنید ( آخرین نسخه توصیه می‌شود )

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

برای یک حساب کاربری در InMobi ثبت نام کنید .

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

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

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

روی افزودن موجودی کلیک کنید و کانال برنامه موبایل را از منوی کشویی انتخاب کنید.

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

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

تنظیمات انطباق برنامه و وب‌سایت را بررسی کنید و سپس روی ذخیره و ایجاد مکان‌ها کلیک کنید.

جایگاه‌ها

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

مناقصه

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

آبشار

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

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

شناسه حساب

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

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

مناقصه

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

آبشار

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

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

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

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

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

برای پیاده‌سازی app-ads.txt برای InMobi، قطعه کد شخصی‌سازی‌شده‌ی خود را اضافه کنید .

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

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

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

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

InMobi را در شرکت‌ها اضافه کنید

مناقصه

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

آبشار

به بخش مدیریت > شرکت‌ها بروید، سپس در تب «همه شرکت‌ها» روی دکمه «شرکت جدید» کلیک کنید. شبکه تبلیغاتی را انتخاب کنید.

InMobi را به عنوان شبکه تبلیغاتی انتخاب کنید، یک نام منحصر به فرد وارد کنید و Mediation را فعال کنید. جمع‌آوری خودکار داده‌ها را فعال کنید و نام کاربری و کلید API به دست آمده در بخش قبل را وارد کنید.

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

فعال کردن اشتراک‌گذاری امن سیگنال

مناقصه

به بخش مدیریت > تنظیمات کلی بروید. به برگه تنظیمات حساب Ad Exchange بروید و اشتراک‌گذاری امن سیگنال را بررسی و فعال کنید. روی ذخیره کلیک کنید.

آبشار

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

سیگنال امن را در درخواست‌های پیشنهاد به اشتراک بگذارید

مناقصه

به Inventory > Secure Signals بروید. در زیر Secure signals ، InMobi را جستجو کنید و گزینه Enable app integration را فعال کنید.

روی ذخیره کلیک کنید.

آبشار

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

امکان اشتراک‌گذاری امن سیگنال برای مناقصه SDK

مناقصه

به بخش تحویل > تنظیمات کانال تقاضا بروید. در تب تنظیمات پیش‌فرض ، گزینه «اجازه اشتراک‌گذاری امن سیگنال برای پیشنهاد SDK» را فعال کنید.

روی ذخیره کلیک کنید.

آبشار

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

پیکربندی پیشنهاد قیمت InMobi

مناقصه

به مسیر Delivery > Bidders بروید و روی Go to SDK Bidding کلیک کنید.

روی پیشنهاددهنده جدید کلیک کنید.

InMobi را به عنوان پیشنهاد دهنده انتخاب کنید.

برای فعال کردن پیشنهاد قیمت SDK برای این پیشنهاد دهنده، روی ادامه کلیک کنید.

روی انجام شد کلیک کنید.

آبشار

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

پیکربندی نگاشت واحد تبلیغات

مناقصه

به مسیر Delivery > Bidders بروید و روی Go to SDK Bidding کلیک کنید.

شرکت InMobi را انتخاب کنید.

به برگه نگاشت واحد تبلیغات بروید و روی نگاشت واحد تبلیغات جدید کلیک کنید.

واحد تبلیغاتی خاص را انتخاب کنید. یک واحد تبلیغاتی و قالب، برنامه موبایل را به عنوان نوع موجودی و برنامه موبایل خود انتخاب کنید. سپس، شناسه حساب و شناسه قرارگیری به دست آمده در بخش قبل را وارد کنید. در نهایت، روی ذخیره کلیک کنید.

آبشار

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

به پایین اسکرول کنید و روی «افزودن شریک عملکرد» کلیک کنید.

شرکتی که در بخش قبل برای InMobi ایجاد کردید را انتخاب کنید. در قسمت Integration type گزینه Mobile SDK mediation ، در قسمت Platform گزینه Android و در قسمت Status گزینه Active را انتخاب کنید.

شناسه حساب و شناسه قرارگیری که در بخش قبل به دست آوردید و مقدار پیش‌فرض CPM را وارد کنید. روی ذخیره کلیک کنید.

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

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

برای افزودن InMobi به فهرست شرکای تبلیغاتی مقررات ایالتی اروپا و ایالات متحده در رابط کاربری Ad Manager، مراحل موجود در تنظیمات مقررات اروپا و تنظیمات مقررات ایالت ایالات متحده را دنبال کنید.

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

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

کاتلین 

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02")
    implementation("com.google.ads.mediation:inmobi:11.1.1.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:inmobi:11.1.1.0'
}

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

ادغام دستی

  1. کیت توسعه نرم‌افزار اندروید InMobi را دانلود کنید و فایل InMobiSDK.aar را از پوشه libs استخراج کرده و به پروژه خود اضافه کنید.

  2. به مصنوعات آداپتور InMobi در مخزن Maven گوگل بروید. آخرین نسخه را انتخاب کنید، فایل .aar آداپتور InMobi را دانلود کنید و آن را به پروژه خود اضافه کنید.

  3. InMobi همچنین نیاز به وابستگی‌های دیگری دارد. برای جزئیات بیشتر، لطفاً به مستندات InMobi مراجعه کنید.

مرحله ۴: تنظیمات حریم خصوصی را در InMobi SDK پیاده‌سازی کنید

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

در نسخه ۷.۱.۰.۰، آداپتور InMobi کلاس InMobiConsent را اضافه کرد که به شما امکان می‌دهد اطلاعات رضایت را به InMobi ارسال کنید. کد نمونه زیر، تابع updateGDPRConsent() را در کلاس InMobiConsent فراخوانی می‌کند. اگر تصمیم به فراخوانی این متد دارید، توصیه می‌شود قبل از درخواست تبلیغات از طریق GMA Next-Gen SDK این کار را انجام دهید.

کاتلین 

import com.inmobi.sdk.InMobiSdk
import com.google.ads.mediation.inmobi.InMobiConsent
// ...

val consentObject = JSONObject()
try {
  consentObject.put(InMobiSdk.IM_GDPR_CONSENT_AVAILABLE, true)
  consentObject.put("gdpr", "1")
} catch (exception: JSONException) {
  Log.e(TAG, "Error creating GDPR consent JSON.", exception)
}

InMobiConsent.updateGDPRConsent(consentObject)

جاوا 

import com.inmobi.sdk.InMobiSdk;
import com.google.ads.mediation.inmobi.InMobiConsent;
// ...

JSONObject consentObject = new JSONObject();
try {
  consentObject.put(InMobiSdk.IM_GDPR_CONSENT_AVAILABLE, true);
  consentObject.put("gdpr", "1");
} catch (JSONException exception) {
  Log.e(TAG, "Error creating GDPR consent JSON.", exception);
}

InMobiConsent.updateGDPRConsent(consentObject);

برای اطلاعات بیشتر در مورد کلیدها و مقادیر احتمالی که InMobi در این شیء رضایت می‌پذیرد ، به جزئیات پیاده‌سازی GDPR در InMobi مراجعه کنید.

قوانین حفظ حریم خصوصی ایالت‌های آمریکا

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

در نسخه ۱۰.۵.۷.۱، آداپتور InMobi پشتیبانی از خواندن رشته حریم خصوصی IAB US از تنظیمات مشترک را اضافه کرد. برای تنظیم رشته حریم خصوصی ایالات متحده در تنظیمات مشترک، دستورالعمل‌های موجود در مستندات قوانین حریم خصوصی ایالت‌های ایالات متحده را دنبال کنید.

علاوه بر این، برای راهنمایی در مورد نحوه فعال کردن تنظیمات CCPA در داشبورد InMobi، به مستندات CCPA شرکت InMobi مراجعه کنید.

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

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

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

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

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

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

برای تأیید اینکه تبلیغات آزمایشی را از 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" />

پارامترهای خاص شبکه

آداپتور InMobi از پارامترهای درخواست اضافی پشتیبانی می‌کند که می‌توانند به عنوان یک Android Bundle به آداپتور منتقل شوند. آداپتور به دنبال کلیدهای زیر در بسته می‌گردد:

درخواست پارامترها و مقادیر
InMobiNetworkKeys.AGE_GROUP
گروه سنی کاربر.		 InMobiNetworkValues.BELOW_18
InMobiNetworkValues.BETWEEN_18_AND_24
InMobiNetworkValues.BETWEEN_25_AND_29
InMobiNetworkValues.BETWEEN_30_AND_34
InMobiNetworkValues.BETWEEN_35_AND_44
InMobiNetworkValues.BETWEEN_45_AND_54
InMobiNetworkValues.BETWEEN_55_AND_65
InMobiNetworkValues.ABOVE_65
InMobiNetworkKeys.EDUCATION
سطح تحصیلات کاربر.		 InMobiNetworkValues.EDUCATION_HIGHSCHOOLORLESS
InMobiNetworkValues.EDUCATION_COLLEGEORGRADUATE
InMobiNetworkValues.EDUCATION_POSTGRADUATEORABOVE
InMobiNetworkKeys.AGE رشته . سن کاربر
InMobiNetworkKeys.POSTAL_CODE رشته . کد پستی کاربر (معمولاً یک عدد پنج رقمی)
InMobiNetworkKeys.AREA_CODE رشته . کد منطقه کاربر (بخشی از شماره تلفن)
InMobiNetworkKeys.LANGUAGE رشته . زبان مادری کاربر (در صورت اطلاع).
InMobiNetworkKeys.CITY رشته . شهر کاربر
InMobiNetworkKeys.STATE رشته . وضعیت کاربر
InMobiNetworkKeys.COUNTRY رشته . کشور کاربر
InMobiNetworkKeys.LOGLEVEL
سطح گزارش را برای InMobi SDK تنظیم می‌کند.		 InMobiNetworkValues.LOGLEVEL_NONE
InMobiNetworkValues.LOGLEVEL_DEBUG
InMobiNetworkValues.LOGLEVEL_ERROR

در اینجا یک مثال کد از نحوه تنظیم این پارامترهای درخواست تبلیغ آورده شده است:

کاتلین 

val extras = Bundle()
extras.putString(InMobiNetworkKeys.AGE_GROUP, InMobiNetworkValues.BETWEEN_35_AND_44)
extras.putString(InMobiNetworkKeys.AREA_CODE, AREA_CODE_VALUE)
val request = AdRequest.Builder(AD_UNIT_ID)
   .putAdSourceExtrasBundle(InMobiAdapter::class.java, extras)
   .build()

جاوا 

Bundle extras = new Bundle();
extras.putString(InMobiNetworkKeys.AGE_GROUP, InMobiNetworkValues.BETWEEN_35_AND_44);
extras.putString(InMobiNetworkKeys.AREA_CODE, AREA_CODE_VALUE);
AdRequest request = new AdRequest.Builder(AD_UNIT_ID)
   .putAdSourceExtrasBundle(InMobiAdapter.class, extras)
   .build();

  • AD_UNIT_ID با شناسه واحد تبلیغاتی خود جایگزین کنید.

  • به جای AREA_CODE_VALUE کد منطقه را وارد کنید.

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

رندرینگ آگهی

آداپتور InMobi تبلیغات بومی خود را به عنوان اشیاء NativeAd برمی‌گرداند. این آداپتور فیلدهای زیر را برای NativeAd پر می‌کند.

میدان دارایی‌ها همیشه توسط آداپتور InMobi گنجانده شده‌اند
تیتر
تصویر ۱
نمای رسانه
بدن
آیکون برنامه
فراخوان برای اقدام
رتبه‌بندی ستاره‌ای
فروشگاه
قیمت

آداپتور InMobi دسترسی مستقیم به تصویر اصلی برای تبلیغات بومی خود را فراهم نمی‌کند. در عوض ، این آداپتور MediaView را با یک ویدیو یا تصویر پر می‌کند.

ردیابی نمایش و کلیک

GMA Next-Gen SDK از فراخوانی‌های InMobi SDK برای ردیابی نمایش و کلیک استفاده می‌کند، بنابراین گزارش‌های هر دو داشبورد باید با اختلاف کم یا بدون اختلاف مطابقت داشته باشند.

کدهای خطا

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

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

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

کد خطا دلیل
۰-۹۹ خطاهای InMobi SDK. برای جزئیات بیشتر به کد مراجعه کنید.
۱۰۰ پارامترهای سرور InMobi که در رابط کاربری Ad Manager پیکربندی شده‌اند، وجود ندارند/نامعتبر هستند.
۱۰۱ مقداردهی اولیه InMobi SDK ناموفق بود.
۱۰۲ اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده توسط InMobi مطابقت ندارد.
۱۰۳ درخواست تبلیغ، یک درخواست تبلیغ بومی یکپارچه نیست.
۱۰۴ تلاش برای درخواست یک تبلیغ InMobi بدون مقداردهی اولیه SDK مربوط به InMobi. در تئوری، این اتفاق هرگز نباید رخ دهد، زیرا آداپتور قبل از درخواست تبلیغات InMobi، SDK مربوط به InMobi را مقداردهی اولیه می‌کند.
۱۰۵ تبلیغ InMobi هنوز آماده نمایش نیست.
۱۰۶ InMobi موفق به نمایش آگهی نشد.
۱۰۷ InMobi یک تبلیغ بومی را که فاقد یک ویژگی ضروری بود، برگرداند.
۱۰۸ تصاویر تبلیغاتی بومی InMobi حاوی یک URL ناقص هستند.
۱۰۹ آداپتور نتوانست فایل‌های تصویر تبلیغاتی بومی InMobi را دانلود کند.