AppLovin را با میانجیگری ادغام کنید

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

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

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

آداپتور میانجی‌گری Ad Manager برای AppLovin قابلیت‌های زیر را دارد:

ادغام
مناقصه
آبشار
قالب‌ها
بنر ۱
بینابینی
پاداش داده شده

Waterfall فقط از بنرهای با اندازه ۳۲۰x۵۰ و ۷۲۸x۹۰ پشتیبانی می‌کند. Bidding از بنرهای تبلیغاتی پشتیبانی نمی‌کند.

الزامات

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

رابط خط فرمان OpenUPM

اگر OpenUPM-CLI را نصب کرده‌اید، می‌توانید افزونه‌ی Google Mobile Ads Applovin Mediation Plugin for Unity را با اجرای دستور زیر از دایرکتوری ریشه‌ی پروژه، روی پروژه‌ی خود نصب کنید:

openupm add com.google.ads.mobile.mediation.applovin

اوپن‌یو‌پی‌ام

در ویرایشگر پروژه یونیتی خود، گزینه Edit > Project Settings > Package Manager را انتخاب کنید تا تنظیمات Unity Package Manager باز شود.

در زیر تب Scoped Registries ، OpenUPM را به عنوان یک رجیستری Scoped با جزئیات زیر اضافه کنید:

  • نام: OpenUPM
  • آدرس اینترنتی: https://package.openupm.com
  • محدوده(ها): com.google

جزئیات OpenUPM

سپس، به مسیر Window > Package Manager بروید تا Unity Package Manager باز شود و از منوی کشویی، My Registrys را انتخاب کنید.

رجیستری‌های یونیتی

بسته Google Mobile Ads Applovin Mediation را انتخاب کرده و روی نصب کلیک کنید.

نصب از OpenUPM

بسته یونیتی

آخرین نسخه افزونه میانجیگری تبلیغات موبایلی گوگل برای Applovin را از لینک دانلود موجود در Changelog دانلود کنید و بسته GoogleMobileAdsApplovinMediation.unitypackage را از فایل زیپ استخراج کنید.

در ویرایشگر پروژه Unity خود، Assets > Import Package > Custom Package را انتخاب کنید و فایل GoogleMobileAdsApplovinMediation.unitypackage را که دانلود کرده‌اید، پیدا کنید. مطمئن شوید که همه فایل‌ها انتخاب شده‌اند و روی Import کلیک کنید.

وارد کردن از یونیتی

سپس، Assets > External Dependency Manager > Android Resolver > Force Resolve را انتخاب کنید. کتابخانه External Dependency Manager تجزیه و تحلیل وابستگی‌ها را از ابتدا انجام می‌دهد و وابستگی‌های اعلام شده را در پوشه Assets/Plugins/Android برنامه Unity شما کپی می‌کند.

عزم راسخ

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

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

از زمان انتشار نسخه ۷.۰.۰ افزونه میانجیگری تبلیغات موبایلی گوگل، AppLovin از خواندن رشته رضایت از تنظیمات برگزیده مشترک و تنظیم وضعیت رضایت بر اساس آن پشتیبانی می‌کند.

اگر از افزونه میانجیگری تبلیغات موبایل گوگل برای Applovin نسخه ۷.۰.۰+ استفاده نمی‌کنید یا از CMP که رشته رضایت را در تنظیمات مشترک می‌نویسد استفاده نمی‌کنید، می‌توانید از متدهای AppLovin.SetHasUserConsent() و AppLovin.SetIsAgeRestrictedUser() استفاده کنید. کد نمونه زیر نحوه ارسال اطلاعات رضایت به AppLovin SDK را نشان می‌دهد. این گزینه‌ها باید قبل از مقداردهی اولیه Google Mobile Ads SDK تنظیم شوند تا از ارسال صحیح آنها به AppLovin SDK اطمینان حاصل شود.

using GoogleMobileAds.Api.Mediation.AppLovin;
// ...

AppLovin.SetHasUserConsent(true);

علاوه بر این، اگر کاربر در یک دسته سنی با محدودیت سنی قرار دارد، می‌توانید پرچم زیر را روی true تنظیم کنید.

