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

پلتفرم مورد نظر را انتخاب کنید: اندروید (بتا)جدید اندروید، iOS، یونیتی ، فلاتر

This guide shows you how to use the Google Mobile Ads Unity Plugin to load and display ads from AppLovin using mediation , covering both bidding and waterfall integrations. It covers how to add AppLovin to an ad unit's mediation configuration, and how to integrate the AppLovin SDK and adapter into a Unity app.

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

The Ad Manager mediation adapter for AppLovin has the following capabilities:

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

Waterfall supports only 320x50 and 728x90 banner sizes. Bidding doesn't support banner ads.

الزامات

  • آخرین Google Mobile Ads Unity Plugin
  • یونیتی ۵.۶ یا بالاتر
  • [For bidding]: To integrate all supported ad formats in bidding, use Google Mobile Ads mediation plugin for AppLovin 4.2.0 or higher ( latest version recommended )
  • برای نصب روی اندروید
    • اندروید API سطح ۲۳ یا بالاتر
  • برای استقرار در iOS
    • هدف استقرار iOS 12.0 یا بالاتر
  • A working Unity project configured with Google Mobile Ads Unity Plugin . See Get Started for details.
  • راهنمای شروع میانجیگری را تکمیل کنید

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

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

To set up your Ad Manager ad unit, you'll need your AppLovin SDK Key and Report Key . To find them, go to the AppLovin UI > Account > Keys to see both values.

If you plan on just integrating bidding, you can proceed to configure your mediation settings .

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

مناقصه

This step isn't required for bidding integrations.

آبشار

On the AppLovin UI, select Applications under the Monetization section to get to your registered apps. Select the app you'd like to use with mediation from the list of available apps.

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

مناقصه

This step isn't required for bidding integrations.

آبشار

On the AppLovin UI, select Zones under the Monetization section to get to your registered zone IDs. If you have already created the required zones for your app, skip ahead to Step 2 . To create a new zone ID, click Create Zone .

Enter the name of Zone ID , select Android as the Platform , and choose the Ad Type .

Configure Pricing for the zone by selecting either Flat CPM or Optimized by AppLovin . CPMs can be configured on a per country basis for the Flat CPM option. Then, click Save .

اندروید

آی‌او‌اس

Once the zone is created, the zone ID can be found under the Zone ID column.

اندروید

آی‌او‌اس

فایل app-ads.txt خود را به‌روزرسانی کنید.

Authorized Sellers for Apps app-ads.txt is an IAB Tech Lab initiative that helps ensure your app ad inventory is only sold through channels you've identified as authorized. To prevent a significant loss in ad revenue, you'll need to implement an app-ads.txt file. If you haven't done so already, create an app-ads.txt file for Ad Manager .

To implement app-ads.txt for Applovin, Add AppLovin to your app-ads.txt file .

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

Follow the instructions in AppLovin's MAX Test Mode guide on how to enable AppLovin test ads.

مرحله ۲: تنظیم تقاضای AppLovin در رابط کاربری Ad Manager

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

اندروید

For instructions, see step 2 in the guide for Android .

آی‌او‌اس

For instructions, see step 2 in the guide for iOS .

Add AppLovin Corp. to GDPR and US state regulations ad partners list

Follow the steps in European regulations settings and US state regulations settings to add Applovin Corp. to the European and US state regulations ad partners list in the Ad Manager UI.

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

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

If you have OpenUPM-CLI installed, you can install the Google Mobile Ads Applovin Mediation Plugin for Unity to your project by running the following command from your project's root directory:

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

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

In your Unity project editor, select Edit > Project Settings > Package Manager to open the Unity Package Manager Settings .

Under the Scoped Registries tab, add OpenUPM as a scoped registry with the following details:

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

جزئیات OpenUPM

Then, navigate to Window > Package Manager to open the Unity Package Manager and select My Registries from the drop-down menu.

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

Select the Google Mobile Ads Applovin Mediation package and click Install .

نصب از OpenUPM

بسته یونیتی

Download the latest version of Google Mobile Ads mediation plugin for Applovin from the download link in the Changelog and extract the GoogleMobileAdsApplovinMediation.unitypackage from the zip file.

In your Unity project editor, select Assets > Import Package > Custom Package and find the GoogleMobileAdsApplovinMediation.unitypackage file you downloaded. Make sure that all the files are selected and click Import .

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

