ادغام تبلیغات Unity با واسطه

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

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

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

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

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

الزامات

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

مرحله 1: تنظیمات را در رابط کاربری Unity Ads تنظیم کنید

ثبت نام کنید یا وارد Unity Ads شوید.

یک پروژه ایجاد کنید

در داشبورد Unity Ads ، به Projects بروید و روی New کلیک کنید.

فرم را پر کنید و روی Create کلیک کنید تا پروژه خود را اضافه کنید.

به Unity Ads Monetization بروید، سپس روی شروع به کار کلیک کنید.

در حالت New Project ، I will use Mediation و Google Admob for Mediation Partner را انتخاب کنید، سپس روی Next کلیک کنید.

گزینه تنظیمات تبلیغات را انتخاب کنید، سپس روی Next کلیک کنید.

تنظیم مکان خود را انتخاب کنید، سپس روی Next کلیک کنید.

مناقصه

آبشار

فرم را پر کنید، سپس روی افزودن پروژه کلیک کنید.

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

واحدها و مکان های تبلیغاتی ایجاد کنید

به Unity Ads Monetization > Placements بروید، سپس پروژه خود را انتخاب کنید و روی Add unit ad کلیک کنید.

نام واحد تبلیغات را وارد کنید، سپس پلتفرم و قالب تبلیغ خود را انتخاب کنید.

اندروید

iOS

مناقصه

Bidding را برای راه اندازی انتخاب کنید. در قسمت Placement ، نام مکان را وارد کنید.

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

آبشار

برای راه اندازی، آبشار را انتخاب کنید. در قسمت Placement ، نام مکان ، GEO Tagging و Target را وارد کنید.

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

در نهایت، روی افزودن واحد تبلیغات کلیک کنید تا واحد تبلیغات و مکان شما ذخیره شود.

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

مناقصه

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

آبشار

به Unity Ads Monetization > مدیریت API بروید و کلید API را در دسترسی به API Stats در کسب درآمد یادداشت کنید.

سپس، به Unity Ads Monetization > Organization Settings بروید و شناسه اصلی سازمان را یادداشت کنید.

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

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

برای پیاده سازی app-ads.txt برای Unity Ads، برای اولین بار به راه اندازی app-ads.txt مراجعه کنید.

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

حالت تست را می توان از داشبورد Unity Ads فعال کرد. به Unity Ads Monetization > Testing بروید.

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

اندروید

iOS

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

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

مرحله 2: درخواست Unity Ads را در رابط کاربری AdMob تنظیم کنید

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

اندروید

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

iOS

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

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

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

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

OpenUPM-CLI

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

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

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

ثبت واحدها

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

از OpenUPM نصب کنید

پکیج یونیتی

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

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

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

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

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

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

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

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

using GoogleMobileAds.Api.Mediation.UnityAds;
// ...

UnityAds.SetConsentMetaData("gdpr.consent", true);

برای جزئیات بیشتر و مقادیری که می‌توان در هر روش ارائه کرد، به APIهای رضایت حریم خصوصی و داده‌های Unity Ads و پیروی از راهنمای GDPR مراجعه کنید.

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

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

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

using GoogleMobileAds.Api.Mediation.UnityAds;
// ...

UnityAds.SetConsentMetaData("privacy.consent", true);

برای جزئیات بیشتر و مقادیری که می‌توان در هر روش ارائه کرد ، APIهای رضایت حریم خصوصی و داده‌های Unity Ads و پیروی از راهنماهای CCPA را ببینید.

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

اندروید

هیچ کد اضافی برای ادغام های Unity Ads Android مورد نیاز نیست.

iOS

ادغام SKAdNetwork

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

خطاهای کامپایل

برای آداپتور Unity Ads 3.4.0 یا بالاتر، باید مراحل ادغام را در اسناد Unity دنبال کنید.

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

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

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

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

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

کدهای خطا

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

اندروید 

com.google.ads.mediation.unity.UnityAdapter
com.google.ads.mediation.unity.UnityMediationAdapter

iOS 

GADMAdapterUnity
GADMediationAdapterUnity

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

اندروید

کد خطا دلیل
0-10 UnityAds SDK یک خطا برگرداند. برای جزئیات بیشتر به کد مراجعه کنید.
101 پارامترهای سرور UnityAds پیکربندی شده در رابط کاربری Admob گم شده/نامعتبر است.
102 UnityAds یک مکان با حالت NO_FILL برگرداند.
103 UnityAds یک مکان را با وضعیت DISABLED برگرداند.
104 UnityAds سعی کرد تبلیغی را با زمینه پوچ نشان دهد.
105 زمینه مورد استفاده برای مقداردهی اولیه، بارگیری و/یا نمایش تبلیغات از Unity Ads یک نمونه Activity نیست.
106 UnityAds سعی کرد تبلیغی را نشان دهد که برای نمایش آماده نیست.
107 UnityAds در دستگاه پشتیبانی نمی شود.
108 UnityAds می تواند تنها 1 تبلیغ را در هر مکان بارگیری کند.
109 UnityAds با یک وضعیت ERROR به پایان رسید.
200-204 بنر UnityAds یک خطای خاص. برای جزئیات بیشتر به کد مراجعه کنید.

