این راهنما به شما نشان میدهد که چگونه از SDK تبلیغات موبایل گوگل برای بارگذاری و نمایش تبلیغات از Liftoff Monetize با استفاده از AdMob Mediation استفاده کنید که شامل ادغامهای پیشنهاد قیمت و آبشاری میشود. این راهنما نحوه اضافه کردن Liftoff Monetize به پیکربندی میانجیگری یک واحد تبلیغاتی و نحوه ادغام SDK و آداپتور Vungle در یک برنامه اندروید را پوشش میدهد.
ادغامها و قالبهای تبلیغاتی پشتیبانیشده
آداپتور میانجیگری برای Liftoff Monetize قابلیتهای زیر را دارد:
| ادغام | |
|---|---|
| مناقصه | |
| آبشار | |
| قالبها | |
| برنامه باز است | |
| بنر | |
| بینابینی | |
| پاداش داده شده | |
| تبلیغات بینابینی پاداشدار | |
| بومی | |
الزامات
اندروید API سطح ۲۳ یا بالاتر
[برای پیشنهاد قیمت]: برای ادغام تمام قالبهای تبلیغاتی پشتیبانیشده در پیشنهاد قیمت، از آداپتور Liftoff Monetize نسخه ۷.۳.۰.۰ یا بالاتر استفاده کنید ( آخرین نسخه توصیه میشود )
جدیدترین SDK تبلیغات موبایلی گوگل.
راهنمای شروع میانجیگری را تکمیل کنید.
مرحله ۱: تنظیمات را در Liftoff Monetize UI تنظیم کنید
ثبت نام کنید یا وارد حساب کاربری خود در Liftoff Monetize شوید .
با کلیک بر روی دکمهی «افزودن برنامه» ، برنامهی خود را به داشبورد Liftoff Monetize اضافه کنید.

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

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

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

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

جزئیات مربوط به اضافه کردن مکانهای جدید در زیر آمده است:
برنامه باز است
گزینه Interstitial را انتخاب کنید و یک نام برای جایگاه تبلیغاتی وارد کنید. سپس، برای Skippable گزینه Yes را انتخاب کنید و بقیه فرم را پر کنید. [Bidding only] در قسمت Monetization ، گزینه In-App Bidding را روی Enabled قرار دهید. برای ایجاد جایگاه تبلیغاتی، روی دکمه Continue در پایین صفحه کلیک کنید.

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

بنر ۳۰۰x۲۵۰
MREC را انتخاب کنید، یک نام برای جایگاه نمایش وارد کنید و بقیه فرم را پر کنید. [فقط پیشنهاد قیمت] در قسمت کسب درآمد ، گزینه پیشنهاد قیمت درون برنامهای را روی فعال قرار دهید. برای ایجاد جایگاه نمایش، روی دکمه ادامه در پایین صفحه کلیک کنید.

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

پاداش داده شده
گزینه «Rewarded» را انتخاب کنید، یک نام برای جایگاه نمایش وارد کنید و بقیه فرم را پر کنید. [Bidding only] در قسمت «Monetization» ، گزینه «In-App Bidding» را روی «Enabled» قرار دهید. برای ایجاد جایگاه نمایش، روی دکمه «Continue» در پایین صفحه کلیک کنید.

تبلیغات بینابینی پاداشدار
گزینه «Rewarded» را انتخاب کنید. یک نام برای جایگاه تبلیغاتی وارد کنید، گزینه «Skipable» را فعال کنید و بقیه فرم را پر کنید. [Bidding only] در قسمت «Monetization» ، گزینه « In-App Bidding» را روی «Enabled» قرار دهید. برای ایجاد جایگاه تبلیغاتی، روی دکمه «Continue» در پایین صفحه کلیک کنید.

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

شناسه مرجع را یادداشت کنید و روی «صداها خوب است» کلیک کنید.
برنامه باز است

بنر

بنر ۳۰۰x۲۵۰

بینابینی

پاداش داده شده

تبلیغات بینابینی پاداشدار

بومی

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

فایل app-ads.txt خود را بهروزرسانی کنید.
فروشندگان مجاز برنامهها app-ads.txt یک ابتکار آزمایشگاه فناوری IAB است که به شما کمک میکند تا موجودی تبلیغات برنامه خود را فقط از طریق کانالهایی که به عنوان مجاز شناسایی کردهاید، به فروش برسانید. برای جلوگیری از کاهش قابل توجه درآمد تبلیغات، باید یک فایل app-ads.txt پیادهسازی کنید. اگر قبلاً این کار را نکردهاید، یک فایل app-ads.txt برای برنامه خود تنظیم کنید .
برای پیادهسازی app-ads.txt برای Liftoff Monetize، ورودیهای app-ads.txt مربوط به Liftoff Monetize را دانلود و به فایل app-ads.txt موجود خود اضافه کنید. برای اطلاعات بیشتر، به app-ads.txt مراجعه کنید.
حالت تست را روشن کنید
برای فعال کردن تبلیغات آزمایشی، به داشبورد Liftoff Monetize خود بروید و به Applications بروید.
برنامهای را که میخواهید تبلیغات آزمایشی برای آن فعال شود، در بخش «شناسه مرجع قرارگیری» برنامه خود انتخاب کنید. تبلیغات آزمایشی را میتوان با انتخاب «حالت آزمایشی» برای نمایش فقط تبلیغات آزمایشی در بخش « وضعیت» فعال کرد.

مرحله ۲: تنظیم تقاضای کسب درآمد Liftoff در رابط کاربری AdMob
تنظیمات میانجیگری را برای واحد تبلیغاتی خود پیکربندی کنید
شما باید Liftoff Monetize را به پیکربندی میانجیگری برای واحد تبلیغاتی خود اضافه کنید.
ابتدا، وارد حساب کاربری AdMob خود شوید. سپس، به برگه Mediation بروید. اگر یک گروه میانجیگری موجود دارید که میخواهید آن را تغییر دهید، روی نام آن گروه میانجیگری کلیک کنید تا آن را ویرایش کنید و به بخش Add Liftoff Monetize as an ad source بروید.
برای ایجاد یک گروه میانجیگری جدید، گزینه «ایجاد گروه میانجیگری» را انتخاب کنید.

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

به گروه میانجیگری خود یک نام بدهید و مکانهایی را برای هدف قرار دادن انتخاب کنید. در مرحله بعد، وضعیت گروه میانجیگری را روی فعال (Enabled) تنظیم کنید و سپس روی افزودن واحدهای تبلیغاتی (Add Ad Units) کلیک کنید.

این گروه میانجی را با یک یا چند واحد تبلیغاتی AdMob موجود خود مرتبط کنید. سپس روی «انجام شد» کلیک کنید.

اکنون باید کارت واحدهای تبلیغاتی را ببینید که با واحدهای تبلیغاتی که انتخاب کردهاید پر شده است:

Liftoff Monetize را به عنوان منبع تبلیغات اضافه کنید
مناقصه
در قسمت « منابع تبلیغات» ، زیر کارت پیشنهاد قیمت ، گزینه «افزودن منبع تبلیغات» را انتخاب کنید. سپس «افزایش درآمد از طریق لیفتآف» را انتخاب کنید.روی نحوه امضای قرارداد مشارکت و تنظیم مشارکت در مناقصه با Liftoff Monetize کلیک کنید.

روی تأیید و موافقت کلیک کنید، سپس روی ادامه کلیک کنید.

اگر از قبل نگاشتی برای Liftoff Monetize دارید، میتوانید آن را انتخاب کنید. در غیر این صورت، روی افزودن نگاشت کلیک کنید.

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

آبشار
در زیر کارت Waterfall در بخش Ad Sources ، گزینه Add Ad Source را انتخاب کنید.
Liftoff Monetize را انتخاب کنید و کلید Optimize را فعال کنید. کلید API گزارشدهی که در بخش قبل به دست آوردید را وارد کنید تا بهینهسازی منبع تبلیغات برای Liftoff Monetize تنظیم شود. سپس یک مقدار eCPM برای Liftoff Monetize وارد کنید و روی Continue کلیک کنید.

