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

انتخاب پلاتفرم: Android iOS Unity Flutter Android (قدیمی)

این راهنما نحوه استفاده از Google Mobile Ads Flutter Plugin را برای بار کردن و نمایش دادن آگهی‌های Liftoff Monetize بااستفاده از واسطه‌گری نشان می‌دهد و هر دو ادغام پیشنهاد قیمت و آبشاری را پوشش می‌دهد. این راهنما نحوه افزودن Liftoff Monetize به پیکربندی واسطه‌گری واحد آگهی و نحوه ادغام کیت توسعه نرم‌افزار و آداپتور Liftoff Monetize در برنامه Flutter را پوشش می‌دهد.

یکپارچه‌سازی‌ها و قالب‌های آگهی پشتیبانی‌شده

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

پیش‌نیازها

قبل‌از ادامه دادن، موارد زیر را درستی‌سنجی کنید:

  • جدیدترین نسخه Google Mobile Ads Flutter Plugin.
  • نسخه چارچوب Flutter‏ ۳.۷.۰ یا بالاتر.
  • برای استقرار در Android
    • سطح میانای برنامه کاربردی Android 24 یا بالاتر.
  • برای استقرار در iOS
    • هدف استقرار iOS نسخه ۱۳.۰ یا بالاتر.
  • پروژه Flutter کاری که با Google Mobile Ads Flutter Plugin پیکربندی شده است. برای جزئیات بیشتر، راه‌اندازی Google Mobile Ads Flutter Plugin را ببینید.
  • واسطه‌گری AdMob را راه‌اندازی کنید.

مرحله ۱: پیکربندی‌ها را در «واسط کاربر Liftoff Monetize» تنظیم کنید

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

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

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

Android

iOS

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

Android

iOS

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

Android

iOS

افزودن جای آگهی جدید

برای ایجاد جای آگهی جدید برای استفاده با «واسطه‌گری AdMob»، به داشبورد «جای آگهی‌های درآمدزایی Liftoff» بروید، روی دکمه افزودن جای آگهی کلیک کنید و برنامه خود را از فهرست کرکره‌ای انتخاب کنید.

جزئیات افزودن جای آگهی جدید در زیر آمده است:

باز کردن برنامه

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

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

برنمای ۳۰۰x۲۵۰

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

بینابینی

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

پاداش

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

بینابینی پاداش‌دار

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

بومی

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

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

باز کردن برنامه

برنمای ۳۰۰x۲۵۰

بینابینی

پاداش

بینابینی پاداش‌دار

بومی

مکان «کلید میانای برنامه‌سازی کاربردی گزارش‌دهی» خود را پیدا کنید

پیشنهاد قیمت

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

آبشار

علاوه‌بر شناسه برنامه و شناسه مرجع، برای راه‌اندازی شناسه واحد آگهی AdMob خود، به کلید API گزارش‌دهی «درآمدزایی Liftoff» نیز نیاز دارید. به داشبورد گزارش‌های درآمدزایی Liftoff بروید و روی دکمه کلید میانای برنامه‌سازی کاربردی گزارش‌دهی کلیک کنید تا کلید میانای برنامه‌سازی کاربردی گزارش‌دهی خود را مشاهده کنید.

به‌روزرسانی app-ads.txt

«فروشندگان مجاز برای برنامه‌ها» app-ads.txt ابتکار IAB Tech Lab است که کمک می‌کند مطمئن شوید فضای آگهی برنامه شما فقط ازطریق کانال‌هایی که به‌عنوان مجاز شناسایی کرده‌اید فروخته می‌شود. برای جلوگیری از کاهش قابل‌توجه درآمد آگهی، باید فایل app-ads.txt را پیاده‌سازی کنید. اگر قبلاً این کار را نکرده‌اید، فایل app-ads.txt را برای برنامه‌تان راه‌اندازی کنید.

برای پیاده‌سازی app-ads.txt برای Liftoff Monetize، ورودی‌های app-ads.txt مربوط به Liftoff Monetize را بارگیری کنید و به فایل app-ads.txt موجودتان اضافه کنید. برای اطلاعات بیشتر، app-ads.txt را ببینید.

روشن کردن حالت آزمایش

برای فعال کردن آگهی‌های آزمایشی، به داشبورد «درآمدزایی Liftoff» بروید و به برنامه‌ها پیمایش کنید.

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

Android

iOS

مرحله ۲: راه‌اندازی کردن تقاضای «درآمدزایی Liftoff» در «واسط کاربر AdMob»

پیکربندی تنظیمات واسطه‌گری برای واحد آگهی

Android

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

iOS

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

افزودن Liftoff به فهرست شرکای آگهی «مقررات کلی حفاظت از داده» و مقررات ایالتی ایالات متحده

مراحل مندرج در تنظیمات مقررات اروپا و تنظیمات مقررات ایالت امریکا را دنبال کنید تا Liftoff را به فهرست شرکای آگهی مقررات اروپا و ایالت امریکا در «میانای کاربری AdMob» اضافه کنید.

مرحله ۳: وارد کردن «کیت توسعه نرم‌افزار Liftoff Monetize» و آداپتور

