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

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

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

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

کارگزار میانجی‌گری Ad Manager برای «شبکه آگهی LY Ads» قابلیت‌های زیر را دارد:

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

پیش‌نیازها

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

  • جدیدترین نسخه Google Mobile Ads Unity Plugin.
  • نسخه ۴ یا بالاتر «ویرایشگر Unity».
  • [برای پیشنهاد قیمت]: برای ادغام کردن همه قالب‌های آگهی پشتیبانی‌شده در پیشنهاد قیمت، از افزونه میانجی‌گری «تبلیغات 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» تأییدیه بگیرید. ممکن است این کار مدتی طول بکشد. اگر سؤالی دارید، با نماینده 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»، به درباره 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 باز شود.

    در زبانه ثبت‌های محدود، OpenUPM را به‌عنوان ثبت محدود با جزئیات زیر اضافه کنید:

    • نام: 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» از پیوند بارگیری در Changelog بارگیری کنید و 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 فعال کنید.

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

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

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

    Android

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

    iOS

    GADMediationAdapterLine

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

    Android

    کد خطا دامنه استدلال
    ۱-۱۰ com.five_corp.ad کیت توسعه نرم‌افزار LY Ads Network خطایی مختص کیت توسعه نرم‌افزار برگرداند. برای جزئیات بیشتر، اسناد «شبکه تبلیغات LY Ads» را ببینید.
    ۱۰۱ 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» مقداردهی اولیه نشد.

    گزارش تغییر افزایه میانجی‌گری Line Unity

    نسخه ۲.۲.۱

    نسخه ۲.۲.۰

    نسخه ۲.۱.۱

    نسخه ۲.۱.۰

    نسخه ۲.۰.۲

    نسخه ۲.۰.۱

    نسخه ۲.۰.۰

    نسخه ۱.۵.۱۰

    نسخه ۱.۵.۹

    نسخه ۱.۵.۸

    نسخه ۱.۵.۷

    نسخه 1.5.6

    نسخه ۱.۵.۵

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

    نسخه ۱.۵.۴

    نسخه ۱.۵.۳

    نسخه ۱.۵.۲

    نسخه ۱.۵.۱

    نسخه ۱.۵.۰

    نسخه ۱.۴.۰

    نسخه ۱.۳.۱

    نسخه ۱.۳.۰

    نسخه ۱.۲.۰

    نسخه ۱.۱.۲

    نسخه ۱.۱.۱

    نسخه ۱.۱.۰

    نسخه ۱.۰.۰