اگر از قبل نگاشتی برای Liftoff Monetize دارید، میتوانید آن را انتخاب کنید. در غیر این صورت، روی افزودن نگاشت کلیک کنید.

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

Liftoff را به فهرست شرکای تبلیغاتی GDPR و مقررات ایالتی ایالات متحده اضافه کنید
برای اضافه کردن Liftoff به فهرست شرکای تبلیغاتی مقررات ایالتی اروپا و ایالات متحده در رابط کاربری AdMob، مراحل موجود در تنظیمات مقررات اروپا و تنظیمات مقررات ایالت ایالات متحده را دنبال کنید.
مرحله ۳: وارد کردن Vungle SDK و آداپتور Liftoff Monetize
ادغام با اندروید استودیو (توصیه میشود)
در فایل build.gradle.kts سطح برنامه خود، وابستگیها و پیکربندیهای پیادهسازی زیر را اضافه کنید. از آخرین نسخههای Vungle SDK و آداپتور استفاده کنید:
dependencies {
implementation("com.google.android.gms:play-services-ads:24.7.0")
implementation("com.google.ads.mediation:vungle:7.6.0.0")
}
ادغام دستی
آخرین نسخه Vungle Android SDK را دانلود کنید و فایلهای
.aarو JAR را از پوشهlibsاستخراج کرده و به پروژه خود اضافه کنید.به مصنوعات آداپتور Liftoff Monetize در مخزن Maven گوگل بروید. آخرین نسخه را انتخاب کنید، فایل
.aarآداپتور Vungle را دانلود کنید و آن را به پروژه خود اضافه کنید.
مرحله ۴: تنظیمات حریم خصوصی را روی Vungle SDK پیادهسازی کنید
رضایت اتحادیه اروپا و GDPR
برای رعایت سیاست رضایت کاربر اتحادیه اروپا گوگل ، شما باید اطلاعات خاصی را در اختیار کاربران خود در منطقه اقتصادی اروپا (EEA)، بریتانیا و سوئیس قرار دهید و رضایت آنها را برای استفاده از کوکیها یا سایر ذخیرهسازیهای محلی در صورت لزوم قانونی، و برای جمعآوری، اشتراکگذاری و استفاده از دادههای شخصی برای شخصیسازی تبلیغات، دریافت کنید. این سیاست منعکسکننده الزامات دستورالعمل حریم خصوصی الکترونیکی اتحادیه اروپا و مقررات عمومی حفاظت از دادهها (GDPR) است. شما مسئول تأیید انتشار رضایت به هر منبع تبلیغاتی در زنجیره واسطهگری خود هستید. گوگل قادر نیست رضایت کاربر را به طور خودکار به چنین شبکههایی منتقل کند.
با شروع از نسخه ۷.۴.۱ کیت توسعه نرمافزار Vungle، ابزار Liftoff Monetize بهطور خودکار رضایتنامه GDPR تنظیمشده توسط پلتفرمهای مدیریت رضایتنامه که از مشخصات رضایتنامه اضافی گوگل ، از جمله UMP SDK، پشتیبانی میکنند را میخواند. برای اطلاعات بیشتر، به دستورالعملهای پیادهسازی توصیهشده GDPR مراجعه کنید.
قوانین حفظ حریم خصوصی ایالتهای آمریکا
قوانین حفظ حریم خصوصی ایالتهای ایالات متحده، به کاربران حق انصراف از «فروش» «اطلاعات شخصی» خود (همانطور که قانون این اصطلاحات را تعریف میکند) را میدهد، و این انصراف از طریق پیوند برجسته «اطلاعات شخصی من را نفروشید» در صفحه اصلی طرف «فروشنده» ارائه میشود. راهنمای انطباق با قوانین حفظ حریم خصوصی ایالتهای ایالات متحده، امکان فعال کردن پردازش دادههای محدود برای سرویس تبلیغات گوگل را ارائه میدهد، اما گوگل قادر به اعمال این تنظیم برای هر شبکه تبلیغاتی در زنجیره واسطهگری شما نیست. بنابراین، شما باید هر شبکه تبلیغاتی را در زنجیره واسطهگری خود که ممکن است در فروش اطلاعات شخصی شرکت کند، شناسایی کنید و برای اطمینان از انطباق، از راهنماییهای هر یک از این شبکهها پیروی کنید.
Liftoff Monetize شامل یک API است که به شما امکان میدهد رضایت خود را به Vungle SDK ارسال کنید. نمونه کد زیر نحوه ارسال این اطلاعات رضایت به Vungle SDK را نشان میدهد. اگر تصمیم به فراخوانی این روش دارید، توصیه میشود قبل از درخواست تبلیغات از طریق Google Mobile Ads SDK این کار را انجام دهید.
جاوا
import com.vungle.ads.VunglePrivacySettings;
// ...
VunglePrivacySettings.setCCPAStatus(true);
کاتلین
import com.vungle.ads.VunglePrivacySettings
// ...
VunglePrivacySettings.setCCPAStatus(true)
برای جزئیات بیشتر و مقادیری که میتوانند در این روش ارائه شوند، به پیادهسازی CCPA مراجعه کنید.
مرحله ۵: اضافه کردن کد مورد نیاز
برای ادغام Liftoff Monetize به کد اضافی نیاز نیست.
مرحله ۶: پیادهسازی خود را آزمایش کنید
فعال کردن تبلیغات آزمایشی
مطمئن شوید که دستگاه آزمایشی خود را برای AdMob ثبت کردهاید و حالت آزمایشی را در Liftoff Monetize UI فعال کردهاید .
تأیید تبلیغات آزمایشی
برای تأیید اینکه تبلیغات آزمایشی را از Liftoff Monetize دریافت میکنید، آزمایش منبع تبلیغاتی تکی را در بازرس تبلیغات با استفاده از منبع(های) تبلیغاتی Liftoff Monetize (Bidding) و Liftoff Monetize (Waterfall) فعال کنید.
مراحل اختیاری
پارامترهای خاص شبکه
آداپتور Liftoff Monetize از پارامترهای درخواست اضافی زیر که میتوانند به آداپتور ارسال شوند، پشتیبانی میکند:
-
userId - رشتهای که نشاندهندهی شناسهی کاربری تشویقی Liftoff Monetize است.
-
adOrientation - یک عدد صحیح که جهت نمایش تبلیغات تمام صفحه را مشخص میکند.
در اینجا یک نمونه کد از نحوه ایجاد یک درخواست تبلیغ که این پارامترها را تنظیم میکند، آورده شده است:
جاوا
Bundle extras = new Bundle();
extras.putString(VungleConstants.KEY_USER_ID, "myUserID");
extras.putInt(VungleConstants.KEY_ORIENTATION, 1);
AdRequest request = new AdRequest.Builder()
.addNetworkExtrasBundle(VungleAdapter.class, extras) // Rewarded.
.addNetworkExtrasBundle(VungleInterstitialAdapter.class, extras) // Interstitial.
.build();
کاتلین
val extras = Bundle()
extras.putString(VungleConstants.KEY_USER_ID, "myUserID")
extras.putInt(VungleConstants.KEY_ORIENTATION, 1)
val request = AdRequest.Builder()
.addNetworkExtrasBundle(VungleAdapter::class, extras) // Rewarded.
.addNetworkExtrasBundle(VungleInterstitialAdapter.class, extras) // Interstitial.
.build()
رندر تبلیغات بومی
آداپتور Liftoff Monetize تبلیغات بومی خود را به عنوان اشیاء NativeAd برمیگرداند. این آداپتور توضیحات فیلد تبلیغات بومی زیر را برای یک NativeAd پر میکند.
| میدان | داراییهایی که همیشه توسط آداپتور Liftoff Monetize لحاظ میشوند |
|---|---|
| تیتر | |
| تصویر | ۱ |
| نمای رسانه | |
| بدن | |
| آیکون برنامه | |
| فراخوان برای اقدام | |
| رتبهبندی ستارهای | |
| فروشگاه | |
| قیمت |
آداپتور Liftoff Monetize دسترسی مستقیم به تصویر اصلی برای تبلیغات بومی خود را فراهم نمیکند. در عوض، این آداپتور MediaView با یک ویدیو یا یک تصویر پر میکند.
کدهای خطا
اگر آداپتور نتواند تبلیغی از Liftoff Monetize دریافت کند، ناشران میتوانند خطای اساسی را از پاسخ تبلیغ با استفاده از ResponseInfo.getAdapterResponses() تحت کلاسهای زیر بررسی کنند:
| قالب | نام کلاس |
|---|---|
| برنامه باز است (مناقصه) | 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 |
| بومی (مناقصه) | com.google.ads.mediation.vungle.VungleMediationAdapter |
| بومی (آبشار) | com.google.ads.mediation.vungle.VungleMediationAdapter |
در اینجا کدها و پیامهای همراه که توسط آداپتور Liftoff Monetize هنگام عدم بارگیری یک تبلیغ نمایش داده میشوند، آمده است:
| کد خطا | دامنه | دلیل |
|---|---|---|
| ۱۰۱ | com.google.ads.mediation.vungle | پارامترهای سرور نامعتبر است (مثلاً شناسه برنامه یا شناسه قرارگیری). |
| ۱۰۲ | com.google.ads.mediation.vungle | اندازه بنر درخواستی با اندازه تبلیغات معتبر Liftoff Monetize مطابقت ندارد. |
| ۱۰۳ | com.google.ads.mediation.vungle | Liftoff Monetize برای درخواست تبلیغات به یک زمینه Activity (Activity context) نیاز دارد. |
| ۱۰۴ | com.google.ads.mediation.vungle | کیت توسعه نرمافزاری Vungle نمیتواند چندین تبلیغ را برای یک شناسه قرارگیری یکسان بارگذاری کند. |
| ۱۰۵ | com.google.ads.mediation.vungle | SDK وانگِل (Vungle) نتوانست مقداردهی اولیه شود. |
| ۱۰۶ | com.google.ads.mediation.vungle | Vungle SDK یک فراخوانی موفقیتآمیز برای بارگذاری برگرداند، اما Banners.getBanner() یا Vungle.getNativeAd() مقدار null را برمیگردانند. |
| ۱۰۷ | com.google.ads.mediation.vungle | کیت توسعه نرمافزاری وانگل (Vungle SDK) برای پخش تبلیغ آماده نیست. |
| ۱۰۸ | com.google.ads.mediation.vungle | Vungle SDK توکن پیشنهاد قیمت نامعتبر را برگرداند. |
برای خطاهایی که از Vungle SDK ناشی میشوند، به کدهای خطا: Vungle SDK برای iOS و اندروید مراجعه کنید.
لیست تغییرات آداپتور واسطهگری اندروید Liftoff برای کسب درآمد
نسخه ۷.۶.۰.۰
- سازگاری تأیید شده با Vungle SDK 7.6.0.
ساخته و آزمایش شده با:
- نسخه ۲۴.۷.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه ۷.۶.۰ کیت توسعه نرمافزار وانگِل.
نسخه ۷.۵.۱.۱
- ارجاعات سطح کلاس به Context حذف شد. میتواند به کاهش مشکلات نشت حافظه کمک کند.
- پیادهسازی API جدید برای تبلیغ بنری آبشاری اضافه شد.
ساخته و آزمایش شده با:
- نسخه ۲۴.۷.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه ۷.۵.۱ از SDK وانگل.
نسخه ۷.۵.۱.۰
- سازگاری تأیید شده با Vungle SDK 7.5.1.
ساخته و آزمایش شده با:
- نسخه ۲۴.۵.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه ۷.۵.۱ از SDK وانگل.
نسخه ۷.۵.۰.۱
-
overrideImpressionRecordingبرای هر دو نوع تبلیغات بومی آبشاری و RTB روی true تنظیم میکند.
ساخته و آزمایش شده با:
- نسخه ۲۴.۴.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه ۷.۵.۰ کیت توسعه نرمافزار وانگِل.
نسخه ۷.۵.۰.۰
- سازگاری تأیید شده با Vungle SDK 7.5.0.
ساخته و آزمایش شده با:
- نسخه ۲۴.۲.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه ۷.۵.۰ کیت توسعه نرمافزار وانگِل.
نسخه ۷.۴.۳.۱
- حداقل سطح API اندروید مورد نیاز به ۲۳ ارتقا یافت.
- حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به ۲۴.۰.۰ بهروزرسانی شد.
ساخته و آزمایش شده با:
- نسخه ۲۴.۰.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه ۷.۴.۳ از SDK وانگل.
نسخه ۷.۴.۳.۰
- سازگاری تأیید شده با Vungle SDK 7.4.3.
ساخته و آزمایش شده با:
- نسخه ۲۳.۶.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه ۷.۴.۳ از SDK وانگل.
نسخه ۷.۴.۲.۰
- سازگاری تأیید شده با Vungle SDK 7.4.2.
ساخته و آزمایش شده با:
- نسخه ۲۳.۵.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه ۷.۴.۲ از SDK وانگل.
نسخه ۷.۴.۱.۰
- سازگاری تأیید شده با Vungle SDK 7.4.1.
ساخته و آزمایش شده با:
- نسخه ۲۳.۳.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه ۷.۴.۱ از SDK وانگل.
نسخه ۷.۴.۰.۱
- پشتیبانی از اندازه سفارشی تبلیغ برای تبلیغات بنری آبشاری و مزایدهای اضافه شد.
ساخته و آزمایش شده با:
- نسخه ۲۳.۲.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه ۷.۴.۰ کیت توسعه نرمافزار وانگِل.
نسخه ۷.۴.۰.۰
- کلاس
VungleInterstitialAdapterرا ازVungleMediationAdapterتوسعه دادیم تا پشتیبانی آبشاری را برای قالب تبلیغات باز برنامه در Google Ad Manager اضافه کنیم. - سازگاری تأیید شده با Vungle SDK 7.4.0.
ساخته و آزمایش شده با:
- نسخه ۲۳.۲.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه ۷.۴.۰ کیت توسعه نرمافزار وانگِل.
نسخه ۷.۳.۲.۰
- سازگاری تأیید شده با Vungle SDK 7.3.2.
ساخته و آزمایش شده با:
- نسخه ۲۳.۰.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه ۷.۳.۲ از SDK وانگل.
نسخه ۷.۳.۱.۰
- سازگاری تأیید شده با Vungle SDK 7.3.1.
ساخته و آزمایش شده با:
- نسخه ۲۳.۰.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه ۷.۳.۱ از SDK وانگل.
نسخه ۷.۳.۰.۰
- حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به ۲۳.۰.۰ بهروزرسانی شد.
- سازگاری تأیید شده با Vungle SDK 7.3.0.
- پشتیبانی از آبشار و پیشنهاد قیمت برای قالب تبلیغات باز برنامه اضافه شد.
ساخته و آزمایش شده با:
- نسخه ۲۳.۰.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه ۷.۳.۰ کیت توسعه نرمافزار وانگِل.
نسخه ۷.۱.۰.۰
- سازگاری تأیید شده با Vungle SDK 7.1.0.
ساخته و آزمایش شده با:
- نسخه ۲۲.۳.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه ۷.۱.۰ کیت توسعه نرمافزار وانگِل.
نسخه ۷.۰.۰.۱
- مشکلی که باعث میشد SDK تبلیغات موبایلی گوگل، نمایشها (impressions) را برای پیشنهاد قیمت تبلیغات بومی ثبت نکند، برطرف شد.
- آداپتور را به نسخه ۲۲.۳.۰ کیت توسعه نرمافزاری تبلیغات موبایل گوگل (Google Mobile Ads SDK) وابسته کردیم.
ساخته و آزمایش شده با:
- نسخه ۲۲.۳.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه ۷.۰.۰ کیت توسعه نرمافزار وانگِل.
نسخه ۷.۰.۰.۰
- پشتیبانی از بارگذاری چندین تبلیغ با شناسه قرارگیری یکسان برای همه قالبهای تبلیغات آبشاری اضافه شد.
- نام آداپتور از Vungle به Liftoff Monetize تغییر یافت.
- سازگاری تأیید شده با Vungle SDK 7.0.0.
ساخته و آزمایش شده با:
- نسخه ۲۲.۴.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه ۷.۰.۰ کیت توسعه نرمافزار وانگِل.
نسخه ۶.۱۲.۱.۱
- آداپتور برای استفاده از کلاس
VersionInfoجدید بهروزرسانی شد. - حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به ۲۲.۰.۰ بهروزرسانی شد.
ساخته و آزمایش شده با:
- نسخه ۲۲.۰.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه SDK وانگل ۶.۱۲.۱.
نسخه ۶.۱۲.۱.۰
- سازگاری تأیید شده با Vungle SDK 6.12.1.
ساخته و آزمایش شده با:
- نسخه ۲۱.۴.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه SDK وانگل ۶.۱۲.۱.
نسخه ۶.۱۲.۰.۱
- پشتیبانی از پیشنهاد قیمت برای قالب بنر تبلیغاتی اضافه شد.
- سازگاری تأیید شده با Vungle SDK 6.12.0.
- حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به ۲۱.۴.۰ بهروزرسانی شد.
ساخته و آزمایش شده با:
- نسخه ۲۱.۴.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه SDK وانگِل ۶.۱۲.۰.
نسخه ۶.۱۲.۰.۰
- پشتیبانی از میانجیگری آبشاری و پیشنهاد قیمت برای قالب تبلیغات بینابینی پاداشی اضافه شد.
- پشتیبانی از پیشنهاد قیمت برای قالب تبلیغات بومی اضافه شد.
ساخته و آزمایش شده با:
- نسخه ۲۱.۱.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه SDK وانگِل ۶.۱۲.۰.
نسخه ۶.۱۱.۰.۳
- پشتیبانی از میانجیگری آبشاری برای قالب تبلیغات بومی اضافه شد.
- حداقل نسخه SDK مورد نیاز برای تبلیغات موبایلی گوگل به ۲۱.۱.۰ بهروزرسانی شد.
ساخته و آزمایش شده با:
- نسخه ۲۱.۱.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه SDK وانگِل ۶.۱۱.۰.
نسخه ۶.۱۱.۰.۲
- پشتیبانی از بارگذاری چندین تبلیغ برای یک شناسه قرارگیری مشابه در تبلیغات جایزهدار اضافه شد.
ساخته و آزمایش شده با:
- نسخه ۲۱.۰.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه SDK وانگِل ۶.۱۱.۰.
نسخه ۶.۱۱.۰.۱
-
compileSdkVersionوtargetSdkVersionبه API 31 بهروزرسانی شدند. - حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به ۲۱.۰.۰ بهروزرسانی شد.
- حداقل سطح API اندروید مورد نیاز به ۱۹ ارتقا یافت.
ساخته و آزمایش شده با:
- نسخه ۲۱.۰.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه SDK وانگِل ۶.۱۱.۰.
نسخه ۶.۱۱.۰.۰
- سازگاری تأیید شده با Vungle SDK 6.11.0.
ساخته و آزمایش شده با:
- نسخه ۲۰.۶.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه SDK وانگِل ۶.۱۱.۰.
نسخه ۶.۱۰.۵.۰
- سازگاری تأیید شده با Vungle SDK 6.10.5.
- حداقل نسخه SDK مورد نیاز برای تبلیغات موبایلی گوگل به 20.6.0 بهروزرسانی شد.
ساخته و آزمایش شده با:
- نسخه ۲۰.۶.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه ۶.۱۰.۵ از SDK وانگل.
نسخه ۶.۱۰.۴.۰
- سازگاری تأیید شده با Vungle SDK 6.10.4.
ساخته و آزمایش شده با:
- نسخه ۲۰.۵.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه SDK وانگِل ۶.۱۰.۴.
نسخه ۶.۱۰.۳.۰
- سازگاری تأیید شده با Vungle SDK 6.10.3.
ساخته و آزمایش شده با:
- نسخه ۲۰.۵.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه SDK وانگِل ۶.۱۰.۳.
نسخه ۶.۱۰.۲.۱
- سازگاری تأیید شده با Vungle SDK 6.10.2.
- پشتیبانی از پیشنهاد قیمت برای قالبهای تبلیغات بینابینی و پاداشی اضافه شد.
- حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به 20.5.0 بهروزرسانی شد.
ساخته و آزمایش شده با:
- نسخه ۲۰.۵.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه SDK وانگِل ۶.۱۰.۲.
نسخه ۶.۱۰.۲.۰
- سازگاری تأیید شده با Vungle SDK 6.10.2.
- با جایگزینی پارامتر
serverParametersباmediationExtrasبرای دریافت پارامترهای خاص شبکه Vungle، هنگام درخواست تبلیغات بنری و بینابینی، مشکل آداپتور برطرف شد.
ساخته و آزمایش شده با:
- نسخه ۲۰.۳.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه SDK وانگِل ۶.۱۰.۲.
نسخه ۶.۱۰.۱.۰
- سازگاری تأیید شده با Vungle SDK 6.10.1.
- حداقل نسخه SDK مورد نیاز برای تبلیغات موبایلی گوگل به 20.3.0 بهروزرسانی شد.
- تبلیغات MREC اکنون با API بنر Vungle پشتیبانی میشوند.
- کدهای خطا و پیامهای استاندارد بهروزرسانی شدند.
ساخته و آزمایش شده با:
- نسخه ۲۰.۳.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه ۶.۱۰.۱ از SDK وانگل.
نسخه ۶.۹.۱.۱
- حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به 20.0.0 بهروزرسانی شد.
ساخته و آزمایش شده با:
- نسخه ۲۰.۰.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه ۶.۹.۱ از SDK وانگل.
نسخه ۶.۹.۱.۰
- سازگاری تأیید شده با Vungle SDK 6.9.1.
- پشتیبانی از OMSDK اضافه شد.
- رفع اشکالات مختلف.
- پشتیبانی از تبلیغات جایزهدار برای فراخوانی Vungle در AdViewed.
- حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به ۱۹.۷.۰ بهروزرسانی شد.
ساخته و آزمایش شده با:
- نسخه ۱۹.۷.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل
- نسخه ۶.۹.۱ از SDK وانگل.
نسخه ۶.۸.۱.۱
- حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به ۱۹.۶.۰ بهروزرسانی شد.
ساخته و آزمایش شده با:
- نسخه ۱۹.۶.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه ۶.۸.۱ از SDK وانگل.
نسخه ۶.۸.۱.۰
- سازگاری تأیید شده با Vungle SDK 6.8.1.
- حداقل نسخه SDK مورد نیاز برای تبلیغات موبایلی گوگل به ۱۹.۵.۰ بهروزرسانی شد.
ساخته و آزمایش شده با:
- نسخه ۱۹.۵.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه ۶.۸.۱ از SDK وانگل.
نسخه ۶.۸.۰.۰
- سازگاری تأیید شده با Vungle SDK 6.8.0.
- آداپتور بهروزرسانی شد تا هنگام بهروزرسانی یا از بین رفتن تبلیغات بنری،
onAdClosed() ارسال نشود. -
FlexFeedوFlexViewرا حذف کنید (در Vungle 6.8.0 منسوخ شدهاند). - حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به ۱۹.۴.۰ بهروزرسانی شد.
ساخته و آزمایش شده با:
- نسخه ۱۹.۴.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل
- نسخه ۶.۸.۰ کیت توسعه نرمافزاری وانگِل.
نسخه ۶.۷.۱.۰
- سازگاری تأیید شده با Vungle SDK 6.7.1.
- اشکالی که باعث میشد اگر تبلیغی با استفاده از یک زمینه برنامه بارگذاری میشد، بارگذاری نشود، برطرف شد.
-
targetSdkVersionبه API 29 بهروزرسانی شد. - حداقل نسخه SDK مورد نیاز برای تبلیغات موبایلی گوگل به ۱۹.۳.۰ بهروزرسانی شد.
ساخته و آزمایش شده با:
- نسخه ۱۹.۳.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه ۶.۷.۱ از SDK وانگل.
نسخه ۶.۷.۰.۰
- سازگاری تأیید شده با Vungle SDK 6.7.0.
- آداپتور بهروزرسانی شد تا از درخواستهای بنر تطبیقی درونخطی پشتیبانی کند.
- تبلیغات بینابینی و تبلیغات جایزهدار اکنون به طور پیشفرض بیصدا هستند.
- تبلیغات بینابینی اکنون هنگام کلیک، تابع فراخوانی
onAdLeftApplication()را ارسال میکنند. - حداقل نسخه SDK مورد نیاز برای تبلیغات موبایلی گوگل به ۱۹.۲.۰ بهروزرسانی شد.
ساخته و آزمایش شده با:
- نسخه ۱۹.۲.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه ۶.۷.۰ کیت توسعه نرمافزاری وانگِل.
نسخه ۶.۵.۳.۰
- سازگاری تأیید شده با Vungle SDK 6.5.3.
- پشتیبانی از فرمت بنر جدید Vungle اضافه شد.
- حداقل نسخه SDK مورد نیاز برای تبلیغات موبایلی گوگل به ۱۹.۰.۱ بهروزرسانی شد.
ساخته و آزمایش شده با:
- نسخه ۱۹.۰.۱ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه ۶.۵.۳ از SDK وانگل.
نسخه ۶.۴.۱۱.۱
- مشکلی که باعث میشد بنرهای تبلیغاتی بهروزرسانی نشوند، برطرف شد.
نسخه ۶.۴.۱۱.۰
- سازگاری تأیید شده با Vungle SDK 6.4.11.
- پشتیبانی از تبلیغات بنری اضافه شد.
- آداپتور را به AndroidX منتقل کردم.
- حداقل نسخه SDK مورد نیاز برای تبلیغات موبایلی گوگل به ۱۸.۲.۰ بهروزرسانی شد.
نسخه ۶.۳.۲۴.۱
- آداپتور بهروزرسانی شده برای پشتیبانی از API پاداشدهی بتای باز جدید.
- حداقل نسخه SDK مورد نیاز برای تبلیغات موبایلی گوگل به ۱۷.۲.۰ بهروزرسانی شد.
نسخه ۶.۳.۲۴.۰
- سازگاری تأیید شده با Vungle SDK 6.3.24.
نسخه ۶.۳.۱۷.۰
- سازگاری تأیید شده با Vungle SDK 6.3.17.
نسخه ۶.۳.۱۲.۰
- سازگاری تأیید شده با Vungle SDK 6.3.12.
نسخه ۶.۲.۵.۱
- آداپتور بهروزرسانی شد تا رویداد تبلیغ
onRewardedVideoComplete()را فراخوانی کند.
نسخه ۶.۲.۵.۰
- سازگاری تأیید شده با Vungle SDK 6.2.5.
نسخه ۵.۳.۲.۱
- آداپتور بهروزرسانی شد تا کلیکها را به درستی به SDK تبلیغات موبایلی گوگل گزارش دهد.
نسخه ۵.۳.۲.۰
- سازگاری تأیید شده با Vungle SDK 5.3.2.
- پروژه Adpater برای اندروید استودیو ۳.۰ بهروزرسانی شد.
- متدهای زیر به کلاس سازندهی بسته (Bundle builder) اضافه شد.
-
setOrdinalViewCount: این فیلد برای ارسال مقدار ترتیبی میانجی، هر زمان که ناشر گزارشهای دادههای ترتیبی را از Vungle دریافت میکند، استفاده میشود. -
setFlexViewCloseTimeInSec: این گزینه برای غیرفعال کردن تبلیغات flex view پس از تعداد ثانیههای مشخصشده استفاده میشود.
-
نسخه ۵.۳.۰.۰
- سازگاری تأیید شده با Vungle SDK 5.3.0.
نسخه ۵.۱.۰.۰
- آداپتور بهروزرسانی شد تا با Vungle SDK 5.1.0 سازگار شود.
- سیستم نامگذاری نسخه به [نسخه Vungle SDK].[نسخه وصله آداپتور] تغییر یافت.
نسخههای پیشین
- پشتیبانی از قالبهای تبلیغات ویدیویی بینابینی و پاداشی اضافه شد.
این راهنما به شما نشان میدهد که چگونه از SDK تبلیغات موبایل گوگل برای بارگذاری و نمایش تبلیغات از Liftoff Monetize با استفاده از AdMob Mediation استفاده کنید که شامل ادغامهای پیشنهاد قیمت و آبشاری میشود. این راهنما نحوه اضافه کردن Liftoff Monetize به پیکربندی میانجیگری یک واحد تبلیغاتی و نحوه ادغام SDK و آداپتور Vungle در یک برنامه اندروید را پوشش میدهد.
ادغامها و قالبهای تبلیغاتی پشتیبانیشده
آداپتور میانجیگری برای Liftoff Monetize قابلیتهای زیر را دارد:
| ادغام | |
|---|---|
| مناقصه | |
| آبشار | |
| قالبها | |
| برنامه باز است | |
| بنر | |
| بینابینی | |
| پاداش داده شده | |
| تبلیغات بینابینی پاداشدار | |
| بومی | |
الزامات
اندروید API سطح ۲۳ یا بالاتر
[برای پیشنهاد قیمت]: برای ادغام تمام قالبهای تبلیغاتی پشتیبانیشده در پیشنهاد قیمت، از آداپتور Liftoff Monetize نسخه ۷.۳.۰.۰ یا بالاتر استفاده کنید ( آخرین نسخه توصیه میشود )
جدیدترین SDK تبلیغات موبایلی گوگل.
راهنمای شروع میانجیگری را تکمیل کنید.
مرحله ۱: تنظیمات را در Liftoff Monetize UI تنظیم کنید
ثبت نام کنید یا وارد حساب کاربری خود در Liftoff Monetize شوید .
با کلیک بر روی دکمهی «افزودن برنامه» ، برنامهی خود را به داشبورد Liftoff Monetize اضافه کنید.

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

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

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

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

