این راهنما به شما نشان می‌دهد که چگونه از SDK تبلیغات موبایل گوگل برای بارگذاری و نمایش تبلیغات از AppLovin با استفاده از میانجیگری استفاده کنید، که شامل ادغام‌های مناقصه‌ای و آبشاری می‌شود. این راهنما نحوه اضافه کردن AppLovin به پیکربندی میانجیگری یک واحد تبلیغاتی و نحوه ادغام SDK و آداپتور AppLovin در یک برنامه Flutter را پوشش می‌دهد.
ادغام‌ها و قالب‌های تبلیغاتی پشتیبانی‌شده
آداپتور میانجیگری Ad Manager برای AppLovin قابلیت‌های زیر را دارد:
| ادغام | |
|---|---|
| مناقصه | |
| آبشار | |
| قالب‌ها | |
| بنر | ۱ |
| بینابینی | |
| پاداش داده شده | |
Waterfall فقط از بنرهای با اندازه ۳۲۰x۵۰ و ۷۲۸x۹۰ پشتیبانی می‌کند. Bidding از بنرهای تبلیغاتی پشتیبانی نمی‌کند.
الزامات
- جدیدترین SDK تبلیغات موبایلی گوگل
- فلاتر ۳.۷.۰ یا بالاتر
- برای نصب روی اندروید
- اندروید API سطح ۲۳ یا بالاتر
- برای استقرار در iOS
- هدف استقرار iOS 12.0 یا بالاتر
- یک پروژه فلاترِ در حال کار که با SDK تبلیغات موبایلی گوگل پیکربندی شده است. برای جزئیات بیشتر به «شروع به کار» مراجعه کنید.
- راهنمای شروع میانجیگری را تکمیل کنید
مرحله ۱: تنظیمات را در AppLovin UI تنظیم کنید
ثبت نام کنید یا وارد حساب AppLovin خود شوید .
برای تنظیم واحد تبلیغاتی Ad Manager خود، به کلید AppLovin SDK و کلید گزارش نیاز دارید. برای یافتن آنها، به AppLovin UI > Account > Keys بروید تا هر دو مقدار را مشاهده کنید.
اگر قصد دارید فقط پیشنهاد قیمت را ادغام کنید، می‌توانید تنظیمات میانجیگری خود را پیکربندی کنید .
انتخاب برنامه برای میانجیگری
مناقصه
این مرحله برای ادغام‌های پیشنهاد قیمت لازم نیست.
آبشار
در رابط کاربری AppLovin، در بخش کسب درآمد، گزینه برنامه‌ها (Applications) را انتخاب کنید تا به برنامه‌های ثبت‌شده خود دسترسی پیدا کنید. برنامه‌ای را که می‌خواهید با واسطه‌گری از آن استفاده کنید، از لیست برنامه‌های موجود انتخاب کنید.
ایجاد یک منطقه
مناقصه
این مرحله برای ادغام‌های پیشنهاد قیمت لازم نیست.
آبشار
در رابط کاربری AppLovin، در بخش کسب درآمد ، گزینه Zones را انتخاب کنید تا به شناسه‌های منطقه ثبت‌شده خود دسترسی پیدا کنید. اگر قبلاً مناطق مورد نیاز برای برنامه خود را ایجاد کرده‌اید، به مرحله ۲ بروید. برای ایجاد شناسه منطقه جدید، روی Create Zone کلیک کنید.
نام Zone ID را وارد کنید، Android را به عنوان Platform انتخاب کنید و Ad Type را انتخاب کنید.
با انتخاب گزینه‌ی «قیمت ثابت برای هر منطقه» یا «بهینه‌سازی شده توسط AppLovin» ، قیمت‌گذاری را برای منطقه پیکربندی کنید. برای گزینه‌ی «قیمت ثابت برای هر منطقه»، می‌توان CPMها را بر اساس هر کشور پیکربندی کرد. سپس، روی «ذخیره» کلیک کنید.
اندروید
آی‌او‌اس
پس از ایجاد منطقه، شناسه منطقه را می‌توان در زیر ستون شناسه منطقه یافت.
اندروید
آی‌او‌اس
فایل app-ads.txt خود را به‌روزرسانی کنید.
فروشندگان مجاز برنامه‌ها app-ads.txt یک ابتکار آزمایشگاه فناوری IAB است که به شما کمک می‌کند تا موجودی تبلیغات برنامه خود را فقط از طریق کانال‌هایی که به عنوان مجاز شناسایی کرده‌اید، به فروش برسانید. برای جلوگیری از کاهش قابل توجه درآمد تبلیغات، باید یک فایل app-ads.txt پیاده‌سازی کنید. اگر قبلاً این کار را نکرده‌اید، یک فایل app-ads.txt برای Ad Manager ایجاد کنید .
برای پیاده‌سازی app-ads.txt برای Applovin، AppLovin را به فایل app-ads.txt خود اضافه کنید .
حالت تست را روشن کنید
برای فعال کردن تبلیغات آزمایشی AppLovin، دستورالعمل‌های موجود در راهنمای حالت آزمایشی MAX از AppLovin را دنبال کنید.
مرحله ۲: تنظیم تقاضای AppLovin در رابط کاربری Ad Manager
تنظیمات میانجیگری را برای واحد تبلیغاتی خود پیکربندی کنید
اندروید
برای دستورالعمل‌ها، به مرحله ۲ در راهنمای اندروید مراجعه کنید.
آی‌او‌اس
برای دستورالعمل‌ها، به مرحله ۲ در راهنمای iOS مراجعه کنید.
شرکت AppLovin را به فهرست شرکای تبلیغاتی مقررات GDPR و ایالت ایالات متحده اضافه کنید
برای افزودن شرکت Applovin به فهرست شرکای تبلیغاتی مقررات ایالتی اروپا و ایالات متحده در رابط کاربری Ad Manager، مراحل موجود در تنظیمات مقررات اروپا و تنظیمات مقررات ایالت ایالات متحده را دنبال کنید.
مرحله ۳: SDK و آداپتور AppLovin را وارد کنید
ادغام از طریق pub.dev
وابستگی زیر را به همراه آخرین نسخه‌های Applovin SDK و آداپتور آن در فایل pubspec.yaml پکیج خود اضافه کنید:
dependencies:
gma_mediation_applovin: ^
ادغام دستی
آخرین نسخه افزونه میانجیگری تبلیغات موبایلی گوگل برای Applovin را دانلود کنید، فایل دانلود شده را استخراج کنید و پوشه افزونه استخراج شده (و محتویات آن) را به پروژه Flutter خود اضافه کنید. سپس با اضافه کردن وابستگی زیر، افزونه را در فایل pubspec.yaml خود ارجاع دهید:
dependencies:
gma_mediation_applovin:
path: path/to/local/package
مرحله ۴: تنظیمات حریم خصوصی را روی AppLovin SDK پیاده‌سازی کنید
رضایت اتحادیه اروپا و GDPR
برای رعایت سیاست رضایت کاربر اتحادیه اروپا گوگل ، شما باید اطلاعات خاصی را در اختیار کاربران خود در منطقه اقتصادی اروپا (EEA)، بریتانیا و سوئیس قرار دهید و رضایت آنها را برای استفاده از کوکی‌ها یا سایر ذخیره‌سازی‌های محلی در صورت لزوم قانونی، و برای جمع‌آوری، اشتراک‌گذاری و استفاده از داده‌های شخصی برای شخصی‌سازی تبلیغات، دریافت کنید. این سیاست منعکس‌کننده الزامات دستورالعمل حریم خصوصی الکترونیکی اتحادیه اروپا و مقررات عمومی حفاظت از داده‌ها (GDPR) است. شما مسئول تأیید انتشار رضایت به هر منبع تبلیغاتی در زنجیره واسطه‌گری خود هستید. گوگل قادر نیست رضایت کاربر را به طور خودکار به چنین شبکه‌هایی منتقل کند.
AppLovin از خواندن رشته رضایت از تنظیمات برگزیده مشترک و تنظیم وضعیت رضایت بر اساس آن پشتیبانی می‌کند. اگر از CMP که رشته رضایت را در تنظیمات اشتراکی می‌نویسد استفاده نمی‌کنید، می‌توانید از متدهای GmaMediationApplovin.setHasUserConsent() و GmaMediationApplovin.setIsAgeRestrictedUser() استفاده کنید. کد نمونه زیر نحوه ارسال اطلاعات رضایت به AppLovin SDK را نشان می‌دهد. این گزینه‌ها باید قبل از مقداردهی اولیه Google Mobile Ads SDK تنظیم شوند تا از ارسال صحیح آنها به AppLovin SDK اطمینان حاصل شود.
import 'package:gma_mediation_applovin/gma_mediation_applovin.dart';
// ...
GmaMediationApplovin.setHasUserConsent(true);
GmaMediationApplovin.setIsAgeRestrictedUser(true);
برای اطلاعات بیشتر به تنظیمات حریم خصوصی AppLovin مراجعه کنید.
قوانین حفظ حریم خصوصی ایالت‌های آمریکا
قوانین حفظ حریم خصوصی ایالت‌های ایالات متحده ، به کاربران حق انصراف از «فروش» «اطلاعات شخصی» خود (همانطور که قانون این اصطلاحات را تعریف می‌کند) را می‌دهد، و این انصراف از طریق پیوند برجسته «اطلاعات شخصی من را نفروشید» در صفحه اصلی طرف «فروشنده» ارائه می‌شود. راهنمای انطباق با قوانین حفظ حریم خصوصی ایالت‌های ایالات متحده، امکان فعال کردن پردازش داده‌های محدود برای سرویس تبلیغات گوگل را ارائه می‌دهد، اما گوگل قادر به اعمال این تنظیم برای هر شبکه تبلیغاتی در زنجیره واسطه‌گری شما نیست. بنابراین، شما باید هر شبکه تبلیغاتی را در زنجیره واسطه‌گری خود که ممکن است در فروش اطلاعات شخصی شرکت کند، شناسایی کنید و برای اطمینان از انطباق، از راهنمایی‌های هر یک از این شبکه‌ها پیروی کنید.
افزونه میانجیگری تبلیغات موبایل گوگل برای AppLovin شامل متد GmaMediationApplovin.setDoNotSell() است. نمونه کد زیر نحوه ارسال اطلاعات رضایت به AppLovin SDK را نشان می‌دهد. این گزینه‌ها باید قبل از مقداردهی اولیه Google Mobile Ads SDK تنظیم شوند تا از ارسال صحیح آنها به AppLovin SDK اطمینان حاصل شود.
import 'package:gma_mediation_applovin/gma_mediation_applovin.dart';
// ...
GmaMediationApplovin.setDoNotSell(true);
برای اطلاعات بیشتر به مستندات حریم خصوصی AppLovin مراجعه کنید.
مرحله ۵: اضافه کردن کد مورد نیاز
اندروید
برای ادغام AppLovin هیچ کد اضافی لازم نیست.
آی‌او‌اس
ادغام شبکه SKAd
برای افزودن شناسه‌های SKAdNetwork به فایل Info.plist` پروژه خود ، مستندات AppLovin را دنبال کنید.
مرحله ۶: پیاده‌سازی خود را آزمایش کنید
فعال کردن تبلیغات آزمایشی
مطمئن شوید که دستگاه آزمایشی خود را برای Ad Manager ثبت کرده‌اید و حالت آزمایشی را در Applovin UI فعال کرده‌اید .
تأیید تبلیغات آزمایشی
برای تأیید اینکه تبلیغات آزمایشی را از 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 تحت کلاس‌های زیر بررسی کنند:
اندروید
com.google.ads.mediation.applovin.mediation.ApplovinAdapter
com.google.ads.mediation.applovin.AppLovinMediationAdapter
آی‌او‌اس
GADMAdapterAppLovin
GADMAdapterAppLovinRewardBasedVideoAd
GADMediationAdapterAppLovin
در اینجا کدها و پیام‌های همراه که توسط آداپتور AppLovin هنگام عدم بارگیری یک تبلیغ نمایش داده می‌شوند، آمده است:
اندروید
| کد خطا | دلیل |
|---|---|
| -۱۰۰۹ تا -۱، ۲۰۴ | AppLovin SDK خطایی را برگرداند. برای جزئیات بیشتر به مستندات AppLovin مراجعه کنید. |
| ۱۰۱ | اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده توسط AppLovin مطابقت ندارد. |
| ۱۰۳ | زمینه تهی است. |
| ۱۰۴ | توکن پیشنهاد AppLovin خالی است. |
| ۱۰۵ | درخواست چندین تبلیغ برای یک منطقه. AppLovin فقط می‌تواند در هر منطقه، یک تبلیغ را بارگذاری کند. |
| ۱۰۶ | آگهی آماده نمایش نیست. |
| ۱۰۸ | آداپتور AppLovin از قالب تبلیغاتی که درخواست شده است پشتیبانی نمی‌کند. |
| ۱۰۹ | Context یک نمونه Activity نیست. |
| ۱۱۰ | پارامترهای سرور نامعتبر است (مثلاً کلید SDK تهی است). |
| ۱۱۲ | کاربر کودک است. |
آی‌او‌اس
| کد خطا | دلیل |
|---|---|
| -۱۰۰۹ تا -۱، ۲۰۴ | AppLovin SDK خطایی را برگرداند. برای جزئیات بیشتر به مستندات AppLovin مراجعه کنید. |
| ۱۰۱ | اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده توسط AppLovin مطابقت ندارد. |
| ۱۰۲ | پارامترهای سرور AppLovin که در رابط کاربری Ad Manager پیکربندی شده‌اند، وجود ندارند/نامعتبر هستند. |
| ۱۰۳ | نمایش تبلیغ AppLovin ناموفق بود. |
| ۱۰۴ | درخواست چندین تبلیغ برای یک منطقه. AppLovin فقط می‌تواند در هر منطقه، یک تبلیغ را بارگذاری کند. |
| ۱۰۵ | کلید SDK مربوط به AppLovin پیدا نشد. |
| ۱۰۷ | توکن پیشنهاد قیمت خالی است. |
| ۱۰۸ | آداپتور AppLovin از قالب تبلیغاتی که درخواست شده است پشتیبانی نمی‌کند. |
| ۱۱۰ | AppLovin یک فراخوانی موفقیت‌آمیز ارسال کرد اما هیچ تبلیغی را بارگذاری نکرد. |
| ۱۱۱ | قادر به بازیابی نمونه‌ی AppLovin SDK نیست. |
| ۱۱۲ | کاربر کودک است. |
| ۱۱۳ | نمونه اشتراکی AppLovin SDK مقداردهی اولیه نشده است. |
| ۱۱۴ | SDK مربوط به AppLovin نتوانست توکن پیشنهاد قیمت را برگرداند. |
تغییرات آداپتور میانجیگری Flutter در AppLovin
نسخه ۲.۴.۰ (در حال انجام)
نسخه ۲.۳.۲
- از آداپتور اندروید AppLovin نسخه ۱۳.۳.۱.۱ پشتیبانی می‌کند.
- از آداپتور iOS نسخه ۱۳.۳.۱.۰ از AppLovin پشتیبانی می‌کند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Flutter نسخه ۶.۰.۰.
نسخه ۲.۳.۱
- از آداپتور اندروید AppLovin نسخه ۱۳.۳.۱.۰ پشتیبانی می‌کند.
- از آداپتور iOS نسخه ۱۳.۳.۱.۰ از AppLovin پشتیبانی می‌کند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Flutter نسخه ۶.۰.۰.
نسخه ۲.۳.۰
- از آداپتور اندروید AppLovin نسخه ۱۳.۳.۰.۰ پشتیبانی می‌کند.
- از آداپتور iOS نسخه ۱۳.۳.۰.۰ از AppLovin پشتیبانی می‌کند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Flutter نسخه ۶.۰.۰.
نسخه ۲.۲.۱
- از آداپتور اندروید AppLovin نسخه ۱۳.۲.۰.۱ پشتیبانی می‌کند.
- از آداپتور iOS نسخه ۱۳.۲.۰.۰ از AppLovin پشتیبانی می‌کند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Flutter نسخه ۶.۰.۰.
نسخه ۲.۲.۰
- از آداپتور اندروید AppLovin نسخه ۱۳.۲.۰.۰ پشتیبانی می‌کند.
- از آداپتور iOS نسخه ۱۳.۲.۰.۰ از AppLovin پشتیبانی می‌کند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Flutter نسخه ۶.۰.۰.
نسخه ۲.۱.۰
- از آداپتور اندروید AppLovin نسخه ۱۳.۱.۰.۰ پشتیبانی می‌کند.
- از آداپتور iOS نسخه ۱۳.۱.۰.۰ از AppLovin پشتیبانی می‌کند.
- با افزونه Google Mobile Ads Flutter نسخه ۵.۳.۱ ساخته و آزمایش شده است.
نسخه ۲.۰.۰
- از آداپتور اندروید AppLovin نسخه ۱۳.۰.۱.۰ پشتیبانی می‌کند.
- از آداپتور iOS نسخه ۱۳.۰.۱.۰ از AppLovin پشتیبانی می‌کند.
- با افزونه Google Mobile Ads Flutter نسخه ۵.۳.۱ ساخته و آزمایش شده است.
نسخه ۱.۲.۰
- از آداپتور اندروید AppLovin نسخه ۱۲.۶.۱.۰ پشتیبانی می‌کند.
- از آداپتور iOS نسخه 12.6.1.0 از AppLovin پشتیبانی می‌کند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Flutter نسخه ۵.۱.۰.
نسخه ۱.۱.۰
- رابط برنامه‌نویسی کاربردی (API) برای GmaMediationApplovin دیگر ایستا نیست.
- از آداپتور اندروید AppLovin نسخه ۱۲.۴.۳.۰ پشتیبانی می‌کند.
- از آداپتور iOS نسخه 12.4.2.0 از AppLovin پشتیبانی می‌کند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Flutter نسخه ۵.۱.۰.
نسخه ۱.۰.۰
- انتشار اولیه.
- از آداپتور اندروید AppLovin نسخه ۱۲.۳.۰.۰ پشتیبانی می‌کند.
- از آداپتور iOS نسخه 12.2.1.0 از AppLovin پشتیبانی می‌کند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Flutter نسخه ۵.۰.۰.