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

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

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

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

پیش‌نیازها

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

• هدف استقرار iOS نسخه ۱۳.۰ یا بالاتر.

• [برای پیشنهاد قیمت]: برای ادغام کردن همه قالب‌های آگهی پشتیبانی‌شده در پیشنهاد قیمت، از آداپتور LY Ads Network نسخه 2.8.20240827.0 یا جدیدتر (جدیدترین نسخه توصیه می‌شود) استفاده کنید.

• جدیدترین نسخه Google Mobile Ads SDK.

• راه‌اندازی میانجی‌گری.

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

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

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

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

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

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

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

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

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

به سیستم حساب Ad Manager خود وارد شوید.

افزودن LY Ads Network در شرکت‌ها

فعال کردن هم‌رسانی سیگنال ایمن

هم‌رسانی نشان امن در درخواست‌های پیشنهاد قیمت

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

پیکربندی پیشنهاد قیمت شبکه آگهی‌های LY

پیکربندی تخصیص واحد آگهی

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

استفاده از Swift Package Manager

قبل‌از ادامه دادن، باید حداقل نسخه آداپتور پشتیبانی‌شده 2.9.20251119 را داشته باشید.

برای افزودن وابستگی بسته به پروژه‌تان، این مراحل را دنبال کنید:

1. در Xcode، به File > Add Package Dependencies...‎ بروید.

2. در پیام‌واره‌ای که ظاهر می‌شود، نشانی وب بسته زیر را جستجو کنید:

   https://github.com/googleads/googleads-mobile-ios-mediation-line.git
   

3. در قانون وابستگی، شاخه را انتخاب کنید.

4. در فیلد نوشتاری، main را وارد کنید.

استفاده از CocoaPods

خط زیر را به Podfile پروژه‌تان اضافه کنید:

pod 'GoogleMobileAdsMediationLine'

از خط فرمان، این دستور را اجرا کنید:

pod install --repo-update

ادغام دستی

• جدیدترین نسخه LY Ads Network SDK را بارگیری کنید و FiveAd.framework را در پروژه‌تان پیوند دهید.
• جدیدترین نسخه آداپتور LY Ads Network را از پیوند بارگیری در «گزارش تغییرات» بارگیری کنید و LineAdapter.framework را در پروژه‌تان پیوند دهید.

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

پیاده‌سازی SKAdNetwork

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

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

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

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

آداپتور LY Ads Network حاوی یک روش کمکی برای فعال کردن حالت آزمایشی برای LY Ads Network است. باید این گزینه را قبل‌از مقداردهی اولیه Google Mobile Ads SDK تنظیم کنید تا مطمئن شوید که به‌درستی به LY Ads Network SDK بازارسال می‌شوند.

import LineAdapter
// ...

GADMediationAdapterLine.testMode = true

#import <LineAdapter/LineAdapter.h>
// ...

GADMediationAdapterLine.testMode = YES;

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

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

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

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

آداپتور LY Ads Network از پارامتر درخواست دیگری پشتیبانی می‌کند که می‌توان آن را بااستفاده از کلاس GADMediationAdapterLineExtras به آداپتور ارسال کرد. این کلاس شامل ویژگی‌های زیر است:

adAudio

وضعیت شروع صدای پیش‌فرض آگهی‌های برنمایی، بینابینی، و پاداشی را مشخص می‌کند.

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

import LineAdapter
// ...

let request = GAMRequest()
let extras = GADMediationAdapterLineExtras()
extras.adAudio = GADMediationAdapterLineAdAudio.unmuted
// ...
request.register(extras)

#import <LineAdapter/LineAdapter.h>
// ...

GAMRequest *request = [GAMRequest request];
GADMediationAdapterLineExtras *extras = [[GADMediationAdapterLineExtras alloc] init];
extras.adAudio = GADMediationAdapterLineAdAudioUnmuted;
// ...
[request registerAdNetworkExtras:extras];

استفاده از آگهی‌های بومی

پرداز آگهی

آداپتور LY Ads Network فیلدهای زیر را برای GADNativeAd پر می‌کند.

