ادغام شبکه تبلیغاتی LY با میانجیگری

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

این راهنما به شما نشان می‌دهد که چگونه از Google Mobile Ads Flutter Plugin برای بارگذاری و نمایش تبلیغات از LY Ads Network با استفاده از میانجیگری استفاده کنید و ادغام‌های آبشاری را پوشش می‌دهد. این راهنما نحوه اضافه کردن LY Ads Network به پیکربندی میانجیگری یک واحد تبلیغاتی و نحوه ادغام SDK و آداپتور LY Ads Network را در یک برنامه Flutter پوشش می‌دهد.

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

آداپتور میانجیگری Ad Manager برای شبکه تبلیغات LY دارای قابلیت‌های زیر است:

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

الزامات

مرحله ۱: تنظیمات را در رابط کاربری شبکه تبلیغات LY تنظیم کنید

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

افزودن یک برنامه جدید

به برگه «برنامه» بروید و روی دکمه «ثبت نام جدید» کلیک کنید.

ثبت نام جدید

فرم را پر کنید و روی ثبت نام کلیک کنید.

فرم ثبت نام جدید

شناسه برنامه را یادداشت کنید.

اندروید

جزئیات ثبت نام

آی‌او‌اس

جزئیات ثبت نام

ایجاد جایگاه تبلیغاتی

در برگه برنامه ، برنامه خود را انتخاب کنید تا جزئیات برنامه خود را مشاهده کنید. در بخش اسلات ، روی افزودن کلیک کنید.

اضافه کردن اسلات

برای جزئیات بیشتر در مورد اسلات، فرم را پر کنید. برای نوع پیشنهاد ، گزینه استاندارد را برای پیکربندی این اسلات برای میانجیگری آبشاری یا گزینه Google SDK Bidding را برای پیکربندی این اسلات برای پیشنهاد انتخاب کنید. پس از پر کردن فرم، روی ایجاد کلیک کنید.

فرم اسلات را اضافه کنید

به شناسه اسلات (Slot ID) توجه کنید.

جزئیات اسلات

پس از ایجاد اولین جایگاه، برای دریافت تأیید از شبکه تبلیغات LY، روی «بررسی» در صفحه جزئیات برنامه خود کلیک کنید. این کار ممکن است کمی طول بکشد. در صورت داشتن هرگونه سؤالی با نماینده شبکه تبلیغات LY خود تماس بگیرید.

درخواست بررسی

ایجاد کلید API گزارش‌دهی

به برگه مدیریت کلیدهای API گزارش‌دهی بروید و روی دکمه ایجاد کلید API کلیک کنید.

برگه کلید API گزارش‌دهی

فرم را پر کنید و روی ذخیره کلیک کنید.

فرم کلید API گزارش‌دهی

شناسه کلید API و راز کلید API خود را یادداشت کنید.

فرم کلید API گزارش‌دهی

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

فروشندگان مجاز برنامه‌ها app-ads.txt یک ابتکار آزمایشگاه فناوری IAB است که به شما کمک می‌کند تا موجودی تبلیغات برنامه خود را فقط از طریق کانال‌هایی که به عنوان مجاز شناسایی کرده‌اید، به فروش برسانید. برای جلوگیری از کاهش قابل توجه درآمد تبلیغات، باید یک فایل app-ads.txt پیاده‌سازی کنید. اگر قبلاً این کار را نکرده‌اید، یک فایل app-ads.txt برای Ad Manager ایجاد کنید .

برای پیاده‌سازی app-ads.txt برای شبکه تبلیغات LY، به بخش «درباره app-ads.txt» مراجعه کنید.

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

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

اندروید

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

آی‌او‌اس

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

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

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

وابستگی زیر را به همراه آخرین نسخه‌های SDK و آداپتور LY Ads Network در فایل pubspec.yaml پکیج خود اضافه کنید:

dependencies:
  gma_mediation_line: ^2.1.0

ادغام دستی

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

dependencies:
  gma_mediation_line:
    path: path/to/local/package

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

اندروید

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

آی‌او‌اس

ادغام شبکه SKAd

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

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

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

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

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

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

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

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

افزونه میانجیگری LY Ads Network Flutter از پارامتر درخواست اضافی زیر پشتیبانی می‌کند که می‌تواند از طریق کلاس LineMediationExtras به آداپتور منتقل شود:

  • enableAdSound : حالت پیش‌فرض شروع صدای تبلیغات بنری، بینابینی و جایزه‌دار را مشخص می‌کند.

در اینجا یک نمونه کد از نحوه ایجاد یک درخواست تبلیغ که این پارامترها را تنظیم می‌کند، آورده شده است:

LineMediationExtras lineExtras = LineMediationExtras(enableAdSound: true)

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

کدهای خطا

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

اندروید 

com.line.ads
com.google.ads.mediation.line.LineMediationAdapter

آی‌او‌اس 

GADMediationAdapterLine

در اینجا کدها و پیام‌های همراه که توسط آداپتور شبکه LY Ads هنگام بارگیری ناموفق یک تبلیغ نمایش داده می‌شوند، آمده است:

اندروید

کد خطا دامنه دلیل
۱-۱۰ com.five_corp.ad کیت توسعه نرم‌افزار شبکه تبلیغات LY یک خطای مختص به SDK را نشان داد. برای جزئیات بیشتر به مستندات شبکه تبلیغات LY مراجعه کنید.
۱۰۱ com.google.ads.mediation.line شناسه برنامه موجود نیست یا نامعتبر است.
۱۰۲ com.google.ads.mediation.line شناسه اسلات نامعتبر یا موجود نیست.
۱۰۳ com.google.ads.mediation.line اندازه آگهی درخواستی با اندازه بنر تبلیغاتی پشتیبانی شده توسط شبکه تبلیغات LY مطابقت ندارد.
۱۰۴ com.google.ads.mediation.line به دلیل عدم نمایش زمینه فعالیت، بارگذاری تبلیغ بینابینی یا جایزه‌دار ناموفق بود.
۱۰۵ com.google.ads.mediation.line کیت توسعه نرم‌افزار شبکه تبلیغات LY نتوانست تبلیغ بینابینی یا پاداشی را نمایش دهد.
۱۰۶ com.google.ads.mediation.line به دلیل فقدان دارایی‌ها، بارگذاری تبلیغ بومی ناموفق بود.

آی‌او‌اس

کد خطا دامنه دلیل
۱-۱۰ ارسال شده توسط SDK شبکه تبلیغات LY کیت توسعه نرم‌افزار شبکه تبلیغات LY یک خطای مختص به SDK را نشان داد. برای جزئیات بیشتر به مستندات شبکه تبلیغات LY مراجعه کنید.
۱۰۱ com.google.ads.mediation.line پارامترهای سرور نامعتبر است (مثلاً شناسه برنامه یا شناسه اسلات وجود ندارد).
۱۰۲ com.google.ads.mediation.line اندازه آگهی درخواستی با اندازه بنر تبلیغاتی پشتیبانی شده توسط شبکه تبلیغات LY مطابقت ندارد.
۱۰۳ com.google.ads.mediation.line بارگذاری یک تصویر آیکون اطلاعاتی در تبلیغ بومی ناموفق بود.

تغییرات آداپتور میانجیگری Line Flutter

نسخه ۲.۱.۱ (در حال انجام)

نسخه ۲.۱.۰

نسخه ۲.۰.۰

نسخه ۱.۰.۶

نسخه ۱.۰.۵

نسخه ۱.۰.۴

نسخه ۱.۰.۳

نسخه ۱.۰.۲

نسخه ۱.۰.۱

نسخه ۱.۰.۰