تبلیغات ironSource را با میانجیگری ادغام کنید

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

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

آداپتور میانجی AdMob برای ironSource Ads دارای قابلیت‌های زیر است:

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

2 این قالب فقط در یکپارچه سازی آبشار پشتیبانی می شود.

الزامات

  • جدیدترین SDK تبلیغات موبایل گوگل
  • یونیتی 4 یا بالاتر
  • [برای مناقصه]: برای ادغام همه قالب‌های تبلیغاتی پشتیبانی‌شده در مناقصه، از افزونه میانجی‌گری Google Mobile Ads برای IronSource 3.5.1 یا بالاتر استفاده کنید ( آخرین نسخه توصیه می‌شود )
  • برای استقرار در اندروید
    • Android API سطح 21 یا بالاتر
  • برای استقرار در iOS
    • هدف استقرار iOS 12.0 یا بالاتر
  • یک پروژه واحد کاری که با Google Mobile Ads SDK پیکربندی شده است. برای جزئیات بیشتر به شروع به کار مراجعه کنید.
  • راهنمای شروع میانجیگری را کامل کنید

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

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

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

برای افزودن یک برنامه جدید، به Ads > Apps بروید و روی Add app کلیک کنید.

فرم را پر کنید و روی افزودن برنامه کلیک کنید.

کلید برنامه را یادداشت کنید، سپس قالب‌های تبلیغاتی را که برنامه‌تان پشتیبانی می‌کند انتخاب کنید و روی Continue کلیک کنید.

اندروید

iOS

یک نمونه ایجاد کنید

در مرحله بعد، یک نمونه برای برنامه ای که اضافه کرده اید پیکربندی کنید.

مناقصه

به LevelPlay > Setup > Instances بروید، سپس برنامه خود را انتخاب کنید. در قسمت Bidding ، روی ironSource کلیک کنید.

شناسه نمونه را یادداشت کنید.

اندروید

iOS

آبشار

به Ads > Setup > Instances بروید. برنامه را انتخاب کنید و روی ایجاد نمونه کلیک کنید.

فرم را پر کنید و روی ذخیره و بستن کلیک کنید.

شناسه نمونه را یادداشت کنید.

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

مناقصه

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

آبشار

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

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

دستورالعمل های راهنمای تست یکپارچه سازی ironSource Ads را در مورد نحوه فعال کردن تبلیغات آزمایشی ironSource Ads دنبال کنید.

مرحله 2: تقاضای ironSource Ads را در رابط کاربری AdMob تنظیم کنید

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

اندروید

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

iOS

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

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

برای افزودن ironSource Mobile به فهرست شرکای تبلیغات مقررات ایالتی اروپا و ایالات متحده در رابط کاربری AdMob، مراحل تنظیمات مقررات اروپا و تنظیمات مقررات ایالتی ایالات متحده را دنبال کنید.

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

OpenUPM-CLI

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

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

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 را از منوی کشویی انتخاب کنید.

ثبت واحدها

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

از OpenUPM نصب کنید

پکیج یونیتی

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

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

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

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

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

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

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

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

using GoogleMobileAds.Api.Mediation.IronSource;
// ...

IronSource.SetConsent(true);

برای جزئیات بیشتر به مستندات ironSource Ads در مورد تنظیمات پیشرفته مقررات مراجعه کنید.

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

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

افزونه میانجیگری تبلیغات موبایلی Google برای ironSource Ads نسخه 2.2.4 شامل روش IronSource.SetMetaData() است. کد نمونه زیر نحوه ارسال اطلاعات رضایت را به ironSource Ads SDK نشان می دهد. این گزینه‌ها باید قبل از راه‌اندازی SDK تبلیغات موبایلی Google تنظیم شوند تا مطمئن شوید که به درستی به ironSource Ads SDK منتقل می‌شوند.

using GoogleMobileAds.Api.Mediation.IronSource;
// ...

IronSource.SetMetaData("do_not_sell", "true");

برای جزئیات بیشتر و مقادیری که در روش ارائه می شود، به مستندات ironSource Ads در مورد تنظیمات پیشرفته تنظیم برای Android و iOS مراجعه کنید.

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

اندروید

قوانین پروگارد

اگر برنامه خود را کوچک، مبهم و بهینه کنید ، IronSource Ads به قوانین ProGuard اضافی برای پروژه شما نیاز دارد.

هنگام ساخت پروژه خود، Android را به عنوان پلتفرم انتخاب کنید. سپس، Player Settings را باز کنید و User Proguard File را در تب Publishing Settings علامت بزنید. یونیتی باید نشان دهد که کجا یک فایل سفارشی proguard-user.txt برای اصلاح شما ایجاد شده است.

فایل حفاظت کاربر Unity

برای اطلاعات بیشتر در مورد قوانین ProGuard که برای پروژه شما لازم است، با راهنمای ادغام Android SDK Ads IronSource Ads مشورت کنید و آن قوانین را به فایل proguard-user.txt خود اضافه کنید.

iOS

ادغام SKAdNetwork

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

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

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

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

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

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

کدهای خطا

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

اندروید 

com.google.ads.mediation.ironsource.IronSourceAdapter
com.google.ads.mediation.ironsource.IronSourceRewardedAdapter

iOS 

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

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

اندروید

کد خطا دلیل
101 پارامترهای سرور ironSource Ads پیکربندی شده در رابط کاربری AdMob وجود ندارد/نامعتبر است.
102 ironSource Ads برای مقداردهی اولیه SDK خود به یک زمینه فعالیت نیاز دارد.
103 تبلیغات ironSource فقط می تواند 1 تبلیغ را در هر شناسه نمونه ironSource بارگیری کند.
105 اندازه آگهی بنر درخواستی توسط ironSource Ads پشتیبانی نمی شود.
106 ironSource Ads SDK راه اندازی نشده است.
501-1056 خطاهای ironSource Ads SDK. برای جزئیات بیشتر به مستندات مراجعه کنید.

