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

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

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

آداپتور میانجی برای Liftoff Monetize دارای قابلیت های زیر است:

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

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

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

الزامات

  • جدیدترین SDK تبلیغات موبایل گوگل

  • راهنمای شروع میانجیگری را کامل کنید

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

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

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

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

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

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

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

برای ایجاد یک مکان جدید برای استفاده با میانجیگری 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 بروید و به برنامه‌ها بروید.

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

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

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

باید اضافه کنید Liftoff Monetize به پیکربندی میانجی برای واحد تبلیغات شما.

ابتدا وارد حساب AdMob خود شوید. سپس به تب Mediation بروید. اگر گروه میانجی موجودی دارید که می‌خواهید آن را تغییر دهید، روی نام آن گروه میانجی کلیک کنید تا آن را ویرایش کنید و به افزودن بروید. Liftoff Monetize به عنوان منبع آگهی

برای ایجاد یک گروه میانجی جدید، Create Mediation Group را انتخاب کنید.

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

به گروه میانجی خود یک نام بدهید و مکان‌هایی را برای هدف انتخاب کنید. سپس، وضعیت گروه میانجی را روی Enabled تنظیم کنید و سپس روی Add Units Ad Units کلیک کنید.

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

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

اضافه کنید Liftoff Monetize به عنوان منبع تبلیغات

مناقصه


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

آبشار


در زیر کارت Waterfall در بخش Ad Sources ، Add Source Ad را انتخاب کنید. سپس Liftoff Monetize را انتخاب کنید.

Liftoff Monetize را انتخاب کنید و سوئیچ Optimize را فعال کنید. برای راه‌اندازی بهینه‌سازی منبع آگهی برای Liftoff Monetize، کلید API گزارشی را که در بخش قبل به دست آمده است وارد کنید. سپس یک مقدار eCPM برای Liftoff Monetize وارد کنید و روی Continue کلیک کنید.



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

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


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

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

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

در فایل build.gradle.kts در سطح برنامه خود، وابستگی ها و پیکربندی های پیاده سازی زیر را اضافه کنید. از آخرین نسخه Vungle SDK و آداپتور استفاده کنید: 

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.5.0")
    implementation("com.google.ads.mediation:vungle:7.4.2.0")
}

ادغام دستی

  • جدیدترین Vungle Android SDK را دانلود کنید و فایل‌های .jar را در زیر پوشه libs استخراج کنید و آن را به پروژه خود اضافه کنید.

  • به آرتیفکت‌های آداپتور Liftoff Monetize در مخزن Maven Google بروید. آخرین نسخه را انتخاب کنید، فایل .aar آداپتور Vungle را دانلود کنید و آن را به پروژه خود اضافه کنید.

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

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

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

جاوا 

import com.vungle.ads.VunglePrivacySettings;
// ...

VunglePrivacySettings.setGDPRStatus(true, "v1.0.0");

کاتلین 

import com.vungle.ads.VunglePrivacySettings
// ...

VunglePrivacySettings.setGDPRStatus(true, "v1.0.0")

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

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

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

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 را ببینید.

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

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

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

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

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

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

برای تأیید اینکه آگهی‌های آزمایشی را از Liftoff Monetize دریافت می‌کنید، با استفاده از منبع(های) آگهی Liftoff Monetize (مناقصه) و 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 گنجانده شده است
تیتر
تصویر 1
نمای رسانه ای
بدن
نماد برنامه
فراخوان به اقدام
امتیاز ستاره
فروشگاه
قیمت

1 آداپتور 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 پرتاب می‌شود، زمانی که آگهی بارگیری نمی‌شود، آمده است:

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

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

Liftoff Monetize Android Adapter Mediation Changelog

نسخه 7.4.2.0

  • سازگاری تایید شده با Vungle SDK 7.4.2.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 23.5.0.
  • Vungle SDK نسخه 7.4.2.

