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

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

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

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

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

الزامات

  • جدیدترین SDK تبلیغات موبایل گوگل
  • یونیتی 4 یا بالاتر
  • [برای مناقصه]: برای ادغام همه قالب‌های تبلیغاتی پشتیبانی‌شده در مناقصه، از افزونه میانجی‌گری Google Mobile Ads برای InMobi 4.5.0 یا بالاتر استفاده کنید ( آخرین نسخه توصیه می‌شود )
  • برای استقرار در اندروید
    • Android API سطح 21 یا بالاتر
  • برای استقرار در iOS
    • هدف استقرار iOS 10.0 یا بالاتر
  • یک پروژه واحد کاری که با 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 کلیک کنید.

جایگذاری ها

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

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

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

شناسه حساب

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

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

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

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

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

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

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

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

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

اندروید

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

iOS

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

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

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

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

OpenUPM-CLI

اگر OpenUPM-CLI را نصب کرده‌اید، می‌توانید با اجرای دستور زیر از دایرکتوری ریشه پروژه خود، افزونه میانجیگری InMobi Ads Google Mobile برای Unity را در پروژه خود نصب کنید:

openupm add com.google.ads.mobile.mediation.inmobi

OpenUPM

در ویرایشگر پروژه Unity خود، Edit > Project Settings > Package Manager را انتخاب کنید تا تنظیمات Unity Package Manager باز شود.

در برگه Scoped Registries ، OpenUPM را به عنوان یک رجیستری محدوده با جزئیات زیر اضافه کنید:

  • نام: OpenUPM
  • آدرس اینترنتی: https://package.openupm.com
  • محدوده (ها): com.google

جزئیات OpenUPM

سپس به مسیر Window > Package Manager بروید تا Unity Package Manager را باز کنید و My Registries را از منوی کشویی انتخاب کنید.

ثبت واحدها

بسته میانجیگری InMobi Ads Google Mobile را انتخاب کنید و روی Install کلیک کنید.

از OpenUPM نصب کنید

پکیج یونیتی

آخرین نسخه افزونه میانجی گری تبلیغات موبایل گوگل را برای InMobi از لینک دانلود در Changelog دانلود کنید و GoogleMobileAdsInMobiMediation.unitypackage را از فایل فشرده استخراج کنید.

در ویرایشگر پروژه Unity خود، Assets > Import Package > Custom Package را انتخاب کنید و فایل GoogleMobileAdsInMobiMediation.unitypackage را که دانلود کرده اید پیدا کنید. مطمئن شوید که همه فایل‌ها انتخاب شده‌اند و روی Import کلیک کنید.

واردات از یونیتی

سپس، Assets > External Dependency Manager > Android Resolver > Force Resolve را انتخاب کنید. کتابخانه External Dependency Manager تفکیک وابستگی را از ابتدا انجام می دهد و وابستگی های اعلام شده را در فهرست Assets/Plugins/Android برنامه Unity شما کپی می کند.

اجباری حل و فصل

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

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

افزونه میانجیگری Google Mobile Ads برای InMobi نسخه 2.1.0 روش InMobi.UpdateGDPRConsent() را اضافه کرده است که به شما امکان می دهد اطلاعات رضایت را به InMobi ارسال کنید. کد نمونه زیر نحوه انتقال اطلاعات رضایت به InMobi SDK را نشان می دهد. اگر تصمیم به فراخوانی این روش دارید، توصیه می‌کنیم قبل از درخواست تبلیغات با Google Mobile Ads SDK این کار را انجام دهید.

using GoogleMobileAds.Api.Mediation.InMobi;
using System.Collections.Generic;
// ...

Dictionary<string, string> consentObject = new Dictionary<string, string>();
consentObject.Add("gdpr_consent_available", "true");
consentObject.Add("gdpr", "1");

InMobi.UpdateGDPRConsent(consentObject);

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

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

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

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

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

اندروید

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

iOS

ادغام SKAdNetwork

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

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

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

مطمئن شوید که دستگاه آزمایشی خود را برای Ad Manager ثبت کرده اید و حالت آزمایشی را در رابط کاربری 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 Unity Mediation

نسخه 4.7.0

نسخه 4.6.7

نسخه 4.6.6

نسخه 4.6.5

نسخه 4.6.4

نسخه 4.6.3

نسخه 4.6.2

نسخه 4.6.1

نسخه 4.6.0

نسخه 4.5.1

نسخه 4.5.0

نسخه 4.4.1

نسخه 4.4.0

نسخه 4.3.3

نسخه 4.3.0

نسخه 4.2.2

نسخه 4.2.1

نسخه 4.2.0

نسخه 4.1.0

نسخه 4.0.4

نسخه 4.0.3

نسخه 4.0.2

نسخه 4.0.1

نسخه 4.0.0

نسخه 3.2.0

نسخه 3.1.2

نسخه 3.1.1

نسخه 3.1.0

نسخه 3.0.3

نسخه 3.0.2

نسخه 3.0.1

نسخه 3.0.0

نسخه 2.4.0

نسخه 2.3.0

  • از آداپتور اندروید نسخه 7.2.9.0 پشتیبانی می کند.
  • پشتیبانی از آداپتور iOS نسخه 7.3.2.0.

نسخه 2.2.2

  • افزونه را برای پشتیبانی از Rewarded API جدید به روز کرد.
  • از آداپتور اندروید نسخه 7.2.7.0 پشتیبانی می کند.
  • پشتیبانی از آداپتور iOS نسخه 7.2.7.0.

نسخه 2.2.1

  • از آداپتور اندروید نسخه 7.2.2.0 پشتیبانی می کند.
  • پشتیبانی از آداپتور iOS نسخه 7.2.4.0.

نسخه 2.2.0

  • از آداپتور اندروید نسخه 7.2.1.0 پشتیبانی می کند.
  • پشتیبانی از آداپتور iOS نسخه 7.2.0.0.

نسخه 2.1.2

  • پشتیبانی از آداپتور اندروید نسخه 7.1.1.1.
  • پشتیبانی از آداپتور iOS نسخه 7.1.2.0.

نسخه 2.1.1

  • پشتیبانی از آداپتور اندروید نسخه 7.1.1.1.
  • پشتیبانی از آداپتور iOS نسخه 7.1.1.2.

نسخه 2.1.0

  • از آداپتور اندروید نسخه 7.1.0.0 پشتیبانی می کند.
  • پشتیبانی از آداپتور iOS نسخه 7.1.1.1.
  • متد InMobi.UpdateGDPRConsent() اضافه شد.

نسخه 2.0.0

  • از آداپتور اندروید نسخه 7.0.4.0 پشتیبانی می کند.
  • پشتیبانی از آداپتور iOS نسخه 7.1.1.0.

نسخه 1.0.0

  • اولین انتشار!
  • از آداپتور اندروید نسخه 6.2.4.0 پشتیبانی می کند.
  • پشتیبانی از آداپتور iOS نسخه 6.2.1.0.