جزئیات مربوط به اضافه کردن مکانهای جدید در زیر آمده است:
برنامه باز است
گزینه Interstitial را انتخاب کنید و یک نام برای جایگاه تبلیغاتی وارد کنید. سپس، برای Skippable گزینه Yes را انتخاب کنید و بقیه فرم را پر کنید. [Bidding only] در قسمت Monetization ، گزینه In-App Bidding را روی Enabled قرار دهید. برای ایجاد جایگاه تبلیغاتی، روی دکمه Continue در پایین صفحه کلیک کنید.

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

بنر ۳۰۰x۲۵۰
MREC را انتخاب کنید، یک نام برای جایگاه نمایش وارد کنید و بقیه فرم را پر کنید. [فقط پیشنهاد قیمت] در قسمت کسب درآمد ، گزینه پیشنهاد قیمت درون برنامهای را روی فعال قرار دهید. برای ایجاد جایگاه نمایش، روی دکمه ادامه در پایین صفحه کلیک کنید.

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

پاداش داده شده
گزینه «Rewarded» را انتخاب کنید، یک نام برای جایگاه نمایش وارد کنید و بقیه فرم را پر کنید. [Bidding only] در قسمت «Monetization» ، گزینه «In-App Bidding» را روی «Enabled» قرار دهید. برای ایجاد جایگاه نمایش، روی دکمه «Continue» در پایین صفحه کلیک کنید.