نسخه 7.4.1.0

  • سازگاری تایید شده با Vungle SDK 7.4.1.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 23.3.0.
  • Vungle SDK نسخه 7.4.1.

نسخه 7.4.0.1

  • اضافه شدن پشتیبانی از اندازه آگهی سفارشی برای مناقصه و تبلیغات بنر آبشاری.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 23.2.0.
  • Vungle SDK نسخه 7.4.0.

نسخه 7.4.0.0

  • کلاس VungleInterstitialAdapter را از VungleMediationAdapter گسترش داد تا پشتیبانی آبنما را برای قالب تبلیغات باز برنامه در Google Ad Manager اضافه کند.
  • سازگاری تایید شده با Vungle SDK 7.4.0.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 23.2.0.
  • Vungle SDK نسخه 7.4.0.

نسخه 7.3.2.0

  • سازگاری تایید شده با Vungle SDK 7.3.2.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 23.0.0.
  • Vungle SDK نسخه 7.3.2.

نسخه 7.3.1.0

  • سازگاری تایید شده با Vungle SDK 7.3.1.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 23.0.0.
  • Vungle SDK نسخه 7.3.1.

نسخه 7.3.0.0

  • حداقل نسخه مورد نیاز Google Mobile Ads SDK به 23.0.0 به روز شد.
  • سازگاری تایید شده با Vungle SDK 7.3.0.
  • پشتیبانی از آبشار و مناقصه برای فرمت تبلیغات باز برنامه اضافه شده است.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 23.0.0.
  • Vungle SDK نسخه 7.3.0.

نسخه 7.1.0.0

  • سازگاری تایید شده با Vungle SDK 7.1.0.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 22.3.0.
  • Vungle SDK نسخه 7.1.0.

نسخه 7.0.0.1

  • مشکلی را که در آن Google Mobile Ads SDK نمایش‌ها را برای آگهی‌های بومی ثبت نمی‌کرد، برطرف کرد.
  • آداپتور را به وابستگی به Google Mobile Ads SDK نسخه 22.3.0 برگرداند.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 22.3.0.
  • Vungle SDK نسخه 7.0.0.

نسخه 7.0.0.0

  • پشتیبانی برای بارگیری چندین آگهی با شناسه مکان یکسان برای همه قالب‌های تبلیغاتی آبشاری اضافه شده است.
  • نام آداپتور تغییر نام داد از Vungle به Liftoff Monetize.
  • سازگاری تایید شده با Vungle SDK 7.0.0.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 22.4.0.
  • Vungle SDK نسخه 7.0.0.

نسخه 6.12.1.1

  • آداپتور به‌روزرسانی شده برای استفاده از کلاس جدید VersionInfo .
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK به 22.0.0 به روز شد.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 22.0.0.
  • Vungle SDK نسخه 6.12.1.

نسخه 6.12.1.0

  • سازگاری تایید شده با Vungle SDK 6.12.1.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 21.4.0.
  • Vungle SDK نسخه 6.12.1.

نسخه 6.12.0.1

  • پشتیبانی مناقصه برای قالب تبلیغات بنری اضافه شد.
  • سازگاری تایید شده با Vungle SDK 6.12.0.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 21.4.0 به روز کرد.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 21.4.0.
  • Vungle SDK نسخه 6.12.0.

نسخه 6.12.0.0

  • میانجی‌گری آبشار و پشتیبانی از مناقصه برای قالب آگهی بینابینی با پاداش اضافه شد.
  • پشتیبانی مناقصه برای قالب تبلیغات بومی اضافه شد.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 21.1.0.
  • Vungle SDK نسخه 6.12.0.

نسخه 6.11.0.3

  • پشتیبانی از میانجیگری آبشار برای قالب تبلیغات بومی اضافه شد.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 21.1.0 به روز کرد.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 21.1.0.
  • Vungle SDK نسخه 6.11.0.

