ادغام «شبکه آگهی LY» با واسطه‌گری

پلاتفرم را انتخاب کنید: Android iOS Unity Flutter Android (Legacy)

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

یکپارچه‌سازی‌ها و قالب‌های آگهی پشتیبانی‌شده

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

یکپارچه‌سازی
پیشنهاد قیمت
آبشار
قالب‌ها
برنما
بینابینی
پاداش
بومی

پیش‌نیازها

قبل‌از ادامه دادن، موارد زیر را تأیید کنید:

  • جدیدترین نسخه Google Mobile Ads Flutter Plugin.
  • چارچوب Flutter نسخه ۳.۷.۰ یا بالاتر.
  • برای استقرار در Android
    • Android API سطح ۲۴ یا بالاتر.
  • برای استقرار در iOS
    • هدف استقرار iOS نسخه ۱۳.۰ یا بالاتر.
  • یک پروژه Flutter فعال که با Google Mobile Ads Flutter Plugin پیکربندی شده است. برای جزئیات، راه‌اندازی Google Mobile Ads Flutter Plugin را ببینید.
  • راه‌اندازی میانجی‌گری.

    • مرحله ۱: راه‌اندازی پیکربندی‌ها در میانای کاربر شبکه آگهی‌های LY

    ثبت‌نام کنید و به سیستم حساب LY Ads Network خود وارد شوید.

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

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

    ثبت‌نام جدید

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

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

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

    Android

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

    iOS

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

    ایجاد جایگاه آگهی

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

    افزودن جایگاه

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

    افزودن فرم جایگاه

    شناسه جایگاه را یادداشت کنید.

    جزئیات جای آزاد

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

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

    ایجاد کلید میانای برنامه‌سازی کاربردی گزارش‌دهی

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

    برگه کلید میانای برنامه‌سازی کاربردی گزارش‌دهی

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

    فرم کلید میانای برنامه‌سازی کاربردی گزارش‌دهی

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

    فرم کلید میانای برنامه‌سازی کاربردی گزارش‌دهی

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

    Authorized Sellers for Apps app-ads.txt ابتکاری از IAB Tech Lab است که کمک می‌کند مطمئن شوید فضای آگهی برنامه‌تان فقط ازطریق کانال‌هایی که به‌عنوان مجاز شناسایی کرده‌اید فروخته می‌شود. برای جلوگیری از افت قابل‌توجه در درآمد آگهی، باید فایل app-ads.txt را پیاده‌سازی کنید. اگر قبلاً این کار را نکرده‌اید، فایل app-ads.txt برای Ad Manager ایجاد کنید.

    برای پیاده‌سازی app-ads.txt برای LY Ads Network، به درباره app-ads.txt مراجعه کنید.

    مرحله ۲: راه‌اندازی تقاضای LY Ads Network در واسط کاربر Ad Manager

    پیکربندی تنظیمات میانجی‌گری برای واحد آگهی شما

    Android

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

    iOS

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

    مرحله ۳: وارد کردن آداپتور و کیت توسعه نرم‌افزار LY Ads Network

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

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

    dependencies:
  gma_mediation_line: ^2.2.1

    ادغام دستی

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

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

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

    Android

    برای ادغام «شبکه آگهی‌های LY» به کد دیگری نیاز نیست.

    iOS

    ادغام SKAdNetwork

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

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

    فعال کردن آگهی‌های آزمایشی

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

    درستی‌سنجی آگهی‌های آزمایشی

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

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

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

    افزونه میانجی‌گری 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 Ads Network دریافت کند، ناشران می‌توانند خطای زمینه‌ای را از پاسخ آگهی بااستفاده از ResponseInfo تحت کلاس‌های زیر بررسی کنند:

    Android

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

    iOS

    GADMediationAdapterLine

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

    Android

    کد خطا دامنه استدلال
    ۱-۱۰ com.five_corp.ad کیت توسعه نرم‌افزار LY Ads Network خطایی مختص کیت توسعه نرم‌افزار برگرداند. برای جزئیات بیشتر، اسناد LY Ads Network را ببینید.
    ۱۰۱ com.google.ads.mediation.line شناسه برنامه وجود ندارد یا نامعتبر است.
    102 com.google.ads.mediation.line «شناسه جایگاه» وجود ندارد یا نامعتبر است.
    103 com.google.ads.mediation.line اندازه آگهی درخواستی با اندازه آگهی برنمای پشتیبانی‌شده در «شبکه آگهی‌های LY» مطابقت ندارد.
    104 com.google.ads.mediation.line به‌دلیل نبودن بافت فعالیت، آگهی تمام‌صفحه یا پاداشی بار نشد.
    ۱۰۵ com.google.ads.mediation.line کیت توسعه نرم‌افزار LY Ads Network نتوانست آگهی بینابینی یا پاداشی را نشان دهد.
    106 com.google.ads.mediation.line آگهی بومی به‌دلیل نبود دارایی‌ها بار نشد.
    107 com.google.ads.mediation.line کیت توسعه نرم‌افزار FiveAd بارکننده آگهی تهی برگرداند.

    iOS

    کد خطا دامنه استدلال
    ۱-۱۰ ارسال‌شده توسط LY Ads Network SDK کیت توسعه نرم‌افزار LY Ads Network خطایی مختص کیت توسعه نرم‌افزار برگرداند. برای جزئیات بیشتر، اسناد LY Ads Network را ببینید.
    ۱۰۱ com.google.ads.mediation.line پارامترهای سرور نامعتبر است (مثلاً شناسه برنامه یا شناسه جایگاه وجود ندارد).
    102 com.google.ads.mediation.line اندازه آگهی درخواستی با اندازه آگهی برنمای پشتیبانی‌شده در «شبکه آگهی‌های LY» مطابقت ندارد.
    103 com.google.ads.mediation.line بار کردن دارایی تصویر نماد اطلاعات در آگهی بومی ناموفق بود.
    104 com.google.ads.mediation.line سیگنال‌های پیشنهاد قیمت جمع‌آوری نشد.
    ۱۰۵ com.google.ads.mediation.line مقداردهی اولیه بارکننده آگهی LINE Ads SDK ناموفق بود.

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

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

    • اکنون به حداقل iOS نسخه ۱۵.۰ نیاز دارد.

    نسخه ۲.۲.۱

    نسخه ۲.۲.۰

    نسخه ۲.۱.۳

    • به‌روزرسانی‌شده برای پشتیبانی از نسخه ۹.۱.۰ افزونه Flutter تبلیغات تلفن همراه Google.
    • پشتیبانی از Swift Package Manager اضافه شد.
    • از Line Android adapter نسخه ۳.۱.۱.۱ پشتیبانی می‌کند.
    • از آداپتور Line iOS نسخه ۳.۰.۱.۲ پشتیبانی می‌کند.
    • ساخته‌شده و آزمایش‌شده با نسخه ۹.۱.۰ «افزونه Flutter تبلیغات تلفن همراه Google»

    نسخه ۲.۱.۲

    نسخه ۲.۱.۱

    نسخه ۲.۱.۰

    • پایین‌ترین نسخه Flutter به ۳.۳۸.۱ به‌روز شد
    • به‌روزرسانی‌شده برای پشتیبانی از نسخه ۸.۰.۰ «افزونه Flutter تبلیغات تلفن همراه Google»
    • از Line Android adapter نسخه ۳.۱.۰.۰ پشتیبانی می‌کند.
    • از آداپتور Line iOS نسخه ۳.۰.۱.۰ پشتیبانی می‌کند.
    • بااستفاده از «افزونه Flutter تبلیغات تلفن همراه Google» نسخه ۸.۰.۰ ساخته و آزمایش شده است

    نسخه ۲.۰.۰

    • حداقل نسخه Flutter به ۳.۳۵.۱ به‌روز شد
    • به‌روزرسانی‌شده برای پشتیبانی از نسخه ۷.۰.۰ «افزونه Flutter تبلیغات تلفن همراه Google»
    • از آداپتور Line Android نسخه ۳.۰.۱.۰ پشتیبانی می‌کند.
    • از آداپتور Line iOS نسخه ۳.۰.۰.۰ پشتیبانی می‌کند.
    • ساخته و آزمایش‌شده با نسخه 7.0.0 افزونه Flutter برای Google Mobile Ads

    نسخه ۱.۰.۶

    نسخه ۱.۰.۵

    نسخه ۱.۰.۴

    نسخه ۱.۰.۳

    نسخه ۱.۰.۲

    نسخه ۱.۰.۱

    نسخه ۱.۰.۰