ادغام LINE Ads Network با واسطه

این راهنما به شما نشان می‌دهد که چگونه از SDK تبلیغات موبایل گوگل برای بارگذاری و نمایش تبلیغات از شبکه تبلیغات لاین با استفاده از AdMob Mediation استفاده کنید و ادغام‌های آبشاری را پوشش می‌دهد. این راهنما نحوه اضافه کردن شبکه تبلیغات لاین به پیکربندی میانجیگری یک واحد تبلیغاتی و نحوه ادغام SDK و آداپتور شبکه تبلیغات لاین در یک برنامه iOS را پوشش می‌دهد.

رابط کاربری داشبورد شبکه تبلیغات لاین از متن ژاپنی برای برچسب‌ها، دکمه‌ها و توضیحات استفاده می‌کند. تصاویر موجود در این راهنما ترجمه نشده‌اند. با این حال، در توضیحات و دستورالعمل‌های این راهنما، برچسب‌ها و دکمه‌ها با معادل‌های انگلیسی آنها در داخل پرانتز ترجمه شده‌اند.

ادغام‌ها و قالب‌های تبلیغاتی پشتیبانی‌شده

آداپتور میانجیگری برای شبکه تبلیغات LINE دارای قابلیت‌های زیر است:

^۱ تبلیغات بومی (برای پیشنهاد قیمت) در مرحله بتای بسته است، برای درخواست دسترسی با مدیر حساب خود تماس بگیرید.

الزامات

• هدف استقرار iOS 12.0 یا بالاتر

• [برای پیشنهاد قیمت]: برای ادغام تمام قالب‌های تبلیغاتی پشتیبانی‌شده در پیشنهاد قیمت، از آداپتور شبکه LINE Ads نسخه ۲.۸.۲۰۲۴۰۸۲۷.۰ یا بالاتر استفاده کنید ( آخرین نسخه توصیه می‌شود )

• جدیدترین SDK تبلیغات موبایلی گوگل

• راهنمای شروع میانجیگری را تکمیل کنید

مرحله ۱: تنظیمات را در رابط کاربری شبکه تبلیغات لاین (LINE Ads Network UI) انجام دهید

ثبت نام کنید و وارد حساب کاربری شبکه تبلیغات LINE خود شوید .

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

کلیک کنید広告枠管理 (مدیریت جایگاه آگهی) >メディア (رسانه) . سپس، روی新規作成 (ایجاد جدید) کلیک کنید.

فرم را پر کنید و روی登録 (ثبت نام) کلیک کنید.

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

ایجاد جایگاه تبلیغات

روی شناسه برنامه‌ای که می‌خواهید محل قرارگیری تبلیغ را اضافه کنید، کلیک کنید. سپس،詳細 (جزئیات) را انتخاب کنید.

رویスロット 追加 (افزودن شکاف) کلیک کنید.

برای جزئیات بیشتر در مورد اسلات، فرم را پر کنید. برای نوع پیشنهاد ، گزینه استاندارد را برای پیکربندی این اسلات برای میانجیگری آبشاری یا گزینه Google SDK Bidding را برای پیکربندی این اسلات برای پیشنهاد انتخاب کنید. پس از پر کردن فرم، روی登録 (ثبت نام) کلیک کنید.

به شناسه اسلات (Slot ID) توجه کنید.

فایل app-ads.txt خود را به‌روزرسانی کنید.

فروشندگان مجاز برنامه‌ها app-ads.txt یک ابتکار آزمایشگاه فناوری IAB است که به شما کمک می‌کند تا موجودی تبلیغات برنامه خود را فقط از طریق کانال‌هایی که به عنوان مجاز شناسایی کرده‌اید، به فروش برسانید. برای جلوگیری از کاهش قابل توجه درآمد تبلیغات، باید یک فایل app-ads.txt پیاده‌سازی کنید. اگر قبلاً این کار را نکرده‌اید، یک فایل app-ads.txt برای برنامه خود تنظیم کنید .

برای پیاده‌سازی app-ads.txt برای شبکه تبلیغات LINE، به بخش «درباره app-ads.txt» مراجعه کنید.

مرحله ۲: تنظیم تقاضای شبکه تبلیغات لاین در رابط کاربری ادموب

تنظیمات میانجیگری را برای واحد تبلیغاتی خود پیکربندی کنید

شما باید شبکه تبلیغات لاین (LINE Ads Network) را به پیکربندی میانجیگری برای واحد تبلیغاتی خود اضافه کنید.