AppLovin.SetIsAgeRestrictedUser(true);

برای اطلاعات بیشتر به تنظیمات حریم خصوصی AppLovin مراجعه کنید.

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

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

افزونه میانجیگری تبلیغات موبایل گوگل برای AppLovin نسخه ۶.۳.۱ شامل متد AppLovin.SetDoNotSell() است. کد نمونه زیر نحوه ارسال اطلاعات رضایت به AppLovin SDK را نشان می‌دهد. این گزینه‌ها باید قبل از مقداردهی اولیه Google Mobile Ads SDK تنظیم شوند تا از ارسال صحیح آنها به AppLovin SDK اطمینان حاصل شود.

using GoogleMobileAds.Api.Mediation.AppLovin;
// ...

AppLovin.SetDoNotSell(true);

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

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

اندروید

برای ادغام AppLovin هیچ کد اضافی لازم نیست.

آی‌او‌اس

ادغام شبکه SKAd

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

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

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

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

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

برای تأیید اینکه تبلیغات آزمایشی را از Applovin دریافت می‌کنید، آزمایش منبع تبلیغاتی واحد را در بازرس تبلیغات با استفاده از منبع(های) تبلیغاتی Applovin (پیشنهاد) و Applovin (آبشاری ) فعال کنید.

مراحل اختیاری

بهینه‌سازی‌ها

اضافه کردن فراخوانی AppLovin.Initialize() به اکتیویتی راه‌اندازی، به 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 نتوانست توکن پیشنهاد قیمت را برگرداند.

تغییرات افزونه میانجیگری AppLovin Unity

نسخه ۸.۴.۰

نسخه ۸.۳.۲

نسخه ۸.۳.۱

نسخه ۸.۳.۰

نسخه ۸.۲.۱

نسخه ۸.۲.۰

نسخه ۸.۱.۱

نسخه ۸.۱.۰

نسخه ۸.۰.۴

نسخه ۸.۰.۳

نسخه ۸.۰.۲

نسخه ۷.۴.۱

نسخه ۷.۴.۰

نسخه ۷.۳.۱

نسخه ۷.۳.۰

نسخه ۷.۲.۲

نسخه ۷.۲.۱

نسخه ۷.۲.۰

نسخه ۷.۱.۰

نسخه ۷.۰.۱

نسخه ۷.۰.۰

نسخه ۶.۹.۱

نسخه ۶.۹.۰

نسخه ۶.۸.۰

نسخه ۶.۷.۰

نسخه ۶.۶.۰

نسخه ۶.۵.۱

نسخه ۶.۵.۰

نسخه ۶.۴.۳

نسخه ۶.۴.۲

نسخه ۶.۴.۱

نسخه ۶.۴.۰

نسخه ۶.۳.۱

نسخه ۶.۳.۰

نسخه ۶.۲.۱

نسخه ۶.۲.۰

نسخه ۶.۱.۰

نسخه ۶.۰.۰

نسخه ۵.۱.۳

نسخه ۵.۱.۲

نسخه ۵.۱.۱

نسخه ۵.۱.۰

نسخه ۵.۰.۰

نسخه ۴.۸.۱

نسخه ۴.۸.۰

نسخه ۴.۷.۰

نسخه ۴.۶.۲

نسخه ۴.۶.۱

نسخه ۴.۶.۰

نسخه ۴.۵.۸

نسخه ۴.۵.۷

نسخه ۴.۵.۶

نسخه ۴.۵.۵

نسخه ۴.۵.۴

نسخه ۴.۵.۳

نسخه ۴.۵.۲

نسخه ۴.۵.۱

نسخه ۴.۵.۰

نسخه ۴.۴.۱

نسخه ۴.۴.۰

نسخه ۴.۳.۰

نسخه ۴.۲.۰

  • از آداپتور اندروید AppLovin نسخه ۹.۴.۲.۰ پشتیبانی می‌کند.
  • از آداپتور iOS نسخه 6.6.1.0 از AppLovin پشتیبانی می‌کند.

