این راهنما به شما نشان میدهد که چگونه از Google Mobile Ads Flutter Plugin برای بار کردن و نمایش دادن آگهیهای AppLovin بااستفاده از میانجیگری استفاده کنید و ادغامهای مزایدهای و آبشاری را پوشش میدهد. این راهنما نحوه افزودن AppLovin به پیکربندی میانجیگری واحد آگهی و نحوه ادغام کردن کیت توسعه نرمافزار و آداپتور AppLovin در برنامه Flutter را پوشش میدهد.
یکپارچهسازیها و قالبهای آگهی پشتیبانیشده
کارگزار میانجیگری Ad Manager برای AppLovin قابلیتهای زیر را دارد:
| یکپارچهسازی | |
|---|---|
| پیشنهاد قیمت | |
| آبشار | |
| قالبها | |
| صفحه باز شدن برنامه | ۱ |
| برنما | ۲ |
| بینابینی | |
| پاداش | |
۱ ادغام آبشاری در نسخه بتای محدود است.
آبشاری فقط از اندازههای برنمای ۳۲۰×۵۰ و ۷۲۸×۹۰ پشتیبانی میکند. پیشنهاد قیمت از آگهیهای برنما پشتیبانی نمیکند.
پیشنیازها
قبلاز ادامه دادن، موارد زیر را تأیید کنید:
- جدیدترین نسخه Google Mobile Ads Flutter Plugin.
- چارچوب Flutter نسخه ۳.۷.۰ یا بالاتر.
- برای استقرار در Android
- سطح میانای برنامه کاربردی Android 24 یا بالاتر.
- برای استقرار در iOS
- هدف استقرار iOS نسخه ۱۳.۰ یا جدیدتر.
- پروژه Flutter فعال پیکربندیشده با Google Mobile Ads Flutter Plugin. برای جزئیات، راهاندازی Google Mobile Ads Flutter Plugin را ببینید.
مرحله ۱: پیکربندیها را در «میانای کاربری AppLovin» راهاندازی کنید
ثبتنام کنید یا وارد حساب AppLovin خود شوید.
برای راهاندازی واحد آگهی Ad Manager، به کلید کیت توسعه نرمافزار و کلید گزارش AppLovin نیاز دارید. برای پیدا کردن آنها، به رابط کاربری AppLovin > حساب > کلیدها بروید تا هر دو مقدار را ببینید.

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

ایجاد منطقه
پیشنهاد قیمت
این مرحله برای ادغامهای پیشنهاد قیمت لازم نیست.
آبشار
در رابط کاربری AppLovin، مناطق را در بخش درآمدزایی انتخاب کنید تا به شناسههای منطقه ثبتشده خود دسترسی پیدا کنید. اگر قبلاً مناطق موردنیاز را برای برنامهتان ایجاد کردهاید، به مرحله ۲ بروید. برای ایجاد شناسه منطقه جدید، روی ایجاد منطقه کلیک کنید.

نام شناسه منطقه را وارد کنید، Android را بهعنوان پلاتفرم انتخاب کنید، و نوع آگهی را انتخاب کنید.
با انتخاب «هزارظهوربهای ثابت» یا «بهینهسازیشده توسط AppLovin»، قیمتگذاری را برای منطقه پیکربندی کنید. «هزارظهوربها» را میتوان براساس هر کشور برای گزینه هزارظهوربهای ثابت پیکربندی کرد. سپس روی ذخیره کردن کلیک کنید.
Android

iOS

پساز ایجاد منطقه، شناسه منطقه را میتوانید در ستون شناسه منطقه پیدا کنید.
Android

iOS

