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

این راهنما به شما نشان می‌دهد که چگونه از 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» دریافت کنید. ممکن است این کار مدتی طول بکشد. اگر سؤالی دارید، با نماینده شبکه آگهی‌های LY تماس بگیرید.

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

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

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

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

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

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

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

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

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

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

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

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

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

    Android

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

    iOS

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

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

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

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

    dependencies:
  gma_mediation_line: ^2.2.2

    یکپارچه‌سازی دستی

    جدیدترین نسخه افزونه میانجی‌گری 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 فعال کنید.

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

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

    افزونه میانجی‌گری Flutter در شبکه آگهی‌های LY از پارامتر درخواست اضافی زیر پشتیبانی می‌کند که می‌تواند ازطریق کلاس 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 15.0 نیاز دارد.
    • مشکل ازکار افتادن iOS هنگام عبور از LineMediationExtras برطرف شد.
    • از آداپتور Line Android نسخه 3.1.1.2 پشتیبانی می‌کند.
    • از آداپتور Line iOS نسخه ۳.۱.۱.۰ پشتیبانی می‌کند.
    • با نسخه 9.1.0 افزونه Flutter «تبلیغات تلفن همراه Google» ساخته و آزمایش شده است.

    نسخه ۲.۲.۱

    نسخه ۲.۲.۰

    نسخه ۲.۱.۳

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

    نسخه ۲.۱.۲

    نسخه ۲.۱.۱

    نسخه ۲.۱.۰

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

    نسخه ۲.۰.۰

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

    نسخه ۱.۰.۶

    نسخه ۱.۰.۵

    نسخه ۱.۰.۴

    نسخه ۱.۰.۳

    نسخه ۱.۰.۲

    نسخه ۱.۰.۱

    نسخه ۱.۰.۰