تبلیغات بینابینی پاداشدار
گزینه «Rewarded» را انتخاب کنید. یک نام برای جایگاه تبلیغاتی وارد کنید، گزینه «Skipable» را فعال کنید و بقیه فرم را پر کنید. [Bidding only] در قسمت «Monetization» ، گزینه « In-App Bidding» را روی «Enabled» قرار دهید. برای ایجاد جایگاه تبلیغاتی، روی دکمه «Continue» در پایین صفحه کلیک کنید.

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

شناسه مرجع را یادداشت کنید و روی «صداها خوب است» کلیک کنید.
برنامه باز است

بنر

بنر ۳۰۰x۲۵۰

بینابینی

پاداش داده شده

تبلیغات بینابینی پاداشدار

بومی

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

فایل app-ads.txt خود را بهروزرسانی کنید.
فروشندگان مجاز برنامهها app-ads.txt یک ابتکار آزمایشگاه فناوری IAB است که به شما کمک میکند تا موجودی تبلیغات برنامه خود را فقط از طریق کانالهایی که به عنوان مجاز شناسایی کردهاید، به فروش برسانید. برای جلوگیری از کاهش قابل توجه درآمد تبلیغات، باید یک فایل app-ads.txt پیادهسازی کنید. اگر قبلاً این کار را نکردهاید، یک فایل app-ads.txt برای برنامه خود تنظیم کنید .
برای پیادهسازی app-ads.txt برای Liftoff Monetize، ورودیهای app-ads.txt مربوط به Liftoff Monetize را دانلود و به فایل app-ads.txt موجود خود اضافه کنید. برای اطلاعات بیشتر، به app-ads.txt مراجعه کنید.
حالت تست را روشن کنید
برای فعال کردن تبلیغات آزمایشی، به داشبورد Liftoff Monetize خود بروید و به Applications بروید.
برنامهای را که میخواهید تبلیغات آزمایشی برای آن فعال شود، در بخش «شناسه مرجع قرارگیری» برنامه خود انتخاب کنید. تبلیغات آزمایشی را میتوان با انتخاب «حالت آزمایشی» برای نمایش فقط تبلیغات آزمایشی در بخش « وضعیت» فعال کرد.

