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

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

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

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

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

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

الزامات

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

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

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

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

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

فرم را پر کنید و برای اضافه کردن پروژه خود، روی ایجاد کلیک کنید.

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

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

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

تنظیمات قرارگیری خود را انتخاب کنید، سپس روی «بعدی» کلیک کنید.

مناقصه

آبشار

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

به شناسه بازی (Game ID) توجه کنید.

ایجاد واحدهای تبلیغاتی و جایگاه‌ها

به بخش کسب درآمد از تبلیغات یونیتی > مکان‌ها بروید، سپس پروژه خود را انتخاب کنید و روی افزودن واحد تبلیغاتی کلیک کنید.

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

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

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

برای تنظیمات، آبشار (Waterfall) را انتخاب کنید. در قسمت جایگذاری (Placement) ، نام جایگذاری (Placement name) ، برچسب‌گذاری جغرافیایی (GEO Tagging) و هدف (Target) را وارد کنید.

شناسه‌ی محل قرارگیری را یادداشت کنید.

در نهایت، برای ذخیره واحد تبلیغاتی و جایگاه آن، روی افزودن واحد تبلیغاتی کلیک کنید.

کلید API گزارش تبلیغات Unity را پیدا کنید

مناقصه

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

آبشار

به Unity Ads Monetization > API management بروید و کلید API را در Monetization Stats API Access یادداشت کنید.

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

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

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

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

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

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

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

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

Enter your test device details, then click Save .

مرحله ۲: تنظیم تقاضای تبلیغات یونیتی در رابط کاربری مدیریت تبلیغات

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

تبلیغات Unity را در شرکت‌ها اضافه کنید

مناقصه

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

آبشار

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

Unity Ads را به عنوان شبکه تبلیغاتی انتخاب کنید، یک نام منحصر به فرد وارد کنید و Mediation را فعال کنید. جمع‌آوری خودکار داده‌ها را فعال کنید و کلید API و شناسه اصلی سازمان (Organization core ID) که در بخش قبل به دست آورده‌اید را وارد کنید.

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

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

مناقصه

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

آبشار

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

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

مناقصه

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

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

آبشار

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

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

مناقصه

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

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

آبشار

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

پیکربندی پیشنهاد قیمت تبلیغات Unity

مناقصه

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

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

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

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

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

آبشار

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

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

مناقصه

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

شرکت Unity Ads را انتخاب کنید.

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

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

آبشار

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

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

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

شناسه بازی (Game ID) و شناسه مکان (Placement ID) که در بخش قبل به دست آوردید و مقدار پیش‌فرض CPM را وارد کنید. روی ذخیره (Save) کلیک کنید.

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

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

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

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

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

کاتلین 

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02")
    implementation("com.unity3d.ads:unity-ads:4.16.5")
    implementation("com.google.ads.mediation:unity:4.16.6.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.unity3d.ads:unity-ads:4.16.5'
    implementation 'com.google.ads.mediation:unity:4.16.6.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. آخرین نسخه SDK مربوط به Unity Ads ( unity-ads.aar ) را از مخزن گیت‌هاب آنها دانلود کرده و به پروژه خود اضافه کنید.

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

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

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

در نسخه ۲.۰.۰ SDK، Unity Ads یک API برای پشتیبانی از تنظیمات حریم خصوصی اضافه کرد. نمونه کد زیر نحوه ارسال این اطلاعات رضایت به Unity Ads SDK را نشان می‌دهد. اگر تصمیم دارید اطلاعات رضایت را به صورت دستی به Unity Ads SDK ارسال کنید، توصیه می‌شود قبل از درخواست تبلیغات از طریق GMA Next-Gen SDK ، این کد فراخوانی شود.

جاوا 

MetaData gdprMetaData = new MetaData(this);
gdprMetaData.set("gdpr.consent", true);
gdprMetaData.commit();
UnityAdsMediationSnippets.java

کاتلین 

val gdprMetaData = MetaData(this)
gdprMetaData["gdpr.consent"] = true
gdprMetaData.commit()
UnityAdsMediationSnippets.kt

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

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

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

در SDK نسخه ۲.۰.۰، Unity Ads یک API برای پشتیبانی از تنظیمات حریم خصوصی اضافه کرد. نمونه کد زیر نحوه ارسال این اطلاعات رضایت به Unity Ads SDK را نشان می‌دهد. اگر تصمیم دارید اطلاعات رضایت را به صورت دستی به Unity Ads SDK ارسال کنید، توصیه می‌شود قبل از درخواست تبلیغات از طریق GMA Next-Gen SDK ، این کد فراخوانی شود.

جاوا 

MetaData ccpaMetaData = new MetaData(this);
ccpaMetaData.set("privacy.consent", true);
ccpaMetaData.commit();
UnityAdsMediationSnippets.java

کاتلین 

val ccpaMetaData = MetaData(this)
ccpaMetaData["privacy.consent"] = true
ccpaMetaData.commit()
UnityAdsMediationSnippets.kt

برای جزئیات بیشتر و مقادیری که می‌توان در هر روش ارائه داد، به بخش انطباق با قانون حفظ حریم خصوصی مصرف‌کنندگان Unity Ads مراجعه کنید.

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

بارگذاری تبلیغ با زمینه فعالیت

هنگام بارگذاری قالب‌های تبلیغات بنری، بینابینی و بومی، زمینه Activity را ارسال کنید. بدون زمینه فعالیت، بارگذاری تبلیغ با شکست مواجه خواهد شد.

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

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

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

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

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

کدهای خطا

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

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

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

کد خطا دلیل
۰-۱۰ UnityAds SDK خطایی را برگرداند. برای جزئیات بیشتر به کد مراجعه کنید.
۱۰۱ پارامترهای سرور UnityAds که در رابط کاربری Ad Manager پیکربندی شده‌اند، وجود ندارند/نامعتبر هستند.
۱۰۲ UnityAds یک موقعیت مکانی با حالت NO_FILL را برگرداند.
۱۰۳ UnityAds یک موقعیت مکانی را با وضعیت غیرفعال (DISABLED) برگرداند.
۱۰۴ UnityAds سعی کرد تبلیغی با متن تهی (null context) نمایش دهد.
۱۰۵ زمینه‌ای که برای مقداردهی اولیه، بارگذاری و/یا نمایش تبلیغات از Unity Ads استفاده می‌شود، یک نمونه Activity نیست.
۱۰۶ UnityAds سعی کرد تبلیغی را نمایش دهد که آماده نمایش نبود.
۱۰۷ UnityAds روی این دستگاه پشتیبانی نمی‌شود.
۱۰۸ UnityAds فقط می‌تواند در هر بار نمایش، یک تبلیغ را بارگذاری کند.
۱۰۹ UnityAds با وضعیت خطا (ERROR) کار خود را به پایان رساند.
۲۰۰-۲۰۴ خطای مربوط به بنر UnityAds. برای جزئیات بیشتر به کد مراجعه کنید.