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

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

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

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

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

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

پیش‌نیازها

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

  • جدیدترین نسخه Google Mobile Ads Unity Plugin.
  • Unity Editor نسخه ۴ یا بالاتر.
  • [برای پیشنهاد قیمت]: برای ادغام کردن همه قالب‌های آگهی پشتیبانی‌شده در پیشنهاد قیمت، از افزونه میانجی‌گری «تبلیغات Google برای تلفن همراه» برای LY Ads Network نسخه ۱.۵.۰ یا جدیدتر استفاده کنید (جدیدترین نسخه توصیه می‌شود).
  • برای استقرار در Android
    • Android API سطح ۲۴ یا بالاتر.
  • برای استقرار در iOS
    • هدف استقرار iOS نسخه ۱۳.۰ یا بالاتر.
  • یک پروژه Unity فعال که با Google Mobile Ads Unity Plugin پیکربندی شده باشد. برای جزئیات، راه‌اندازی Google Mobile Ads Unity 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

    OpenUPM-CLI

    اگر OpenUPM-CLI را نصب کرده‌اید، می‌توانید با اجرای فرمان زیر از دایرکتوری ریشه پروژه‌تان، «افزونه واسطه‌گری شبکه آگهی‌های Google Mobile Ads LY» را برای Unity در پروژه‌تان نصب کنید:

    openupm add com.google.ads.mobile.mediation.line

    OpenUPM

    در ویرایشگر پروژه Unity، ویرایش > تنظیمات پروژه > مدیر بسته را انتخاب کنید تا تنظیمات مدیر بسته Unity باز شود.

    در برگه Scoped Registries،‏ OpenUPM را به‌عنوان یک scoped registry با جزئیات زیر اضافه کنید:

    • نام: OpenUPM
    • نشانی وب: https://package.openupm.com
    • حوزه(ها): com.google

    جزئیات OpenUPM

    سپس، به Window > Package Manager بروید تا Unity Package Manager را باز کنید و My Registries را از منوِ کرکره‌ای انتخاب کنید.

    Unity Registries

    بسته Google Mobile Ads Line Mediation را انتخاب کنید و روی نصب کلیک کنید.

    نصب از OpenUPM

    بسته Unity

    جدیدترین نسخه افزونه میانجی‌گری «تبلیغات Google برای تلفن همراه» را برای LY Ads Network از پیوند بارگیری در گزارش تغییرات بارگیری کنید و GoogleMobileAdsLineMediation.unitypackage را از فایل zip استخراج کنید.

    در ویرایشگر پروژه Unity، دارایی‌ها > وارد کردن بسته > بسته سفارشی را انتخاب کنید و فایل GoogleMobileAdsLineMediation.unitypackage بارگیری‌شده را پیدا کنید. مطمئن شوید همه فایل‌ها انتخاب شده باشند و روی وارد کردن کلیک کنید.

    وارد کردن از Unity

    سپس Assets (دارایی‌ها) > External Dependency Manager (مدیر وابستگی خارجی) > Android Resolver (حل‌کننده Android) > Force Resolve (حل اجباری) را انتخاب کنید. کتابخانه «مدیر وابستگی خارجی» وضوح وابستگی را از ابتدا انجام خواهد داد و وابستگی‌های اعلام‌شده را در دایرکتوری Assets/Plugins/Android برنامه Unity شما کپی خواهد کرد.

    حل‌وفصل اجباری

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

    Android

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

    iOS

    ادغام SKAdNetwork

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

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

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

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

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

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

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

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

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

    • ‫SetEnableAdSound(boolean) : وضعیت شروع صدای پیش‌فرض آگهی‌های پاداشی، بینابینی، و برنمایی را مشخص می‌کند.

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

    using GoogleMobileAds.Api;
using GoogleMobileAds.Mediation.Line.Api;
// ...

var adRequest = new AdRequest();
var lineExtras = new LineMediationExtras();
lineExtras.SetEnableAdSound(true);
adRequest.MediationExtras.Add(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 Unity

    نسخه ۲.۲.۱

    نسخه ۲.۲.۰

    نسخه ۲.۱.۱

    نسخه ۲.۱.۰

    نسخه ۲.۰.۲

    نسخه ۲.۰.۱

    نسخه ۲.۰.۰

    نسخه ۱.۵.۱۰

    نسخه ۱.۵.۹

    نسخه ۱.۵.۸

    نسخه ۱.۵.۷

    نسخه ۱.۵.۶

    نسخه ۱.۵.۵

    • مشکلی که باعث می‌شد نصب ازطریق OpenUPM باعث شود افزونه بسته‌ها را به‌درستی وارد نکند برطرف شد.

    نسخه ۱.۵.۴

    نسخه ۱.۵.۳

    نسخه ۱.۵.۲

    نسخه ۱.۵.۱

    نسخه ۱.۵.۰

    نسخه ۱.۴.۰

    نسخه ۱.۳.۱

    نسخه ۱.۳.۰

    نسخه ۱.۲.۰

    نسخه ۱.۱.۲

    نسخه ۱.۱.۱

    نسخه ۱.۱.۰

    • کلاس LineMediationExtras با روش‌های زیر برای پشتیبانی از ارسال موارد اضافی میانجی‌گری اضافه شد.
      • SetEnabledAdSound(bool)
    • از آداپتور Line Android نسخه 2.7.20240214.1 پشتیبانی می‌کند.
    • از Line iOS adapter نسخه 2.7.20240318.0 پشتیبانی می‌کند.
    • بااستفاده از «افزونه Google Mobile Ads Unity» نسخه ۹.۰.۰ ساخته و آزمایش شده است.

    نسخه ۱.۰.۰