نسخه 6.11.0.2

  • پشتیبانی برای بارگیری چندین آگهی برای شناسه مکان یکسان در آگهی‌های مناقصه پاداش اضافه شده است.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 21.0.0.
  • Vungle SDK نسخه 6.11.0.

نسخه 6.11.0.1

  • compileSdkVersion و targetSdkVersion به API 31 به روز کرد.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 21.0.0 به روز کرد.
  • حداقل سطح API Android مورد نیاز را به 19 به روز کرد.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 21.0.0.
  • Vungle SDK نسخه 6.11.0.

نسخه 6.11.0.0

  • سازگاری تایید شده با Vungle SDK 6.11.0.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 20.6.0.
  • Vungle SDK نسخه 6.11.0.

نسخه 6.10.5.0

  • سازگاری تایید شده با Vungle SDK 6.10.5.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK به 20.6.0 به روز شد.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 20.6.0.
  • Vungle SDK نسخه 6.10.5.

نسخه 6.10.4.0

  • سازگاری تایید شده با Vungle SDK 6.10.4.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 20.5.0.
  • Vungle SDK نسخه 6.10.4.

نسخه 6.10.3.0

  • سازگاری تایید شده با Vungle SDK 6.10.3.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 20.5.0.
  • Vungle SDK نسخه 6.10.3.

نسخه 6.10.2.1

  • سازگاری تایید شده با Vungle SDK 6.10.2.
  • پشتیبانی از مناقصه برای قالب های تبلیغاتی بینابینی و پاداش اضافه شده است.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK به 20.5.0 به روز شد.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 20.5.0.
  • Vungle SDK نسخه 6.10.2.

نسخه 6.10.2.0

  • سازگاری تایید شده با Vungle SDK 6.10.2.
  • مشکل آداپتور را با جایگزینی پارامتر serverParameters با mediationExtras برای به دست آوردن پارامترهای شبکه Vungle در هنگام درخواست تبلیغات بنر و بینابینی برطرف کرد.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 20.3.0.
  • Vungle SDK نسخه 6.10.2.

نسخه 6.10.1.0

  • سازگاری تایید شده با Vungle SDK 6.10.1.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 20.3.0 به روز کرد.
  • تبلیغات MREC اکنون با API بنر Vungle پشتیبانی می شود.
  • کدهای خطای استاندارد و پیام ها به روز شده است.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 20.3.0.
  • Vungle SDK نسخه 6.10.1.

نسخه 6.9.1.1

  • حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 20.0.0 به روز کرد.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 20.0.0.
  • Vungle SDK نسخه 6.9.1.

نسخه 6.9.1.0

  • سازگاری تایید شده با Vungle SDK 6.9.1.
  • پشتیبانی از OMSDK اضافه شده است.
  • رفع اشکال مختلف
  • پشتیبانی از تبلیغات پاداش برای Vungle در پاسخ به تماس AdViewed.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK به 19.7.0 به روز شد.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 19.7.0.
  • Vungle SDK نسخه 6.9.1.

نسخه 6.8.1.1

  • حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 19.6.0 به روز کرد.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 19.6.0.
  • Vungle SDK نسخه 6.8.1.

نسخه 6.8.1.0

  • سازگاری تایید شده با Vungle SDK 6.8.1.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 19.5.0 به روز کرد.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 19.5.0.
  • Vungle SDK نسخه 6.8.1.

نسخه 6.8.0.0

  • سازگاری تایید شده با Vungle SDK 6.8.0.
  • آداپتور را به‌روزرسانی کرد تا onAdClosed() زمانی که آگهی‌های بنر به‌روزرسانی یا از بین می‌روند، ارسال نشود.
  • FlexFeed و FlexView (منسوخ شده در Vungle 6.8.0) را حذف کنید.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 19.4.0 به روز کرد.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 19.4.0.
  • Vungle SDK نسخه 6.8.0.

