این راهنما به شما نشان میدهد که چگونه از Google Mobile Ads SDK برای بارگذاری و نمایش تبلیغات از AppLovin با استفاده از AdMob Mediation استفاده کنید که شامل ادغام آبشاری و مناقصهای میشود. این راهنما نحوه اضافه کردن AppLovin به پیکربندی میانجیگری یک واحد تبلیغاتی و نحوه ادغام SDK و آداپتور AppLovin در یک برنامه اندروید را پوشش میدهد.
آداپتور میانجیگری برای AppLovin قابلیتهای زیر را دارد:
| ادغام | |
|---|---|
| مناقصه | |
| آبشار | |
| قالبها | |
| بنر | ۱ |
| بینابینی | |
| پاداش داده شده | |
| بومی | |
Waterfall فقط از بنرهای با اندازه ۳۲۰x۵۰ و ۷۲۸x۹۰ پشتیبانی میکند. Bidding از بنرهای تبلیغاتی پشتیبانی نمیکند.
- اندروید API سطح ۲۳ یا بالاتر
- [برای پیشنهاد قیمت]: برای ادغام تمام قالبهای تبلیغاتی پشتیبانیشده در پیشنهاد قیمت، از آداپتور AppLovin نسخه ۹.۴.۲.۰ یا بالاتر ( آخرین نسخه توصیه میشود ) استفاده کنید.
جدیدترین Google Mobile Ads SDK
راهنمای شروع میانجیگری را تکمیل کنید
ثبت نام کنید یا وارد حساب AppLovin خود شوید .
برای راهاندازی واحد تبلیغاتی AdMob خود، به کلید AppLovin SDK و کلید گزارش نیاز دارید. برای یافتن آنها، به AppLovin UI > Account > Keys بروید تا هر دو مقدار را مشاهده کنید.
اگر قصد دارید فقط پیشنهاد قیمت را ادغام کنید، میتوانید تنظیمات میانجیگری خود را پیکربندی کنید .
این مرحله برای ادغامهای پیشنهاد قیمت لازم نیست.
در رابط کاربری AppLovin، در بخش کسب درآمد، گزینه برنامهها (Applications) را انتخاب کنید تا به برنامههای ثبتشده خود دسترسی پیدا کنید. برنامهای را که میخواهید با واسطهگری از آن استفاده کنید، از لیست برنامههای موجود انتخاب کنید.
این مرحله برای ادغامهای پیشنهاد قیمت لازم نیست.
در رابط کاربری AppLovin، در بخش کسب درآمد ، گزینه Zones را انتخاب کنید تا به شناسههای منطقه ثبتشده خود دسترسی پیدا کنید. اگر قبلاً مناطق مورد نیاز برای برنامه خود را ایجاد کردهاید، به مرحله ۲ بروید. برای ایجاد شناسه منطقه جدید، روی Create Zone کلیک کنید.
نام Zone ID را وارد کنید، Android را به عنوان Platform انتخاب کنید و Ad Type را انتخاب کنید.
با انتخاب گزینهی «قیمت ثابت برای هر منطقه» یا «بهینهسازی شده توسط AppLovin» ، قیمتگذاری را برای منطقه پیکربندی کنید. برای گزینهی «قیمت ثابت برای هر منطقه» ، میتوان CPMها را بر اساس هر کشور پیکربندی کرد. سپس، روی «ذخیره» کلیک کنید.
پس از ایجاد منطقه، شناسه منطقه را میتوان در زیر ستون شناسه منطقه یافت.
فروشندگان مجاز برنامهها app-ads.txt یک ابتکار آزمایشگاه فناوری IAB است که به شما کمک میکند تا موجودی تبلیغات برنامه خود را فقط از طریق کانالهایی که به عنوان مجاز شناسایی کردهاید، به فروش برسانید. برای جلوگیری از کاهش قابل توجه درآمد تبلیغات، باید یک فایل app-ads.txt پیادهسازی کنید. اگر قبلاً این کار را نکردهاید، یک فایل app-ads.txt برای برنامه خود تنظیم کنید .
برای پیادهسازی app-ads.txt برای Applovin، AppLovin را به فایل app-ads.txt خود اضافه کنید .
برای فعال کردن تبلیغات آزمایشی AppLovin، دستورالعملهای موجود در راهنمای حالت آزمایشی MAX از AppLovin را دنبال کنید.
شما باید Applovin را به پیکربندی میانجیگری برای واحد تبلیغاتی خود اضافه کنید.
ابتدا، وارد حساب کاربری AdMob خود شوید. سپس، به برگه Mediation بروید. اگر یک گروه میانجیگری موجود دارید که میخواهید آن را تغییر دهید، روی نام آن گروه میانجیگری کلیک کنید تا آن را ویرایش کنید و به مرحله بعد، یعنی Add Applovin as an ad source بروید.
برای ایجاد یک گروه میانجیگری جدید، گزینه «ایجاد گروه میانجیگری» را انتخاب کنید.
قالب و پلتفرم تبلیغ خود را وارد کنید، سپس روی ادامه کلیک کنید.
به گروه میانجیگری خود یک نام بدهید و مکانهایی را برای هدف قرار دادن انتخاب کنید. در مرحله بعد، وضعیت گروه میانجیگری را روی فعال (Enabled) تنظیم کنید و سپس روی افزودن واحدهای تبلیغاتی (Add Ad Units) کلیک کنید.
این گروه میانجی را با یک یا چند واحد تبلیغاتی AdMob موجود خود مرتبط کنید. سپس روی «انجام شد» کلیک کنید.
اکنون باید کارت واحدهای تبلیغاتی را ببینید که با واحدهای تبلیغاتی که انتخاب کردهاید پر شده است:
روی نحوه امضای قرارداد مشارکت و تنظیم قرارداد مشارکت در مناقصه با Applovin کلیک کنید.
روی تأیید و موافقت کلیک کنید، سپس روی ادامه کلیک کنید.
اگر از قبل نگاشتی برای Applovin دارید، میتوانید آن را انتخاب کنید. در غیر این صورت، روی افزودن نگاشت کلیک کنید.
سپس، کلید SDK که در بخش قبل به دست آوردهاید را وارد کنید. سپس روی Done کلیک کنید.
در زیر کارت Waterfall در بخش Ad Sources ، گزینه Add Ad Source را انتخاب کنید.
Applovin را انتخاب کنید و کلید Optimize را فعال کنید. برای تنظیم بهینهسازی منبع تبلیغات برای Applovin، کلید گزارش (Report Key) که در بخش قبل به دست آوردید را وارد کنید. سپس یک مقدار eCPM برای Applovin وارد کنید و روی Continue کلیک کنید.
اگر از قبل نگاشتی برای Applovin دارید، میتوانید آن را انتخاب کنید. در غیر این صورت، روی افزودن نگاشت کلیک کنید.
در مرحله بعد، شناسه برنامه خود را به همراه کلید SDK و شناسه منطقه (Zone ID) که در بخش قبل به دست آوردهاید، وارد کنید. سپس روی «انجام شد» (Done) کلیک کنید.
برای افزودن شرکت Applovin به فهرست شرکای تبلیغاتی مقررات ایالتی اروپا و ایالات متحده در رابط کاربری AdMob، مراحل موجود در تنظیمات مقررات اروپا و تنظیمات مقررات ایالت ایالات متحده را دنبال کنید.
در فایل gradle سطح برنامه خود، وابستگیهای پیادهسازی زیر را اضافه کنید:
dependencies { implementation("com.google.android.gms:play-services-ads:24.9.0") implementation("com.google.ads.mediation:applovin:13.5.1.0") }
dependencies { implementation 'com.google.android.gms:play-services-ads:24.9.0' implementation 'com.google.ads.mediation:applovin:13.5.1.0' }
SDK اندروید AppLovin را دانلود کنید،
applovin-sdk-xyzjarرا استخراج کنید و آن را به پروژه خود اضافه کنید.به مصنوعات آداپتور AppLovin در مخزن Maven گوگل بروید. آخرین نسخه را انتخاب کنید، فایل .aar آداپتور AppLovin را دانلود کنید و آن را به پروژه خود اضافه کنید.
برای رعایت سیاست رضایت کاربر اتحادیه اروپا گوگل ، شما باید اطلاعات خاصی را در اختیار کاربران خود در منطقه اقتصادی اروپا (EEA)، بریتانیا و سوئیس قرار دهید و رضایت آنها را برای استفاده از کوکیها یا سایر ذخیرهسازیهای محلی در صورت لزوم قانونی، و برای جمعآوری، اشتراکگذاری و استفاده از دادههای شخصی برای شخصیسازی تبلیغات، دریافت کنید. این سیاست منعکسکننده الزامات دستورالعمل حریم خصوصی الکترونیکی اتحادیه اروپا و مقررات عمومی حفاظت از دادهها (GDPR) است. شما مسئول تأیید انتشار رضایت به هر منبع تبلیغاتی در زنجیره واسطهگری خود هستید. گوگل قادر نیست رضایت کاربر را به طور خودکار به چنین شبکههایی منتقل کند.
از نسخه ۱۲.۰.۰ کیت توسعه نرمافزار (SDK)، AppLovin از خواندن رشته رضایت از تنظیمات برگزیده مشترک و تنظیم وضعیت رضایت بر اساس آن پشتیبانی میکند.
اگر از AppLovin SDK نسخه ۱۲.۰.۰+ استفاده نمیکنید یا از CMP که رشته رضایت را در تنظیمات مشترک مینویسد استفاده نمیکنید، میتوانید از متد setHasUserConsent استفاده کنید. مثال زیر اطلاعات رضایت را به AppLovin SDK ارسال میکند. قبل از مقداردهی اولیه Google Mobile Ads SDK باید این گزینهها را تنظیم کنید تا از ارسال صحیح آنها به AppLovin SDK اطمینان حاصل شود.
AppLovinPrivacySettings.setHasUserConsent(true);
AppLovinPrivacySettings.setHasUserConsent(true)
برای اطلاعات بیشتر به تنظیمات حریم خصوصی AppLovin مراجعه کنید.
از AppLovin SDK نسخه ۱۳.۰.۰ به بعد، AppLovin دیگر از پرچمهای کاربر با محدودیت سنی پشتیبانی نمیکند و شما نمیتوانید AppLovin SDK را در ارتباط با یک «کودک» طبق تعریف قوانین مربوطه، راهاندازی یا استفاده کنید. برای اطلاعات بیشتر، به مستندات AppLovin در مورد ممنوعیت دادههای کودکان یا استفاده از خدمات برای کودکان یا برنامههایی که منحصراً برای کودکان هدفگذاری شدهاند، مراجعه کنید.
آداپتور AppLovin نسخه ۱۳.۰.۰.۱ یا بالاتر، میانجیگری AppLovin را برای برنامههایی که هر یک از تنظیمات زیر را با Google Mobile Ads SDK اعلام میکنند، بهطور خودکار غیرفعال میکند:
قوانین حفظ حریم خصوصی ایالتهای ایالات متحده ، به کاربران حق انصراف از «فروش» «اطلاعات شخصی» خود (همانطور که قانون این اصطلاحات را تعریف میکند) را میدهد، و این انصراف از طریق پیوند برجسته «اطلاعات شخصی من را نفروشید» در صفحه اصلی طرف «فروشنده» ارائه میشود. راهنمای انطباق با قوانین حفظ حریم خصوصی ایالتهای ایالات متحده ، امکان فعال کردن پردازش دادههای محدود برای سرویس تبلیغات گوگل را ارائه میدهد، اما گوگل قادر به اعمال این تنظیم برای هر شبکه تبلیغاتی در زنجیره واسطهگری شما نیست. بنابراین، شما باید هر شبکه تبلیغاتی را در زنجیره واسطهگری خود که ممکن است در فروش اطلاعات شخصی شرکت کند، شناسایی کنید و برای اطمینان از انطباق، از راهنماییهای هر یک از این شبکهها پیروی کنید.
کیت توسعه نرمافزار AppLovin شامل متد setDoNotSell است که به ناشران اجازه میدهد از فروش اطلاعات شخصی انصراف دهند.
مثال زیر این اطلاعات رضایت را به AppLovin SDK ارسال میکند. شما باید این گزینهها را قبل از راهاندازی اولیه Google Mobile Ads SDK تنظیم کنید تا از ارسال صحیح آنها به AppLovin SDK اطمینان حاصل شود.
AppLovinPrivacySettings.setDoNotSell(true);
AppLovinPrivacySettings.setDoNotSell(true)
برای اطلاعات بیشتر به مستندات حریم خصوصی AppLovin مراجعه کنید.
برای ادغام AppLovin هیچ کد اضافی لازم نیست.
مطمئن شوید که دستگاه آزمایشی خود را برای AdMob ثبت کردهاید و حالت آزمایشی را در Applovin UI فعال کردهاید . برای تأیید اینکه تبلیغات آزمایشی را از Applovin دریافت میکنید، آزمایش منبع تبلیغاتی واحد را در بازرس تبلیغات با استفاده از منبع(های) تبلیغاتی Applovin (پیشنهاد) و Applovin (آبشاری ) فعال کنید. آداپتور AppLovin از اگر آداپتور نتواند تبلیغی از AppLovin دریافت کند، ناشران میتوانند خطای اساسی را از پاسخ تبلیغ با استفاده در اینجا کدها و پیامهای همراه که توسط آداپتور AppLovin هنگام عدم بارگیری یک تبلیغ نمایش داده میشوند، آمده است: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با:setMuteAudio() پشتیبانی میکند که میتواند صدا را در تبلیغات ویدیویی غیرفعال کند. این متد را میتوان از یک شیء AppLovinExtras.Builder() فراخوانی کرد:
Bundle extras = new AppLovinExtras.Builder().setMuteAudio(true).build();
AdRequest request =
new AdRequest.Builder().addNetworkExtrasBundle(ApplovinAdapter.class, extras).build();
val extras = AppLovinExtras.Builder().setMuteAudio(true).build()
val request =
AdRequest.Builder().addNetworkExtrasBundle(ApplovinAdapter::class.java, extras).build()
ResponseInfo.getAdapterResponses() تحت کلاسهای زیر بررسی کنند:com.google.ads.mediation.applovin.ApplovinAdapter
com.google.ads.mediation.applovin.AppLovinMediationAdapter
کد خطا دلیل -۱۰۰۹ تا -۱، ۲۰۴ AppLovin SDK خطایی را برگرداند. برای جزئیات بیشتر به مستندات AppLovin مراجعه کنید. ۱۰۱ اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده توسط AppLovin مطابقت ندارد. ۱۰۳ زمینه تهی است. ۱۰۴ توکن پیشنهاد AppLovin خالی است. ۱۰۵ درخواست چندین تبلیغ برای یک منطقه. AppLovin فقط میتواند در هر منطقه، یک تبلیغ را بارگذاری کند. ۱۰۶ آگهی آماده نمایش نیست. ۱۰۸ آداپتور AppLovin از قالب تبلیغاتی که درخواست شده است پشتیبانی نمیکند. ۱۰۹ Context یک نمونه Activity نیست. ۱۱۰ کلید SDK گم شده است. ۱۱۲ کاربر کودک است. ۱۱۳ شناسه واحد تبلیغ موجود نیست. onUserEarnedReward در فراخوانی videoPlaybackEnded پشتیبانی کند.AppLovinSdkSettings شود، برطرف شد.AndroidManifest.xml بررسی نمیکند.VersionInfo جدید بهروزرسانی شد.NullPointerException شود، برطرف شد.compileSdkVersion و targetSdkVersion به API 31 بهروزرسانی شدند.AppLovinMediationAdapter.getSdkSettings() بهروزرسانی شد تا به یک پارامتر Context نیاز داشته باشد.AppLovinMediationAdapter.getSdkSettings() اضافه شد. ناشران اکنون میتوانند تنظیمات AppLovin SDK را از طریق این گزینهها پیکربندی کنند.Application تبلیغات را بارگیری و درخواست کند.Activity (Activity context) نیاز دارد.onRewardedVideoComplete() را فراخوانی کند.