ابتدا، وارد حساب کاربری AdMob خود شوید. سپس، به برگه Mediation بروید. اگر یک گروه میانجیگری موجود دارید که می‌خواهید آن را تغییر دهید، روی نام آن گروه میانجیگری کلیک کنید تا آن را ویرایش کنید و به مرحله بعد بروید و شبکه تبلیغات LINE را به عنوان منبع تبلیغات اضافه کنید .

برای ایجاد یک گروه میانجیگری جدید، گزینه «ایجاد گروه میانجیگری» را انتخاب کنید.

قالب و پلتفرم تبلیغ خود را وارد کنید، سپس روی ادامه کلیک کنید.

به گروه میانجیگری خود یک نام بدهید و مکان‌هایی را برای هدف قرار دادن انتخاب کنید. در مرحله بعد، وضعیت گروه میانجیگری را روی فعال (Enabled) تنظیم کنید و سپس روی افزودن واحدهای تبلیغاتی (Add Ad Units) کلیک کنید.

این گروه میانجی را با یک یا چند واحد تبلیغاتی AdMob موجود خود مرتبط کنید. سپس روی «انجام شد» کلیک کنید.

اکنون باید کارت واحدهای تبلیغاتی را ببینید که با واحدهای تبلیغاتی که انتخاب کرده‌اید پر شده است:

شبکه تبلیغات LINE را به عنوان منبع تبلیغات اضافه کنید

مناقصه

در قسمت «منابع تبلیغات» ، زیر کارت پیشنهاد قیمت ، گزینه «افزودن منبع تبلیغات» را انتخاب کنید. سپس «شبکه تبلیغات لاین» را انتخاب کنید.

روی نحوه امضای قرارداد مشارکت و تنظیم مشارکت در مناقصه با شبکه تبلیغات LINE کلیک کنید.



روی تأیید و موافقت کلیک کنید، سپس روی ادامه کلیک کنید.



اگر از قبل برای شبکه تبلیغات لاین، نگاشتی دارید، می‌توانید آن را انتخاب کنید. در غیر این صورت، روی افزودن نگاشت کلیک کنید.



در مرحله بعد، شناسه برنامه و شناسه اسلات (Slot ID) که در بخش قبل به دست آورده‌اید را وارد کنید. سپس روی «انجام شد» (Done) کلیک کنید.

آبشار

در زیر کارت Waterfall در بخش Ad Sources ، گزینه Add Ad Source را انتخاب کنید.

شبکه تبلیغات لاین (LINE Ads Network) را انتخاب کنید و کلید بهینه‌سازی (Optimize) را فعال کنید. نام کاربری و رمز عبوری که در بخش قبل به دست آوردید را وارد کنید تا بهینه‌سازی منبع تبلیغات برای شبکه تبلیغات لاین (LINE Ads Network) را تنظیم کنید. سپس یک مقدار eCPM برای شبکه تبلیغات لاین وارد کنید و روی ادامه کلیک کنید.



اگر از قبل برای شبکه تبلیغات لاین، نگاشتی دارید، می‌توانید آن را انتخاب کنید. در غیر این صورت، روی افزودن نگاشت کلیک کنید.

در مرحله بعد، شناسه برنامه و شناسه اسلات (Slot ID) که در بخش قبل به دست آورده‌اید را وارد کنید. سپس روی «انجام شد» (Done) کلیک کنید.

مرحله ۳: SDK و آداپتور شبکه تبلیغات لاین را وارد کنید

استفاده از CocoaPods (توصیه می‌شود)

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

pod 'GoogleMobileAdsMediationLine'

از خط فرمان اجرا کنید:

pod install --repo-update

ادغام دستی

• آخرین نسخه کیت توسعه نرم‌افزاری شبکه تبلیغات لاین (LINE Ads Network SDK) را دانلود کنید و FiveAd.framework به پروژه خود لینک دهید.
• آخرین نسخه آداپتور شبکه LINE Ads را از لینک دانلود در Changelog دانلود کنید و LineAdapter.framework در پروژه خود لینک دهید.

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

ادغام شبکه SKAd

برای افزودن شناسه‌های SKAdNetwork به فایل Info.plist پروژه خود ، مستندات شبکه تبلیغات LINE را دنبال کنید.

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

فعال کردن تبلیغات آزمایشی

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

تأیید تبلیغات آزمایشی