فایل app-ads.txt خود را بهروز کنید
Authorized Sellers for Apps app-ads.txt ابتکاری از IAB Tech Lab است که کمک میکند مطمئن شوید
فهرست آگهیهای برنامهتان فقط ازطریق کانالهایی که بهعنوان مجاز شناسایی کردهاید فروخته میشود. برای جلوگیری از
افت قابلتوجه در درآمد آگهی، باید فایل app-ads.txt را پیادهسازی کنید.
اگر قبلاً این کار را نکردهاید،
فایل app-ads.txt برای Ad Manager ایجاد کنید.
برای پیادهسازی app-ads.txt برای AppLovin،
AppLovin را به فایل app-ads.txt خود اضافه کنید.
روشن کردن حالت آزمایشی
دستورالعملهای موجود در راهنمای حالت آزمایش MAX از AppLovin را درباره نحوه فعال کردن آگهیهای آزمایشی AppLovin دنبال کنید.
مرحله ۲: راهاندازی تقاضای AppLovin در میانای کاربری «مدیر آگهی»
پیکربندی تنظیمات واسطهگری برای واحد آگهی
Android
برای دستورالعملها، مرحله ۲ را در راهنمای Android ببینید.
iOS
برای دستورالعملها، مرحله ۲ را در راهنمای iOS ببینید.
افزودن AppLovin Corp. به فهرست شرکای آگهی «مقررات کلی حفاظت از داده» و مقررات ایالتی ایالات متحده
مراحل موجود در تنظیمات مقررات اروپا و تنظیمات مقررات ایالتی ایالات متحده را دنبال کنید تا AppLovin Corp. را به فهرست شرکای آگهی مقررات اروپا و ایالتی ایالات متحده در میانای کاربری Ad Manager اضافه کنید.
مرحله ۳: وارد کردن SDK و آداپتور AppLovin
ادغام ازطریق pub.dev
وابستگی زیر را با جدیدترین نسخههای
کیت توسعه نرمافزار AppLovin و آداپتور در
فایل pubspec.yaml بستهتان اضافه کنید:
dependencies:
gma_mediation_applovin: ^2.6.5
ادغام دستی
جدیدترین نسخه افزایه میانجی Google Mobile Ads را برای
AppLovin بارگیری کنید،
فایل بارگیریشده را از حالت فشرده خارج کنید، و پوشه افزایه استخراجشده
(و محتوای آن) را به پروژه Flutter خود اضافه کنید. سپس، با افزودن وابستگی زیر، به افزونه در فایل
pubspec.yaml ارجاع دهید:
dependencies:
gma_mediation_applovin:
path: path/to/local/package
مرحله ۴: پیادهسازی تنظیمات حریم خصوصی در AppLovin SDK
رضایت اتحادیه اروپا و «مقررات کلی حفاظت از داده»
برای رعایت خطمشی Google درخصوص موافقت کاربر اتحادیه اروپا، باید شفافسازیهای خاصی را برای کاربران خود در منطقه اقتصادی اروپا (EEA)، پادشاهی متحد، و سوئیس انجام دهید و موافقت آنها را برای استفاده از کوکیها یا دیگر فضاهای ذخیرهسازی محلی در جاهایی که قانون الزام میکند، و برای جمعآوری، همرسانی، و استفاده از دادههای شخصی برای شخصیسازی آگهیها کسب کنید. این خطمشی منعکسکننده الزامات «آییننامه حریمخصوصی الکترونیکی» اتحادیه اروپا و «مقررات کلی حفاظت از داده» (GDPR) است. شما مسئولید که تأیید کنید رضایت به هر منبع آگهی در زنجیره میانجیگری شما منتقل شده است.
نسخه 1.0.0 و نسخههای جدیدتر آداپتور AppLovin Flutter از ارسال سیگنالهای کسب رضایت با مقررات کلی حفاظت از داده از کیت توسعه نرمافزار UMP و پلاتفرمهای مدیریت رضایتها که با مشخصات رضایت تکمیلی Google ادغام میشوند پشتیبانی میکند
برای اطلاعات بیشتر، تنظیمات حریم خصوصی AppLovin را ببینید.
اعلام کاربران کودک
AppLovin از مقداردهی اولیه کیت توسعه نرمافزار AppLovin درارتباط با کودک پشتیبانی نمیکند. برای اطلاعات بیشتر، به اسناد AppLovin درباره «ممنوعیت دادههای کودکان یا استفاده از سرویسها برای کودکان یا برنامههایی که منحصراً کودکان را هدف قرار میدهند» برای Android یا iOS مراجعه کنید.
افزایه میانجیگری Google Mobile Ads Flutter برای
AppLovin
نسخه 9.1.0 یا بالاتر
میانجیگری را برای
AppLovin
بهطور خودکار برای برنامههایی که کاربر کودک را بااستفاده از هریک از تنظیمات زیر اعلام میکنند غیرفعال میکند:
قوانین حریم خصوصی ایالتی در ایالات متحده
قوانین حریم خصوصی ایالتهای امریکا ملزم میکند به کاربران حق داده شود که از «فروش» «اطلاعات شخصی» خود (طبق تعریف قانون از این اصطلاحات) انصراف دهند، و این انصراف ازطریق پیوند برجسته «اطلاعات شخصی من فروخته نشود» در صفحه اصلی طرف «فروشنده» ارائه شود. راهنمای رعایت قوانین حریم خصوصی ایالتهای ایالات متحده امکان فعال کردن پردازش محدود دادهها را برای آگهیرسانی Google فراهم میکند، اما Google نمیتواند این تنظیم را برای هر شبکه آگهی در زنجیره میانجیگری شما اعمال کند. بنابراین، باید هریک از شبکههای آگهی را که ممکن است در فروش اطلاعات شخصی مشارکت داشته باشند در زنجیره میانجیگریتان شناسایی کنید و برای اطمینان از رعایت مقررات، از راهنماییهای هریک از آن شبکهها پیروی کنید.
افزونه میانجیگری Google Mobile Ads برای
AppLovin
شامل روش
GmaMediationApplovin.setDoNotSell()
است. نمونه کد زیر نحوه ارسال اطلاعات رضایت به
کیت توسعه نرمافزار AppLovin را نشان میدهد. این گزینهها باید قبلاز راهاندازی کیت توسعه نرمافزار تبلیغات تلفن همراه Google تنظیم شوند تا اطمینان حاصل شود که بهدرستی به کیت توسعه نرمافزار AppLovin ارسال میشوند.
import 'package:gma_mediation_applovin/gma_mediation_applovin.dart';
// ...
GmaMediationApplovin.setDoNotSell(true);
برای اطلاعات بیشتر، اسناد حریم خصوصی AppLovin را ببینید.
مرحله ۵: افزودن کد الزامی
Android
برای یکپارچهسازی AppLovin، کد اضافی لازم نیست.
iOS
یکپارچهسازی SKAdNetwork
مستندات AppLovin را دنبال کنید تا شناسههای SKAdNetwork را به فایل Info.plist پروژه خود اضافه کنید.
مرحله ۶: پیادهسازیتان را آزمایش کنید
فعال کردن آگهیهای آزمایشی
حتماً دستگاه آزمایشیتان را برای Ad Manager ثبت کنید و حالت آزمایشی را در رابط کاربری AppLovin فعال کنید.
درستیسنجی آگهیهای آزمایشی
برای تأیید اینکه از AppLovin آگهیهای آزمایشی دریافت میکنید، آزمایش منبع آگهی تکی را در بازرس آگهی بااستفاده از منبع (های) آگهی AppLovin (پیشنهاد قیمت) و AppLovin(آبشاری) فعال کنید.
مراحل اختیاری
پارامترهای مختص شبکه
آداپتور AppLovin از ارسال شیء AppLovinMediationExtras به درخواست آگهی برای تنظیم پارامترهای مختص شبکه پشتیبانی میکند. نمونه کد زیر نشان میدهد
چگونه بااستفاده از پارامتر isMuted، صدا را در آگهیهای ویدیویی غیرفعال کنید:
AppLovinMediationExtras applovinExtras = AppLovinMediationExtras(isMuted: true)
AdRequest request = AdRequest(
keywords: <String>['foo', 'bar'],
contentUrl: 'http://foo.com/bar.html',
mediationExtras: [applovinExtras],
);
بهینهسازیها
افزودن یک تماس به
GmaMediationApplovin.initializeSdk('sdkKey')
به فعالیت راهاندازی شما به AppLovin امکان میدهد
رویدادها را بهمحض شروع برنامه پیگیری کند.
کدهای خطا
اگر آداپتور نتواند آگهیای از AppLovin دریافت کند،
ناشران میتوانند خطای زمینهای را از پاسخ آگهی بااستفاده از
ResponseInfo تحت
کلاسهای زیر بررسی کنند:
Android
com.google.ads.mediation.applovin.mediation.ApplovinAdapter
com.google.ads.mediation.applovin.AppLovinMediationAdapter
iOS
GADMAdapterAppLovin
GADMAdapterAppLovinRewardBasedVideoAd
GADMediationAdapterAppLovin
در اینجا کدها و پیامهای همراهی که توسط آداپتور AppLovin ارسال میشوند وقتی آگهی بارگیری نمیشود، آورده شده است:
Android
| کد خطا | استدلال |
|---|---|
| -۱۰۰۹ تا -۱، ۲۰۴ | کیت توسعه نرمافزار AppLovin خطایی برگرداند. برای جزئیات بیشتر، اسناد AppLovin را ببینید. |
| ۱۰۱ | اندازه آگهی درخواستشده با اندازه برنمای پشتیبانیشده AppLovin مطابقت ندارد. |
| 103 | بافت تهی است. |
| 104 | کد پیشنهاد قیمت AppLovin خالی است. |
| ۱۰۵ | چندین آگهی برای یک منطقه درخواست شده است. AppLovin در هر زمان فقط میتواند ۱ آگهی در هر منطقه بار کند. |
| 106 | آگهی برای نمایش آماده نیست. |
| 108 | «آداپتور AppLovin» از قالب آگهی درخواستشده پشتیبانی نمیکند. |
| ۱۰۹ | بافت نمونهای از «فعالیت» نیست. |
| 110 | کلید کیت توسعه نرمافزار وجود ندارد. |
| 112 | کاربر کودک است. |
| ۱۱۳ | شناسه واحد آگهی وجود ندارد. |
iOS
| کد خطا | استدلال |
|---|---|
| -۱۰۹ تا -۱٬۲۰۴ | کیت توسعه نرمافزار AppLovin خطایی برگرداند. برای جزئیات بیشتر، مستندات AppLovin را ببینید. |
| ۱۰۱ | اندازه آگهی درخواستشده با اندازه برنمای پشتیبانیشده AppLovin مطابقت ندارد. |
| 102 | پارامترهای سرور AppLovin که در «واسط کاربر Ad Manager» پیکربندی شدهاند وجود ندارند/نامعتبر هستند. |
| 103 | آگهی AppLovin نشان داده نشد. |
| 104 | چندین آگهی برای یک منطقه درخواست شده است. AppLovin در هر منطقه فقط میتواند ۱ آگهی را در هر بار بار کند. |
| ۱۰۵ | کلید کیت توسعه نرمافزار AppLovin پیدا نشد. |
| 107 | کد پیشنهاد قیمت خالی است. |
| 108 | «آداپتور AppLovin» از قالب آگهی درخواستی پشتیبانی نمیکند. |
| 110 | AppLovin یک فراخوان برگشتی بارگیری موفق ارسال کرد اما هیچ آگهیای بارگیری نشد. |
| 111 | نمونه AppLovin SDK بازیابی نشد. |
| 112 | کاربر کودک است. |
| ۱۱۳ | نمونه مشترک «کیت توسعه نرمافزار AppLovin» مقداردهی اولیه نشده است. |
| 114 | کیت توسعه نرمافزار AppLovin نمیتواند کد پیشنهاد قیمت را برگرداند. |
| 115 | شناسه واحد آگهی وجود ندارد. آگهی بار نمیشود. |
| ۱۱۶ | آگهی آماده نیست. آگهی نمایش داده نشد. |
گزارش تغییرات میانجیگری AppLovin Flutter
نسخه ۲.۶.۵
- از آداپتور AppLovin Android نسخه ۱۳.۶.۴.۲ پشتیبانی میکند.
- از آداپتور AppLovin iOS نسخه ۱۳.۶.۴.۰ پشتیبانی میکند.
- بااستفاده از نسخه 9.1.0 «افزونه Flutter تبلیغات تلفن همراه Google» ساخته و آزمایش شده است.
نسخه ۲.۶.۴
- از آداپتور AppLovin Android نسخه ۱۳.۶.۴.۱ پشتیبانی میکند.
- از آداپتور AppLovin iOS نسخه ۱۳.۶.۴.۰ پشتیبانی میکند.
- با نسخه 9.1.0 افزایه Google Mobile Ads Flutter ساخته و آزمایش شده است.
نسخه ۲.۶.۳
- برای پشتیبانی از نسخه ۹.۱.۰ «افزونه Flutter تبلیغات Google در تلفن همراه» بهروز شد.
- پشتیبانی از «مدیر بسته Swift» را اضافه کنید.
- از نسخه 13.6.4.0 آداپتور Android در AppLovin پشتیبانی میکند.
- از نسخه 13.6.3.0 آداپتور AppLovin iOS پشتیبانی میکند.
- بااستفاده از نسخه 9.1.0 «افزونه Flutter تبلیغات تلفن همراه Google» ساخته و آزمایش شده است.
نسخه ۲.۶.۲
- بهروزرسانیشده برای پشتیبانی از نسخه ۹.۰.۰ «افزایه Flutter تبلیغات Google برای تلفن همراه».
- از نسخه 13.6.3.0 آداپتور Android در AppLovin پشتیبانی میکند.
- از نسخه 13.6.3.0 آداپتور AppLovin iOS پشتیبانی میکند.
- با نسخه ۹.۰.۰ افزونه Google Mobile Ads Flutter ساخته و آزمایش شده است.
نسخه ۲.۶.۱
- از آداپتور AppLovin Android نسخه ۱۳.۶.۲.۰ پشتیبانی میکند.
- از آداپتور AppLovin iOS نسخه ۱۳.۶.۲.۰ پشتیبانی میکند.
- با نسخه ۸.۰.۰ افزایه Google Mobile Ads Flutter ساخته و آزمایش شده است.
نسخه ۲.۶.۰
- حداقل نسخه Flutter به ۳.۳۸.۱ بهروز شد.
- برای پشتیبانی از نسخه ۸.۰.۰ «افزایه Google Mobile Ads Flutter» بهروزرسانی شد.
- از نسخه 13.6.2.0 آداپتور Android در AppLovin پشتیبانی میکند.
- از نسخه 13.6.1.0 آداپتور AppLovin iOS پشتیبانی میکند.
- با نسخه ۸.۰.۰ افزونه Flutter برای Google Mobile Ads ساخته و آزمایش شده است.
نسخه ۲.۵.۲
- حداقل نسخه Flutter به ۳.۳۵.۱ بهروز شد
- بهروزرسانیشده برای پشتیبانی از نسخه ۷.۰.۰ «افزونه Flutter تبلیغات تلفن همراه Google»
- از آداپتور AppLovin Android نسخه ۱۳.۵.۱.۰ پشتیبانی میکند.
- از آداپتور AppLovin iOS نسخه ۱۳.۵.۰.۰ پشتیبانی میکند.
- با نسخه ۷.۰.۰ افزایه Google Mobile Ads Flutter ساخته و آزمایش شده است.
نسخه ۲.۵.۱
- از آداپتور AppLovin Android نسخه ۱۳.۵.۱.۰ پشتیبانی میکند.
- از آداپتور AppLovin iOS نسخه ۱۳.۵.۰.۰ پشتیبانی میکند.
- بااستفاده از نسخه 6.0.0 افزونه Flutter برای Google Mobile Ads ساخته و آزمایش شده است.
نسخه ۲.۵.۰
- از آداپتور AppLovin Android نسخه ۱۳.۵.۰.۰ پشتیبانی میکند.
- از نسخه 13.5.0.0 آداپتور AppLovin iOS پشتیبانی میکند.
- بااستفاده از نسخه 6.0.0 افزونه Flutter برای Google Mobile Ads ساخته و آزمایش شده است.
نسخه ۲.۴.۰
- از آداپتور AppLovin Android نسخه ۱۳.۴.۰.۰ پشتیبانی میکند.
- از آداپتور AppLovin iOS نسخه ۱۳.۴.۰.۰ پشتیبانی میکند.
- با نسخه ۶.۰.۰ «افزایه Google Mobile Ads Flutter» ساخته و آزمایش شده است.
نسخه ۲.۳.۲
- از آداپتور AppLovin Android نسخه ۱۳.۳.۱.۱ پشتیبانی میکند.
- از نسخه 13.3.1.0 آداپتور AppLovin iOS پشتیبانی میکند.
- بااستفاده از نسخه 6.0.0 افزونه Flutter برای Google Mobile Ads ساخته و آزمایش شده است.
نسخه ۲.۳.۱
- از نسخه 13.3.1.0 آداپتور Android مربوط به AppLovin پشتیبانی میکند.
- از آداپتور AppLovin iOS نسخه ۱۳.۳.۱.۰ پشتیبانی میکند.
- با نسخه ۶.۰.۰ «افزایه Google Mobile Ads Flutter» ساخته و آزمایش شده است.
نسخه ۲.۳.۰
- از نسخه 13.3.0.0 آداپتور Android در AppLovin پشتیبانی میکند.
- از نسخه 13.3.0.0 آداپتور AppLovin iOS پشتیبانی میکند.
- با نسخه ۶.۰.۰ «افزایه Google Mobile Ads Flutter» ساخته و آزمایش شده است.
نسخه ۲.۲.۱
- از آداپتور AppLovin Android نسخه ۱۳.۲.۰.۱ پشتیبانی میکند.
- از نسخه 13.2.0.0 آداپتور AppLovin iOS پشتیبانی میکند.
- با نسخه ۶.۰.۰ «افزایه Google Mobile Ads Flutter» ساخته و آزمایش شده است.
نسخه ۲.۲.۰
- از نسخه 13.2.0.0 آداپتور Android در AppLovin پشتیبانی میکند.
- از نسخه ۱۳.۲.۰.۰ آداپتور AppLovin iOS پشتیبانی میکند.
- با نسخه ۶.۰.۰ «افزایه Google Mobile Ads Flutter» ساخته و آزمایش شده است.
نسخه ۲.۱.۰
- از آداپتور AppLovin Android نسخه ۱۳.۱.۰.۰ پشتیبانی میکند.
- از نسخه ۱۳.۱.۰.۰ آداپتور AppLovin iOS پشتیبانی میکند.
- بااستفاده از نسخه ۵.۳.۱ «افزونه Flutter تبلیغات تلفن همراه Google» ساخته و آزمایش شده است.
نسخه ۲.۰.۰
- از نسخه 13.0.1.0 آداپتور Android در AppLovin پشتیبانی میکند.
- از نسخه 13.0.1.0 آداپتور AppLovin iOS پشتیبانی میکند.
- بااستفاده از نسخه ۵.۳.۱ «افزونه Flutter تبلیغات تلفن همراه Google» ساخته و آزمایش شده است.
نسخه ۱.۲.۰
- از آداپتور AppLovin Android نسخه ۱۲.۶.۱.۰ پشتیبانی میکند.
- از آداپتور AppLovin iOS نسخه 12.6.1.0 پشتیبانی میکند.
- بااستفاده از «افزونه Google Mobile Ads Flutter» نسخه ۵.۱.۰ ساخته و آزمایش شده است.
نسخه ۱.۱.۰
- میانای برنامهسازی کاربردی برای GmaMediationApplovin دیگر ثابت نیست.
- از نسخه 12.4.3.0 آداپتور Android در AppLovin پشتیبانی میکند.
- از نسخه 12.4.2.0 آداپتور AppLovin iOS پشتیبانی میکند.
- با نسخه ۵.۱.۰ افزایه Google Mobile Ads Flutter ساخته و آزمایش شده است.
نسخه ۱.۰.۰
- نسخهٔ پخش اولیه.
- از آداپتور AppLovin Android نسخه ۱۲.۳.۰.۰ پشتیبانی میکند.
- از آداپتور AppLovin iOS نسخه ۱۲.۲.۱.۰ پشتیبانی میکند.
- با افزایه Google Mobile Ads Flutter نسخه ۵.۰.۰ ساخته و آزمایش شده است.