نسخه 6.7.1.0

  • سازگاری تایید شده با Vungle SDK 6.7.1.
  • رفع اشکالی که در صورت بارگیری آگهی با استفاده از زمینه برنامه، تبلیغات بارگیری نمی شد.
  • targetSdkVersion به API 29 به روز شد.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK به 19.3.0 به روز شد.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 19.3.0.
  • Vungle SDK نسخه 6.7.1.

نسخه 6.7.0.0

  • سازگاری تایید شده با Vungle SDK 6.7.0.
  • آداپتور را برای پشتیبانی از درخواست های بنر تطبیقی ​​درون خطی به روز کرد.
  • اکنون به صورت پیش‌فرض، بی‌صدا شدن تبلیغات بین‌بینی و پاداش‌دار لغو می‌شود.
  • تبلیغات بینابینی اکنون پس از کلیک کردن، فراخوانی onAdLeftApplication() را ارسال می کنند.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 19.2.0 به روز کرد.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 19.2.0.
  • Vungle SDK نسخه 6.7.0.

نسخه 6.5.3.0

  • سازگاری تایید شده با Vungle SDK 6.5.3.
  • برای فرمت بنر Vungle که به تازگی معرفی شده است، پشتیبانی اضافه کنید.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 19.0.1 به روز کرد.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 19.0.1.
  • Vungle SDK نسخه 6.5.3.

نسخه 6.4.11.1

  • مشکلی که در آن تبلیغات بنری بازخوانی نشدند برطرف شد.

نسخه 6.4.11.0

  • سازگاری تایید شده با Vungle SDK 6.4.11.
  • پشتیبانی از تبلیغات بنری اضافه شد.
  • آداپتور را به AndroidX منتقل کرد.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK به 18.2.0 به روز شد.

نسخه 6.3.24.1

  • آداپتور به‌روزرسانی شده برای پشتیبانی از API پاداش‌دهی بتا باز جدید.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK به 17.2.0 به روز شد.

نسخه 6.3.24.0

  • سازگاری تایید شده با Vungle SDK 6.3.24.

نسخه 6.3.17.0

  • سازگاری تایید شده با Vungle SDK 6.3.17.

نسخه 6.3.12.0

  • سازگاری تایید شده با Vungle SDK 6.3.12.

نسخه 6.2.5.1

  • آداپتور را برای فراخوانی رویداد تبلیغاتی onRewardedVideoComplete() به روز کرد.

نسخه 6.2.5.0

  • سازگاری تایید شده با Vungle SDK 6.2.5.

نسخه 5.3.2.1

  • آداپتور به‌روزرسانی شده برای گزارش صحیح کلیک‌ها به Google Mobile Ads SDK.

نسخه 5.3.2.0

  • سازگاری تایید شده با Vungle SDK 5.3.2.
  • پروژه Adpater برای Android Studio 3.0 به روز شد.
  • متدهای زیر را به کلاس Bundle builder اضافه کرد.
    • setOrdinalViewCount : هر زمان که Publisher گزارش‌های داده‌های ترتیبی را از Vungle دریافت می‌کند، از این فیلد برای تصویب ترتیبی میانجی‌گری استفاده می‌شود.
    • setFlexViewCloseTimeInSec : از این گزینه برای اینکه تبلیغات با نمای انعطاف پذیر پس از مدت زمان مشخص شده خود به خود رد شوند استفاده می شود.

نسخه 5.3.0.0

  • سازگاری تایید شده با Vungle SDK 5.3.0.

نسخه 5.1.0.0

  • آداپتور را به روز کرد تا با Vungle SDK 5.1.0 سازگار شود.
  • سیستم نام‌گذاری نسخه را به [نسخه Vungle SDK] تغییر داد.[نسخه وصله آداپتور].

نسخه های قبلی

  • پشتیبانی از قالب‌های تبلیغات ویدیویی بینابینی و پاداش اضافه شده است.
