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

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

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

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

یکپارچه سازی
مناقصه
آبشار
فرمت ها
بنر 1
بینابینی
پاداش داده شد

تبلیغات بنری (به استثنای بنرهای MREC) فقط در میانجیگری پشتیبانی می شوند. مناقصه از هر نوع تبلیغات بنری پشتیبانی نمی کند.

الزامات

  • جدیدترین SDK تبلیغات موبایل گوگل
  • یونیتی 5.6 یا بالاتر
  • [برای مناقصه]: برای ادغام همه قالب‌های تبلیغاتی پشتیبانی‌شده در مناقصه، از افزونه میانجی‌گری تبلیغات موبایلی Google برای AppLovin 4.2.0 یا بالاتر استفاده کنید ( آخرین نسخه توصیه می‌شود )
  • برای استقرار در اندروید
    • Android API سطح 21 یا بالاتر
  • برای استقرار در iOS
    • هدف استقرار iOS 12.0 یا بالاتر
  • یک پروژه واحد کاری که با Google Mobile Ads SDK پیکربندی شده است. برای جزئیات بیشتر به شروع به کار مراجعه کنید.
  • راهنمای شروع میانجیگری را کامل کنید

مرحله 1: تنظیمات را در AppLovin UI تنظیم کنید

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

برای راه‌اندازی واحد تبلیغات Ad Manager، به کلید SDK AppLovin و کلید گزارش نیاز دارید. برای پیدا کردن آنها، به AppLovin UI > Account > Keys بروید تا هر دو مقدار را ببینید.

اگر قصد دارید فقط مناقصه را یکپارچه کنید، می توانید تنظیمات میانجیگری خود را پیکربندی کنید .

برنامه را برای میانجیگری انتخاب کنید

مناقصه

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

آبشار

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

یک منطقه ایجاد کنید

مناقصه

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

آبشار

در رابط کاربری AppLovin، Zones را در بخش Monetization انتخاب کنید تا به شناسه های منطقه ثبت شده خود برسید. اگر قبلاً مناطق مورد نیاز را برای برنامه خود ایجاد کرده اید، به مرحله 2 بروید. برای ایجاد یک شناسه منطقه جدید، روی ایجاد منطقه کلیک کنید.

نام Zone ID را وارد کنید، Android را به عنوان پلتفرم انتخاب کنید و نوع تبلیغ را انتخاب کنید.

با انتخاب Flat CPM یا Optimized by AppLovin، قیمت گذاری را برای منطقه پیکربندی کنید. CPM ها را می توان بر اساس هر کشور برای گزینه Flat CPM پیکربندی کرد. سپس، روی ذخیره کلیک کنید.

اندروید

iOS

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

اندروید

iOS

حالت تست را روشن کنید

دستورالعمل‌های راهنمای MAX Test Mode AppLovin را در مورد نحوه فعال کردن تبلیغات آزمایشی AppLovin دنبال کنید.

مرحله 2: درخواست AppLovin را در رابط کاربری Ad Manager تنظیم کنید

تنظیمات میانجی را برای واحد تبلیغات خود پیکربندی کنید

اندروید

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

iOS

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

AppLovin Corp. را به لیست شرکای تبلیغاتی GDPR و مقررات ایالتی ایالات متحده اضافه کنید

برای افزودن Applovin Corp. به فهرست شرکای آگهی GDPR و مقررات ایالتی ایالات متحده در رابط کاربری Ad Manager، مراحل تنظیمات GDPR و تنظیمات مقررات ایالتی ایالات متحده را دنبال کنید.

مرحله 3: AppLovin SDK و آداپتور را وارد کنید

OpenUPM-CLI

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

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

OpenUPM

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

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

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

جزئیات OpenUPM

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

ثبت واحدها

بسته میانجی Applovin Ads Google Mobile را انتخاب کنید و روی Install کلیک کنید.

از 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 شما کپی می کند.

اجباری حل و فصل

مرحله 4: تنظیمات حریم خصوصی را در AppLovin SDK اجرا کنید

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

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

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

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