iOS

کد خطا دلیل
101 پارامترهای سرور ironSource Ads پیکربندی شده در رابط کاربری AdMob وجود ندارد/نامعتبر است.
102 آداپتور تبلیغات ironSource از قالب آگهی درخواستی پشتیبانی نمی کند.
103 یک تبلیغ ironSource قبلاً برای این پیکربندی شبکه بارگیری شده است.
104 اندازه آگهی بنر درخواستی توسط ironSource Ads پشتیبانی نمی شود.
508-1037 خطاهای ironSource Ads SDK. برای جزئیات بیشتر به مستندات مراجعه کنید.

تغییرات پلاگین IronSource Unity Mediation

نسخه 3.6.1

نسخه 3.6.0

نسخه 3.5.2

نسخه 3.5.1

نسخه 3.5.0

نسخه 3.4.0

نسخه 3.3.1

نسخه 3.3.0

نسخه 3.2.1

نسخه 3.2.0

نسخه 3.1.1

نسخه 3.1.0

نسخه 3.0.1

نسخه 3.0.0

نسخه 2.6.1

نسخه 2.6.0

نسخه 2.5.0

نسخه 2.4.0

نسخه 2.3.1

نسخه 2.3.0

نسخه 2.2.7

نسخه 2.2.6

نسخه 2.2.5

نسخه 2.2.4

نسخه 2.2.3

نسخه 2.2.2

نسخه 2.2.1

نسخه 2.2.0

نسخه 2.1.5

نسخه 2.1.4

نسخه 2.1.3

نسخه 2.1.2

نسخه 2.1.1

نسخه 2.1.0

نسخه 2.0.3

نسخه 2.0.2

نسخه 2.0.1

نسخه 2.0.0

نسخه 1.10.0

نسخه 1.9.1

نسخه 1.9.0

نسخه 1.8.2

نسخه 1.8.1

نسخه 1.8.0

نسخه 1.7.0

نسخه 1.6.0

نسخه 1.5.0

نسخه 1.4.0

نسخه 1.3.2

نسخه 1.3.1

  • از آداپتور اندروید IronSource نسخه 6.10.0.0 پشتیبانی می کند
  • از آداپتور IronSource iOS نسخه 6.8.6.0 پشتیبانی می کند

نسخه 1.3.0

  • از آداپتور اندروید IronSource نسخه 6.10.0.0 پشتیبانی می کند
  • از آداپتور IronSource iOS نسخه 6.8.4.1.0 پشتیبانی می کند

نسخه 1.2.0

  • از آداپتور اندروید IronSource نسخه 6.9.0.1 پشتیبانی می کند
  • از آداپتور IronSource iOS نسخه 6.8.4.1.0 پشتیبانی می کند

نسخه 1.1.2

  • از آداپتور اندروید IronSource نسخه 6.8.4.1 پشتیبانی می کند
  • از آداپتور IronSource iOS نسخه 6.8.4.1 پشتیبانی می کند

نسخه 1.1.1

  • از آداپتور اندروید IronSource نسخه 6.8.4.1 پشتیبانی می کند
  • از آداپتور IronSource iOS نسخه 6.8.3.0 پشتیبانی می کند

نسخه 1.1.0

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

نسخه 1.0.4

  • از آداپتور اندروید IronSource نسخه 6.7.11.0 پشتیبانی می کند
  • از آداپتور IronSource iOS نسخه 6.7.11.0 پشتیبانی می کند

نسخه 1.0.3

  • از آداپتور اندروید IronSource نسخه 6.7.10.0 پشتیبانی می کند
  • از آداپتور IronSource iOS نسخه 6.7.10.0 پشتیبانی می کند

نسخه 1.0.2

  • از آداپتور اندروید IronSource نسخه 6.7.9.1.1 پشتیبانی می کند
  • از آداپتور IronSource iOS نسخه 6.7.10.0 پشتیبانی می کند
  • تداخل با افزونه میانجیگری Chartboost Unity رفع شد.

نسخه 1.0.1

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

نسخه 1.0.0

  • اولین انتشار!
  • از آداپتور اندروید IronSource نسخه 6.7.9.0 پشتیبانی می کند.
  • از آداپتور IronSource iOS نسخه 6.7.9.1.0 پشتیبانی می کند.
،

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

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

آداپتور میانجی AdMob برای ironSource Ads دارای قابلیت‌های زیر است:

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

2 این قالب فقط در یکپارچه سازی آبشار پشتیبانی می شود.

الزامات

  • جدیدترین SDK تبلیغات موبایل گوگل
  • یونیتی 4 یا بالاتر
  • [برای مناقصه]: برای ادغام همه قالب‌های تبلیغاتی پشتیبانی‌شده در مناقصه، از افزونه میانجی‌گری Google Mobile Ads برای IronSource 3.5.1 یا بالاتر استفاده کنید ( آخرین نسخه توصیه می‌شود )
  • برای استقرار در اندروید
    • Android API سطح 21 یا بالاتر
  • برای استقرار در iOS
    • هدف استقرار iOS 12.0 یا بالاتر
  • یک پروژه واحد کاری که با Google Mobile Ads SDK پیکربندی شده است. برای جزئیات بیشتر به شروع به کار مراجعه کنید.
  • راهنمای شروع میانجیگری را کامل کنید

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

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

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

برای افزودن یک برنامه جدید، به Ads > Apps بروید و روی Add app کلیک کنید.

