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

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

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

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

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

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

الزامات

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

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

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

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

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

اندروید

iOS

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

اندروید

iOS

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

اندروید

iOS

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

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

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

بنر را انتخاب کنید، یک نام مکان وارد کنید و بقیه فرم را پر کنید. [فقط مناقصه] در بخش کسب درآمد ، سوئیچ پیشنهاد قیمت درون برنامه را روی فعال قرار دهید. برای ایجاد مکان، روی دکمه Continue در پایین صفحه کلیک کنید.

بنر 300x250

MREC را انتخاب کنید، یک نام مکان وارد کنید و بقیه فرم را پر کنید. [فقط مناقصه] در بخش کسب درآمد ، سوئیچ پیشنهاد قیمت درون برنامه را روی فعال قرار دهید. برای ایجاد مکان، روی دکمه Continue در پایین صفحه کلیک کنید.

بینابینی

Interstitial را انتخاب کنید، یک نام مکان وارد کنید و بقیه فرم را پر کنید. [فقط مناقصه] در بخش کسب درآمد ، سوئیچ پیشنهاد قیمت درون برنامه را روی فعال قرار دهید. برای ایجاد مکان، روی دکمه Continue در پایین صفحه کلیک کنید.

پاداش داده شد

Rewarded را انتخاب کنید، یک نام مکان وارد کنید و بقیه فرم را پر کنید. [فقط مناقصه] در بخش کسب درآمد ، سوئیچ پیشنهاد قیمت درون برنامه را روی فعال قرار دهید. برای ایجاد مکان، روی دکمه Continue در پایین صفحه کلیک کنید.

بینابینی پاداش

Rewarded را انتخاب کنید. یک نام مکان را وارد کنید، Skippable را فعال کنید و بقیه فرم را پر کنید. [فقط مناقصه] در بخش کسب درآمد ، سوئیچ پیشنهاد قیمت درون برنامه را روی فعال قرار دهید. برای ایجاد مکان، روی دکمه Continue در پایین صفحه کلیک کنید.

بومی

بومی را انتخاب کنید، یک نام مکان وارد کنید و بقیه فرم را پر کنید. [فقط مناقصه] در بخش کسب درآمد ، سوئیچ پیشنهاد قیمت درون برنامه را روی فعال قرار دهید. برای ایجاد مکان، روی دکمه Continue در پایین صفحه کلیک کنید.

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

بنر 300x250

بینابینی

پاداش داده شد

بینابینی پاداش

بومی

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

مناقصه

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

آبشار

علاوه بر شناسه برنامه و شناسه مرجع ، برای تنظیم شناسه واحد تبلیغات Ad Manager خود به کلید API گزارش درآمدزایی Liftoff نیز نیاز دارید. به داشبورد Liftoff Monetize Reports بروید و روی دکمه Reporting API Key کلیک کنید تا Reporting API Key خود را مشاهده کنید.

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

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

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

اندروید

iOS

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

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

اندروید

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

iOS

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

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

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

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

OpenUPM-CLI

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

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

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

ثبت واحدها

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

از OpenUPM نصب کنید

پکیج یونیتی

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

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

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

سپس، Assets > External Dependency Manager > Android Resolver > Force Resolve را انتخاب کنید. کتابخانه External Dependency Manager تفکیک وابستگی را از ابتدا انجام می دهد و وابستگی های اعلام شده را در فهرست 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: اجرای خود را آزمایش کنید

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

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

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

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

کدهای خطا

اگر آداپتور نتواند تبلیغی را از 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.2

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