این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

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

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

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

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

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

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

الزامات

جدیدترین SDK تبلیغات موبایل گوگل
فلاتر 3.7.0 یا بالاتر
برای استقرار در اندروید
- Android API سطح 21 یا بالاتر
برای استقرار در iOS
- هدف استقرار iOS 12.0 یا بالاتر
یک کار Flutter پروژه با Google Mobile Ads SDK پیکربندی شده است. برای جزئیات بیشتر به شروع به کار مراجعه کنید.
راهنمای شروع میانجیگری را کامل کنید

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

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

برای راه‌اندازی واحد تبلیغات AdMob، به کلید 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 را در آن تنظیم کنید AdMob UI

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

اندروید

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

iOS

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

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

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

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

ادغام از طریق pub.dev

وابستگی زیر را با آخرین نسخه های آن اضافه کنیدAppLovin SDK و آداپتور در فایل pubspec.yaml بسته شما:

dependencies:
  gma_mediation_applovin: ^1.0.0

ادغام دستی

دانلود آخرین نسخه افزونه میانجی تبلیغات موبایل گوگل برایAppLovin ، فایل دانلود شده را استخراج کنید و پوشه افزونه استخراج شده (و محتویات آن) را به پروژه فلاتر خود اضافه کنید. سپس با افزودن وابستگی زیر به پلاگین موجود در فایل pubspec.yaml خود مراجعه کنید:

dependencies:
  gma_mediation_applovin:
    path: path/to/local/package

ادغام از طریق pub.dev

وابستگی زیر را با آخرین نسخه های آن اضافه کنیدAppLovin SDK و آداپتور در فایل pubspec.yaml بسته شما:

dependencies:
  gma_mediation_applovin: ^1.0.0

ادغام دستی

dependencies:
  gma_mediation_applovin:
    path: path/to/local/package

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

رضایت اتحادیه اروپا و GDPR

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

AppLovin از خواندن رشته رضایت از تنظیمات برگزیده مشترک و تنظیم وضعیت رضایت بر این اساس پشتیبانی می کند.

اگر شما هستیدبدون استفاده از CMP که رشته رضایت را در اولویت های مشترک می نویسد، می توانید استفاده کنیدGmaMediationApplovin.setHasUserConsent() و GmaMediationApplovin.setIsAgeRestrictedUser()روش ها کد نمونه زیر نحوه انتقال اطلاعات رضایت به AppLovin SDK را نشان می دهد. این گزینه‌ها باید قبل از راه‌اندازی SDK تبلیغات موبایلی Google تنظیم شوند تا مطمئن شوید که به‌درستی به AppLovin SDK بازارسال می‌شوند.

import 'package:gma_mediation_applovin/gma_mediation_applovin.dart';
// ...

GmaMediationApplovin.setHasUserConsent(true);
GmaMediationApplovin.setIsAgeRestrictedUser(true);

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

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

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

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

import 'package:gma_mediation_applovin/gma_mediation_applovin.dart';
// ...

GmaMediationApplovin.setDoNotSell(true);

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

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

اندروید

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

iOS

ادغام SKAdNetwork

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

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

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

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

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

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

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

پارامترهای خاص شبکه

آداپتور 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

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 پیکربندی شده در AdMob رابط کاربری موجود نیست/نامعتبر است.
103	تبلیغ AppLovin نمایش داده نشد.
104	درخواست تبلیغات متعدد برای همان منطقه. AppLovin فقط می تواند 1 تبلیغ را در هر زمان در هر منطقه بارگیری کند.
105	کلید AppLovin SDK یافت نشد.
107	رمز پیشنهاد خالی است.
108	آداپتور AppLovin از قالب آگهی درخواستی پشتیبانی نمی کند.
110	AppLovin یک بار تماس با موفقیت ارسال کرد اما تبلیغات صفر بارگیری کرد.
111	بازیابی نمونه AppLovin SDK ممکن نیست.
112	کاربر کودک است

AppLovin Flutter Mediation Adapter Changelog

نسخه بعدی

ساخته و آزمایش شده با Google Mobile Ads Flutter Plugin نسخه 5.2.0.

1.2.0

سازگاری تأیید شده با آداپتور اندروید AppLovin نسخه 12.6.1.0.
سازگاری تایید شده با آداپتور AppLovin iOS نسخه 12.6.1.0.
با افزونه Flutter Ads Google Mobile نسخه 5.1.0 ساخته و آزمایش شده است.

1.1.0

API برای GmaMediationApplovin دیگر ثابت نیست.
سازگاری تایید شده با آداپتور اندروید AppLovin نسخه 12.4.3.0.
سازگاری تأیید شده با آداپتور AppLovin iOS نسخه 12.4.2.0.
با افزونه Flutter Ads Google Mobile نسخه 5.1.0 ساخته و آزمایش شده است.

1.0.0