یکپارچه‌سازی ازطریق pub.dev

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

dependencies:
  gma_mediation_liftoffmonetize: ^1.5.5

یکپارچه‌سازی دستی

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

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

مرحله ۴: پیاده‌سازی تنظیمات حریم خصوصی در «کیت توسعه نرم‌افزار Liftoff Monetize»

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

شروع در Liftoff Monetize نسخه ۱.۱.۰ افزایه Flutter، ‫Liftoff Monetize به‌طور خودکار رضایت GDPR را که پلاتفرم‌های مدیریت موافقت که از مشخصات «موافقت اضافی» Google پشتیبانی می‌کنند تنظیم کرده‌اند می‌خواند، ازجمله کیت توسعه نرم‌افزار UMP. برای اطلاعات بیشتر، «دستورالعمل‌های اجرای توصیه‌شده «مقررات عمومی حفاظت از داده‌ها» برای Android و iOS» را ببینید.

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

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

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

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

GmaMediationLiftoffmonetize.setCCPAStatus(true);

برای جزئیات بیشتر و مقادیر قابل ارائه در روش، دستورالعمل‌های پیاده‌سازی توصیه‌شده «قانون حریم خصوصی مصرف‌کننده در کالیفرنیا» را برای Android و iOS ببینید.

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

Android

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

iOS

یکپارچه‌سازی SKAdNetwork

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

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

فعال کردن آگهی‌های آزمایشی

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

درستی‌سنجی آگهی‌های آزمایشی

برای درستی‌سنجی اینکه آگهی‌های آزمایشی را از Liftoff Monetize دریافت می‌کنید، آزمایش منبع آگهی تکی را در بازرس آگهی بااستفاده از منبع (های) آگهی Liftoff Monetize (پیشنهاد قیمت) و Liftoff Monetize(آبشاری) فعال کنید.

کدهای خطا

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

Android

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

iOS

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

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

Android

کد خطا استدلال
۱۰۱ پارامترهای سرور نامعتبر است (برای نمونه، شناسه برنامه یا شناسه جای آگهی).
102 اندازه درخواست‌شده برای برنمای آگهی با اندازه معتبر آگهی Liftoff Monetize مطابقت ندارد.
103 ‫Liftoff Monetize برای درخواست آگهی به بافت Activity نیاز دارد.
104 «کیت توسعه نرم‌افزار Vungle» نمی‌تواند چندین آگهی را برای جای آگهی یکسان بار کند شناسه.
۱۰۵ «کیت توسعه نرم‌افزار Vungle» مقداردهی اولیه نشد.
106 «کیت توسعه نرم‌افزار Vungle» یک پاسخ‌برگ بار موفقیت‌آمیز برگرداند، اما Banners.getBanner() یا Vungle.getNativeAd() مقدار null برگرداندند.
107 «کیت توسعه نرم‌افزار Vungle» برای پخش آگهی آماده نیست.
108 «کیت توسعه نرم‌افزار Vungle» کد پیشنهاد قیمت نامعتبری برگرداند.

iOS

کد خطا استدلال
۱۰۱ پارامترهای سرور نامعتبر است (برای نمونه، شناسه برنامه یا شناسه جای آگهی).
102 آگهی‌ای ازقبل برای این پیکربندی شبکه بار شده است. «کیت توسعه نرم‌افزار Vungle» نمی‌تواند آگهی دومی را برای همان شناسه جای آگهی بار کند.
103 اندازه آگهی درخواست‌شده با اندازه برنمای پشتیبانی‌شده در Liftoff Monetize مطابقت ندارد.
104 «کیت توسعه نرم‌افزار Vungle» نتوانست آگهی برنمایی را ارائه کند.
۱۰۵ «کیت توسعه نرم‌افزار Vungle» فقط از بار کردن ۱ آگهی برنما در هر زمان پشتیبانی می‌کند، صرف‌نظر از شناسه جای آگهی.
106 «کیت توسعه نرم‌افزار Vungle» یک عملکرد برگشتی ارسال کرد که می‌گوید آگهی قابل‌پخش نیست.
107 «کیت توسعه نرم‌افزار Vungle» برای پخش آگهی آماده نیست.

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

گزارش تغییرات «آداپتور میانجی‌گری Flutter» برای درآمدزایی Liftoff

نسخه ۱.۵.۵

نسخه ۱.۵.۴

نسخه ۱.۵.۳

نسخه 1.5.2

نسخه 1.5.1

نسخه ۱.۵.۰

نسخه ۱.۴.۳

نسخه 1.4.2

  • حداقل نسخه Flutter به ۳.۳۵.۱ به‌روز شد
  • برای پشتیبانی از نسخه ۷.۰.۰ «افزایه Flutter تبلیغات تلفن همراه Google» به‌روزرسانی شد

نسخه ۱.۴.۱

نسخه ۱.۴.۰

نسخه ۱.۳.۰

نسخه ۱.۲.۳

نسخه ۱.۲.۲

نسخه ۱.۲.۱

نسخه ۱.۲.۰

نسخه ۱.۱.۱

نسخه ۱.۱.۰

نسخه ۱.۰.۰