این راهنما به شما نشان میدهد که چگونه از Google Mobile Ads SDK برای بارگیری و نمایش تبلیغات از Line با استفاده از AdMob Mediation استفاده کنید که ادغامهای آبشار را پوشش میدهد. نحوه افزودن Line به پیکربندی میانجی واحد تبلیغات و نحوه ادغام Line SDK و آداپتور در یک برنامه iOS را پوشش می دهد.
رابط داشبورد برای Line از متن ژاپنی برای برچسبها، دکمهها و توضیحات خود استفاده میکند. اسکرین شات های این راهنما ترجمه نشده اند. با این حال، در توضیحات و دستورالعملهای این راهنما، برچسبها و دکمهها با معادلهای انگلیسی خود در پرانتز ترجمه شدهاند.
ادغام ها و قالب های تبلیغاتی پشتیبانی شده
آداپتور میانجی برای Line دارای قابلیت های زیر است:
یکپارچه سازی | |
---|---|
مناقصه | 1 |
آبشار | 2 |
فرمت ها | |
بنر | 3 |
بینابینی | 3 |
پاداش داده شد | |
بومی |
2 ادغام Waterfall در نسخه بتا باز است.
3 این قالب فقط در یکپارچه سازی آبشار پشتیبانی می شود.
الزامات
هدف استقرار iOS 12.0 یا بالاتر
[برای مناقصه]: برای ادغام همه قالبهای تبلیغاتی پشتیبانی شده در مناقصه، از Line adapter 2.8.20240827.0 یا بالاتر استفاده کنید ( آخرین نسخه توصیه میشود )
جدیدترین SDK تبلیغات موبایل گوگل
راهنمای شروع میانجیگری را کامل کنید
مرحله 1: تنظیمات را در Line UI تنظیم کنید
یک برنامه جدید اضافه کنید
کلیک کنید広告枠管理 (مدیریت جایگاه آگهی) >メディア (رسانه) . سپس، روی新規作成 (ایجاد جدید) کلیک کنید.
فرم را پر کنید و روی登録 (ثبت نام) کلیک کنید.
به شناسه برنامه توجه داشته باشید.
یک مکان تبلیغاتی ایجاد کنید
روی شناسه برنامهای که میخواهید درج آگهی اضافه کنید کلیک کنید. سپس،詳細 (جزئیات) را انتخاب کنید.
رویスロット 追加 (افزودن شکاف) کلیک کنید.
فرم را پر کنید و پس از انجام، روی (登録) ثبت نام کلیک کنید.
به شناسه اسلات توجه داشته باشید.
مرحله 2: تقاضای خط را در رابط کاربری AdMob تنظیم کنید
تنظیمات میانجی را برای واحد تبلیغات خود پیکربندی کنید
باید Line را به پیکربندی میانجی واحد تبلیغاتی خود اضافه کنید.
ابتدا وارد حساب AdMob خود شوید. سپس به تب Mediation بروید. اگر یک گروه میانجی موجود دارید که میخواهید آن را تغییر دهید، روی نام آن گروه میانجی کلیک کنید تا آن را ویرایش کنید و به افزودن خط به عنوان منبع آگهی بروید.
برای ایجاد یک گروه میانجی جدید، Create Mediation Group را انتخاب کنید.
قالب و پلتفرم تبلیغ خود را وارد کنید، سپس روی Continue کلیک کنید.
به گروه میانجی خود یک نام بدهید و مکانهایی را برای هدف انتخاب کنید. سپس، وضعیت گروه میانجی را روی Enabled تنظیم کنید و سپس روی Add Units Ad Units کلیک کنید.
این گروه میانجی را با یک یا چند واحد تبلیغات AdMob موجود خود مرتبط کنید. سپس روی Done کلیک کنید.
اکنون باید کارت واحدهای تبلیغاتی را با واحدهای تبلیغاتی که انتخاب کردهاید مشاهده کنید:
خط را به عنوان منبع تبلیغ اضافه کنید
مناقصه
در زیر کارت مناقصه در بخش منابع آگهی ، افزودن منبع آگهی را انتخاب کنید. سپس Line را انتخاب کنید.
روی نحوه امضای قرارداد مشارکت و تنظیم یک مشارکت در مناقصه با لاین کلیک کنید.
روی تأیید و موافقت کلیک کنید، سپس روی ادامه کلیک کنید.
اگر قبلاً نقشه ای برای Line دارید، می توانید آن را انتخاب کنید. در غیر این صورت، روی افزودن نقشه کلیک کنید.
در مرحله بعد، شناسه برنامه و شناسه اسلات را که در قسمت قبل به دست آمده بود وارد کنید. سپس روی Done کلیک کنید.
آبشار
در زیر کارت Waterfall در بخش Ad Sources ، Add Source Ad را انتخاب کنید. سپس Line را انتخاب کنید.
خط را انتخاب کنید. سپس یک مقدار eCPM را برای Line وارد کنید و روی Continue کلیک کنید.
اگر قبلاً نقشه ای برای Line دارید، می توانید آن را انتخاب کنید. در غیر این صورت، روی افزودن نقشه کلیک کنید.
در مرحله بعد، شناسه برنامه و شناسه اسلات را که در قسمت قبل به دست آمده بود وارد کنید. سپس روی Done کلیک کنید.
مرحله 3: Line SDK و Adapter را وارد کنید
استفاده از CocoaPods (توصیه می شود)
خط زیر را به Podfile پروژه خود اضافه کنید:
pod 'GoogleMobileAdsMediationLine'
از خط فرمان اجرا کنید:
pod install --repo-update
ادغام دستی
- آخرین نسخه Line SDK را دانلود کنید و
FiveAd.framework
در پروژه خود پیوند دهید. - آخرین نسخه آداپتور Line را از لینک دانلود در Changelog دانلود کنید و
LineAdapter.framework
در پروژه خود پیوند دهید.
مرحله 4: کد مورد نیاز را اضافه کنید
ادغام SKAdNetwork
برای افزودن شناسه های SKAdNetwork به فایل Info.plist
پروژه خود ، مستندات Line را دنبال کنید.
مرحله 5: اجرای خود را آزمایش کنید
فعال کردن تبلیغات آزمایشی
مطمئن شوید که دستگاه آزمایشی خود را برای AdMob ثبت کرده اید.
دستورالعمل های موجود در مستندات Line را در مورد نحوه فعال کردن تبلیغات آزمایشی Line دنبال کنید.
تبلیغات آزمایشی را تأیید کنید
برای تأیید اینکه آگهیهای آزمایشی را از Line دریافت میکنید، با استفاده از منبع(های) آگهی Line (Waterfall) آزمایش منبع آگهی را در بازرس آگهی فعال کنید.
مراحل اختیاری
پارامترهای خاص شبکه
آداپتور Line از یک پارامتر درخواست اضافی پشتیبانی می کند که می تواند با استفاده از کلاس GADMediationAdapterLineExtras
به آداپتور ارسال شود. این کلاس شامل ویژگی های زیر است:
-
adAudio
- وضعیت شروع صدای پیشفرض آگهیهای بنر، بینابینی و پاداش را مشخص میکند.
در اینجا یک نمونه کد از نحوه ایجاد یک درخواست تبلیغاتی است که این پارامترها را تنظیم می کند:
سویفت
import LineAdapter
// ...
let request = GADRequest()
let extras = GADMediationAdapterLineExtras()
extras.adAudio = GADMediationAdapterLineAdAudio.unmuted
// ...
request.register(extras)
هدف-C
#import <LineAdapter/LineAdapter.h>
// ...
GADRequest *request = [GADRequest request];
GADMediationAdapterLineExtras *extras = [[GADMediationAdapterLineExtras alloc] init];
extras.adAudio = GADMediationAdapterLineAdAudioUnmuted;
// ...
[request registerAdNetworkExtras:extras];
استفاده از تبلیغات بومی
رندر آگهی
آداپتور Line توضیحات فیلد پیشرفته تبلیغات بومی زیر را برای یک GADNativeAd
پر می کند.
میدان | دارایی ها همیشه توسط آداپتور خط گنجانده شده است |
---|---|
تیتر | |
تصویر | |
بدن | |
نماد برنامه | 1 |
فراخوان به اقدام | |
امتیاز ستاره | |
فروشگاه | |
قیمت |
1 برای تبلیغات بومی، Line SDK دارایی نماد برنامه را ارائه نمی دهد. در عوض، آداپتور Line نماد برنامه را با یک تصویر شفاف پر می کند.
کدهای خطا
اگر آداپتور نتواند تبلیغی را از Line دریافت کند، میتوانید با استفاده از GADResponseInfo.adNetworkInfoArray
در کلاسهای زیر، خطای اساسی مربوط به پاسخ آگهی را بررسی کنید:
GADMediationAdapterLine
در اینجا کدها و پیامهای همراهی هستند که توسط آداپتور Line هنگام بارگیری نشدن آگهی ارسال میشوند:
کد خطا | دامنه | دلیل |
---|---|---|
1-10 | ارسال شده توسط Line SDK | خط SDK یک خطای خاص SDK را برگرداند. برای جزئیات بیشتر به مستندات لاین مراجعه کنید. |
101 | com.google.ads.mediation.line | پارامترهای سرور نامعتبر (به عنوان مثال شناسه برنامه یا شناسه شکاف از دست رفته). |
102 | com.google.ads.mediation.line | اندازه آگهی درخواستی با اندازه آگهی بنر پشتیبانی شده خط مطابقت ندارد. |
103 | com.google.ads.mediation.line | دارایی تصویر نماد اطلاعات در آگهی بومی بارگیری نشد. |
LINE تغییرات آداپتور iOS Mediation
نسخه 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.