Liftoff Monetize را با میانجیگری ادغام کنید

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

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

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

² ادغام Waterfall برای این فرمت در نسخه بتا باز است.

الزامات

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

مرحله 1: تنظیمات را در Liftoff Monetize UI تنظیم کنید

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

با کلیک بر روی دکمه افزودن برنامه ، برنامه خود را به داشبورد Liftoff Monetize اضافه کنید.

فرم را پر کنید و تمام جزئیات لازم را وارد کنید.

پس از ایجاد برنامه، برنامه خود را از داشبورد Liftoff Monetize Applications انتخاب کنید.

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

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

برای ایجاد یک مکان جدید برای استفاده با میانجیگری AdMob، به داشبورد Liftoff Monetize Placements بروید، روی دکمه افزودن مکان کلیک کنید و برنامه خود را از لیست کشویی انتخاب کنید.

جزئیات اضافه کردن مکان‌های جدید در زیر آمده است:

شناسه مرجع را یادداشت کنید و روی Sounds Good کلیک کنید.

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

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

برای فعال کردن تبلیغات آزمایشی، به داشبورد Liftoff Monetize بروید و به برنامه‌ها بروید.

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

مرحله ۲: تقاضای Liftoff Monetize را در رابط کاربری AdMob تنظیم کنید

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

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

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

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

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

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

رضایت اتحادیه اروپا و GDPR

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

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

using GoogleMobileAds.Mediation.LiftoffMonetize.Api;
// ...

LiftoffMonetize.SetGDPRStatus(true, "v1.0.0");
#if UNITY_IPHONE
LiftoffMonetize.SetGDPRMessageVersion("v1.0.0");
#endif

برای جزئیات بیشتر و مقادیر قابل ارائه در روش، دستورالعمل‌های اجرای توصیه‌شده GDPR را برای Android و iOS ببینید.

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

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

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

using GoogleMobileAds.Mediation.LiftoffMonetize.Api;
// ...

LiftoffMonetize.SetCCPAStatus(true);

برای جزئیات بیشتر و مقادیر قابل ارائه در روش، دستورالعمل‌های اجرای توصیه‌شده CCPA برای Android و iOS را ببینید.

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

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

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

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

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

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

کدهای خطا

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

در اینجا کدها و پیام‌های همراهی که توسط آداپتور Liftoff Monetize پرتاب می‌شود، زمانی که آگهی بارگیری نمی‌شود، آمده است:

برای خطاهای ناشی از Vungle SDK، به کدهای خطا مراجعه کنید: Vungle SDK برای iOS و Android .

تغییرات پلاگین Liftoff Monetize Unity Mediation

نسخه 5.2.2

• از آداپتور اندروید Liftoff Monetize نسخه 7.4.2.0 پشتیبانی می کند.
• از آداپتور Liftoff Monetize iOS نسخه 7.4.2.0 پشتیبانی می کند.
• ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.4.0.

نسخه 5.2.1

• DummyClient به PlaceholderClient تغییر نام داد.
• از آداپتور اندروید Liftoff Monetize نسخه 7.4.0.1 پشتیبانی می کند.
• از آداپتور Liftoff Monetize iOS نسخه 7.4.0.1 پشتیبانی می کند.
• ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.2.0.

نسخه 5.2.0

• از آداپتور اندروید Liftoff Monetize نسخه 7.4.0.0 پشتیبانی می کند.
• از آداپتور Liftoff Monetize iOS نسخه 7.4.0.0 پشتیبانی می کند.
• ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.1.1.

نسخه 5.1.1

• از آداپتور Liftoff Monetize اندروید نسخه 7.3.2.0 پشتیبانی می کند.
• از آداپتور Liftoff Monetize iOS نسخه 7.3.2.0 پشتیبانی می کند.
• ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.1.0.

نسخه 5.1.0

• رفع یک NullPointerException که باعث خرابی ساخت در هنگام صادرات به عنوان یک پروژه اندرویدی شد.
• API های حریم خصوصی را به روز کرد:
  • متدهای UpdateConsentStatus() و UpdateCCPAStatus() حذف کرد.
  • فهرست VungleConsentStatus و VungleCCPAStatus حذف شد.
  • روش SetGDPRStatus(bool) را به SetGDPRStatus(bool, String) به روز کرد.
• متدهای زیر را از کلاس LiftoffMonetizeMediationExtras حذف کرد:
  • SetAllPlacements(String[])
  • SetSoundEnabled(bool)
• از آداپتور اندروید Liftoff Monetize نسخه 7.3.1.0 پشتیبانی می کند.
• از آداپتور Liftoff Monetize iOS نسخه 7.3.1.0 پشتیبانی می کند.
• ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.1.0.

نسخه 5.0.0

• یک هشدار تعریف تکراری برای MediationExtras رفع شد.
• از آداپتور اندروید Liftoff Monetize نسخه 7.1.0.0 پشتیبانی می کند.
• از آداپتور Liftoff Monetize iOS نسخه 7.2.1.1 پشتیبانی می کند.
• با افزونه Google Mobile Ads Unity نسخه 8.7.0 ساخته و آزمایش شده است.

نسخه 4.0.0

• پلاگین میانجیگری Unity از Vungle به Liftoff Monetize تغییر نام داد.
• محتوای آداپتور به GoogleMobileAds/Mediation/LiftoffMonetize/ منتقل شد.
• فضای نام آداپتور برای استفاده از GoogleMobileAds.Mediation.LiftoffMonetize بازسازی شد.
• متدهای زیر را به کلاس LiftoffMonetize اضافه کرد:
  • SetGDPRStatus(bool)
  • SetGDPRMessageVersion(String)
  • SetCCPAStatus(bool)
