این راهنما به شما نشان میدهد که چگونه از Google Mobile Ads SDK برای بارگیری و نمایش تبلیغات از Line با استفاده از میانجیگری استفاده کنید که ادغامهای آبشار را پوشش میدهد. نحوه افزودن Line به پیکربندی میانجی واحد تبلیغات و نحوه ادغام Line SDK و آداپتور در یک برنامه iOS را پوشش می دهد.
رابط داشبورد برای LINE Ads Network از متن ژاپنی برای برچسبها، دکمهها و توضیحات خود استفاده میکند. اسکرین شات های این راهنما ترجمه نشده اند. با این حال، در توضیحات و دستورالعملهای این راهنما، برچسبها و دکمهها با معادلهای انگلیسی خود در پرانتز ترجمه شدهاند.
ادغام ها و قالب های تبلیغاتی پشتیبانی شده
آداپتور میانجی برای LINE Ads Network دارای قابلیت های زیر است:
یکپارچه سازی | |
---|---|
مناقصه | 1 |
آبشار | 2 |
فرمت ها | |
بنر | 3 |
بینابینی | 3 |
پاداش داده شد | |
بومی |
2 ادغام Waterfall در نسخه بتا باز است.
3 این قالب فقط در یکپارچه سازی آبشار پشتیبانی می شود.
الزامات
هدف استقرار iOS 12.0 یا بالاتر
جدیدترین SDK تبلیغات موبایل گوگل
راهنمای شروع میانجیگری را کامل کنید
مرحله 1: تنظیمات را در رابط کاربری LINE Ads Network تنظیم کنید
به حساب LINE Ads Network خود وارد شوید .
یک برنامه جدید اضافه کنید
کلیک کنید広告枠管理 (مدیریت جایگاه آگهی) >メディア (رسانه) . سپس، روی新規作成 (ایجاد جدید) کلیک کنید.
فرم را پر کنید و روی登録 (ثبت نام) کلیک کنید.
به شناسه برنامه توجه داشته باشید.
یک مکان تبلیغاتی ایجاد کنید
مراحل یکسانی را برای ایجاد مکان های تبلیغاتی برای ادغام مناقصه و آبشار دنبال کنید. هر تبلیغ را می توان برای هر دو مورد استفاده قرار داد.روی شناسه برنامهای که میخواهید درج آگهی اضافه کنید کلیک کنید. سپس،詳細 (جزئیات) را انتخاب کنید.
رویスロット 追加 (افزودن شکاف) کلیک کنید.
فرم را پر کنید و پس از انجام، روی (登録) ثبت نام کلیک کنید.
به شناسه اسلات توجه داشته باشید.
مرحله 2: تقاضای شبکه LINE Ads را در رابط کاربری Ad Manager تنظیم کنید
به حساب Ad Manager خود وارد شوید.
اضافه کردن LINE Ads Network در شرکت ها
مناقصه
این مرحله برای ادغام پیشنهادها لازم نیست.
آبشار
به Admin > Companies بروید، سپس روی دکمه New company در تب All companys کلیک کنید. شبکه تبلیغات را انتخاب کنید.
LINE Ads Network را به عنوان شبکه تبلیغاتی انتخاب کنید، یک نام منحصر به فرد وارد کنید و Mediation را فعال کنید.
شما نیازی به وارد کردن نام کاربری یا رمز عبور ندارید. پس از اتمام روی ذخیره کلیک کنید.
اشتراک گذاری سیگنال ایمن را فعال کنید
مناقصه
به Admin > تنظیمات جهانی بروید. به برگه تنظیمات حساب Ad Exchange بروید و اشتراکگذاری ایمن سیگنال را بررسی کرده و آن را تغییر دهید. روی ذخیره کلیک کنید.
آبشار
این مرحله برای ادغام آبشار لازم نیست.
مناقصه شبکه LINE Ads را پیکربندی کنید
مناقصه
به Delivery > Bidders بروید و روی New bidder در زیر برگه SDK Bidding کلیک کنید.
LINE Ads Network را به عنوان پیشنهاد دهنده انتخاب کنید.
روی افزودن کتابخانه سیگنال این مناقصهدهنده به فهرست سیگنالهای مجاز و اجازه اشتراکگذاری سیگنالها با این پیشنهاد دهنده را تغییر دهید. سپس، روی Continue کلیک کنید.
روی Continue کلیک کنید.
روی Done کلیک کنید.
آبشار
این مرحله برای ادغام آبشار لازم نیست.
پیکربندی نقشه واحد تبلیغات
مناقصه
به Delivery > Bidders بروید و شرکتی را برای LINE Ads Network در برگه SDK Bidding انتخاب کنید.
به برگه نگاشت واحد آگهی بروید و روی نقشه واحد آگهی جدید کلیک کنید.
واحد تبلیغات خاص را انتخاب کنید. یک واحد تبلیغات و قالب، برنامه موبایل را به عنوان نوع موجودی ، و برنامه تلفن همراه خود را انتخاب کنید. سپس Application ID و Slot ID بدست آمده در قسمت قبل را وارد کنید. در نهایت روی Save کلیک کنید.
آبشار
به مسیر Delivery > Yield Groups بروید و روی دکمه گروه بازده جدید کلیک کنید. برنامه موبایل خود را انتخاب کنید.
به پایین بروید و روی افزودن شریک بازده کلیک کنید.
شرکتی را که برای LINE Ads Network ایجاد کرده اید در قسمت قبل انتخاب کنید. میانجی SDK موبایل را به عنوان نوع یکپارچه سازی ، iOS را به عنوان پلتفرم و Active را به عنوان وضعیت انتخاب کنید.
شناسه برنامه و شناسه اسلات به دست آمده در بخش قبل و مقدار پیش فرض CPM را وارد کنید. روی ذخیره کلیک کنید.
مرحله 3: SDK و آداپتور LINE Ads Network را وارد کنید
استفاده از CocoaPods (توصیه می شود)
خط زیر را به Podfile پروژه خود اضافه کنید:
pod 'GoogleMobileAdsMediationLine'
از خط فرمان اجرا کنید:
pod install --repo-update
ادغام دستی
- آخرین نسخه LINE Ads Network SDK را دانلود کنید و
FiveAd.framework
در پروژه خود پیوند دهید. - آخرین نسخه آداپتور شبکه LINE Ads را از لینک دانلود در Changelog دانلود کنید و
LineAdapter.framework
در پروژه خود پیوند دهید.
مرحله 4: کد مورد نیاز را اضافه کنید
ادغام SKAdNetwork
مستندات LINE Ads Network را دنبال کنید تا شناسه های SKAdNetwork را به فایل Info.plist
پروژه خود اضافه کنید.
مرحله 5: اجرای خود را آزمایش کنید
فعال کردن تبلیغات آزمایشی
مطمئن شوید که دستگاه آزمایشی خود را برای Ad Manager ثبت کرده اید.
تبلیغات آزمایشی را تأیید کنید
برای تأیید اینکه آگهیهای آزمایشی را از شبکه LINE Ads دریافت میکنید، با استفاده از منبع(های) تبلیغات LINE Ads Network (Waterfall) آزمایش منبع آگهی را در بازرس آگهی فعال کنید.
مراحل اختیاری
پارامترهای خاص شبکه
آداپتور شبکه LINE Ads از یک پارامتر درخواست اضافی پشتیبانی می کند که می تواند با استفاده از کلاس GADMediationAdapterLineExtras
به آداپتور ارسال شود. این کلاس شامل ویژگی های زیر است:
-
adAudio
- وضعیت شروع صدای پیشفرض آگهیهای بنر، بینابینی و پاداش را مشخص میکند.
در اینجا یک نمونه کد از نحوه ایجاد یک درخواست تبلیغاتی است که این پارامترها را تنظیم می کند:
سویفت
import LineAdapter
// ...
let request = GAMRequest()
let extras = GADMediationAdapterLineExtras()
extras.adAudio = GADMediationAdapterLineAdAudio.unmuted
// ...
request.register(extras)
هدف-C
#import <LineAdapter/LineAdapter.h>
// ...
GAMRequest *request = [GAMRequest request];
GADMediationAdapterLineExtras *extras = [[GADMediationAdapterLineExtras alloc] init];
extras.adAudio = GADMediationAdapterLineAdAudioUnmuted;
// ...
[request registerAdNetworkExtras:extras];
استفاده از تبلیغات بومی
رندر آگهی
آداپتور شبکه LINE Ads فیلدهای زیر را برای GADNativeAd
پر می کند.
میدان | دارایی ها همیشه توسط آداپتور شبکه LINE Ads گنجانده شده است |
---|---|
تیتر | |
تصویر | |
بدن | |
نماد برنامه | 1 |
فراخوان به اقدام | |
امتیاز ستاره | |
فروشگاه | |
قیمت |
1 برای تبلیغات بومی، LINE Ads Network SDK دارایی نماد برنامه را ارائه نمی دهد. در عوض، آداپتور شبکه LINE Ads نماد برنامه را با یک تصویر شفاف پر می کند.
کدهای خطا
اگر آداپتور نتواند تبلیغی را از LINE Ads Network دریافت کند، میتوانید خطای اساسی را از پاسخ آگهی با استفاده از GADResponseInfo.adNetworkInfoArray
در کلاسهای زیر بررسی کنید:
GADMediationAdapterLine
در اینجا کدها و پیامهای همراهی وجود دارد که توسط آداپتور شبکه LINE Ads هنگام بارگیری نشدن آگهی ارسال میشود:
کد خطا | دامنه | دلیل |
---|---|---|
1-10 | ارسال شده توسط LINE Ads Network SDK | LINE Ads Network SDK یک خطای خاص SDK را برگرداند. برای جزئیات بیشتر به مستندات LINE Ads Network مراجعه کنید. |
101 | com.google.ads.mediation.line | پارامترهای سرور نامعتبر (به عنوان مثال شناسه برنامه یا شناسه شکاف از دست رفته). |
102 | com.google.ads.mediation.line | اندازه تبلیغ درخواستی با اندازه تبلیغات بنری پشتیبانی شده از شبکه LINE Ads مطابقت ندارد. |
103 | com.google.ads.mediation.line | دارایی تصویر نماد اطلاعات در آگهی بومی بارگیری نشد. |
LINE تغییرات آداپتور iOS Mediation
نسخه بعدی
- منطق حذف شد که بررسی میکرد آیا FAD SDK در تنظیمات آداپتور ثبت شده است یا خیر.
- API «نمایش» تبلیغات بینابینی و پاداشی را با API جدید «showWithViewController:» بهروزرسانی کرد.
- بررسی وضعیت آگهی بومی قبل از دانلود داراییهای تبلیغات بومی حذف شد، زیرا منسوخ شده است و جایگزینی وجود ندارد.
نسخه 2.9.20241106.1
- آداپتور را بهروزرسانی کرد تا از آخرین API بارگذاری آگهی برای آگهیهای بنری مناقصه استفاده کند.
- مشکلی را برطرف کرد که مانع از ارسال صحیح رویدادهای تبلیغاتی برای آگهیهای بینابینی شد.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 11.12.0.
- FiveAd SDK نسخه 2.9.20241106.
نسخه 2.9.20241106.0
- سازگاری تأیید شده با FiveAd SDK نسخه 2.9.20241106.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 11.12.0.
- FiveAd SDK نسخه 2.9.20241106.
نسخه 2.8.20240827.1
-
CFBundleShortVersionString
بهروزرسانی کرد تا به جای چهار مؤلفه، سه مؤلفه داشته باشد.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 11.10.0.
- FiveAd SDK نسخه 2.8.20240827.
نسخه 2.8.20240827.0
- سازگاری تأیید شده با FiveAd SDK نسخه 2.8.20240827.
- پشتیبانی از مناقصه برای قالبهای تبلیغاتی بنر، بینابینی، پاداش و بومی اضافه شد.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 11.8.0.
- FiveAd SDK نسخه 2.8.20240827.
نسخه 2.8.20240612.0
- کنترل صوتی برای تبلیغات بومی از طریق GADVideoOptions اضافه شده است.
- سازگاری تأیید شده با FiveAd SDK نسخه 2.8.20240612.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 11.5.0.
- FiveAd SDK نسخه 2.8.20240612.
نسخه 2.7.20240411.0
- سازگاری تأیید شده با FiveAd SDK نسخه 2.7.20240411.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 11.3.0.
- FiveAd SDK نسخه 2.7.20240411.
نسخه 2.7.20240318.0
- سازگاری تأیید شده با FiveAd SDK نسخه 2.7.20240318.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 11.2.0.
- FiveAd SDK نسخه 2.7.20240318.
نسخه 2.7.20240214.1
- اکنون به حداقل نسخه iOS 12.0 نیاز دارد.
- اکنون به Google Mobile Ads SDK نسخه 11.0 یا بالاتر نیاز دارد.
- شامل
Info.plist
در چارچوب های موجود درLineAdapter.xcframework
.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 11.0.1.
- FiveAd SDK نسخه 2.7.20240214.
نسخه 2.7.20240214.0
- سازگاری تأیید شده با FiveAd SDK نسخه 2.7.20240214.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 11.0.1.
- FiveAd SDK نسخه 2.7.20240214.
نسخه 2.7.20240126.0
- سازگاری تأیید شده با FiveAd SDK نسخه 2.7.20240126.
- اجرای آداپتور را با پروتکل های نمایندگی جدید FiveAd SDK به روز کرد.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 10.14.0.
- FiveAd SDK نسخه 2.7.20240126.
نسخه 2.7.20231115.0
- سازگاری تأیید شده با FiveAd SDK نسخه 2.7.20231115.
- هدر
GADMediationAdapterLineExtras
در نقشه ماژول گنجانده شده است.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 10.14.0.
- FiveAd SDK نسخه 2.7.20231115.
نسخه 2.6.20230609.1
-
GADMediationAdapterLineAudioState
اضافه شد تا وضعیت صوتی اولیه بنر، تبلیغات بینابینی و پاداش را در هنگام نمایش برای اولین بار مدیریت کند.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 10.14.0.
- FiveAd SDK نسخه 2.6.20230609.
نسخه 2.6.20230609.0
- انتشار اولیه!
- پشتیبانی از آبشار برای قالبهای تبلیغاتی بنر، بینابینی، پاداش و بومی اضافه شد.
- سازگاری تأیید شده با FiveAd SDK نسخه 2.6.20230609.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 10.9.0.
- FiveAd SDK نسخه 2.6.20230609.