AppLovin.SetHasUserConsent(true);

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

AppLovin.SetIsAgeRestrictedUser(true);

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

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

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

افزونه میانجیگری تبلیغات موبایلی Google برای AppLovin نسخه 6.3.1 شامل متد AppLovin.SetDoNotSell() است. کد نمونه زیر نحوه انتقال اطلاعات رضایت به AppLovin SDK را نشان می دهد. این گزینه‌ها باید قبل از راه‌اندازی SDK تبلیغات موبایلی Google تنظیم شوند تا مطمئن شوید که به‌درستی به AppLovin SDK بازارسال می‌شوند.

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

AppLovin.SetDoNotSell(true);

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

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

اندروید

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

iOS

ادغام SKAdNetwork

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

مرحله 6: اجرای خود را آزمایش کنید

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

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

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

برای تأیید اینکه آگهی‌های آزمایشی را از Applovin دریافت می‌کنید، با استفاده از منابع آگهی Applovin (مناقصه) و Applovin (Waterfall) آزمایش منبع آگهی را در بازرس آگهی فعال کنید.

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

بهینه سازی ها

افزودن تماس به AppLovin.Initialize() به فعالیت راه‌اندازی، به AppLovin امکان ردیابی رویدادها را به محض شروع برنامه فراهم می‌کند.

کدهای خطا

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

اندروید 

com.google.ads.mediation.applovin.mediation.ApplovinAdapter
com.google.ads.mediation.applovin.AppLovinMediationAdapter

iOS 

GADMAdapterAppLovin
GADMAdapterAppLovinRewardBasedVideoAd
GADMediationAdapterAppLovin

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

اندروید

کد خطا دلیل
-1009 تا -1، 204 AppLovin SDK خطایی را برگرداند. برای جزئیات بیشتر به مستندات AppLovin مراجعه کنید.
101 اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده AppLovin مطابقت ندارد.
103 متن پوچ است.
104 کد پیشنهادی AppLovin خالی است.
105 درخواست تبلیغات متعدد برای همان منطقه. AppLovin فقط می تواند 1 تبلیغ را در هر زمان در هر منطقه بارگیری کند.
106 آگهی آماده نمایش نیست
108 آداپتور AppLovin از قالب آگهی درخواستی پشتیبانی نمی کند.

iOS

کد خطا دلیل
-1009 تا -1، 204 AppLovin SDK خطایی را برگرداند. برای جزئیات بیشتر به مستندات AppLovin مراجعه کنید.
101 اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده AppLovin مطابقت ندارد.
102 پارامترهای سرور AppLovin پیکربندی شده در رابط کاربری Ad Manager وجود ندارد/نامعتبر است.
103 تبلیغ AppLovin نمایش داده نشد.
104 درخواست تبلیغات متعدد برای همان منطقه. AppLovin فقط می تواند 1 تبلیغ را در هر زمان در هر منطقه بارگیری کند.
105 کلید AppLovin SDK یافت نشد.
107 نماد پیشنهاد خالی است.
108 آداپتور AppLovin از قالب آگهی درخواستی پشتیبانی نمی کند.
110 AppLovin یک بار تماس با موفقیت ارسال کرد اما تبلیغات صفر بارگیری کرد.
111 بازیابی نمونه AppLovin SDK ممکن نیست.
112 کاربر کودک است

تغییرات افزونه AppLovin Unity Mediation

نسخه 8.0.3

نسخه 8.0.2

نسخه 7.4.1

نسخه 7.4.0

نسخه 7.3.1

نسخه 7.3.0

نسخه 7.2.2

نسخه 7.2.1

نسخه 7.2.0

نسخه 7.1.0

نسخه 7.0.1

نسخه 7.0.0

نسخه 6.9.1

نسخه 6.9.0

نسخه 6.8.0

نسخه 6.7.0

نسخه 6.6.0

نسخه 6.5.1

نسخه 6.5.0

نسخه 6.4.3

نسخه 6.4.2

نسخه 6.4.1

نسخه 6.4.0

نسخه 6.3.1

نسخه 6.3.0