،

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

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

آداپتور میانجی برای Liftoff Monetize دارای قابلیت های زیر است:

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

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

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

الزامات

  • جدیدترین SDK تبلیغات موبایل گوگل

  • راهنمای شروع میانجیگری را کامل کنید

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

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

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

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

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

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

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

برای ایجاد یک مکان جدید برای استفاده با میانجیگری 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 بروید و به برنامه‌ها بروید.

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

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

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

باید اضافه کنید Liftoff Monetize به پیکربندی میانجی برای واحد تبلیغات شما.

ابتدا وارد حساب AdMob خود شوید. سپس به تب Mediation بروید. اگر گروه میانجی موجودی دارید که می‌خواهید آن را تغییر دهید، روی نام آن گروه میانجی کلیک کنید تا آن را ویرایش کنید و به افزودن بروید. Liftoff Monetize به عنوان منبع آگهی

برای ایجاد یک گروه میانجی جدید، Create Mediation Group را انتخاب کنید.

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

به گروه میانجی خود یک نام بدهید و مکان‌هایی را برای هدف انتخاب کنید. سپس، وضعیت گروه میانجی را روی Enabled تنظیم کنید و سپس روی Add Units Ad Units کلیک کنید.

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

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

اضافه کنید Liftoff Monetize به عنوان منبع تبلیغات

مناقصه


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

آبشار


در زیر کارت Waterfall در بخش Ad Sources ، Add Source Ad را انتخاب کنید. سپس Liftoff Monetize را انتخاب کنید.

Liftoff Monetize را انتخاب کنید و سوئیچ Optimize را فعال کنید. برای راه‌اندازی بهینه‌سازی منبع آگهی برای Liftoff Monetize، کلید API گزارشی را که در بخش قبل به دست آمده است وارد کنید. سپس یک مقدار eCPM برای Liftoff Monetize وارد کنید و روی Continue کلیک کنید.



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

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


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

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

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

در فایل build.gradle.kts در سطح برنامه خود، وابستگی ها و پیکربندی های پیاده سازی زیر را اضافه کنید. از آخرین نسخه Vungle SDK و آداپتور استفاده کنید: 

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.5.0")
    implementation("com.google.ads.mediation:vungle:7.4.2.0")
}

ادغام دستی

  • جدیدترین Vungle Android SDK را دانلود کنید و فایل‌های .jar را در زیر پوشه libs استخراج کنید و آن را به پروژه خود اضافه کنید.

  • به آرتیفکت‌های آداپتور Liftoff Monetize در مخزن Maven Google بروید. آخرین نسخه را انتخاب کنید، فایل .aar آداپتور Vungle را دانلود کنید و آن را به پروژه خود اضافه کنید.

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

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

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

جاوا 

import com.vungle.ads.VunglePrivacySettings;
// ...

VunglePrivacySettings.setGDPRStatus(true, "v1.0.0");

کاتلین 

import com.vungle.ads.VunglePrivacySettings
// ...

VunglePrivacySettings.setGDPRStatus(true, "v1.0.0")

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

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

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

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 را ببینید.

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

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

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

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

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

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

برای تأیید اینکه آگهی‌های آزمایشی را از Liftoff Monetize دریافت می‌کنید، با استفاده از منبع(های) آگهی Liftoff Monetize (مناقصه) و 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 گنجانده شده است
تیتر
تصویر 1
نمای رسانه ای
بدن
نماد برنامه
فراخوان به اقدام
امتیاز ستاره
فروشگاه
قیمت

1 آداپتور 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 پرتاب می‌شود، زمانی که آگهی بارگیری نمی‌شود، آمده است:

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

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

Liftoff Monetize Android Adapter Mediation Changelog

نسخه 7.4.2.0

  • سازگاری تایید شده با Vungle SDK 7.4.2.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 23.5.0.
  • Vungle SDK نسخه 7.4.2.