iOS

0-9 UnityAds SDK یک خطا برگرداند. برای جزئیات بیشتر به مستندات Unity مراجعه کنید.
101 پارامترهای سرور UnityAds پیکربندی شده در رابط کاربری AdMob وجود ندارد/نامعتبر است.
102 دستگاه توسط UnityAds پشتیبانی نمی شود.
103 UnityAds با حالت خطا ارائه شد. kUnityAdsFinishStateError .
104 شیء تبلیغ Unity پس از فراخوانی اولیه ساز آن صفر می شود.
105 به دلیل آماده نبودن آگهی، تبلیغات Unity نمایش داده نشد.
107 UnityAds به نام یک مکان، پاسخ تماس را با وضعیت قرار دادن تغییر داد. kUnityAdsPlacementStateDisabled .
108 قبلاً یک آگهی برای این مکان بارگیری شده است. UnityAds SDK از بارگیری تبلیغات چندگانه برای یک مکان پشتیبانی نمی کند.
109 بنری که توسط UnityAds برگردانده شده است با اندازه درخواستی مطابقت ندارد.
110 UnityAds یک خطای اولیه را برگرداند.
111 قالب تبلیغ پشتیبانی نشده

Unity Ads Unity Mediation Plugin Changelog

نسخه 3.15.1

نسخه 3.15.0

نسخه 3.14.4

نسخه 3.14.3

نسخه 3.14.2

نسخه 3.14.1

نسخه 3.14.0

نسخه 3.13.0

نسخه 3.12.6

نسخه 3.12.5

نسخه 3.12.4

نسخه 3.12.3

نسخه 3.12.2

نسخه 3.12.1

نسخه 3.12.0

نسخه 3.11.1

نسخه 3.11.0

نسخه 3.10.0

نسخه 3.9.1

نسخه 3.9.0

نسخه 3.8.0

نسخه 3.7.1

نسخه 3.7.0

نسخه 3.6.1

نسخه 3.6.0

نسخه 3.5.0

نسخه 3.4.1

نسخه 3.4.0

نسخه 3.3.0

نسخه 3.2.1

نسخه 3.2.0

نسخه 3.1.0

نسخه 3.0.1

نسخه 3.0.0

نسخه 2.7.2

نسخه 2.7.1

نسخه 2.7.0

نسخه 2.6.0

نسخه 2.5.1

نسخه 2.5.0

نسخه 2.4.7

نسخه 2.4.6

نسخه 2.4.5

نسخه 2.4.4

نسخه 2.4.3

نسخه 2.4.2

نسخه 2.4.1

نسخه 2.4.0

نسخه 2.3.0

نسخه 2.2.0

نسخه 2.1.0

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

نسخه 2.0.3

  • افزونه را برای پشتیبانی از API پاداشدهی بتا باز جدید به روز کرد.
  • پشتیبانی از تبلیغات بنری را اضافه می کند.
  • از آداپتور اندروید Unity Ads نسخه 3.0.0.2 پشتیبانی می کند.
  • پشتیبانی از Unity Ads آداپتور iOS نسخه 3.0.0.3.

نسخه 2.0.2

  • از آداپتور اندروید Unity Ads نسخه 3.0.0.0 پشتیبانی می کند.
  • پشتیبانی از Unity Ads آداپتور iOS نسخه 3.0.0.1.

نسخه 2.0.1

  • خطای «نوع ناسازگار» را که باعث ایجاد مشکلاتی در هنگام ساخت برای iOS می‌شد، رفع شد.

نسخه 2.0.0

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

نسخه 1.2.0

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

نسخه 1.1.3

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

نسخه 1.1.2

  • پشتیبانی از Unity Ads Android SDK نسخه 2.2.0.
  • پشتیبانی از Unity Ads iOS SDK نسخه 2.2.0.
  • روش UnityAds.SetGdprConsentMetaData() اضافه شد تا به صورت دستی درخواست انتخاب کاربر برای تبلیغات هدفمند شود.

نسخه 1.1.1

  • پشتیبانی از Unity Ads Android SDK نسخه 2.2.0.
  • پشتیبانی از Unity Ads iOS SDK نسخه 2.2.1.

نسخه 1.1.0

  • پشتیبانی از Unity Ads Android SDK نسخه 2.2.0.
  • پشتیبانی از Unity Ads iOS SDK نسخه 2.2.0.

نسخه 1.0.0

  • اولین انتشار!
  • پشتیبانی از Unity Ads Android SDK نسخه 2.1.2.
  • پشتیبانی از Unity Ads iOS SDK نسخه 2.1.2.