فرم را پر کنید و روی افزودن برنامه کلیک کنید.

کلید برنامه را یادداشت کنید، سپس قالب‌های تبلیغاتی را که برنامه‌تان پشتیبانی می‌کند انتخاب کنید و روی Continue کلیک کنید.

اندروید

iOS

یک نمونه ایجاد کنید

در مرحله بعد، یک نمونه برای برنامه ای که اضافه کرده اید پیکربندی کنید.

مناقصه

به LevelPlay > Setup > Instances بروید، سپس برنامه خود را انتخاب کنید. در قسمت Bidding ، روی ironSource کلیک کنید.

شناسه نمونه را یادداشت کنید.

اندروید

iOS

آبشار

به Ads > Setup > Instances بروید. برنامه را انتخاب کنید و روی ایجاد نمونه کلیک کنید.

فرم را پر کنید و روی ذخیره و بستن کلیک کنید.

شناسه نمونه را یادداشت کنید.

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

مناقصه

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

آبشار

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

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

دستورالعمل های راهنمای تست یکپارچه سازی ironSource Ads را در مورد نحوه فعال کردن تبلیغات آزمایشی ironSource Ads دنبال کنید.

مرحله 2: تقاضای ironSource Ads را در رابط کاربری AdMob تنظیم کنید

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

اندروید

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

iOS

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

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

برای افزودن ironSource Mobile به فهرست شرکای تبلیغات مقررات ایالتی اروپا و ایالات متحده در رابط کاربری AdMob، مراحل تنظیمات مقررات اروپا و تنظیمات مقررات ایالتی ایالات متحده را دنبال کنید.

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

OpenUPM-CLI

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

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

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 را از منوی کشویی انتخاب کنید.

ثبت واحدها

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

از OpenUPM نصب کنید

پکیج یونیتی

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

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

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

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

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

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

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

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

using GoogleMobileAds.Api.Mediation.IronSource;
// ...

IronSource.SetConsent(true);

برای جزئیات بیشتر به مستندات ironSource Ads در مورد تنظیمات پیشرفته مقررات مراجعه کنید.

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

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

افزونه میانجیگری تبلیغات موبایلی Google برای ironSource Ads نسخه 2.2.4 شامل روش IronSource.SetMetaData() است. کد نمونه زیر نحوه ارسال اطلاعات رضایت را به ironSource Ads SDK نشان می دهد. این گزینه‌ها باید قبل از راه‌اندازی SDK تبلیغات موبایلی Google تنظیم شوند تا مطمئن شوید که به درستی به ironSource Ads SDK منتقل می‌شوند.

using GoogleMobileAds.Api.Mediation.IronSource;
// ...

IronSource.SetMetaData("do_not_sell", "true");

برای جزئیات بیشتر و مقادیری که در روش ارائه می شود، به مستندات ironSource Ads در مورد تنظیمات پیشرفته تنظیم برای Android و iOS مراجعه کنید.

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

اندروید

قوانین پروگارد

اگر برنامه خود را کوچک، مبهم و بهینه کنید ، IronSource Ads به قوانین ProGuard اضافی برای پروژه شما نیاز دارد.

هنگام ساخت پروژه خود، Android را به عنوان پلتفرم انتخاب کنید. سپس، Player Settings را باز کنید و User Proguard File را در تب Publishing Settings علامت بزنید. یونیتی باید نشان دهد که کجا یک فایل سفارشی proguard-user.txt برای اصلاح شما ایجاد شده است.

فایل حفاظت کاربر Unity

برای اطلاعات بیشتر در مورد قوانین ProGuard که برای پروژه شما لازم است، با راهنمای ادغام Android SDK Ads IronSource Ads مشورت کنید و آن قوانین را به فایل proguard-user.txt خود اضافه کنید.

iOS

ادغام SKAdNetwork

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

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

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

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

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

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

کدهای خطا

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

اندروید 

com.google.ads.mediation.ironsource.IronSourceAdapter
com.google.ads.mediation.ironsource.IronSourceRewardedAdapter

iOS 

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

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

اندروید

کد خطا دلیل
101 پارامترهای سرور ironSource Ads پیکربندی شده در رابط کاربری AdMob وجود ندارد/نامعتبر است.
102 ironSource Ads برای مقداردهی اولیه SDK خود به یک زمینه فعالیت نیاز دارد.
103 تبلیغات ironSource فقط می تواند 1 تبلیغ را در هر شناسه نمونه ironSource بارگیری کند.
105 اندازه آگهی بنر درخواستی توسط ironSource Ads پشتیبانی نمی شود.
106 ironSource Ads SDK راه اندازی نشده است.
501-1056 خطاهای ironSource Ads SDK. برای جزئیات بیشتر به مستندات مراجعه کنید.

iOS

کد خطا دلیل
101 پارامترهای سرور ironSource Ads پیکربندی شده در رابط کاربری AdMob وجود ندارد/نامعتبر است.
102 آداپتور تبلیغات ironSource از قالب آگهی درخواستی پشتیبانی نمی کند.
103 یک تبلیغ ironSource قبلاً برای این پیکربندی شبکه بارگیری شده است.
104 اندازه آگهی بنر درخواستی توسط ironSource Ads پشتیبانی نمی شود.
508-1037 خطاهای ironSource Ads SDK. برای جزئیات بیشتر به مستندات مراجعه کنید.

تغییرات پلاگین IronSource Unity Mediation

نسخه 3.6.1

نسخه 3.6.0

نسخه 3.5.2

نسخه 3.5.1

نسخه 3.5.0

نسخه 3.4.0

نسخه 3.3.1

نسخه 3.3.0

