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

پلتفرم مورد نظر: اندروید، iOS، یونیتی، فلاتر

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

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

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

الزامات

  • جدیدترین SDK تبلیغات موبایلی گوگل
  • فلاتر ۳.۷.۰ یا بالاتر
  • [برای پیشنهاد قیمت]: برای ادغام تمام قالب‌های تبلیغاتی پشتیبانی‌شده در پیشنهاد قیمت، از افزونه‌ی میانجیگری تبلیغات موبایلی گوگل برای AppLovin 5.1.0 یا بالاتر استفاده کنید ( آخرین نسخه توصیه می‌شود )
  • برای نصب روی اندروید
    • اندروید API سطح ۲۳ یا بالاتر
  • برای استقرار در iOS
    • هدف استقرار iOS 12.0 یا بالاتر
  • یک پروژه فلاترِ در حال کار که با 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

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

اندروید

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

آی‌او‌اس

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

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

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

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

ادغام از طریق pub.dev

وابستگی زیر را به همراه آخرین نسخه‌های Liftoff Monetize SDK و آداپتور آن در فایل pubspec.yaml پکیج خود اضافه کنید:

dependencies:
  gma_mediation_liftoffmonetize: ^1.3.0

ادغام دستی

آخرین نسخه افزونه Google Mobile Ads mediation را برای Liftoff Monetize دانلود کنید، فایل دانلود شده را استخراج کنید و پوشه افزونه استخراج شده (و محتویات آن) را به پروژه Flutter خود اضافه کنید. سپس با اضافه کردن وابستگی زیر، افزونه را در فایل pubspec.yaml خود ارجاع دهید:

dependencies:
  gma_mediation_liftoffmonetize:
    path: path/to/local/package

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

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

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

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

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

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

import 'package:gma_mediation_liftoffmonetize/gma_mediation_liftoffmonetize.dart';
// ...

GmaMediationLiftoffmonetize.setCCPAStatus(true);

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

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

اندروید

برای یکپارچه‌سازی با Liftoff Monetize نیازی به کد اضافی نیست.

آی‌او‌اس

ادغام شبکه SKAd

برای افزودن شناسه‌های SKAdNetwork به فایل Info.plist پروژه خود ، مستندات Liftoff Monetize را دنبال کنید.

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

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

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

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

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

کدهای خطا

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

اندروید

قالب نام کلاس
برنامه باز است (مناقصه) com.google.ads.mediation.vungle.VungleMediationAdapter
برنامه باز (آبشاری) com.google.ads.mediation.vungle.VungleMediationAdapter
بنر (مناقصه) com.google.ads.mediation.vungle.VungleMediationAdapter
بنر (آبشار) com.vungle.mediation.VungleInterstitialAdapter
تبلیغات بینابینی (مناقصه) com.google.ads.mediation.vungle.VungleMediationAdapter
بینابینی (آبشاری) com.vungle.mediation.VungleInterstitialAdapter
پاداش داده شده (مناقصه) com.google.ads.mediation.vungle.VungleMediationAdapter
پاداش داده شده (آبشار) com.vungle.mediation.VungleAdapter
تبلیغات بینابینی پاداش‌دار (مناقصه) com.google.ads.mediation.vungle.VungleMediationAdapter
تبلیغات بینابینی پاداش‌دار (آبشاری) com.google.ads.mediation.vungle.VungleMediationAdapter

آی‌او‌اس

قالب نام کلاس
برنامه باز است (مناقصه) GADMediationAdapterVungle
برنامه باز (آبشاری) GADMediationAdapterVungle
بنر (مناقصه) GADMediationAdapterVungle
بنر (آبشار) GADMAdapterVungleInterstitial
تبلیغات بینابینی (مناقصه) GADMediationAdapterVungle
بینابینی (آبشاری) GADMAdapterVungleInterstitial
پاداش داده شده (مناقصه) GADMediationAdapterVungle
پاداش داده شده (آبشار) GADMAdapterVungleRewardBasedVideoAd
تبلیغات بینابینی پاداش‌دار (مناقصه) GADMediationAdapterVungle
تبلیغات بینابینی پاداش‌دار (آبشاری) GADMediationAdapterVungle

در اینجا کدها و پیام‌های همراه که توسط آداپتور Liftoff Monetize هنگام عدم بارگیری یک تبلیغ نمایش داده می‌شوند، آمده است:

اندروید

کد خطا دلیل
۱۰۱ پارامترهای سرور نامعتبر است (مثلاً شناسه برنامه یا شناسه قرارگیری).
۱۰۲ اندازه بنر درخواستی با اندازه تبلیغات معتبر Liftoff Monetize مطابقت ندارد.
۱۰۳ Liftoff Monetize برای درخواست تبلیغات به یک زمینه Activity (Activity context) نیاز دارد.
۱۰۴ کیت توسعه نرم‌افزاری Vungle نمی‌تواند چندین تبلیغ را برای یک شناسه قرارگیری یکسان بارگذاری کند.
۱۰۵ SDK وانگِل (Vungle) نتوانست مقداردهی اولیه شود.
۱۰۶ Vungle SDK یک فراخوانی موفقیت‌آمیز برای بارگذاری برگرداند، اما Banners.getBanner() یا Vungle.getNativeAd() مقدار null را برمی‌گردانند.
۱۰۷ کیت توسعه نرم‌افزاری وانگل (Vungle SDK) برای پخش تبلیغ آماده نیست.
۱۰۸ Vungle SDK توکن پیشنهاد قیمت نامعتبر را برگرداند.

آی‌او‌اس

کد خطا دلیل
۱۰۱ پارامترهای سرور نامعتبر است (مثلاً شناسه برنامه یا شناسه قرارگیری).
۱۰۲ یک تبلیغ از قبل برای این پیکربندی شبکه بارگذاری شده است. Vungle SDK نمی‌تواند تبلیغ دومی را برای همان شناسه‌ی قرارگیری بارگذاری کند.
۱۰۳ اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده توسط Liftoff Monetize مطابقت ندارد.
۱۰۴ کیت توسعه نرم‌افزاری Vungle نتوانست بنر تبلیغاتی را رندر کند.
۱۰۵ Vungle SDK فقط از بارگذاری ۱ بنر تبلیغاتی در یک زمان، صرف نظر از شناسه قرارگیری، پشتیبانی می‌کند.
۱۰۶ Vungle SDK تماسی مبنی بر عدم امکان پخش تبلیغ ارسال کرد.
۱۰۷ کیت توسعه نرم‌افزاری وانگل (Vungle SDK) برای پخش تبلیغ آماده نیست.

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

لیست تغییرات آداپتور میانجیگری فلاتر برای کسب درآمد از لیفت‌آف

نسخه ۱.۲.۳

نسخه ۱.۲.۲

نسخه ۱.۲.۱

نسخه ۱.۲.۰

نسخه ۱.۱.۱

نسخه ۱.۱.۰

نسخه ۱.۰.۰