مرحله ۲: تنظیم تقاضای کسب درآمد Liftoff در رابط کاربری AdMob
تنظیمات میانجیگری را برای واحد تبلیغاتی خود پیکربندی کنید
شما باید Liftoff Monetize را به پیکربندی میانجیگری برای واحد تبلیغاتی خود اضافه کنید.
ابتدا، وارد حساب کاربری AdMob خود شوید. سپس، به برگه Mediation بروید. اگر یک گروه میانجیگری موجود دارید که میخواهید آن را تغییر دهید، روی نام آن گروه میانجیگری کلیک کنید تا آن را ویرایش کنید و به بخش Add Liftoff Monetize as an ad source بروید.
برای ایجاد یک گروه میانجیگری جدید، گزینه «ایجاد گروه میانجیگری» را انتخاب کنید.

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

به گروه میانجیگری خود یک نام بدهید و مکانهایی را برای هدف قرار دادن انتخاب کنید. در مرحله بعد، وضعیت گروه میانجیگری را روی فعال (Enabled) تنظیم کنید و سپس روی افزودن واحدهای تبلیغاتی (Add Ad Units) کلیک کنید.

این گروه میانجی را با یک یا چند واحد تبلیغاتی AdMob موجود خود مرتبط کنید. سپس روی «انجام شد» کلیک کنید.

