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 تنظیم کنید

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

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

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

اندروید

iOS

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

اندروید

iOS

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

اندروید

iOS

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

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

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

برنامه باز شود

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

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

بنر 300x250

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

بینابینی

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

پاداش داده شد

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

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

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

بومی

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

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

برنامه باز شود

بنر 300x250

بینابینی

پاداش داده شد

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

بومی

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

مناقصه

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

آبشار

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

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

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

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

اندروید

iOS

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

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

اندروید

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

iOS

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

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

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

مرحله 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: اجرای خود را آزمایش کنید

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

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

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

برای تأیید اینکه آگهی‌های آزمایشی را از 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.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.