برای تأیید اینکه تبلیغات آزمایشی را از شبکه تبلیغات LINE دریافت می‌کنید، آزمایش منبع تبلیغاتی واحد را در بازرس تبلیغات با استفاده از منبع(های ) تبلیغاتی شبکه تبلیغات LINE (آبشاری ) فعال کنید.

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

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

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

adAudio

حالت پیش‌فرض شروع صدا برای تبلیغات بنری، بینابینی و جایزه‌دار را مشخص می‌کند.

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

import LineAdapter
// ...

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

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

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

استفاده از تبلیغات بومی

رندرینگ آگهی

آداپتور شبکه تبلیغات LINE توضیحات پیشرفته فیلد تبلیغات بومی زیر را برای GADNativeAd پر می‌کند.

^۱ برای تبلیغات بومی، کیت توسعه نرم‌افزار شبکه تبلیغات لاین (LINE Ads Network SDK) آیکون برنامه را ارائه نمی‌دهد. در عوض، آداپتور شبکه تبلیغات لاین (LINE Ads Network) آیکون برنامه را با یک تصویر شفاف پر می‌کند.

کدهای خطا

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

GADMediationAdapterLine

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

لیست تغییرات آداپتور میانجیگری LINE iOS

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

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

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

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

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

• آداپتور اکنون قبل از هر درخواست تبلیغ، FiveAd SDK را مقداردهی اولیه می‌کند.
• سازگاری تأیید شده با FiveAd SDK نسخه ۲.۹.۲۰۲۵۰۹۱۲.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• CFBundleShortVersionString به‌روزرسانی شد تا به جای چهار جزء، سه جزء داشته باشد.

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

• نسخه ۱۱.۱۰.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• نسخه SDK فایو اد ۲.۸.۲۰۲۴۰۸۲۷.

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

• سازگاری تأیید شده با FiveAd SDK نسخه ۲.۸.۲۰۲۴۰۸۲۷.
• پشتیبانی از پیشنهاد قیمت برای قالب‌های تبلیغات بنری، بینابینی، پاداشی و بومی اضافه شد.

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

• نسخه ۱۱.۸.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• نسخه SDK فایو اد ۲.۸.۲۰۲۴۰۸۲۷.

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

• کنترل صدا برای تبلیغات بومی از طریق GADVideoOptions اضافه شد.
• سازگاری تأیید شده با FiveAd SDK نسخه ۲.۸.۲۰۲۴۰۶۱۲.

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

• نسخه ۱۱.۵.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• نسخه SDK فایو اد ۲.۸.۲۰۲۴۰۶۱۲.

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

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

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

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

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

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

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

• نسخه ۱۱.۲.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• نسخه SDK فایو اد ۲.۷.۲۰۲۴۰۳۱۸.

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

• اکنون به حداقل نسخه iOS 12.0 نیاز دارد.
• اکنون به نسخه ۱۱.۰ یا بالاتر SDK تبلیغات موبایل گوگل نیاز دارد.
• Info.plist در چارچوب‌های موجود در LineAdapter.xcframework گنجانده شده است.

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

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

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

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

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

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

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

• سازگاری تأیید شده با FiveAd SDK نسخه ۲.۷.۲۰۲۴۰۱۲۶.
• پیاده‌سازی آداپتور با پروتکل‌های نماینده جدید FiveAd SDK به‌روزرسانی شد.

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

• نسخه ۱۰.۱۴.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• نسخه SDK فایو اد ۲.۷.۲۰۲۴۰۱۲۶.

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

• سازگاری تأیید شده با FiveAd SDK نسخه ۲.۷.۲۰۲۳۱۱۱۵.
• هدر GADMediationAdapterLineExtras در modulemap گنجانده شده است.

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

• نسخه ۱۰.۱۴.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• نسخه SDK فایو اد ۲.۷.۲۰۲۳۱۱۱۵.

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

• GADMediationAdapterLineAudioState برای مدیریت وضعیت صوتی اولیه بنر، تبلیغات بینابینی و تبلیغات جایزه‌دار هنگام اولین نمایش، اضافه شد.

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

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

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

• انتشار اولیه!
• پشتیبانی از قالب‌های تبلیغات آبشاری (waterfall) برای بنر، بینابینی، پاداشی و بومی اضافه شد.
• سازگاری تأیید شده با FiveAd SDK نسخه ۲.۶.۲۰۲۳۰۶۰۹.

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

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