^۱ برای آگهی‌های بومی، کیت توسعه نرم‌افزار شبکه آگهی‌های LY دارایی نماد برنامه را ارائه نمی‌دهد. درعوض، آداپتور LY Ads Network نماد برنامه را با تصویر شفاف پر می‌کند.

کدهای خطا

اگر آداپتور نتواند آگهی را از LY Ads Network دریافت کند، می‌توانید خطای اساسی را از پاسخ آگهی بااستفاده از GADResponseInfo.adNetworkInfoArray تحت کلاس‌های زیر بررسی کنید:

GADMediationAdapterLine

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

گزارش تغییرات آداپتور میانجی LINE iOS

نسخه ۳.۱.۱.۰

• سازگاری با FiveAd SDK نسخه ۳.۱.۱ تأیید شد.

ساخته و آزمایش‌شده با:

• کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۱۳.۹.۰.
• FiveAd SDK نسخه ۳.۱.۱.

نسخه ۳.۱.۰.۰

• اکنون به حداقل iOS نسخه 15.0 نیاز دارد.
• سازگاری با FiveAd SDK نسخه ۳.۱.۰ تأیید شد.

ساخته و آزمایش‌شده با:

• نسخه ۱۳.۸.۰ کیت توسعه نرم‌افزار آگهی تلفن همراه Google.
• FiveAd SDK نسخه ۳.۱.۰.

نسخه ۳.۰.۱.۲

• حداقل نسخه iOS را به‌روز کنید تا وابستگی کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google را کاهش دهید و نسخه‌های جزئی مجاز شوند.
• مشکلی که باعث می‌شد نماد AdChoices برای آگهی‌های بومی خیلی بزرگ باشد برطرف شد.

ساخته و آزمایش‌شده با:

• کیت توسعه نرم‌افزار آگهی‌های Google Mobile نسخه ۱۳.۴.۰.
• FiveAd SDK نسخه ۳.۰.۱.

نسخه ۳.۰.۱.۱

• اکنون آداپتور پرچم ageRestrictedTreatment «کیت توسعه نرم‌افزار آگهی‌های Google Mobile» را به میانای برنامه‌سازی کاربردی COPPA در «کیت توسعه نرم‌افزار FiveAd» بازارسال می‌کند.

ساخته و آزمایش‌شده با:

• نسخه ۱۳.۳.۰ کیت توسعه نرم‌افزار آگهی تلفن همراه Google.
• FiveAd SDK نسخه ۳.۰.۱.

نسخه ۳.۰.۱.۰

• سازگاری با FiveAd SDK نسخه ۳.۰.۱ تأیید شد.

ساخته و آزمایش‌شده با:

• کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۱۳.۱.۰.
• FiveAd SDK نسخه ۳.۰.۱.

نسخه ۳.۰.۰.۱

• وابستگی کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google به نسخه ۱۳.۰.۰ به‌روز شد.

ساخته و آزمایش‌شده با:

• کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۱۳.۰.۰.
• FiveAd SDK نسخه ۳.۰.۰.

نسخه ۳.۰.۰.۰

• سازگاری با FiveAd SDK نسخه 3.0.0.0 تأیید شد.

ساخته و آزمایش‌شده با:

• کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۱۲.۱۴.۰.
• FiveAd SDK نسخه ۳.۰.۰.

نسخه 2.9.20251119.1

• پشتیبانی از بازارسال پارامترهای tagForUnderAgeOfConsent کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google به کیت توسعه نرم‌افزار FiveAd اضافه شد.

ساخته و آزمایش‌شده با:

• کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۱۲.۱۴.۰.
• FiveAd SDK نسخه ۲.۹.۲۰۲۵۱۱۱۹.

نسخه 2.9.20251119.0

• سازگاری با FiveAd SDK نسخه 2.9.20251119 تأیید شد.

ساخته و آزمایش‌شده با:

• کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۱۲.۱۴.۰.
• FiveAd SDK نسخه ۲.۹.۲۰۲۵۱۱۱۹.

نسخه 2.9.20250930.0