نسخه 3.2.1

نسخه 3.2.0

نسخه 3.1.1

نسخه 3.1.0

نسخه 3.0.1

نسخه 3.0.0

نسخه 2.6.1

نسخه 2.6.0

نسخه 2.5.0

نسخه 2.4.0

نسخه 2.3.1

نسخه 2.3.0

نسخه 2.2.7

نسخه 2.2.6

نسخه 2.2.5

نسخه 2.2.4

نسخه 2.2.3

نسخه 2.2.2

نسخه 2.2.1

نسخه 2.2.0

نسخه 2.1.5

نسخه 2.1.4

نسخه 2.1.3

نسخه 2.1.2

نسخه 2.1.1

نسخه 2.1.0

نسخه 2.0.3

نسخه 2.0.2

نسخه 2.0.1

نسخه 2.0.0

نسخه 1.10.0

نسخه 1.9.1

نسخه 1.9.0

نسخه 1.8.2

نسخه 1.8.1

نسخه 1.8.0

نسخه 1.7.0

نسخه 1.6.0

نسخه 1.5.0

نسخه 1.4.0

نسخه 1.3.2

نسخه 1.3.1

  • از آداپتور اندروید IronSource نسخه 6.10.0.0 پشتیبانی می کند
  • از آداپتور IronSource iOS نسخه 6.8.6.0 پشتیبانی می کند

نسخه 1.3.0

  • از آداپتور اندروید IronSource نسخه 6.10.0.0 پشتیبانی می کند
  • از آداپتور IronSource iOS نسخه 6.8.4.1.0 پشتیبانی می کند

نسخه 1.2.0

  • از آداپتور اندروید IronSource نسخه 6.9.0.1 پشتیبانی می کند
  • از آداپتور IronSource iOS نسخه 6.8.4.1.0 پشتیبانی می کند

نسخه 1.1.2

  • از آداپتور اندروید IronSource نسخه 6.8.4.1 پشتیبانی می کند
  • از آداپتور IronSource iOS نسخه 6.8.4.1 پشتیبانی می کند

نسخه 1.1.1

  • از آداپتور اندروید IronSource نسخه 6.8.4.1 پشتیبانی می کند
  • از آداپتور IronSource iOS نسخه 6.8.3.0 پشتیبانی می کند

نسخه 1.1.0

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

نسخه 1.0.4

  • از آداپتور اندروید IronSource نسخه 6.7.11.0 پشتیبانی می کند
  • از آداپتور IronSource iOS نسخه 6.7.11.0 پشتیبانی می کند

نسخه 1.0.3

  • از آداپتور اندروید IronSource نسخه 6.7.10.0 پشتیبانی می کند
  • از آداپتور IronSource iOS نسخه 6.7.10.0 پشتیبانی می کند

نسخه 1.0.2

  • از آداپتور اندروید IronSource نسخه 6.7.9.1.1 پشتیبانی می کند
  • از آداپتور IronSource iOS نسخه 6.7.10.0 پشتیبانی می کند
  • تداخل با افزونه میانجیگری Chartboost Unity رفع شد.

نسخه 1.0.1

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

نسخه 1.0.0

  • اولین انتشار!
  • از آداپتور اندروید IronSource نسخه 6.7.9.0 پشتیبانی می کند.
  • از آداپتور IronSource iOS نسخه 6.7.9.1.0 پشتیبانی می کند.
،

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

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

آداپتور میانجی AdMob برای ironSource Ads دارای قابلیت‌های زیر است:

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

2 این قالب فقط در یکپارچه سازی آبشار پشتیبانی می شود.

الزامات

  • جدیدترین SDK تبلیغات موبایل گوگل
  • یونیتی 4 یا بالاتر
  • [برای مناقصه]: برای ادغام همه قالب‌های تبلیغاتی پشتیبانی‌شده در مناقصه، از افزونه میانجی‌گری Google Mobile Ads برای IronSource 3.5.1 یا بالاتر استفاده کنید ( آخرین نسخه توصیه می‌شود )
  • برای استقرار در اندروید
    • Android API سطح 21 یا بالاتر
  • برای استقرار در iOS
    • هدف استقرار iOS 12.0 یا بالاتر
  • یک پروژه واحد کاری که با Google Mobile Ads SDK پیکربندی شده است. برای جزئیات بیشتر به شروع به کار مراجعه کنید.
  • راهنمای شروع میانجیگری را کامل کنید

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

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

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

برای افزودن یک برنامه جدید، به Ads > Apps بروید و روی Add app کلیک کنید.

فرم را پر کنید و روی افزودن برنامه کلیک کنید.

کلید برنامه را یادداشت کنید، سپس قالب‌های تبلیغاتی را که برنامه‌تان پشتیبانی می‌کند انتخاب کنید و روی Continue کلیک کنید.

اندروید

iOS

یک نمونه ایجاد کنید

در مرحله بعد، یک نمونه برای برنامه ای که اضافه کرده اید پیکربندی کنید.

مناقصه

به LevelPlay > Setup > Instances بروید، سپس برنامه خود را انتخاب کنید. در قسمت Bidding ، روی ironSource کلیک کنید.

شناسه نمونه را یادداشت کنید.

اندروید

iOS

آبشار

به Ads > Setup > Instances بروید. برنامه را انتخاب کنید و روی ایجاد نمونه کلیک کنید.

فرم را پر کنید و روی ذخیره و بستن کلیک کنید.

شناسه نمونه را یادداشت کنید.

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

مناقصه

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

آبشار

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

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

دستورالعمل های مربوط به راهنمای تست ادغام Aronsource Ads را در مورد چگونگی فعال کردن تبلیغات آزمون تبلیغات Ironsource دنبال کنید.

