ادغام شبکه تبلیغات LINE با واسطه (بتا)

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

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

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

آداپتور میانجی برای LINE Ads Network دارای قابلیت های زیر است:

یکپارچه سازی
مناقصه 1
آبشار 2
فرمت ها
بنر 3
بینابینی 3
پاداش داده شد
بومی
1 ادغام مناقصه در نسخه آزمایشی بسته است، برای درخواست دسترسی با مدیر حساب خود تماس بگیرید.

2 ادغام Waterfall در نسخه بتا باز است.

3 این قالب فقط در یکپارچه سازی آبشار پشتیبانی می شود.

الزامات

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

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

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

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

مرحله 1: تنظیمات را در رابط کاربری LINE Ads Network تنظیم کنید

به حساب LINE Ads Network خود وارد شوید .

یک برنامه جدید اضافه کنید

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

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

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

یک مکان تبلیغاتی ایجاد کنید

مراحل یکسانی را برای ایجاد مکان های تبلیغاتی برای ادغام مناقصه و آبشار دنبال کنید. هر تبلیغ را می توان برای هر دو مورد استفاده قرار داد.

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

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

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

به شناسه اسلات توجه داشته باشید.

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

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

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

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

برای ایجاد یک گروه میانجی جدید، Create Mediation Group را انتخاب کنید.

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

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

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

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

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

مناقصه


در زیر کارت مناقصه در بخش منابع آگهی ، افزودن منبع آگهی را انتخاب کنید. سپس LINE Ads Network را انتخاب کنید.
روی نحوه امضای قرارداد مشارکت و تنظیم یک مشارکت در مناقصه با LINE Ads Network کلیک کنید.
روی تأیید و موافقت کلیک کنید، سپس روی ادامه کلیک کنید.
اگر قبلاً نقشه‌ای برای LINE Ads Network دارید، می‌توانید آن را انتخاب کنید. در غیر این صورت، روی افزودن نقشه کلیک کنید.
در مرحله بعد، شناسه برنامه و شناسه اسلات را که در قسمت قبل به دست آمده بود وارد کنید. سپس روی Done کلیک کنید.

آبشار


در زیر کارت Waterfall در بخش Ad Sources ، Add Source Ad را انتخاب کنید. سپس LINE Ads Network را انتخاب کنید.

LINE Ads Network را انتخاب کنید. سپس یک مقدار eCPM را برای LINE Ads Network وارد کنید و روی Continue کلیک کنید.



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

در مرحله بعد، شناسه برنامه و شناسه اسلات را که در قسمت قبل به دست آمده بود وارد کنید. سپس روی Done کلیک کنید.


مرحله 3: SDK و آداپتور LINE Ads Network را وارد کنید

خط زیر را به 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: اجرای خود را آزمایش کنید

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

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

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

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

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

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

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