• سازگاری با FiveAd SDK نسخه 2.9.20250930 تأیید شد.

ساخته و آزمایش‌شده با:

• کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۱۲.۱۲.۰.
• FiveAd SDK نسخه ۲.۹.۲۰۲۵۰۹۳۰.

نسخه 2.9.20250912.0

• اکنون آداپتور پیش‌از هر درخواست آگهی، FiveAd SDK را مقداردهی اولیه می‌کند.
• سازگاری با FiveAd SDK نسخه 2.9.20250912 تأیید شد.

ساخته و آزمایش‌شده با:

• کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۱۲.۱۱.۰.
• FiveAd SDK نسخه ۲.۹.۲۰۲۵۰۹۱۲.

نسخه 2.9.20250512.0

• اکنون به حداقل iOS نسخه ۱۳.۰ نیاز دارد.
• سازگاری با FiveAd SDK نسخه 2.9.20250512 تأیید شد.

ساخته و آزمایش‌شده با:

• کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۱۲.۴.۰.
• FiveAd SDK نسخه ۲.۹.۲۰۲۵۰۵۱۲.

نسخه ۲.۹.۲۰۲۴۱۱۰۶.۳

• مشکلی که باعث می‌شد GADMediationAdapterLine.h سرصفحه عمومی نباشد برطرف شد.
• پرچم‌های -fobjc-arc و -fstack-protector-all فعال شد.
• درستی‌سنجی اندازه آگهی برنمایی برای پیشنهاد قیمت پس‌از بار کردن موفقیت‌آمیز برداشته شد.
  • آگهی‌های برنمای آبشاری پس‌از بار شدن موفقیت‌آمیز، همچنان اندازه‌های آگهی برنما را بررسی خواهند کرد.

ساخته و آزمایش‌شده با:

• کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۱۲.۲.۰.
• FiveAd SDK نسخه ۲.۹.۲۰۲۴۱۱۰۶.

نسخه 2.9.20241106.2

• ویژگی GADMediationAdapterLine.testMode اضافه شد تا نشان دهد که آیا FiveAd SDK باید در حالت آزمایشی مقداردهی اولیه شود یا نه. این پرچم باید قبل‌از مقداردهی اولیه «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» تنظیم شود.
• بررسی وضعیت مقداردهی اولیه FiveAd SDK قبل‌از مقداردهی اولیه FiveAd SDK برداشته شد.
• بررسی وضعیت آگهی بومی منسوخ‌شده قبل‌از بارگیری دارایی‌های آگهی بومی برداشته شد.
• اکنون به «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» نسخه ۱۲.۰.۰ یا بالاتر نیاز دارد.

ساخته و آزمایش‌شده با:

• کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۱۲.۰.۰.
• FiveAd SDK نسخه ۲.۹.۲۰۲۴۱۱۰۶.

نسخه 2.9.20241106.1

• آداپتور به‌روز شد تا از جدیدترین میانای برنامه‌سازی کاربردی بار کردن آگهی برای آگهی‌های برنمای پیشنهاد قیمت استفاده کند.
• مشکلی که مانع از بازارسال صحیح رویدادهای آگهی برای آگهی‌های بینابینی مزایده‌ای می‌شد برطرف شد.

ساخته و آزمایش‌شده با:

• کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۱۱.۱۲.۰.
• FiveAd SDK نسخه 2.9.20241106.

نسخه 2.9.20241106.0

• سازگاری با FiveAd SDK نسخه 2.9.20241106 تأیید شد.

ساخته و آزمایش‌شده با:

• کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۱۱.۱۲.۰.
• FiveAd SDK نسخه 2.9.20241106.

نسخه 2.8.20240827.1

• ‫CFBundleShortVersionString به‌روز شد تا به‌جای چهار مؤلفه، سه مؤلفه داشته باشد.

ساخته و آزمایش‌شده با:

• کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۱۱.۱۰.۰.
• FiveAd SDK نسخه 2.8.20240827.

نسخه 2.8.20240827.0

