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

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

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

آداپتور واسطه‌گری AdMob برای 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 را ببینید.
  • «واسطه‌گری AdMob» را راه‌اندازی کنید.

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

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

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

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

    ثبت‌نام جدید

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

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

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

    Android

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

    iOS

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    Android

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

    iOS

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

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

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

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

    iOS

    ادغام SKAdNetwork

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

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

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

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

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

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

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

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

    افزونه میانجی‌گری 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 نسخه ۱۵.۰ نیاز دارد.

    نسخه ۲.۲.۱

    نسخه ۲.۲.۰

    نسخه ۲.۱.۳

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

    نسخه ۲.۱.۲

    نسخه ۲.۱.۱

    نسخه ۲.۱.۰

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

    نسخه ۲.۰.۰

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

    نسخه ۱.۰.۶

    نسخه ۱.۰.۵

    نسخه ۱.۰.۴

    نسخه ۱.۰.۳

    نسخه ۱.۰.۲

    نسخه ۱.۰.۱

    نسخه ۱.۰.۰