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

این راهنما به شما نشان می‌دهد که چگونه از SDK تبلیغات موبایل گوگل برای بارگذاری و نمایش تبلیغات از شبکه تبلیغات لاین با استفاده از میانجیگری استفاده کنید و ادغام‌های آبشاری را پوشش می‌دهد. این راهنما نحوه اضافه کردن شبکه تبلیغات لاین به پیکربندی میانجیگری یک واحد تبلیغاتی و نحوه ادغام 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 برای Ad Manager ایجاد کنید .

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

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

وارد حساب مدیر تبلیغات خود شوید.

شبکه تبلیغات LINE را در شرکت‌ها اضافه کنید

فعال کردن اشتراک‌گذاری امن سیگنال

سیگنال امن را در درخواست‌های پیشنهاد به اشتراک بگذارید

امکان اشتراک‌گذاری امن سیگنال برای مناقصه SDK

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

پیکربندی نگاشت واحد تبلیغات

مرحله ۳: 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 را دنبال کنید.

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

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

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

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

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

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

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

آداپتور شبکه LINE Ads از یک پارامتر درخواست اضافی پشتیبانی می‌کند که می‌تواند با استفاده از کلاس 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];

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

رندرینگ آگهی

آداپتور شبکه تبلیغات 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 فایو اد ۲.۶.۲۰۲۳۰۶۰۹.