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

این راهنما نحوه استفاده از Google Mobile Ads SDK را برای بار کردن و نمایش دادن آگهی‌ها از «شبکه آگهی‌های LY» بااستفاده از واسطه‌گری نشان می‌دهد، و ادغام‌های آبشاری را پوشش می‌دهد. این راهنما نحوه افزودن 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 SDK را برای پیکربندی این جایگاه برای «پیشنهاد قیمت» انتخاب کنید. پس‌از تکمیل فرم، روی ایجاد کلیک کنید.

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

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

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

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

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

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

به‌روزرسانی app-ads.txt

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

برای پیاده‌سازی app-ads.txt برای LY Ads Network، به درباره app-ads.txt مراجعه کنید.

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

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

افزودن «شبکه آگهی LY» در «شرکت‌ها»

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

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

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

پیکربندی پیشنهاد قیمت شبکه تبلیغات LY

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

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

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

قبل‌از ادامه دادن، باید حداقل نسخه پشتیبانی‌شده آداپتور ۲.۹.۲۰۲۵۱۱۱۹ را داشته باشید.

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

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

برای افزودن شناسه‌های SKAdNetwork به فایل Info.plist پروژه خود، اسناد شبکه آگهی LY را دنبال کنید.

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

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

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

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

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» دریافت کند، می‌توانید خطای زیربنایی را از پاسخ آگهی بااستفاده از GADResponseInfo.adNetworkInfoArray در کلاس‌های زیر بررسی کنید:

GADMediationAdapterLine

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

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

نسخه ۳.۱.۱.۰

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

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

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

نسخه ۳.۱.۰.۰

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

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

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

نسخه ۳.۰.۱.۲

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

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

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

نسخه ۳.۰.۱.۱

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

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

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

نسخه ۳.۰.۱.۰

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

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

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

نسخه ۳.۰.۰.۱

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

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

• نسخه 13.0.0 کیت توسعه نرم‌افزار آگهی تلفن همراه Google.
• نسخه کیت توسعه نرم‌افزار FiveAd‏ 3.0.0.

نسخه ۳.۰.۰.۰

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

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

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

نسخه ۲.۹.۲۰۲۵۱۱۱۹.۱

• پشتیبانی از بازارسال پارامترهای 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» تأیید شد.

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

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

نسخه 2.9.20250512.0

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

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

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

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

• مشکلی که باعث می‌شد 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.

نسخه 2.9.20241106.1

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

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

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

نسخه 2.9.20241106.0

• سازگاری با نسخه ۲.۹.۲۰۲۴۱۱۰۶ «کیت توسعه نرم‌افزار FiveAd» تأیید شد.

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

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

نسخه ۲.۸.۲۰۲۴۰۸۲۷.۱

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

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

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

نسخه 2.8.20240827.0

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

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

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

نسخه 2.8.20240612.0

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

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

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

نسخه 2.7.20240411.0

• سازگاری با نسخه ۲.۷.۲۰۲۴۰۴۱۱ کیت توسعه نرم‌افزار FiveAd تأیید شد.

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

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

نسخه 2.7.20240318.0

• سازگاری با نسخه 2.7.20240318 کیت توسعه نرم‌افزار FiveAd تأیید شد.

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

• نسخه ۱۱.۲.۰ کیت توسعه نرم‌افزار آگهی تلفن همراه 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

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

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

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

نسخه ۲.۷.۲۰۲۳۱۱۱۵.۰

• سازگاری با نسخه 2.7.20231115 کیت توسعه نرم‌افزار FiveAd تأیید شد.
• سرصفحه GADMediationAdapterLineExtras در modulemap اضافه شد.

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

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

نسخه 2.6.20230609.1

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

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

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

نسخه 2.6.20230609.0

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

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

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