مرحله 2: تقاضای تبلیغات Ironsource را در Admob UI تنظیم کنید

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

اندروید

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

iOS

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

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

مراحل تنظیمات مقررات اروپایی و تنظیمات مقررات ایالتی ایالات متحده را دنبال کنید تا ironsource موبایل را به لیست شرکای تبلیغاتی مقررات اروپایی و ایالات متحده در لیست Admob UI اضافه کنید.

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

OpenUPM-CLI

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

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

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 را از منوی کشویی انتخاب کنید.

ثبت واحدها

بسته Google Mobile Ads Ironsource Mediation را انتخاب کرده و روی نصب کلیک کنید.

از OpenUPM نصب کنید

پکیج یونیتی

آخرین نسخه افزونه Google Mobile Ads Ads را برای تبلیغات Ironsource از لینک بارگیری در ChangeLog بارگیری کرده و GoogleMobileAdsIronSourceMediation.unitypackage را از پرونده ZIP استخراج کنید.

در ویرایشگر پروژه وحدت خود ، دارایی ها > بسته وارد کردن > بسته سفارشی را انتخاب کنید و فایل GoogleMobileAdsIronSourceMediation.unitypackage را که بارگیری کرده اید پیدا کنید. مطمئن شوید که همه فایل‌ها انتخاب شده‌اند و روی Import کلیک کنید.

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

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

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

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

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

افزونه Google Mobile Ads Ads برای تبلیغات Ironsource نسخه 1.0.0 شامل روش IronSource.SetConsent() است. کد نمونه زیر نحوه انتقال اطلاعات رضایت به Aronsource Ads SDK را نشان می دهد. اگر تصمیم دارید با این روش تماس بگیرید ، توصیه می شود قبل از درخواست تبلیغات از طریق Google Mobile Ads SDK این کار را انجام دهید.

using GoogleMobileAds.Api.Mediation.IronSource;
// ...

IronSource.SetConsent(true);

برای اطلاعات بیشتر به اسناد تبلیغات Aronsource Ads در مورد تنظیمات پیشرفته تنظیمات مراجعه کنید.

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

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

افزونه Google Mobile Ads Ads برای تبلیغات Ironsource نسخه 2.2.4 شامل روش IronSource.SetMetaData() است. کد نمونه زیر نحوه انتقال اطلاعات رضایت به Aronsource Ads SDK را نشان می دهد. این گزینه ها باید قبل از شروع اولیه ADS Google Mobile SDK تنظیم شود تا اطمینان حاصل شود که آنها به درستی به Aronsource Ads SDK ارسال می شوند.

using GoogleMobileAds.Api.Mediation.IronSource;
// ...

IronSource.SetMetaData("do_not_sell", "true");

برای جزئیات بیشتر و مقادیری که می توان در این روش ارائه داد ، مستندات Ads Ads Ironsource را در مورد تنظیم تنظیمات پیشرفته برای Android و iOS مشاهده کنید.

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

اندروید

قوانین پروگارد

اگر برنامه خود را کوچک کنید ، مبهم کنید و برنامه خود را بهینه کنید ، تبلیغات Ironsource برای پروژه شما به قوانین پروژارد اضافی نیاز دارد.

هنگام ساخت پروژه خود ، Android را به عنوان سیستم عامل انتخاب کنید. سپس تنظیمات پخش کننده را باز کنید و پرونده proguard کاربر را در زیر برگه تنظیمات انتشارات بررسی کنید. وحدت باید نشان دهد که یک پرونده proguard-user.txt سفارشی برای اصلاح شما ایجاد شده است.

فایل proguard کاربر وحدت

برای کسب اطلاعات بیشتر در مورد قوانین Proguard برای پروژه شما ، با راهنمای ادغام Android SDK Android Ads مشورت کنید و آن قوانین را به پرونده proguard-user.txt خود اضافه کنید.

iOS

ادغام SKAdNetwork

برای افزودن شناسه های Skadnetwork به پرونده Info.plist پروژه خود ، مستندات Ads Ironsource Ads را دنبال کنید.

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

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

اطمینان حاصل کنید که دستگاه تست خود را برای ADMOB ثبت کرده و حالت تست را در Aronsource Ads UI فعال کنید .

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

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

کدهای خطا

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

اندروید 

com.google.ads.mediation.ironsource.IronSourceAdapter
com.google.ads.mediation.ironsource.IronSourceRewardedAdapter

iOS 

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

در اینجا کدها و پیام های همراهی که توسط آداپتور تبلیغات Ironsource پرتاب شده است در صورت عدم موفقیت یک آداپتور Ironsource:

اندروید

کد خطا دلیل
101 پارامترهای سرور Ads IronSource پیکربندی شده در Admob UI از دست رفته/نامعتبر هستند.
102 تبلیغات Ironsource برای شروع SDK خود به یک زمینه فعالیت نیاز دارد.
103 تبلیغات Ironsource فقط می تواند 1 تبلیغ در هر شناسه نمونه Ironsource را بارگیری کند.
105 اندازه تبلیغات بنر درخواست شده توسط تبلیغات Ironsource پشتیبانی نمی شود.
106 Aronsource Ads SDK اولیه نشده است.
501-1056 خطاهای SDK ADS Ironsource. برای جزئیات بیشتر به مستندات مراجعه کنید.

iOS

