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

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

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

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

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

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

الزامات

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

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

مرحله 2: تقاضای Liftoff Monetize را در آن تنظیم کنید Ad Manager UI

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

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

،

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

،

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

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

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

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

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

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

تحت «خط‌مشی رضایت کاربر اتحادیه اروپا» 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: کد مورد نیاز را اضافه کنید

اندروید

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

iOS

ادغام SKAdNetwork

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

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

کدهای خطا

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

اندروید

قالب نام کلاس
باز کردن برنامه (مناقصه) com.google.ads.mediation.vungle.VungleMediationAdapter
برنامه باز (آبشار) com.google.ads.mediation.vungle.VungleMediationAdapter
بنر (مناقصه) com.google.ads.mediation.vungle.VungleMediationAdapter
بنر (آبشار) com.vungle.mediation.VungleInterstitialAdapter
بینابینی (مناقصه) com.google.ads.mediation.vungle.VungleMediationAdapter
بینابینی (آبشار) com.vungle.mediation.VungleInterstitialAdapter
پاداش داده شده (مناقصه) com.google.ads.mediation.vungle.VungleMediationAdapter
پاداش (آبشار) com.vungle.mediation.VungleAdapter
بینابینی با پاداش (مناقصه) com.google.ads.mediation.vungle.VungleMediationAdapter
بینابینی با پاداش (آبشار) com.google.ads.mediation.vungle.VungleMediationAdapter

iOS

قالب نام کلاس
باز کردن برنامه (مناقصه) GADMediationAdapterVungle
برنامه باز (آبشار) GADMediationAdapterVungle
بنر (مناقصه) GADMediationAdapterVungle
بنر (آبشار) GADMAdapterVungleInterstitial
بینابینی (مناقصه) GADMediationAdapterVungle
بینابینی (آبشار) GADMAdapterVungleInterstitial
پاداش داده شده (مناقصه) GADMediationAdapterVungle
پاداش (آبشار) GADMAdapterVungleRewardBasedVideoAd
بینابینی با پاداش (مناقصه) GADMediationAdapterVungle
بینابینی با پاداش (آبشار) GADMediationAdapterVungle

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

اندروید

کد خطا دلیل
101 پارامترهای سرور نامعتبر (مانند شناسه برنامه یا شناسه مکان).
102 اندازه بنر درخواستی با اندازه تبلیغ معتبر Liftoff Monetize مطابقت ندارد.
103 Liftoff Monetize به یک زمینه Activity برای درخواست تبلیغات نیاز دارد.
104 Vungle SDK نمی‌تواند چندین آگهی را برای شناسه مکان یکسان بارگیری کند.
105 Vungle SDK راه اندازی نشد.
106 Vungle SDK یک بار تماس با موفقیت را برگرداند، اما Banners.getBanner() یا Vungle.getNativeAd() null برگرداندند.
107 Vungle SDK برای پخش آگهی آماده نیست.
108 Vungle SDK کد پیشنهادی نامعتبر را برگرداند.

iOS

کد خطا دلیل
101 پارامترهای سرور نامعتبر (مانند شناسه برنامه یا شناسه مکان).
102 یک آگهی قبلاً برای این پیکربندی شبکه بارگیری شده است. Vungle SDK نمی‌تواند آگهی دومی را برای همان شناسه مکان بارگیری کند.
103 اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده Liftoff Monetize مطابقت ندارد.
104 Vungle SDK نتوانست آگهی بنر را ارائه دهد.
105 Vungle SDK تنها از بارگیری 1 آگهی بنر در یک زمان پشتیبانی می کند، صرف نظر از شناسه مکان.
106 Vungle SDK پاسخ تماسی ارسال کرد و گفت که تبلیغ قابل پخش نیست.
107 Vungle SDK برای پخش آگهی آماده نیست.

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

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

نسخه 5.2.1

نسخه 5.2.0

نسخه 5.1.1

نسخه 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

نسخه 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

نسخه 3.9.1

نسخه 3.9.0

نسخه 3.8.2

نسخه 3.8.1

نسخه 3.8.0

نسخه 3.7.5

نسخه 3.7.4

نسخه 3.7.3

نسخه 3.7.2

نسخه 3.7.1

نسخه 3.7.0

نسخه 3.6.0

نسخه 3.5.1

نسخه 3.5.0

نسخه 3.4.1

نسخه 3.4.0

نسخه 3.3.1

نسخه 3.3.0

نسخه 3.2.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.