نسخه 7.4.1.0

  • سازگاری تایید شده با Vungle SDK 7.4.1.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 23.3.0.
  • Vungle SDK نسخه 7.4.1.

نسخه 7.4.0.1

  • اضافه شدن پشتیبانی از اندازه آگهی سفارشی برای مناقصه و تبلیغات بنر آبشاری.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 23.2.0.
  • Vungle SDK نسخه 7.4.0.

نسخه 7.4.0.0

  • کلاس VungleInterstitialAdapter را از VungleMediationAdapter گسترش داد تا پشتیبانی آبنما را برای قالب تبلیغات باز برنامه در Google Ad Manager اضافه کند.
  • سازگاری تایید شده با Vungle SDK 7.4.0.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 23.2.0.
  • Vungle SDK نسخه 7.4.0.

نسخه 7.3.2.0

  • سازگاری تایید شده با Vungle SDK 7.3.2.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 23.0.0.
  • Vungle SDK نسخه 7.3.2.

نسخه 7.3.1.0

  • سازگاری تایید شده با Vungle SDK 7.3.1.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 23.0.0.
  • Vungle SDK نسخه 7.3.1.

نسخه 7.3.0.0

  • حداقل نسخه مورد نیاز Google Mobile Ads SDK به 23.0.0 به روز شد.
  • سازگاری تایید شده با Vungle SDK 7.3.0.
  • پشتیبانی از آبشار و مناقصه برای فرمت تبلیغات باز برنامه اضافه شده است.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 23.0.0.
  • Vungle SDK نسخه 7.3.0.

نسخه 7.1.0.0

  • سازگاری تایید شده با Vungle SDK 7.1.0.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 22.3.0.
  • Vungle SDK نسخه 7.1.0.

نسخه 7.0.0.1

  • مشکلی را که در آن Google Mobile Ads SDK نمایش‌ها را برای آگهی‌های بومی ثبت نمی‌کرد، برطرف کرد.
  • آداپتور را به وابستگی به Google Mobile Ads SDK نسخه 22.3.0 برگرداند.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 22.3.0.
  • Vungle SDK نسخه 7.0.0.

نسخه 7.0.0.0

  • پشتیبانی برای بارگیری چندین آگهی با شناسه مکان یکسان برای همه قالب‌های تبلیغاتی آبشاری اضافه شده است.
  • نام آداپتور تغییر نام داد از Vungle به Liftoff Monetize.
  • سازگاری تایید شده با Vungle SDK 7.0.0.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 22.4.0.
  • Vungle SDK نسخه 7.0.0.

نسخه 6.12.1.1

  • آداپتور به‌روزرسانی شده برای استفاده از کلاس جدید VersionInfo .
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK به 22.0.0 به روز شد.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 22.0.0.
  • Vungle SDK نسخه 6.12.1.

نسخه 6.12.1.0

  • سازگاری تایید شده با Vungle SDK 6.12.1.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 21.4.0.
  • Vungle SDK نسخه 6.12.1.

نسخه 6.12.0.1

  • پشتیبانی مناقصه برای قالب تبلیغات بنری اضافه شد.
  • سازگاری تایید شده با Vungle SDK 6.12.0.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 21.4.0 به روز کرد.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 21.4.0.
  • Vungle SDK نسخه 6.12.0.

نسخه 6.12.0.0

  • میانجی‌گری آبشار و پشتیبانی از مناقصه برای قالب آگهی بینابینی با پاداش اضافه شد.
  • پشتیبانی مناقصه برای قالب تبلیغات بومی اضافه شد.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 21.1.0.
  • Vungle SDK نسخه 6.12.0.

نسخه 6.11.0.3

  • پشتیبانی از میانجیگری آبشار برای قالب تبلیغات بومی اضافه شد.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 21.1.0 به روز کرد.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 21.1.0.
  • Vungle SDK نسخه 6.11.0.