اکنون باید کارت واحدهای تبلیغاتی را ببینید که با واحدهای تبلیغاتی که انتخاب کردهاید پر شده است:

Liftoff Monetize را به عنوان منبع تبلیغات اضافه کنید
مناقصه
در قسمت « منابع تبلیغات» ، زیر کارت پیشنهاد قیمت ، گزینه «افزودن منبع تبلیغات» را انتخاب کنید. سپس «افزایش درآمد از طریق لیفتآف» را انتخاب کنید.روی نحوه امضای قرارداد مشارکت و تنظیم مشارکت در مناقصه با Liftoff Monetize کلیک کنید.

روی تأیید و موافقت کلیک کنید، سپس روی ادامه کلیک کنید.

اگر از قبل نگاشتی برای Liftoff Monetize دارید، میتوانید آن را انتخاب کنید. در غیر این صورت، روی افزودن نگاشت کلیک کنید.

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

آبشار
در زیر کارت Waterfall در بخش Ad Sources ، گزینه Add Ad Source را انتخاب کنید.
Select Liftoff Monetize and enable the Optimize switch. Enter the Reporting API Key obtained in the previous section to set up ad source optimization for Liftoff Monetize. Then enter an eCPM value for Liftoff Monetize and click Continue .

If you already have a mapping for Liftoff Monetize, you can select it. Otherwise, click Add mapping .

Next, enter the Application ID and Placement Reference ID obtained in the previous section. Then click Done .