نسخه ۴.۱.۰

  • افزونه برای پشتیبانی از API پاداش‌دهی بتای باز جدید به‌روزرسانی شد.
  • از آداپتور اندروید AppLovin نسخه 9.2.1.1 پشتیبانی می‌کند.
  • از آداپتور iOS نسخه 6.3.0.0 از AppLovin پشتیبانی می‌کند.

نسخه ۴.۰.۰

  • از آداپتور اندروید AppLovin نسخه ۹.۲.۱.۰ پشتیبانی می‌کند.
  • از آداپتور iOS نسخه 6.2.0.0 از AppLovin پشتیبانی می‌کند.

نسخه ۳.۱.۲

  • از آداپتور اندروید AppLovin نسخه ۸.۱.۴.۰ پشتیبانی می‌کند.
  • از آداپتور iOS نسخه ۵.۱.۲.۰ از AppLovin پشتیبانی می‌کند.

نسخه ۳.۱.۱

  • از آداپتور اندروید AppLovin نسخه ۸.۱.۰.۰ پشتیبانی می‌کند.
  • از آداپتور iOS نسخه ۵.۱.۱.۰ از AppLovin پشتیبانی می‌کند.

نسخه ۳.۱.۰

  • از آداپتور اندروید AppLovin نسخه ۸.۱.۰.۰ پشتیبانی می‌کند.
  • از آداپتور iOS نسخه ۵.۱.۰.۰ AppLovin پشتیبانی می‌کند.

نسخه ۳.۰.۳

  • از آداپتور اندروید AppLovin نسخه ۸.۰.۲.۱ پشتیبانی می‌کند.
  • از آداپتور iOS نسخه ۵.۰.۲.۰ از AppLovin پشتیبانی می‌کند.

نسخه ۳.۰.۲

  • از AppLovin Android SDK نسخه ۸.۰.۱ پشتیبانی می‌کند.
  • از AppLovin iOS SDK نسخه ۵.۰.۱ پشتیبانی می‌کند.

نسخه ۳.۰.۱

  • از AppLovin Android SDK نسخه ۸.۰.۰ پشتیبانی می‌کند.
  • از AppLovin iOS SDK نسخه ۵.۰.۱ پشتیبانی می‌کند.
  • متد AppLovin.SetIsAgeRestrictedUser() اضافه شده است تا نشان دهد که آیا کاربر در یک دسته بندی با محدودیت سنی قرار دارد یا خیر.

نسخه ۳.۰.۰

  • از AppLovin Android SDK نسخه ۸.۰.۰ پشتیبانی می‌کند.
  • از AppLovin iOS SDK نسخه ۵.۰.۱ پشتیبانی می‌کند.
  • متد AppLovin.SetHasUserConsent() برای ارسال پرچم رضایت کاربر به AppLovin SDK اضافه شد.

نسخه ۲.۰.۰

  • از AppLovin Android SDK نسخه ۷.۸.۶ پشتیبانی می‌کند.
  • از AppLovin iOS SDK نسخه ۵.۰.۱ پشتیبانی می‌کند.

نسخه ۱.۲.۱

  • از AppLovin Android SDK نسخه ۷.۸.۶ پشتیبانی می‌کند.
  • از AppLovin iOS SDK نسخه ۴.۸.۳ پشتیبانی می‌کند.

نسخه ۱.۲.۰

  • از AppLovin Android SDK نسخه ۷.۸.۵ پشتیبانی می‌کند.
  • از AppLovin iOS SDK نسخه ۴.۸.۳ پشتیبانی می‌کند.

نسخه ۱.۱.۰

  • از AppLovin Android SDK نسخه ۷.۷.۰ پشتیبانی می‌کند.
  • از AppLovin iOS SDK نسخه ۴.۷.۰ پشتیبانی می‌کند.

نسخه ۱.۰.۰

  • اولین انتشار!
  • از AppLovin Android SDK نسخه ۷.۴.۱ پشتیبانی می‌کند.
  • از AppLovin iOS SDK نسخه ۴.۴.۱ پشتیبانی می‌کند.