انتشار اولیه
سازگاری تأیید شده با آداپتور اندروید AppLovin نسخه 12.3.0.0
سازگاری تأیید شده با آداپتور AppLovin iOS نسخه 12.2.1.0
با افزونه Flutter Ads Google Mobile نسخه 5.0.0 ساخته و آزمایش شده است.

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

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

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

الزامات

جدیدترین SDK تبلیغات موبایل گوگل
فلاتر 3.7.0 یا بالاتر
برای استقرار در اندروید
- Android API سطح 21 یا بالاتر
برای استقرار در iOS
- هدف استقرار iOS 12.0 یا بالاتر
یک کار Flutter پروژه با Google Mobile Ads SDK پیکربندی شده است. برای جزئیات بیشتر به شروع به کار مراجعه کنید.
راهنمای شروع میانجیگری را کامل کنید

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

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

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

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

مناقصه

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

آبشار

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

مناقصه

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

آبشار

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

اندروید

iOS

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

اندروید

iOS

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

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

مرحله 2: درخواست AppLovin را در آن تنظیم کنید AdMob UI

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

اندروید

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

iOS

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

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

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

ادغام از طریق pub.dev

وابستگی زیر را با آخرین نسخه های آن اضافه کنیدAppLovin SDK و آداپتور در فایل pubspec.yaml بسته شما:

dependencies:
  gma_mediation_applovin: ^1.0.0

ادغام دستی

dependencies:
  gma_mediation_applovin:
    path: path/to/local/package

ادغام از طریق pub.dev

وابستگی زیر را با آخرین نسخه های آن اضافه کنیدAppLovin SDK و آداپتور در فایل pubspec.yaml بسته شما:

dependencies:
  gma_mediation_applovin: ^1.0.0

ادغام دستی

dependencies:
  gma_mediation_applovin:
    path: path/to/local/package

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

رضایت اتحادیه اروپا و GDPR

AppLovin از خواندن رشته رضایت از تنظیمات برگزیده مشترک و تنظیم وضعیت رضایت بر این اساس پشتیبانی می کند.

import 'package:gma_mediation_applovin/gma_mediation_applovin.dart';
// ...

GmaMediationApplovin.setHasUserConsent(true);
GmaMediationApplovin.setIsAgeRestrictedUser(true);

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

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

import 'package:gma_mediation_applovin/gma_mediation_applovin.dart';
// ...

GmaMediationApplovin.setDoNotSell(true);

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

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

اندروید

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

iOS

ادغام SKAdNetwork

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

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

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

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

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

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

پارامترهای خاص شبکه

AppLovinMediationExtras applovinExtras = AppLovinMediationExtras(isMuted: true)

AdRequest request = AdRequest(
    keywords: <String>['foo', 'bar'],
    contentUrl: 'http://foo.com/bar.html',
    mediationExtras: [applovinExtras],
);

بهینه سازی ها

کدهای خطا

اندروید

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 پیکربندی شده در AdMob رابط کاربری موجود نیست/نامعتبر است.
103	تبلیغ AppLovin نمایش داده نشد.
104	درخواست تبلیغات متعدد برای همان منطقه. AppLovin فقط می تواند 1 تبلیغ را در هر زمان در هر منطقه بارگیری کند.
105	کلید AppLovin SDK یافت نشد.
107	رمز پیشنهاد خالی است.
108	آداپتور AppLovin از قالب آگهی درخواستی پشتیبانی نمی کند.
110	AppLovin یک بار تماس با موفقیت ارسال کرد اما تبلیغات صفر بارگیری کرد.
111	بازیابی نمونه AppLovin SDK ممکن نیست.
112	کاربر کودک است

AppLovin Flutter Mediation Adapter Changelog

نسخه بعدی

ساخته و آزمایش شده با Google Mobile Ads Flutter Plugin نسخه 5.2.0.

1.2.0

سازگاری تأیید شده با آداپتور اندروید AppLovin نسخه 12.6.1.0.
سازگاری تایید شده با آداپتور AppLovin iOS نسخه 12.6.1.0.
با افزونه Flutter Ads Google Mobile نسخه 5.1.0 ساخته و آزمایش شده است.

1.1.0

API برای GmaMediationApplovin دیگر ثابت نیست.
سازگاری تایید شده با آداپتور اندروید AppLovin نسخه 12.4.3.0.
سازگاری تأیید شده با آداپتور AppLovin iOS نسخه 12.4.2.0.
با افزونه Flutter Ads Google Mobile نسخه 5.1.0 ساخته و آزمایش شده است.

1.0.0

انتشار اولیه
سازگاری تأیید شده با آداپتور اندروید AppLovin نسخه 12.3.0.0
سازگاری تأیید شده با آداپتور AppLovin iOS نسخه 12.2.1.0
با افزونه Flutter Ads Google Mobile نسخه 5.0.0 ساخته و آزمایش شده است.