Then, select Assets > External Dependency Manager > Android Resolver > Force Resolve . The External Dependency Manager library will perform dependency resolution from scratch and copy the declared dependencies into the Assets/Plugins/Android directory of your Unity app.

عزم راسخ

Step 4: Implement privacy settings on AppLovin SDK

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

Since Google Mobile Ads mediation plugin version 7.0.0, AppLovin supports reading the consent string from shared preferences and setting the consent status accordingly.

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

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

AppLovin.SetHasUserConsent(true);

Additionally, if the user is known to be in an age-restricted category, you can also set the below flag to true .

AppLovin.SetIsAgeRestrictedUser(true);

See AppLovin's privacy settings for more information.

اعلام کاربران کودک

Starting from AppLovin SDK 13.0.0, AppLovin no longer supports age-restricted user flags and you may not initialize or use the AppLovin SDK in connection with a "child" as defined under applicable laws. For more information, see AppLovin's documentation on "Prohibition on Children Data or Using the Services for Children or Apps Exclusively Targeted to Children" for Android or iOS .

Version 8.0.2 or higher of the Google Mobile Ads Unity mediation plugin for AppLovin disables AppLovin mediation automatically for apps that declare either of the following settings with the Google Mobile Ads Unity Plugin :

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

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

The Google Mobile Ads mediation plugin for AppLovin version 6.3.1 includes the AppLovin.SetDoNotSell() method. The following sample code shows how to pass consent information to the AppLovin SDK. These options must be set before you initialize the Google Mobile Ads SDK to ensure they get forwarded properly to the AppLovin SDK.

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

AppLovin.SetDoNotSell(true);

See AppLovin's Privacy documentation for more information.

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

اندروید

No additional code is required for AppLovin integration.

آی‌او‌اس

ادغام شبکه SKAd