نسخه 6.11.0.2

  • پشتیبانی برای بارگیری چندین آگهی برای شناسه مکان یکسان در آگهی‌های مناقصه پاداش اضافه شده است.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 21.0.0.
  • Vungle SDK نسخه 6.11.0.

نسخه 6.11.0.1

  • compileSdkVersion و targetSdkVersion به API 31 به روز کرد.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 21.0.0 به روز کرد.
  • حداقل سطح API Android مورد نیاز را به 19 به روز کرد.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 21.0.0.
  • Vungle SDK نسخه 6.11.0.

نسخه 6.11.0.0

  • سازگاری تایید شده با Vungle SDK 6.11.0.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 20.6.0.
  • Vungle SDK نسخه 6.11.0.

نسخه 6.10.5.0

  • سازگاری تایید شده با Vungle SDK 6.10.5.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK به 20.6.0 به روز شد.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 20.6.0.
  • Vungle SDK نسخه 6.10.5.

نسخه 6.10.4.0

  • سازگاری تایید شده با Vungle SDK 6.10.4.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 20.5.0.
  • Vungle SDK نسخه 6.10.4.

نسخه 6.10.3.0

  • سازگاری تایید شده با Vungle SDK 6.10.3.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 20.5.0.
  • Vungle SDK نسخه 6.10.3.

نسخه 6.10.2.1

  • سازگاری تایید شده با Vungle SDK 6.10.2.
  • پشتیبانی از مناقصه برای قالب های تبلیغاتی بینابینی و پاداش اضافه شده است.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK به 20.5.0 به روز شد.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 20.5.0.
  • Vungle SDK نسخه 6.10.2.

نسخه 6.10.2.0

  • سازگاری تایید شده با Vungle SDK 6.10.2.
  • مشکل آداپتور را با جایگزینی پارامتر serverParameters با mediationExtras برای به دست آوردن پارامترهای شبکه Vungle در هنگام درخواست تبلیغات بنر و بینابینی برطرف کرد.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 20.3.0.
  • Vungle SDK نسخه 6.10.2.

نسخه 6.10.1.0

  • سازگاری تایید شده با Vungle SDK 6.10.1.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 20.3.0 به روز کرد.
  • تبلیغات MREC اکنون با API بنر Vungle پشتیبانی می شود.
  • کدهای خطای استاندارد و پیام ها به روز شده است.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 20.3.0.
  • Vungle SDK نسخه 6.10.1.

نسخه 6.9.1.1

  • حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 20.0.0 به روز کرد.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 20.0.0.
  • Vungle SDK نسخه 6.9.1.

نسخه 6.9.1.0

  • سازگاری تایید شده با Vungle SDK 6.9.1.
  • پشتیبانی از OMSDK اضافه شده است.
  • رفع اشکال مختلف
  • پشتیبانی از تبلیغات پاداش برای Vungle در پاسخ به تماس AdViewed.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK به 19.7.0 به روز شد.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 19.7.0.
  • Vungle SDK نسخه 6.9.1.

نسخه 6.8.1.1

  • حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 19.6.0 به روز کرد.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 19.6.0.
  • Vungle SDK نسخه 6.8.1.

نسخه 6.8.1.0

  • سازگاری تایید شده با Vungle SDK 6.8.1.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 19.5.0 به روز کرد.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 19.5.0.
  • Vungle SDK نسخه 6.8.1.

نسخه 6.8.0.0

  • سازگاری تایید شده با Vungle SDK 6.8.0.
  • آداپتور را به‌روزرسانی کرد تا onAdClosed() زمانی که آگهی‌های بنر به‌روزرسانی یا از بین می‌روند، ارسال نشود.
  • FlexFeed و FlexView (منسوخ شده در Vungle 6.8.0) را حذف کنید.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 19.4.0 به روز کرد.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 19.4.0.
  • Vungle SDK نسخه 6.8.0.