• از آداپتور اندروید Liftoff Monetize نسخه 6.12.1.1 پشتیبانی می کند.
• از آداپتور Liftoff Monetize iOS نسخه 7.0.1.0 پشتیبانی می کند.
• با افزونه Google Mobile Ads Unity نسخه 8.4.1 ساخته و آزمایش شده است.

نسخه 3.9.2

• کلاس Vungle را به روز کرد:
  • روش UpdateCCPAStatus(VungleCCPAStatus) اضافه شد.
  • متد GetCurrentConsentStatus() را حذف کرد.
  • متد GetCurrentConsentMessageVersion() حذف شد.
• از آداپتور Vungle اندروید نسخه 6.12.1.0 پشتیبانی می کند.
• از آداپتور Vungle iOS نسخه 6.12.2.0 پشتیبانی می کند.
• با افزونه Google Mobile Ads Unity نسخه 7.4.1 ساخته و آزمایش شده است.

نسخه 3.9.1

• از آداپتور Vungle اندروید نسخه 6.12.1.0 پشتیبانی می کند.
• از آداپتور Vungle iOS نسخه 6.12.1.1 پشتیبانی می کند.
• با افزونه Google Mobile Ads Unity نسخه 7.4.0 ساخته و آزمایش شده است.

نسخه 3.9.0

• از آداپتور Vungle اندروید نسخه 6.12.0.0 پشتیبانی می کند.
• از آداپتور Vungle iOS نسخه 6.12.0.0 پشتیبانی می کند.
• با افزونه Google Mobile Ads Unity نسخه 7.2.0 ساخته و آزمایش شده است.

نسخه 3.8.2

• از آداپتور Vungle اندروید نسخه 6.11.0.2 پشتیبانی می کند.
• از آداپتور Vungle iOS نسخه 6.11.0.1 پشتیبانی می کند.
• ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 7.1.0.

نسخه 3.8.1

• از آداپتور Vungle اندروید نسخه 6.11.0.1 پشتیبانی می کند.
• از آداپتور Vungle iOS نسخه 6.11.0.0 پشتیبانی می کند.
• ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 7.0.2.

نسخه 3.8.0

• از آداپتور Vungle اندروید نسخه 6.11.0.0 پشتیبانی می کند.
• از آداپتور Vungle iOS نسخه 6.11.0.0 پشتیبانی می کند.
• با افزونه Google Mobile Ads Unity نسخه 7.0.0 ساخته و آزمایش شده است.

نسخه 3.7.5

• از آداپتور Vungle اندروید نسخه 6.10.5.0 پشتیبانی می کند.
• از آداپتور Vungle iOS نسخه 6.10.6.1 پشتیبانی می کند.
• با افزونه Google Mobile Ads Unity نسخه 7.0.0 ساخته و آزمایش شده است.

نسخه 3.7.4

• از آداپتور Vungle اندروید نسخه 6.10.4.0 پشتیبانی می کند.
• از آداپتور Vungle iOS نسخه 6.10.6.1 پشتیبانی می کند.
• با افزونه Google Mobile Ads Unity نسخه 7.0.0 ساخته و آزمایش شده است.

نسخه 3.7.3

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

نسخه 3.7.2

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

نسخه 3.7.1

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

نسخه 3.7.0

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

نسخه 3.6.0

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

نسخه 3.5.1

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

نسخه 3.5.0

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

نسخه 3.4.1

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

نسخه 3.4.0

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

نسخه 3.3.1

• بسته بندی مجدد vungle-extras-library.jar به vungle-unity-android-library.aar ، با استفاده از ساخت .aar برای پشتیبانی از Unity 2020.
  • هنگام ارتقاء به این نسخه، لطفاً vungle-extras-library.jar از پروژه خود حذف کنید.
• از آداپتور Vungle اندروید نسخه 6.5.3.0 پشتیبانی می کند.
• از آداپتور Vungle iOS نسخه 6.5.3.0 پشتیبانی می کند.

نسخه 3.3.0

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

نسخه 3.2.0

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

نسخه 3.1.4

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

نسخه 3.1.3

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

نسخه 3.1.2

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

نسخه 3.1.1

• از آداپتور اندروید نسخه 6.3.24.0 پشتیبانی می کند.
• پشتیبانی از آداپتور iOS نسخه 6.3.2.0.
• روش Vungle.UpdateConsentStatus() را برای اختیاری کردن پارامتر consentMessageVersion به روز کرد. اکنون مقدار consentMessageVersion برای iOS نادیده گرفته شده است.
• Vungle.GetCurrentConsentMessageVersion() منسوخ شده برای iOS.

نسخه 3.1.0

• از آداپتور اندروید نسخه 6.3.17.0 پشتیبانی می کند.
• پشتیبانی از آداپتور iOS نسخه 6.3.0.0.
• متد Vungle.UpdateConsentStatus() را برای گرفتن یک پارامتر String اضافی برای نسخه پیام رضایت ارائه شده توسط ناشر به روز کرد.
• روش Vungle.GetCurrentConsentMessageVersion() برای دریافت نسخه پیام رضایت ارائه شده توسط ناشر اضافه شد.

نسخه 3.0.1

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

نسخه 3.0.0

• از آداپتور اندروید نسخه 6.2.5.0 پشتیبانی می کند.
• پشتیبانی از آداپتور iOS نسخه 6.2.0.2.
• روش های زیر را اضافه کرد:
  • روش Vungle.UpdateConsentStatus() برای تنظیم وضعیت رضایتی که در Vungle SDK ثبت خواهد شد.
  • روش Vungle.GetCurrentConsentStatus() برای دریافت وضعیت رضایت فعلی کاربر.

نسخه 2.0.0

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

نسخه 1.1.0

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

نسخه 1.0.0

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