Add Liftoff to GDPR and US state regulations ad partners list
Follow the steps in European regulations settings and US state regulations settings to add Liftoff to the European and US state regulations ad partners list in the AdMob UI.
Step 3: Import the Vungle SDK and Liftoff Monetize adapter
Android Studio integration (recommended)
In your app-level build.gradle.kts file, add the following implementation dependencies and configurations. Use the latest versions of the Vungle SDK and adapter:
dependencies {
implementation("com.google.android.gms:play-services-ads:24.7.0")
implementation("com.google.ads.mediation:vungle:7.6.0.0")
}
Manual integration
Download the latest Vungle Android SDK and extract the
.aarand JAR files under thelibsfolder and add it to your project.Navigate to the Liftoff Monetize adapter artifacts on Google's Maven Repository. Select the latest version, download the Vungle adapter's
.aarfile, and add it to your project.
Step 4: Implement privacy settings on the Vungle SDK
EU consent and GDPR
To comply with Google EU User Consent Policy , you must make certain disclosures to your users in the European Economic Area (EEA), the UK, and Switzerland, and obtain their consent for the use of cookies or other local storage where legally required, and for the collection, sharing, and use of personal data for ads personalization. This policy reflects the requirements of the EU ePrivacy Directive and the General Data Protection Regulation (GDPR). You are responsible for verifying consent is propagated to each ad source in your mediation chain. Google is unable to pass the user's consent choice to such networks automatically.
Starting in Vungle SDK version 7.4.1, Liftoff Monetize automatically reads GDPR consent set by consent management platforms that support Google's Additional Consent specification , including the UMP SDK . For more information, see GDPR Recommended Implementation Instructions .
US states privacy laws
US states privacy laws require giving users the right to opt out of the "sale" of their "personal information" (as the law defines those terms), with the opt-out offered through a prominent "Do Not Sell My Personal Information" link on the "selling" party's homepage. The US states privacy laws compliance guide offers the ability to enable restricted data processing for Google ad serving, but Google is unable to apply this setting to each ad network in your mediation chain. Therefore, you must identify each ad network in your mediation chain that may participate in the sale of personal information and follow guidance from each of those networks to ensure compliance.
Liftoff Monetize includes an API that lets you pass consent to the Vungle SDK. The following sample code shows how to pass this consent information to the Vungle SDK. If you choose to call this method, it is recommended that you do so prior to requesting ads through Google Mobile Ads SDK.
جاوا
import com.vungle.ads.VunglePrivacySettings;
// ...
VunglePrivacySettings.setCCPAStatus(true);
Kotlin
import com.vungle.ads.VunglePrivacySettings
// ...
VunglePrivacySettings.setCCPAStatus(true)
See CCPA implementation for more details and the values that can be provided in the method.
Step 5: Add required code
No additional code required for Liftoff Monetize integration.
Step 6: Test your implementation
Enable test ads
Make sure you register your test device for AdMob and enable test mode in Liftoff Monetize UI.
Verify test ads
To verify that you are receiving test ads from Liftoff Monetize, enable single ad source testing in ad inspector using the Liftoff Monetize (Bidding) and Liftoff Monetize (Waterfall) ad source(s).
Optional steps
Network-specific parameters
The Liftoff Monetize adapter supports the following additional request parameters which can be passed to the adapter:
-
userId - A string representing Liftoff Monetize's Incentivized User ID.
-
adOrientation - An integer specifying the presentation orientation for full-screen ads.
Here's a code example of how to create an ad request that sets these parameters:
جاوا
Bundle extras = new Bundle();
extras.putString(VungleConstants.KEY_USER_ID, "myUserID");
extras.putInt(VungleConstants.KEY_ORIENTATION, 1);
AdRequest request = new AdRequest.Builder()
.addNetworkExtrasBundle(VungleAdapter.class, extras) // Rewarded.
.addNetworkExtrasBundle(VungleInterstitialAdapter.class, extras) // Interstitial.
.build();
Kotlin
val extras = Bundle()
extras.putString(VungleConstants.KEY_USER_ID, "myUserID")
extras.putInt(VungleConstants.KEY_ORIENTATION, 1)
val request = AdRequest.Builder()
.addNetworkExtrasBundle(VungleAdapter::class, extras) // Rewarded.
.addNetworkExtrasBundle(VungleInterstitialAdapter.class, extras) // Interstitial.
.build()
Native ads rendering
The Liftoff Monetize adapter returns its native ads as NativeAd objects. It populates the following native ads field descriptions for a NativeAd .
| میدان | Assets always included by Liftoff Monetize adapter |
|---|---|
| تیتر | |
| تصویر | ۱ |
| Media view | |
| بدن | |
| App icon | |
| Call to action | |
| رتبهبندی ستارهای | |
| فروشگاه | |
| قیمت |
1 The Liftoff Monetize adapter does not provide direct access to the main image asset for its native ads. Instead, the adapter populates the MediaView with a video or an image.
Error codes
If the adapter fails to receive an ad from Liftoff Monetize, publishers can check the underlying error from the ad response using ResponseInfo.getAdapterResponses() under the following classes:
| قالب | Class name |
|---|---|
| App Open (Bidding) | com.google.ads.mediation.vungle.VungleMediationAdapter |
| App Open (Waterfall) | com.google.ads.mediation.vungle.VungleMediationAdapter |
| Banner (Bidding) | com.google.ads.mediation.vungle.VungleMediationAdapter |
| Banner (Waterfall) | com.vungle.mediation.VungleInterstitialAdapter |
| Interstitial (Bidding) | com.google.ads.mediation.vungle.VungleMediationAdapter |
| Interstitial (Waterfall) | com.vungle.mediation.VungleInterstitialAdapter |
| Rewarded (Bidding) | com.google.ads.mediation.vungle.VungleMediationAdapter |
| Rewarded (Waterfall) | com.vungle.mediation.VungleAdapter |
| Rewarded Interstitial (Bidding) | com.google.ads.mediation.vungle.VungleMediationAdapter |
| Rewarded Interstitial (Waterfall) | com.google.ads.mediation.vungle.VungleMediationAdapter |
| Native (Bidding) | com.google.ads.mediation.vungle.VungleMediationAdapter |
| Native (Waterfall) | com.google.ads.mediation.vungle.VungleMediationAdapter |
Here are the codes and accompanying messages thrown by the Liftoff Monetize adapter when an ad fails to load:
| Error code | دامنه | دلیل |
|---|---|---|
| ۱۰۱ | com.google.ads.mediation.vungle | Invalid server parameters (eg app ID or placement ID). |
| ۱۰۲ | com.google.ads.mediation.vungle | The requested banner size does not map to a valid Liftoff Monetize ad size. |
| ۱۰۳ | com.google.ads.mediation.vungle | Liftoff Monetize requires an Activity context to request ads. |
| ۱۰۴ | com.google.ads.mediation.vungle | The Vungle SDK cannot load multiple ads for the same placement ID. |
| ۱۰۵ | com.google.ads.mediation.vungle | The Vungle SDK failed to initialize. |
| ۱۰۶ | com.google.ads.mediation.vungle | Vungle SDK returned a successful load callback, but Banners.getBanner() or Vungle.getNativeAd() returned null. |
| ۱۰۷ | com.google.ads.mediation.vungle | Vungle SDK is not ready to play the ad. |
| ۱۰۸ | com.google.ads.mediation.vungle | Vungle SDK returned invalid bidding token. |
For errors that come from the Vungle SDK, refer to Error Codes: Vungle SDK for iOS and Android .
Liftoff Monetize Android Mediation Adapter Changelog
Version 7.6.0.0
- Verified compatibility with Vungle SDK 7.6.0.
Built and tested with:
- Google Mobile Ads SDK version 24.7.0.
- Vungle SDK version 7.6.0.
Version 7.5.1.1
- Removed class-level references to Context. Can help reduce memory leak issues.
- Added new API implementation for Waterfall Banner ad.
Built and tested with:
- Google Mobile Ads SDK version 24.7.0.
- Vungle SDK version 7.5.1.
Version 7.5.1.0
- Verified compatibility with Vungle SDK 7.5.1.
Built and tested with:
- Google Mobile Ads SDK version 24.5.0.
- Vungle SDK version 7.5.1.
Version 7.5.0.1
- Sets
overrideImpressionRecordingto true for both waterfall and RTB native ads.
Built and tested with:
- Google Mobile Ads SDK version 24.4.0.
- Vungle SDK version 7.5.0.
Version 7.5.0.0
- Verified compatibility with Vungle SDK 7.5.0.
Built and tested with:
- Google Mobile Ads SDK version 24.2.0.
- Vungle SDK version 7.5.0.
Version 7.4.3.1
- Updated the minimum required Android API level to 23.
- Updated the minimum required Google Mobile Ads SDK version to 24.0.0.
Built and tested with:
- Google Mobile Ads SDK version 24.0.0.
- Vungle SDK version 7.4.3.
Version 7.4.3.0
- Verified compatibility with Vungle SDK 7.4.3.
Built and tested with:
- Google Mobile Ads SDK version 23.6.0.
- Vungle SDK version 7.4.3.
Version 7.4.2.0
- Verified compatibility with Vungle SDK 7.4.2.
Built and tested with:
- Google Mobile Ads SDK version 23.5.0.
- Vungle SDK version 7.4.2.
Version 7.4.1.0
- Verified compatibility with Vungle SDK 7.4.1.
Built and tested with:
- Google Mobile Ads SDK version 23.3.0.
- Vungle SDK version 7.4.1.
Version 7.4.0.1
- Added custom ad size support for bidding and waterfall banner ads.
Built and tested with:
- Google Mobile Ads SDK version 23.2.0.
- Vungle SDK version 7.4.0.
Version 7.4.0.0
- Extended the
VungleInterstitialAdapterclass fromVungleMediationAdapterto add waterfall support for the app open ad format on Google Ad Manager. - Verified compatibility with Vungle SDK 7.4.0.
Built and tested with:
- Google Mobile Ads SDK version 23.2.0.
- Vungle SDK version 7.4.0.
Version 7.3.2.0
- Verified compatibility with Vungle SDK 7.3.2.
Built and tested with:
- Google Mobile Ads SDK version 23.0.0.
- Vungle SDK version 7.3.2.
Version 7.3.1.0
- Verified compatibility with Vungle SDK 7.3.1.
Built and tested with:
- Google Mobile Ads SDK version 23.0.0.
- Vungle SDK version 7.3.1.
Version 7.3.0.0
- Updated the minimum required Google Mobile Ads SDK version to 23.0.0.
- Verified compatibility with Vungle SDK 7.3.0.
- Added waterfall and bidding support for app open ad format.
Built and tested with:
- Google Mobile Ads SDK version 23.0.0.
- Vungle SDK version 7.3.0.
Version 7.1.0.0
- Verified compatibility with Vungle SDK 7.1.0.
Built and tested with:
- Google Mobile Ads SDK version 22.3.0.
- Vungle SDK version 7.1.0.
Version 7.0.0.1
- Fixed an issue where Google Mobile Ads SDK was not recording impressions for bidding native ads.
- Reverted the adapter to depend on Google Mobile Ads SDK version 22.3.0.
Built and tested with:
- Google Mobile Ads SDK version 22.3.0.
- Vungle SDK version 7.0.0.
Version 7.0.0.0
- Added support to load multiple ads with the same placement ID for all waterfall ad formats.
- Rebranded adapter name from Vungle to Liftoff Monetize.
- Verified compatibility with Vungle SDK 7.0.0.
Built and tested with:
- Google Mobile Ads SDK version 22.4.0.
- Vungle SDK version 7.0.0.
Version 6.12.1.1
- Updated adapter to use new
VersionInfoclass. - Updated the minimum required Google Mobile Ads SDK version to 22.0.0.
Built and tested with:
- Google Mobile Ads SDK version 22.0.0.
- Vungle SDK version 6.12.1.
Version 6.12.1.0
- Verified compatibility with Vungle SDK 6.12.1.
Built and tested with:
- Google Mobile Ads SDK version 21.4.0.
- Vungle SDK version 6.12.1.
Version 6.12.0.1
- Added bidding support for banner ad format.
- Verified compatibility with Vungle SDK 6.12.0.
- Updated the minimum required Google Mobile Ads SDK version to 21.4.0.
Built and tested with:
- Google Mobile Ads SDK version 21.4.0.
- Vungle SDK version 6.12.0.
Version 6.12.0.0
- Added waterfall mediation and bidding support for rewarded interstitial ad format.
- Added bidding support for native ad format.
Built and tested with:
- Google Mobile Ads SDK version 21.1.0.
- Vungle SDK version 6.12.0.
Version 6.11.0.3
- Added waterfall mediation support for native ad format.
- Updated the minimum required Google Mobile Ads SDK version to 21.1.0.
Built and tested with:
- Google Mobile Ads SDK version 21.1.0.
- Vungle SDK version 6.11.0.
Version 6.11.0.2
- Added support for loading multiple ads for the same placement ID in rewarded bidding ads.
Built and tested with:
- Google Mobile Ads SDK version 21.0.0.
- Vungle SDK version 6.11.0.
Version 6.11.0.1
- Updated
compileSdkVersionandtargetSdkVersionto API 31. - Updated the minimum required Google Mobile Ads SDK version to 21.0.0.
- Updated the minimum required Android API level to 19.
Built and tested with:
- Google Mobile Ads SDK version 21.0.0.
- Vungle SDK version 6.11.0.
Version 6.11.0.0
- Verified compatibility with Vungle SDK 6.11.0.
Built and tested with:
- Google Mobile Ads SDK version 20.6.0.
- Vungle SDK version 6.11.0.
Version 6.10.5.0
- Verified compatibility with Vungle SDK 6.10.5.
- Updated the minimum required Google Mobile Ads SDK version to 20.6.0.
Built and tested with:
- Google Mobile Ads SDK version 20.6.0.
- Vungle SDK version 6.10.5.
Version 6.10.4.0
- Verified compatibility with Vungle SDK 6.10.4.
Built and tested with:
- Google Mobile Ads SDK version 20.5.0.
- Vungle SDK version 6.10.4.
Version 6.10.3.0
- Verified compatibility with Vungle SDK 6.10.3.
Built and tested with:
- Google Mobile Ads SDK version 20.5.0.
- Vungle SDK version 6.10.3.
Version 6.10.2.1
- Verified compatibility with Vungle SDK 6.10.2.
- Added bidding support for interstitial and rewarded ad formats.
- Updated the minimum required Google Mobile Ads SDK version to 20.5.0.
Built and tested with:
- Google Mobile Ads SDK version 20.5.0.
- Vungle SDK version 6.10.2.
Version 6.10.2.0
- Verified compatibility with Vungle SDK 6.10.2.
- Fixed an adapter issue by replacing parameter
serverParameters, withmediationExtrasto obtain Vungle network-specific parameters, when requesting Banner and Interstitial ads.
Built and tested with:
- Google Mobile Ads SDK version 20.3.0.
- Vungle SDK version 6.10.2.
Version 6.10.1.0
- Verified compatibility with Vungle SDK 6.10.1.
- Updated the minimum required Google Mobile Ads SDK version to 20.3.0.
- MREC Ads are now supported with Vungle's banner API.
- Updated standardized error codes and messages.
Built and tested with:
- Google Mobile Ads SDK version 20.3.0.
- Vungle SDK version 6.10.1.
Version 6.9.1.1
- Updated the minimum required Google Mobile Ads SDK version to 20.0.0.
Built and tested with:
- Google Mobile Ads SDK version 20.0.0.
- Vungle SDK version 6.9.1.
Version 6.9.1.0
- Verified compatibility with Vungle SDK 6.9.1.
- Added support for OMSDK.
- Various bug fixes.
- Rewarded Ad Support for Vungle onAdViewed callback.
- Updated the minimum required Google Mobile Ads SDK version to 19.7.0.
Built and tested with:
- Google Mobile Ads SDK version 19.7.0.
- Vungle SDK version 6.9.1.
Version 6.8.1.1
- Updated the minimum required Google Mobile Ads SDK version to 19.6.0.
Built and tested with:
- Google Mobile Ads SDK version 19.6.0.
- Vungle SDK version 6.8.1.
Version 6.8.1.0
- Verified compatibility with Vungle SDK 6.8.1.
- Updated the minimum required Google Mobile Ads SDK version to 19.5.0.
Built and tested with:
- Google Mobile Ads SDK version 19.5.0.
- Vungle SDK version 6.8.1.
Version 6.8.0.0
- Verified compatibility with Vungle SDK 6.8.0.
- Updated the adapter to not forward
onAdClosed()when banner ads are refreshed or destroyed. - Remove
FlexFeedandFlexView(deprecated in Vungle 6.8.0). - Updated the minimum required Google Mobile Ads SDK version to 19.4.0.
Built and tested with:
- Google Mobile Ads SDK version 19.4.0.
- Vungle SDK version 6.8.0.
Version 6.7.1.0
- Verified compatibility with Vungle SDK 6.7.1.
- Fixed a bug where ads wouldn't load if an ad was loaded using an application context.
- Updated
targetSdkVersionto API 29. - Updated the minimum required Google Mobile Ads SDK version to 19.3.0.
Built and tested with:
- Google Mobile Ads SDK version 19.3.0.
- Vungle SDK version 6.7.1.
Version 6.7.0.0
- Verified compatibility with Vungle SDK 6.7.0.
- Updated the adapter to support inline adaptive banner requests.
- Interstitial and rewarded ads are now unmuted by default.
- Interstitial ads now forward the
onAdLeftApplication()callback when clicked. - Updated the minimum required Google Mobile Ads SDK version to 19.2.0.
Built and tested with:
- Google Mobile Ads SDK version 19.2.0.
- Vungle SDK version 6.7.0.
Version 6.5.3.0
- Verified compatibility with Vungle SDK 6.5.3.
- Add support for the newly-introduced Vungle's Banner format.
- Updated the minimum required Google Mobile Ads SDK version to 19.0.1.
Built and tested with:
- Google Mobile Ads SDK version 19.0.1.
- Vungle SDK version 6.5.3.
Version 6.4.11.1
- Fixed an issue where banner ads failed to refresh.
Version 6.4.11.0
- Verified compatibility with Vungle SDK 6.4.11.
- Added support for banner ads.
- Migrated the adapter to AndroidX.
- Updated the minimum required Google Mobile Ads SDK version to 18.2.0.
Version 6.3.24.1
- Updated adapter to support new open-beta Rewarded API.
- Updated the minimum required Google Mobile Ads SDK version to 17.2.0.
Version 6.3.24.0
- Verified compatibility with Vungle SDK 6.3.24.
Version 6.3.17.0
- Verified compatibility with Vungle SDK 6.3.17.
Version 6.3.12.0
- Verified compatibility with Vungle SDK 6.3.12.
Version 6.2.5.1
- Updated the adapter to invoke the
onRewardedVideoComplete()ad event.
Version 6.2.5.0
- Verified compatibility with Vungle SDK 6.2.5.
Version 5.3.2.1
- Updated adapter to correctly report clicks to the Google Mobile Ads SDK.
Version 5.3.2.0
- Verified compatibility with Vungle SDK 5.3.2.
- Updated the Adpater project for Android Studio 3.0.
- Added the following methods to Bundle builder class.
-
setOrdinalViewCount: This field is used to pass the mediation ordinal, whenever Publisher receives the ordinal data reports from Vungle. -
setFlexViewCloseTimeInSec: This option is used to make flex view ads dismiss on their own after the specified number of seconds.
-
Version 5.3.0.0
- Verified compatibility with Vungle SDK 5.3.0.
Version 5.1.0.0
- Updated the adapter to make it compatible with Vungle SDK 5.1.0.
- Changed the version naming system to [Vungle SDK version].[adapter patch version].
Earlier versions
- Added support for interstitial and rewarded video ad formats.