نسخه 6.7.1.0

  • سازگاری تایید شده با Vungle SDK 6.7.1.
  • رفع اشکالی که در صورت بارگیری آگهی با استفاده از زمینه برنامه، تبلیغات بارگیری نمی شد.
  • targetSdkVersion به API 29 به روز شد.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK به 19.3.0 به روز شد.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 19.3.0.
  • Vungle SDK نسخه 6.7.1.

نسخه 6.7.0.0

  • سازگاری تایید شده با Vungle SDK 6.7.0.
  • آداپتور را برای پشتیبانی از درخواست های بنر تطبیقی ​​درون خطی به روز کرد.
  • اکنون به صورت پیش‌فرض، بی‌صدا شدن تبلیغات بین‌بینی و پاداش‌دار لغو می‌شود.
  • تبلیغات بینابینی اکنون پس از کلیک کردن، فراخوانی onAdLeftApplication() را ارسال می کنند.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 19.2.0 به روز کرد.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 19.2.0.
  • Vungle SDK نسخه 6.7.0.

نسخه 6.5.3.0

  • سازگاری تایید شده با Vungle SDK 6.5.3.
  • برای فرمت بنر Vungle که به تازگی معرفی شده است، پشتیبانی اضافه کنید.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 19.0.1 به روز کرد.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 19.0.1.
  • Vungle SDK نسخه 6.5.3.

نسخه 6.4.11.1

  • مشکلی که در آن تبلیغات بنری بازخوانی نشدند برطرف شد.

نسخه 6.4.11.0

  • سازگاری تایید شده با Vungle SDK 6.4.11.
  • پشتیبانی از تبلیغات بنری اضافه شد.
  • آداپتور را به AndroidX منتقل کرد.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK به 18.2.0 به روز شد.

نسخه 6.3.24.1

  • آداپتور به‌روزرسانی شده برای پشتیبانی از API پاداش‌دهی بتا باز جدید.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK به 17.2.0 به روز شد.

نسخه 6.3.24.0

  • سازگاری تایید شده با Vungle SDK 6.3.24.

نسخه 6.3.17.0

  • سازگاری تایید شده با Vungle SDK 6.3.17.

نسخه 6.3.12.0

  • سازگاری تایید شده با Vungle SDK 6.3.12.

نسخه 6.2.5.1

  • آداپتور را برای فراخوانی رویداد تبلیغاتی onRewardedVideoComplete() به روز کرد.

نسخه 6.2.5.0

  • سازگاری تایید شده با Vungle SDK 6.2.5.

نسخه 5.3.2.1

  • آداپتور به‌روزرسانی شده برای گزارش صحیح کلیک‌ها به Google Mobile Ads SDK.

نسخه 5.3.2.0

  • سازگاری تایید شده با Vungle SDK 5.3.2.
  • پروژه Adpater برای Android Studio 3.0 به روز شد.
  • متدهای زیر را به کلاس Bundle builder اضافه کرد.
    • setOrdinalViewCount : هر زمان که Publisher گزارش‌های داده‌های ترتیبی را از Vungle دریافت می‌کند، از این فیلد برای تصویب ترتیبی میانجی‌گری استفاده می‌شود.
    • setFlexViewCloseTimeInSec : از این گزینه برای اینکه تبلیغات با نمای انعطاف پذیر پس از مدت زمان مشخص شده خود به خود رد شوند استفاده می شود.

نسخه 5.3.0.0

  • سازگاری تایید شده با Vungle SDK 5.3.0.

نسخه 5.1.0.0

  • آداپتور را به روز کرد تا با Vungle SDK 5.1.0 سازگار شود.
  • سیستم نام‌گذاری نسخه را به [نسخه Vungle SDK] تغییر داد.[نسخه وصله آداپتور].

نسخه های قبلی

  • پشتیبانی از قالب‌های تبلیغات ویدیویی بینابینی و پاداش اضافه شده است.