Follow AppLovin's documentation to add the SKAdNetwork identifiers to your project's Info.plist` file.

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

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

Make sure you register your test device for Ad Manager and enable test mode in Applovin UI.

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

To verify that you are receiving test ads from Applovin, enable single ad source testing in ad inspector using the Applovin (Bidding) and Applovin (Waterfall) ad source(s).

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

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

Adding a call to AppLovin.Initialize() to your launch activity provides AppLovin the ability to track events as soon as the app starts.

کدهای خطا

If the adapter fails to receive an ad from AppLovin, publishers can check the underlying error from the ad response using ResponseInfo under the following classes:

اندروید 

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

آی‌او‌اس 

GADMAdapterAppLovin
GADMAdapterAppLovinRewardBasedVideoAd
GADMediationAdapterAppLovin

Here are the codes and accompanying messages thrown by the AppLovin adapter when an ad fails to load:

اندروید

کد خطا دلیل
‎-۱۰۰۹ تا -۱، ۲۰۴ AppLovin SDK returned an error. See AppLovin's documentation for more details.
۱۰۱ The requested ad size does not match an AppLovin supported banner size.
۱۰۳ زمینه تهی است.
۱۰۴ توکن پیشنهاد AppLovin خالی است.
۱۰۵ Requested multiple ads for the same zone. AppLovin can only load 1 ad at a time per zone.
۱۰۶ آگهی آماده نمایش نیست.
۱۰۸ AppLovin Adapter does not support the ad format being requested.
۱۰۹ Context is not an Activity instance.
۱۱۰ کلید SDK گم شده است.
۱۱۲ کاربر کودک است.
۱۱۳ شناسه واحد تبلیغ موجود نیست.

آی‌او‌اس

کد خطا دلیل
‎-۱۰۰۹ تا -۱، ۲۰۴ AppLovin SDK returned an error. See AppLovin's documentation for more details.
۱۰۱ The requested ad size does not match an AppLovin supported banner size.
۱۰۲ AppLovin server parameters configured in the Ad Manager UI are missing/invalid.
۱۰۳ نمایش تبلیغ AppLovin ناموفق بود.
۱۰۴ Requested multiple ads for the same zone. AppLovin can only load 1 ad at a time per zone.
۱۰۵ کلید SDK مربوط به AppLovin پیدا نشد.
۱۰۷ توکن پیشنهاد قیمت خالی است.
۱۰۸ AppLovin Adapter does not support the ad format being requested.
۱۱۰ AppLovin sent a successful load callback but loaded zero ads.
۱۱۱ قادر به بازیابی نمونه‌ی AppLovin SDK نیست.
۱۱۲ کاربر کودک است.
۱۱۳ AppLovin SDK shared instance has not been initialized.
۱۱۴ SDK مربوط به AppLovin نتوانست توکن پیشنهاد قیمت را برگرداند.
۱۱۵ شناسه واحد تبلیغ وجود ندارد. نمی‌توان تبلیغ را بارگیری کرد.
۱۱۶ آگهی آماده نیست. نمی‌توان آگهی را نمایش داد.

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

نسخه ۸.۵.۱

نسخه ۸.۵.۰

نسخه ۸.۴.۱

نسخه ۸.۴.۰

نسخه ۸.۳.۲

نسخه ۸.۳.۱

نسخه ۸.۳.۰

نسخه ۸.۲.۱

نسخه ۸.۲.۰

نسخه ۸.۱.۱

نسخه ۸.۱.۰

نسخه ۸.۰.۴

نسخه ۸.۰.۳

نسخه ۸.۰.۲

نسخه ۷.۴.۱

نسخه ۷.۴.۰

نسخه ۷.۳.۱

نسخه ۷.۳.۰

نسخه ۷.۲.۲

نسخه ۷.۲.۱

Version 7.2.0

نسخه ۷.۱.۰

نسخه ۷.۰.۱

نسخه ۷.۰.۰

نسخه ۶.۹.۱

نسخه ۶.۹.۰

نسخه ۶.۸.۰

نسخه ۶.۷.۰

نسخه ۶.۶.۰

نسخه ۶.۵.۱

نسخه ۶.۵.۰

نسخه ۶.۴.۳

نسخه ۶.۴.۲

نسخه ۶.۴.۱

نسخه ۶.۴.۰

نسخه ۶.۳.۱

Version 6.3.0

نسخه ۶.۲.۱

نسخه ۶.۲.۰

نسخه ۶.۱.۰

نسخه ۶.۰.۰

نسخه ۵.۱.۳

نسخه ۵.۱.۲

نسخه ۵.۱.۱

نسخه ۵.۱.۰

نسخه ۵.۰.۰

نسخه ۴.۸.۱

نسخه ۴.۸.۰

نسخه ۴.۷.۰

نسخه ۴.۶.۲

نسخه ۴.۶.۱

نسخه ۴.۶.۰

Version 4.5.8

نسخه ۴.۵.۷

نسخه ۴.۵.۶

نسخه ۴.۵.۵

نسخه ۴.۵.۴

نسخه ۴.۵.۳

نسخه ۴.۵.۲

نسخه ۴.۵.۱

نسخه ۴.۵.۰

نسخه ۴.۴.۱

نسخه ۴.۴.۰

نسخه ۴.۳.۰

نسخه ۴.۲.۰

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

نسخه ۴.۱.۰

  • Updated the plugin to support the new open-beta Rewarded API.
  • Supports AppLovin Android adapter version 9.2.1.1.
  • از آداپتور iOS نسخه 6.3.0.0 از AppLovin پشتیبانی می‌کند.

نسخه ۴.۰.۰

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

نسخه ۳.۱.۲

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

Version 3.1.1

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

نسخه ۳.۱.۰

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

نسخه ۳.۰.۳

  • Supports AppLovin Android adapter version 8.0.2.1.
  • از آداپتور iOS نسخه ۵.۰.۲.۰ از AppLovin پشتیبانی می‌کند.

نسخه ۳.۰.۲

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

نسخه ۳.۰.۱

  • از AppLovin Android SDK نسخه ۸.۰.۰ پشتیبانی می‌کند.
  • از AppLovin iOS SDK نسخه ۵.۰.۱ پشتیبانی می‌کند.
  • Added AppLovin.SetIsAgeRestrictedUser() method to indicate if the user is known to be in an age-restricted category.

نسخه ۳.۰.۰

  • از AppLovin Android SDK نسخه ۸.۰.۰ پشتیبانی می‌کند.
  • از AppLovin iOS SDK نسخه ۵.۰.۱ پشتیبانی می‌کند.
  • Added AppLovin.SetHasUserConsent() method to forward user consent flag to the AppLovin SDK.

نسخه ۲.۰.۰

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

نسخه ۱.۲.۱

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

نسخه ۱.۲.۰

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

نسخه ۱.۱.۰

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

نسخه ۱.۰.۰

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