کد خطا دلیل
101 پارامترهای سرور Ads IronSource پیکربندی شده در Admob UI از دست رفته/نامعتبر هستند.
102 آداپتور تبلیغات Ironsource از قالب تبلیغاتی که درخواست می شود پشتیبانی نمی کند.
103 یک تبلیغ Ironsource در حال حاضر برای این پیکربندی شبکه بارگیری شده است.
104 اندازه تبلیغات بنر درخواست شده توسط تبلیغات Ironsource پشتیبانی نمی شود.
508-1037 خطاهای SDK ADS Ironsource. برای جزئیات بیشتر به مستندات مراجعه کنید.

Ironsource Unity Mediation Plugin ChangeLog

نسخه 3.6.1

نسخه 3.6.0

نسخه 3.5.2

نسخه 3.5.1

نسخه 3.5.0

نسخه 3.4.0

نسخه 3.3.1

نسخه 3.3.0

نسخه 3.2.1

نسخه 3.2.0

نسخه 3.1.1

نسخه 3.1.0

نسخه 3.0.1

نسخه 3.0.0

نسخه 2.6.1

نسخه 2.6.0

نسخه 2.5.0

نسخه 2.4.0

نسخه 2.3.1

نسخه 2.3.0

نسخه 2.2.7

نسخه 2.2.6

نسخه 2.2.5

نسخه 2.2.4

نسخه 2.2.3

نسخه 2.2.2

نسخه 2.2.1

نسخه 2.2.0

نسخه 2.1.5

نسخه 2.1.4

نسخه 2.1.3

نسخه 2.1.2

نسخه 2.1.1

نسخه 2.1.0

نسخه 2.0.3

نسخه 2.0.2

نسخه 2.0.1

نسخه 2.0.0

نسخه 1.10.0

نسخه 1.9.1

نسخه 1.9.0

نسخه 1.8.2

نسخه 1.8.1

نسخه 1.8.0

نسخه 1.7.0

نسخه 1.6.0

نسخه 1.5.0

نسخه 1.4.0

نسخه 1.3.2

نسخه 1.3.1

  • پشتیبانی از ironsource Android Adapter نسخه 6.10.0.0
  • پشتیبانی از آداپتور iONSource iOS نسخه 6.8.6.0

نسخه 1.3.0

  • پشتیبانی از ironsource Android Adapter نسخه 6.10.0.0
  • پشتیبانی از آداپتور iONSource iOS نسخه 6.8.4.1.0

نسخه 1.2.0

  • از آداپتور Android Ironsource نسخه 6.9.0.1 پشتیبانی می کند
  • پشتیبانی از آداپتور iONSource iOS نسخه 6.8.4.1.0

نسخه 1.1.2

  • از آداپتور Android Ironsource نسخه 6.8.4.1 پشتیبانی می کند
  • پشتیبانی از آداپتور iOS IOSSOURCE نسخه 6.8.4.1

نسخه 1.1.1

  • از آداپتور Android Ironsource نسخه 6.8.4.1 پشتیبانی می کند
  • پشتیبانی از آداپتور iONSource iOS نسخه 6.8.3.0

نسخه 1.1.0

  • این افزونه را برای پشتیبانی از API پاداش جدید با بتای باز به روز کرد.
  • پشتیبانی از ironsource Android Adapter نسخه 6.8.1.2
  • پشتیبانی از آداپتور iOS IOSSORES نسخه 6.8.0.1

نسخه 1.0.4

  • پشتیبانی از iRonsource Android Adapter نسخه 6.7.11.0
  • پشتیبانی از آداپتور iONSource iOS نسخه 6.7.11.0

نسخه 1.0.3

  • از آداپتور Android Ironsource نسخه 6.7.10.0 پشتیبانی می کند
  • پشتیبانی از آداپتور iOS IOSSORCE نسخه 6.7.10.0

نسخه 1.0.2

  • پشتیبانی از Android Adapter Ironsource نسخه 6.7.9.1.1
  • پشتیبانی از آداپتور iOS IOSSORCE نسخه 6.7.10.0
  • درگیری با افزونه میانجیگری Unity ChartBoost رفع شد.

نسخه 1.0.1

  • از آداپتور Android Ironsource نسخه 6.7.9.0 پشتیبانی می کند.
  • پشتیبانی از iRonsource iOS آداپتور نسخه 6.7.9.2.0.

نسخه 1.0.0

  • اولین انتشار!
  • از آداپتور Android Ironsource نسخه 6.7.9.0 پشتیبانی می کند.
  • پشتیبانی از آداپتور iONSource iOS نسخه 6.7.9.1.0.
،

این راهنما نحوه استفاده از Google Mobile Ads SDK را برای بارگیری و نمایش تبلیغات از تبلیغات Ironsource با استفاده از واسطه ، و پوشش ادغام آبشار نشان می دهد. این شامل چگونگی اضافه کردن تبلیغات Ironsource به پیکربندی واسطه گری واحد تبلیغاتی ، و نحوه ادغام Aronsource Ads SDK و آداپتور در یک برنامه وحدت است.

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

آداپتور میانجی Admob برای تبلیغات Ironsource قابلیت های زیر را دارد:

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

2 این قالب فقط در ادغام آبشار پشتیبانی می شود.

الزامات

  • جدیدترین SDK تبلیغات موبایل گوگل
  • یونیتی 4 یا بالاتر
  • [برای مناقصه]: برای ادغام کلیه قالب های تبلیغاتی پشتیبانی شده در مناقصه ، از افزونه Google Mobile Ads Ads برای Ironsource 3.5.1 یا بالاتر استفاده کنید ( آخرین نسخه توصیه شده )
  • برای استقرار در اندروید
    • Android API سطح 21 یا بالاتر
  • برای استقرار در iOS
    • هدف استقرار iOS 12.0 یا بالاتر
  • یک پروژه واحد کاری که با Google Mobile Ads SDK پیکربندی شده است. برای جزئیات بیشتر به شروع به کار مراجعه کنید.
  • راهنمای شروع میانجیگری را کامل کنید

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

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

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