نسخه 6.2.1

نسخه 6.2.0

نسخه 6.1.0

نسخه 6.0.0

نسخه 5.1.3

نسخه 5.1.2

نسخه 5.1.1

نسخه 5.1.0

نسخه 5.0.0

نسخه 4.8.1

نسخه 4.8.0

نسخه 4.7.0

نسخه 4.6.2

نسخه 4.6.1

نسخه 4.6.0

نسخه 4.5.8

نسخه 4.5.7

نسخه 4.5.6

نسخه 4.5.5

نسخه 4.5.4

نسخه 4.5.3

نسخه 4.5.2

نسخه 4.5.1

نسخه 4.5.0

نسخه 4.4.1

نسخه 4.4.0

نسخه 4.3.0

نسخه 4.2.0

  • از آداپتور اندروید AppLovin نسخه 9.4.2.0 پشتیبانی می کند.
  • از آداپتور AppLovin iOS نسخه 6.6.1.0 پشتیبانی می کند.

نسخه 4.1.0

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

نسخه 4.0.0

  • از آداپتور اندروید AppLovin نسخه 9.2.1.0 پشتیبانی می کند.
  • از آداپتور iOS AppLovin نسخه 6.2.0.0 پشتیبانی می کند.

نسخه 3.1.2

  • از آداپتور اندروید AppLovin نسخه 8.1.4.0 پشتیبانی می کند.
  • از آداپتور AppLovin iOS نسخه 5.1.2.0 پشتیبانی می کند.

نسخه 3.1.1

  • از آداپتور اندروید AppLovin نسخه 8.1.0.0 پشتیبانی می کند.
  • از آداپتور AppLovin iOS نسخه 5.1.1.0 پشتیبانی می کند.

نسخه 3.1.0

  • از آداپتور اندروید AppLovin نسخه 8.1.0.0 پشتیبانی می کند.
  • از آداپتور AppLovin iOS نسخه 5.1.0.0 پشتیبانی می کند.

نسخه 3.0.3

  • از آداپتور اندروید AppLovin نسخه 8.0.2.1 پشتیبانی می کند.
  • پشتیبانی از آداپتور AppLovin iOS نسخه 5.0.2.0.

نسخه 3.0.2

  • پشتیبانی از AppLovin Android SDK نسخه 8.0.1.
  • پشتیبانی از AppLovin iOS SDK نسخه 5.0.1.

نسخه 3.0.1

  • پشتیبانی از AppLovin Android SDK نسخه 8.0.0.
  • پشتیبانی از AppLovin iOS SDK نسخه 5.0.1.
  • متد AppLovin.SetIsAgeRestrictedUser() اضافه شد تا مشخص شود کاربر در یک دسته بندی با محدودیت سنی قرار دارد یا خیر.

نسخه 3.0.0

  • پشتیبانی از AppLovin Android SDK نسخه 8.0.0.
  • پشتیبانی از AppLovin iOS SDK نسخه 5.0.1.
  • روش AppLovin.SetHasUserConsent() برای ارسال پرچم رضایت کاربر به AppLovin SDK اضافه شد.

نسخه 2.0.0

  • پشتیبانی از AppLovin Android SDK نسخه 7.8.6.
  • پشتیبانی از AppLovin iOS SDK نسخه 5.0.1.

نسخه 1.2.1

  • پشتیبانی از AppLovin Android SDK نسخه 7.8.6.
  • پشتیبانی از AppLovin iOS SDK نسخه 4.8.3.

نسخه 1.2.0

  • پشتیبانی از AppLovin Android SDK نسخه 7.8.5.
  • پشتیبانی از AppLovin iOS SDK نسخه 4.8.3.

نسخه 1.1.0

  • پشتیبانی از AppLovin Android SDK نسخه 7.7.0.
  • پشتیبانی از AppLovin iOS SDK نسخه 4.7.0.

نسخه 1.0.0

  • اولین انتشار!
  • پشتیبانی از AppLovin Android SDK نسخه 7.4.1.
  • پشتیبانی از AppLovin iOS SDK نسخه 4.4.1.