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

پلتفرم مورد نظر را انتخاب کنید: اندروید (بتا) جدید-منتخب اندروید، iOS، یونیتی ، فلاتر

این راهنما به شما نشان می‌دهد که چگونه از GMA Next-Gen SDK برای بارگذاری و نمایش تبلیغات از Liftoff Monetize با استفاده از AdMob Mediation استفاده کنید که شامل ادغام‌های پیشنهاد قیمت و آبشاری می‌شود. این راهنما نحوه اضافه کردن Liftoff Monetize به پیکربندی میانجیگری یک واحد تبلیغاتی و نحوه ادغام Vungle SDK و آداپتور آن در یک برنامه اندروید را پوشش می‌دهد.

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

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

ادغام
مناقصه
آبشار
قالب‌ها
برنامه باز است
بنر
بینابینی
پاداش داده شده
تبلیغات بینابینی پاداش‌دار
بومی

الزامات

  • اندروید API سطح ۲۴ یا بالاتر

  • [برای پیشنهاد قیمت]: برای ادغام تمام قالب‌های تبلیغاتی پشتیبانی‌شده در پیشنهاد قیمت، از آداپتور Liftoff Monetize نسخه ۷.۳.۰.۰ یا بالاتر استفاده کنید ( آخرین نسخه توصیه می‌شود )

    • مرحله ۱: تنظیمات را در 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

    در فایل gradle سطح برنامه خود، وابستگی‌ها و پیکربندی‌های پیاده‌سازی زیر را اضافه کنید:

    کاتلین 

    dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02")
    implementation("com.google.ads.mediation:vungle:7.7.0.1")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

    گرووی 

    dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02'
    implementation 'com.google.ads.mediation:vungle:7.7.0.1'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

    ادغام دستی

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

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

    مرحله ۴: تنظیمات حریم خصوصی را روی Vungle SDK پیاده‌سازی کنید

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

    با شروع از نسخه ۷.۴.۱ کیت توسعه نرم‌افزار Vungle، ابزار Liftoff Monetize به‌طور خودکار رضایت‌نامه GDPR تنظیم‌شده توسط پلتفرم‌های مدیریت رضایت‌نامه که از مشخصات رضایت‌نامه اضافی گوگل ، از جمله UMP SDK ، پشتیبانی می‌کنند را می‌خواند. برای اطلاعات بیشتر، به دستورالعمل‌های پیاده‌سازی توصیه‌شده GDPR مراجعه کنید.

    قوانین حفظ حریم خصوصی ایالت‌های آمریکا

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

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

    جاوا 

    VunglePrivacySettings.setCCPAStatus(true);
    LiftoffMonetizeMediationSnippets.java

    کاتلین 

    VunglePrivacySettings.setCCPAStatus(true)
    LiftoffMonetizeMediationSnippets.kt

    برای جزئیات بیشتر و مقادیری که می‌توانند در این روش ارائه شوند ، به پیاده‌سازی CCPA مراجعه کنید.

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

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

    مرحله ۶: پیاده‌سازی خود را آزمایش کنید

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

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

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

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

    مراحل اختیاری

    پارامترهای خاص شبکه

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

    userId
    رشته‌ای که نشان‌دهنده‌ی شناسه‌ی کاربری تشویقی Liftoff Monetize است.
    adOrientation
    یک عدد صحیح که جهت نمایش تبلیغات تمام صفحه را مشخص می‌کند.
    setBackButtonImmediatelyEnabled
    یک مقدار بولی برای فعال یا غیرفعال کردن دکمه بازگشت در تبلیغات باز شدن برنامه (App Open ads). برای فعال کردن فوری دکمه بازگشت، آن را روی true و در غیر این صورت روی false تنظیم کنید. مقدار پیش‌فرض false است. برای اطلاعات بیشتر به مستندات Liftoff Monetize در مورد نحوه ادغام تبلیغات باز شدن برنامه مراجعه کنید.

    در اینجا یک نمونه کد از نحوه ایجاد یک درخواست تبلیغ که این پارامترها را تنظیم می‌کند، آورده شده است:

    جاوا 

    Bundle extras = new Bundle();
extras.putString(VungleConstants.KEY_USER_ID, "myUserID");
extras.putInt(VungleConstants.KEY_ORIENTATION, 1);
// Optional: Enables the back button on App Open ads immediately.
extras.putBoolean(VungleConstants.KEY_BACK_BUTTON_IMMEDIATELY_ENABLED, true);

AdRequest request =
    new AdRequest.Builder()
        .addNetworkExtrasBundle(VungleAdapter.class, extras) // Rewarded.
        .addNetworkExtrasBundle(VungleInterstitialAdapter.class, extras) // Interstitial.
        // App Open ads use VungleMediationAdapter
        .addNetworkExtrasBundle(VungleMediationAdapter.class, extras)
        .build();
    LiftoffMonetizeMediationSnippets.java

    کاتلین 

    val extras = Bundle()
extras.putString(VungleConstants.KEY_USER_ID, "myUserID")
extras.putInt(VungleConstants.KEY_ORIENTATION, 1)
// Optional: Enables the back button on App Open ads immediately.
extras.putBoolean(VungleConstants.KEY_BACK_BUTTON_IMMEDIATELY_ENABLED, true)

val request =
  AdRequest.Builder()
    .addNetworkExtrasBundle(VungleAdapter::class.java, extras) // Rewarded.
    .addNetworkExtrasBundle(VungleInterstitialAdapter::class.java, extras) // Interstitial.
    // App Open ads use VungleMediationAdapter
    .addNetworkExtrasBundle(VungleMediationAdapter::class.java, extras)
    .build()
    LiftoffMonetizeMediationSnippets.kt

    رندر تبلیغات بومی

    آداپتور Liftoff Monetize تبلیغات بومی خود را به عنوان اشیاء NativeAd برمی‌گرداند. این آداپتور توضیحات فیلد تبلیغات بومی زیر را برای یک NativeAd پر می‌کند.

    میدان دارایی‌هایی که همیشه توسط آداپتور Liftoff Monetize لحاظ می‌شوند
    تیتر
    تصویر ۱
    نمای رسانه
    بدن
    آیکون برنامه
    فراخوان برای اقدام
    رتبه‌بندی ستاره‌ای
    فروشگاه
    قیمت

    آداپتور Liftoff Monetize دسترسی مستقیم به تصویر اصلی برای تبلیغات بومی خود را فراهم نمی‌کند. در عوض ، این آداپتور MediaView را با یک ویدیو یا یک تصویر پر می‌کند.

    کدهای خطا

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

    قالب نام کلاس
    برنامه باز است (مناقصه) 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 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 و اندروید مراجعه کنید.