برای افزودن یک برنامه جدید ، به تبلیغات > برنامه ها بروید و روی افزودن برنامه کلیک کنید.

فرم را پر کرده و روی افزودن برنامه کلیک کنید.

به کلید برنامه توجه داشته باشید ، سپس Formats Ad Formats را انتخاب کنید و روی ادامه کلیک کنید.

اندروید

iOS

یک نمونه ایجاد کنید

در مرحله بعد ، نمونه ای را برای برنامه اضافه شده پیکربندی کنید.

مناقصه

به LevelPlay > Setup > نمونه ها بروید ، سپس برنامه خود را انتخاب کنید. تحت مناقصه ، روی Ironsource کلیک کنید.

به شناسه نمونه توجه داشته باشید.

اندروید

iOS

آبشار

به تبلیغات > تنظیم > نمونه ها بروید. برنامه را انتخاب کرده و روی ایجاد نمونه کلیک کنید.

فرم را پر کرده و روی ذخیره و بستن کلیک کنید.

به شناسه نمونه توجه داشته باشید.

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

مناقصه

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

آبشار

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

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

دستورالعمل های مربوط به راهنمای تست ادغام Aronsource Ads را در مورد چگونگی فعال کردن تبلیغات آزمون تبلیغات Ironsource دنبال کنید.

مرحله 2: تقاضای تبلیغات Ironsource را در Admob UI تنظیم کنید

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

اندروید

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

iOS

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

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

مراحل تنظیمات مقررات اروپایی و تنظیمات مقررات ایالتی ایالات متحده را دنبال کنید تا ironsource موبایل را به لیست شرکای تبلیغاتی مقررات اروپایی و ایالات متحده در لیست Admob UI اضافه کنید.

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

OpenUPM-CLI

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

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

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 را از منوی کشویی انتخاب کنید.

ثبت واحدها

بسته Google Mobile Ads Ironsource Mediation را انتخاب کرده و روی نصب کلیک کنید.

از OpenUPM نصب کنید

پکیج یونیتی

آخرین نسخه افزونه Google Mobile Ads Ads را برای تبلیغات Ironsource از لینک بارگیری در ChangeLog بارگیری کرده و GoogleMobileAdsIronSourceMediation.unitypackage را از پرونده ZIP استخراج کنید.

در ویرایشگر پروژه وحدت خود ، دارایی ها > بسته وارد کردن > بسته سفارشی را انتخاب کنید و فایل GoogleMobileAdsIronSourceMediation.unitypackage را که بارگیری کرده اید پیدا کنید. مطمئن شوید که همه فایل‌ها انتخاب شده‌اند و روی Import کلیک کنید.

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

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

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

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

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

افزونه Google Mobile Ads Ads برای تبلیغات Ironsource نسخه 1.0.0 شامل روش IronSource.SetConsent() است. کد نمونه زیر نحوه انتقال اطلاعات رضایت به Aronsource Ads SDK را نشان می دهد. اگر تصمیم دارید با این روش تماس بگیرید ، توصیه می شود قبل از درخواست تبلیغات از طریق Google Mobile Ads SDK این کار را انجام دهید.

using GoogleMobileAds.Api.Mediation.IronSource;
// ...

IronSource.SetConsent(true);

برای اطلاعات بیشتر به اسناد تبلیغات Aronsource Ads در مورد تنظیمات پیشرفته تنظیمات مراجعه کنید.

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

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

افزونه Google Mobile Ads Ads برای تبلیغات Ironsource نسخه 2.2.4 شامل روش IronSource.SetMetaData() است. کد نمونه زیر نحوه انتقال اطلاعات رضایت به Aronsource Ads SDK را نشان می دهد. این گزینه ها باید قبل از شروع اولیه ADS Google Mobile SDK تنظیم شود تا اطمینان حاصل شود که آنها به درستی به Aronsource Ads SDK ارسال می شوند.

using GoogleMobileAds.Api.Mediation.IronSource;
// ...

IronSource.SetMetaData("do_not_sell", "true");

برای جزئیات بیشتر و مقادیری که می توان در این روش ارائه داد ، مستندات Ads Ads Ironsource را در مورد تنظیم تنظیمات پیشرفته برای Android و iOS مشاهده کنید.

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

اندروید

قوانین پروگارد

اگر برنامه خود را کوچک کنید ، مبهم کنید و برنامه خود را بهینه کنید ، تبلیغات Ironsource برای پروژه شما به قوانین پروژارد اضافی نیاز دارد.

هنگام ساخت پروژه خود ، Android را به عنوان سیستم عامل انتخاب کنید. سپس تنظیمات پخش کننده را باز کنید و پرونده proguard کاربر را در زیر برگه تنظیمات انتشارات بررسی کنید. وحدت باید نشان دهد که یک پرونده proguard-user.txt سفارشی برای اصلاح شما ایجاد شده است.

فایل proguard کاربر وحدت

برای کسب اطلاعات بیشتر در مورد قوانین Proguard برای پروژه شما ، با راهنمای ادغام Android SDK Android Ads مشورت کنید و آن قوانین را به پرونده proguard-user.txt خود اضافه کنید.

iOS

ادغام SKAdNetwork

برای افزودن شناسه های Skadnetwork به پرونده Info.plist پروژه خود ، مستندات Ads Ironsource Ads را دنبال کنید.

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

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

اطمینان حاصل کنید که دستگاه تست خود را برای ADMOB ثبت کرده و حالت تست را در Aronsource Ads UI فعال کنید .

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

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

کدهای خطا

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

اندروید 