• سازگاری با FiveAd SDK نسخه 2.8.20240827 تأیید شد.
• پشتیبانی از پیشنهاد قیمت برای قالب‌های آگهی بومی، پاداش‌دار، بینابینی، و برنما اضافه شد.

ساخته و آزمایش‌شده با:

• نسخه ۱۱.۸.۰ کیت توسعه نرم‌افزار Google Mobile Ads.
• FiveAd SDK نسخه 2.8.20240827.

نسخه 2.8.20240612.0

• کنترل صوتی برای آگهی بومی ازطریق GADVideoOptions اضافه شد.
• سازگاری با FiveAd SDK نسخه 2.8.20240612 تأیید شد.

ساخته و آزمایش‌شده با:

• کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۱۱.۵.۰.
• FiveAd SDK نسخه 2.8.20240612.

نسخه 2.7.20240411.0

• سازگاری با FiveAd SDK نسخه 2.7.20240411 تأیید شد.

ساخته و آزمایش‌شده با:

• نسخه ۱۱.۳.۰ کیت توسعه نرم‌افزار آگهی تلفن همراه Google.
• FiveAd SDK نسخه 2.7.20240411.

نسخه 2.7.20240318.0

• سازگاری با FiveAd SDK نسخه 2.7.20240318 تأیید شد.

ساخته و آزمایش‌شده با:

• کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۱۱.۲.۰.
• FiveAd SDK نسخه 2.7.20240318.

نسخه 2.7.20240214.1

• اکنون به حداقل iOS نسخه ۱۲.۰ نیاز دارد.
• اکنون به «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» نسخه ۱۱.۰ یا بالاتر نیاز دارد.
• ‫Info.plist را در چارچوب‌های LineAdapter.xcframework گنجاندیم.

ساخته و آزمایش‌شده با:

• کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۱۱.۰.۱.
• FiveAd SDK نسخه ۲.۷.۲۰۲۴۰۲۱۴.

نسخه 2.7.20240214.0

• سازگاری با FiveAd SDK نسخه 2.7.20240214 تأیید شد.

ساخته و آزمایش‌شده با:

• کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۱۱.۰.۱.
• FiveAd SDK نسخه ۲.۷.۲۰۲۴۰۲۱۴.

نسخه 2.7.20240126.0

• سازگاری با FiveAd SDK نسخه 2.7.20240126 تأیید شد.
• پیاده‌سازی آداپتور با پروتکل‌های نماینده جدید FiveAd SDK به‌روز شد.

ساخته و آزمایش‌شده با:

• نسخه ۱۰.۱۴.۰ کیت توسعه نرم‌افزار آگهی تلفن همراه Google.
• FiveAd SDK نسخه 2.7.20240126.

نسخه 2.7.20231115.0

• سازگاری با FiveAd SDK نسخه 2.7.20231115 تأیید شد.
• سرصفحه GADMediationAdapterLineExtras در modulemap گنجانده شده است.

ساخته و آزمایش‌شده با:

• نسخه ۱۰.۱۴.۰ کیت توسعه نرم‌افزار آگهی تلفن همراه Google.
• FiveAd SDK نسخه 2.7.20231115.

نسخه 2.6.20230609.1

• GADMediationAdapterLineAudioState برای مدیریت وضعیت صوتی اولیه آگهی بینابینی، پاداشی، و برنما هنگام نمایش اولیه اضافه شد.

ساخته و آزمایش‌شده با:

• نسخه ۱۰.۱۴.۰ کیت توسعه نرم‌افزار آگهی تلفن همراه Google.
• FiveAd SDK نسخه ۲.۶.۲۰۲۳۰۶۰۹.

نسخه 2.6.20230609.0

• انتشار اولیه!
• پشتیبانی آبشاری برای قالب‌های آگهی بومی، پاداش‌دار، بینابینی، و برنما اضافه شد.
• سازگاری با FiveAd SDK نسخه 2.6.20230609 تأیید شد.

ساخته و آزمایش‌شده با:

• کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۱۰.۹.۰.
• FiveAd SDK نسخه ۲.۶.۲۰۲۳۰۶۰۹.