com.google.ads.mediation.ironsource.IronSourceAdapter
com.google.ads.mediation.ironsource.IronSourceRewardedAdapter

iOS 

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

در اینجا کدها و پیام های همراهی که توسط آداپتور تبلیغات Ironsource پرتاب شده است در صورت عدم موفقیت یک آداپتور Ironsource:

اندروید

کد خطا دلیل
101 پارامترهای سرور Ads IronSource پیکربندی شده در Admob UI از دست رفته/نامعتبر هستند.
102 تبلیغات Ironsource برای شروع SDK خود به یک زمینه فعالیت نیاز دارد.
103 تبلیغات Ironsource فقط می تواند 1 تبلیغ در هر شناسه نمونه Ironsource را بارگیری کند.
105 اندازه تبلیغات بنر درخواست شده توسط تبلیغات Ironsource پشتیبانی نمی شود.
106 Aronsource Ads SDK اولیه نشده است.
501-1056 خطاهای SDK ADS Ironsource. برای جزئیات بیشتر به مستندات مراجعه کنید.

iOS

کد خطا دلیل
101 پارامترهای سرور Ads IronSource پیکربندی شده در Admob UI از دست رفته/نامعتبر هستند.
102 آداپتور تبلیغات Ironsource از قالب تبلیغاتی که درخواست می شود پشتیبانی نمی کند.
103 یک تبلیغ Ironsource در حال حاضر برای این پیکربندی شبکه بارگیری شده است.
104 اندازه تبلیغات بنر درخواست شده توسط تبلیغات Ironsource پشتیبانی نمی شود.
508-1037 خطاهای SDK ADS Ironsource. برای جزئیات بیشتر به مستندات مراجعه کنید.

Ironsource Unity Mediation Plugin ChangeLog

نسخه 3.6.1

نسخه 3.6.0

نسخه 3.5.2

نسخه 3.5.1

نسخه 3.5.0

نسخه 3.4.0

نسخه 3.3.1

نسخه 3.3.0

نسخه 3.2.1

نسخه 3.2.0

نسخه 3.1.1

نسخه 3.1.0

نسخه 3.0.1

نسخه 3.0.0

نسخه 2.6.1

نسخه 2.6.0

نسخه 2.5.0

نسخه 2.4.0

نسخه 2.3.1

نسخه 2.3.0

نسخه 2.2.7

نسخه 2.2.6

نسخه 2.2.5

نسخه 2.2.4

نسخه 2.2.3

نسخه 2.2.2

نسخه 2.2.1

نسخه 2.2.0

نسخه 2.1.5

نسخه 2.1.4

نسخه 2.1.3

نسخه 2.1.2

نسخه 2.1.1

نسخه 2.1.0

نسخه 2.0.3

نسخه 2.0.2

نسخه 2.0.1

نسخه 2.0.0

نسخه 1.10.0

نسخه 1.9.1

نسخه 1.9.0

نسخه 1.8.2

نسخه 1.8.1

نسخه 1.8.0

نسخه 1.7.0

نسخه 1.6.0

نسخه 1.5.0

نسخه 1.4.0

نسخه 1.3.2

نسخه 1.3.1

  • پشتیبانی از ironsource Android Adapter نسخه 6.10.0.0
  • پشتیبانی از آداپتور iONSource iOS نسخه 6.8.6.0

نسخه 1.3.0

  • پشتیبانی از ironsource Android Adapter نسخه 6.10.0.0
  • پشتیبانی از آداپتور iONSource iOS نسخه 6.8.4.1.0

نسخه 1.2.0

  • از آداپتور Android Ironsource نسخه 6.9.0.1 پشتیبانی می کند
  • پشتیبانی از آداپتور iONSource iOS نسخه 6.8.4.1.0

نسخه 1.1.2

  • از آداپتور Android Ironsource نسخه 6.8.4.1 پشتیبانی می کند
  • پشتیبانی از آداپتور iOS IOSSOURCE نسخه 6.8.4.1

نسخه 1.1.1

  • از آداپتور Android Ironsource نسخه 6.8.4.1 پشتیبانی می کند
  • پشتیبانی از آداپتور iONSource iOS نسخه 6.8.3.0

نسخه 1.1.0

  • این افزونه را برای پشتیبانی از API پاداش جدید با بتای باز به روز کرد.
  • پشتیبانی از ironsource Android Adapter نسخه 6.8.1.2
  • پشتیبانی از آداپتور iOS IOSSORES نسخه 6.8.0.1

نسخه 1.0.4

  • پشتیبانی از iRonsource Android Adapter نسخه 6.7.11.0
  • پشتیبانی از آداپتور iONSource iOS نسخه 6.7.11.0

نسخه 1.0.3

  • از آداپتور Android Ironsource نسخه 6.7.10.0 پشتیبانی می کند
  • پشتیبانی از آداپتور iOS IOSSORCE نسخه 6.7.10.0

نسخه 1.0.2

  • پشتیبانی از Android Adapter Ironsource نسخه 6.7.9.1.1
  • پشتیبانی از آداپتور iOS IOSSORCE نسخه 6.7.10.0
  • درگیری با افزونه میانجیگری Unity ChartBoost رفع شد.

نسخه 1.0.1

  • از آداپتور Android Ironsource نسخه 6.7.9.0 پشتیبانی می کند.
  • پشتیبانی از iRonsource iOS آداپتور نسخه 6.7.9.2.0.

نسخه 1.0.0

  • اولین انتشار!
  • از آداپتور Android Ironsource نسخه 6.7.9.0 پشتیبانی می کند.
  • پشتیبانی از آداپتور iONSource iOS نسخه 6.7.9.1.0.