این راهنما به شما نشان می‌دهد که چگونه از Google Mobile Ads SDK برای بارگیری و نمایش تبلیغات از Line با استفاده از میانجیگری استفاده کنید که ادغام‌های آبشار را پوشش می‌دهد. نحوه افزودن Line به پیکربندی میانجی واحد تبلیغاتی و نحوه ادغام Line SDK و آداپتور در یک برنامه Unity را پوشش می دهد.
ادغام ها و قالب های تبلیغاتی پشتیبانی شده
را AdMob آداپتور میانجی برای Line دارای قابلیت های زیر است:
| یکپارچه سازی | |
|---|---|
| مناقصه | |
| آبشار | 1 |
| فرمت ها | |
| بنر | |
| بینابینی | |
| پاداش داده شد | |
1ادغام Waterfall در نسخه بتا باز است.
الزامات
- یونیتی 4 یا بالاتر
- جدیدترین SDK تبلیغات موبایل گوگل
- برای استقرار در اندروید
- Android API سطح 21 یا بالاتر
- برای استقرار در iOS
- هدف استقرار iOS 12.0 یا بالاتر
- یک پروژه واحد کاری که با Google Mobile Ads SDK پیکربندی شده است. برای جزئیات بیشتر به شروع به کار مراجعه کنید.
- راهنمای شروع میانجیگری را کامل کنید
مرحله 1: تنظیمات را در Line UI تنظیم کنید
یک برنامه جدید اضافه کنید
کلیک کنید広告枠管理 (مدیریت جایگاه آگهی) >メディア (رسانه) . سپس، روی新規作成 (ایجاد جدید) کلیک کنید.
فرم را پر کنید و روی登録 (ثبت نام) کلیک کنید.
به شناسه برنامه توجه داشته باشید.
یک مکان تبلیغاتی ایجاد کنید
روی شناسه برنامه‌ای که می‌خواهید درج آگهی اضافه کنید کلیک کنید. سپس،詳細 (جزئیات) را انتخاب کنید.
رویスロット 追加 (افزودن شکاف) کلیک کنید.
فرم را پر کنید و پس از انجام، روی (登録) ثبت نام کلیک کنید.
به شناسه اسلات توجه داشته باشید.
مرحله 2: تقاضای خط را در آن تنظیم کنید AdMob UI
تنظیمات میانجی را برای واحد تبلیغات خود پیکربندی کنید
اندروید
برای دستورالعمل‌ها، مرحله 2 را در راهنما ببینیداندروید .
iOS
برای دستورالعمل‌ها، مرحله 2 را در راهنما ببینیدiOS .
مرحله 3: Line SDK و آداپتور را وارد کنید
آخرین نسخه افزونه میانجی گری تبلیغات موبایل گوگل را برای لاین از لینک دانلود در Changelog دانلود کنید و GoogleMobileAdsLineMediation.unitypackage را از فایل فشرده استخراج کنید.
در ویرایشگر پروژه Unity خود، Assets > Import Package > Custom Package را انتخاب کنید و فایل GoogleMobileAdsLineMediation.unitypackage را که دانلود کرده اید پیدا کنید. مطمئن شوید که همه فایل‌ها انتخاب شده‌اند و روی Import کلیک کنید.
سپس، Assets > Play Services Resolver > Android Resolver > Force Resolve را انتخاب کنید. کتابخانه Unity Play Services Resolver تفکیک وابستگی‌ها را از ابتدا انجام می‌دهد و وابستگی‌های اعلام‌شده را در فهرست Assets/Plugins/Android برنامه Unity شما کپی می‌کند.
مرحله 4: کد مورد نیاز را اضافه کنید
اندروید
هیچ کد اضافی برای ادغام خط مورد نیاز نیست.
iOS
ادغام SKAdNetwork
برای افزودن شناسه های SKAdNetwork به فایل Info.plist پروژه خود ، مستندات Line را دنبال کنید.
مرحله 5: اجرای خود را آزمایش کنید
مراحل اختیاری
پارامترهای خاص شبکه
افزونه میانجی Line Unity از پارامتر درخواست اضافی زیر پشتیبانی می کند که می تواند از طریق کلاس LineMediationExtras به آداپتور ارسال شود:
-
SetEnableAdSound(boolean): وضعیت شروع صدای پیش‌فرض آگهی‌های بنر، بینابینی و پاداش را مشخص می‌کند.
در اینجا یک نمونه کد از نحوه ایجاد یک درخواست تبلیغاتی است که این پارامترها را تنظیم می کند:
using GoogleMobileAds.Api;
using GoogleMobileAds.Mediation.Line.Api;
// ...
var adRequest = new AdRequest();
var lineExtras = new LineMediationExtras();
lineExtras.SetEnableAdSound(true);
adRequest.MediationExtras.Add(lineExtras);
کدهای خطا
اگر آداپتور نتواند تبلیغی را از Line دریافت کند، ناشران می‌توانند با استفاده از ResponseInfo در کلاس‌های زیر، خطای اساسی در پاسخ آگهی را بررسی کنند:
اندروید
com.line.ads
com.google.ads.mediation.line.LineMediationAdapter
iOS
GADMediationAdapterLine
در اینجا کدها و پیام‌های همراهی هستند که توسط آداپتور Line هنگام بارگیری نشدن آگهی ارسال می‌شوند:
اندروید
| کد خطا | دامنه | دلیل |
|---|---|---|
| 1-10 | com.five_corp.ad | خط SDK یک خطای خاص SDK را برگرداند. برای جزئیات بیشتر به مستندات لاین مراجعه کنید. |
| 101 | com.google.ads.mediation.line | شناسه برنامه موجود نیست یا نامعتبر است. |
| 102 | com.google.ads.mediation.line | شناسه اسلات وجود ندارد یا نامعتبر است. |
| 103 | com.google.ads.mediation.line | اندازه آگهی درخواستی با اندازه آگهی بنر پشتیبانی شده خط مطابقت ندارد. |
| 104 | com.google.ads.mediation.line | به دلیل نداشتن زمینه فعالیت، یک آگهی بینابینی یا پاداش بارگیری نشد. |
| 105 | com.google.ads.mediation.line | Line SDK نتوانست یک تبلیغ بینابینی یا دارای پاداش را نشان دهد. |
| 106 | com.google.ads.mediation.line | به دلیل کمبود دارایی، آگهی بومی بارگیری نشد. |
iOS
| کد خطا | دامنه | دلیل |
|---|---|---|
| 1-10 | ارسال شده توسط Line SDK | خط SDK یک خطای خاص SDK را برگرداند. برای جزئیات بیشتر به مستندات لاین مراجعه کنید. |
| 101 | com.google.ads.mediation.line | پارامترهای سرور نامعتبر (به عنوان مثال شناسه برنامه یا شناسه شکاف از دست رفته). |
| 102 | com.google.ads.mediation.line | اندازه آگهی درخواستی با اندازه آگهی بنر پشتیبانی شده خط مطابقت ندارد. |
| 103 | com.google.ads.mediation.line | دارایی تصویر نماد اطلاعات در آگهی بومی بارگیری نشد. |
لاین وحدت میانجی پلاگین تغییر
نسخه 1.3.1
- از آداپتور لاین اندروید نسخه 2.8.20240808.0 پشتیبانی می کند.
- از آداپتور Line iOS نسخه 2.8.20240612.0 پشتیبانی می کند.
- با افزونه Google Mobile Ads Unity نسخه 9.2.0 ساخته و آزمایش شده است.
نسخه 1.3.0
- از آداپتور لاین اندروید نسخه 2.8.20240722.0 پشتیبانی می کند.
- از آداپتور Line iOS نسخه 2.8.20240612.0 پشتیبانی می کند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.2.0.
نسخه 1.2.0
- از آداپتور لاین اندروید نسخه 2.7.20240515.0 پشتیبانی می کند.
- از آداپتور Line iOS نسخه 2.8.20240612.0 پشتیبانی می کند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.1.1.
نسخه 1.1.2
- از آداپتور لاین اندروید نسخه 2.7.20240515.0 پشتیبانی می کند.
- از آداپتور Line iOS نسخه 2.7.20240411.0 پشتیبانی می کند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.1.0.
نسخه 1.1.1
- از آداپتور لاین اندروید نسخه 2.7.20240214.1 پشتیبانی می کند.
- از آداپتور Line iOS نسخه 2.7.20240411.0 پشتیبانی می کند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.1.0.
نسخه 1.1.0
- کلاس
LineMediationExtrasرا با متدهای زیر برای پشتیبانی از انتقال اضافی واسطه اضافه کرد.-
SetEnabledAdSound(bool)
-
- از آداپتور لاین اندروید نسخه 2.7.20240214.1 پشتیبانی می کند.
- از آداپتور Line iOS نسخه 2.7.20240318.0 پشتیبانی می کند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.0.0.
نسخه 1.0.0
- انتشار اولیه.
- از آداپتور لاین اندروید نسخه 2.6.20230607.0 پشتیبانی می کند.
- از آداپتور Line iOS نسخه 2.6.20230609.0 پشتیبانی می کند.
- با افزونه Google Mobile Ads Unity نسخه 8.5.1 ساخته و آزمایش شده است.
این راهنما به شما نشان می‌دهد که چگونه از Google Mobile Ads SDK برای بارگیری و نمایش تبلیغات از Line با استفاده از میانجیگری استفاده کنید که ادغام‌های آبشار را پوشش می‌دهد. نحوه افزودن Line به پیکربندی میانجی واحد تبلیغاتی و نحوه ادغام Line SDK و آداپتور در یک برنامه Unity را پوشش می دهد.
ادغام ها و قالب های تبلیغاتی پشتیبانی شده
را AdMob آداپتور میانجی برای Line دارای قابلیت های زیر است:
| یکپارچه سازی | |
|---|---|
| مناقصه | |
| آبشار | 1 |
| فرمت ها | |
| بنر | |
| بینابینی | |
| پاداش داده شد | |
1ادغام Waterfall در نسخه بتا باز است.
الزامات
- یونیتی 4 یا بالاتر
- جدیدترین SDK تبلیغات موبایل گوگل
- برای استقرار در اندروید
- Android API سطح 21 یا بالاتر
- برای استقرار در iOS
- هدف استقرار iOS 12.0 یا بالاتر
- یک پروژه واحد کاری که با Google Mobile Ads SDK پیکربندی شده است. برای جزئیات بیشتر به شروع به کار مراجعه کنید.
- راهنمای شروع میانجیگری را کامل کنید
مرحله 1: تنظیمات را در Line UI تنظیم کنید
یک برنامه جدید اضافه کنید
کلیک کنید広告枠管理 (مدیریت جایگاه آگهی) >メディア (رسانه) . سپس، روی新規作成 (ایجاد جدید) کلیک کنید.
فرم را پر کنید و روی登録 (ثبت نام) کلیک کنید.
به شناسه برنامه توجه داشته باشید.
یک مکان تبلیغاتی ایجاد کنید
روی شناسه برنامه‌ای که می‌خواهید درج آگهی اضافه کنید کلیک کنید. سپس،詳細 (جزئیات) را انتخاب کنید.
رویスロット 追加 (افزودن شکاف) کلیک کنید.
فرم را پر کنید و پس از انجام، روی (登録) ثبت نام کلیک کنید.
به شناسه اسلات توجه داشته باشید.
مرحله 2: تقاضای خط را در آن تنظیم کنید AdMob UI
تنظیمات میانجی را برای واحد تبلیغات خود پیکربندی کنید
اندروید
برای دستورالعمل‌ها، مرحله 2 را در راهنما ببینیداندروید .
iOS
برای دستورالعمل‌ها، مرحله 2 را در راهنما ببینیدiOS .
مرحله 3: Line SDK و آداپتور را وارد کنید
آخرین نسخه افزونه میانجی گری تبلیغات موبایل گوگل را برای لاین از لینک دانلود در Changelog دانلود کنید و GoogleMobileAdsLineMediation.unitypackage را از فایل فشرده استخراج کنید.
در ویرایشگر پروژه Unity خود، Assets > Import Package > Custom Package را انتخاب کنید و فایل GoogleMobileAdsLineMediation.unitypackage را که دانلود کرده اید پیدا کنید. مطمئن شوید که همه فایل‌ها انتخاب شده‌اند و روی Import کلیک کنید.
سپس، Assets > Play Services Resolver > Android Resolver > Force Resolve را انتخاب کنید. کتابخانه Unity Play Services Resolver تفکیک وابستگی‌ها را از ابتدا انجام می‌دهد و وابستگی‌های اعلام‌شده را در فهرست Assets/Plugins/Android برنامه Unity شما کپی می‌کند.
مرحله 4: کد مورد نیاز را اضافه کنید
اندروید
هیچ کد اضافی برای ادغام خط مورد نیاز نیست.
iOS
ادغام SKAdNetwork
برای افزودن شناسه های SKAdNetwork به فایل Info.plist پروژه خود ، مستندات Line را دنبال کنید.
مرحله 5: اجرای خود را آزمایش کنید
مراحل اختیاری
پارامترهای خاص شبکه
افزونه میانجی Line Unity از پارامتر درخواست اضافی زیر پشتیبانی می کند که می تواند از طریق کلاس LineMediationExtras به آداپتور ارسال شود:
-
SetEnableAdSound(boolean): وضعیت شروع صدای پیش‌فرض آگهی‌های بنر، بینابینی و پاداش را مشخص می‌کند.
در اینجا یک نمونه کد از نحوه ایجاد یک درخواست تبلیغاتی است که این پارامترها را تنظیم می کند:
using GoogleMobileAds.Api;
using GoogleMobileAds.Mediation.Line.Api;
// ...
var adRequest = new AdRequest();
var lineExtras = new LineMediationExtras();
lineExtras.SetEnableAdSound(true);
adRequest.MediationExtras.Add(lineExtras);
کدهای خطا
اگر آداپتور نتواند تبلیغی را از Line دریافت کند، ناشران می‌توانند با استفاده از ResponseInfo در کلاس‌های زیر، خطای اساسی در پاسخ آگهی را بررسی کنند:
اندروید
com.line.ads
com.google.ads.mediation.line.LineMediationAdapter
iOS
GADMediationAdapterLine
در اینجا کدها و پیام‌های همراهی هستند که توسط آداپتور Line هنگام بارگیری نشدن آگهی ارسال می‌شوند:
اندروید
| کد خطا | دامنه | دلیل |
|---|---|---|
| 1-10 | com.five_corp.ad | خط SDK یک خطای خاص SDK را برگرداند. برای جزئیات بیشتر به مستندات لاین مراجعه کنید. |
| 101 | com.google.ads.mediation.line | شناسه برنامه موجود نیست یا نامعتبر است. |
| 102 | com.google.ads.mediation.line | شناسه اسلات وجود ندارد یا نامعتبر است. |
| 103 | com.google.ads.mediation.line | اندازه آگهی درخواستی با اندازه آگهی بنر پشتیبانی شده خط مطابقت ندارد. |
| 104 | com.google.ads.mediation.line | به دلیل نداشتن زمینه فعالیت، یک آگهی بینابینی یا پاداش بارگیری نشد. |
| 105 | com.google.ads.mediation.line | Line SDK نتوانست یک تبلیغ بینابینی یا دارای پاداش را نشان دهد. |
| 106 | com.google.ads.mediation.line | به دلیل کمبود دارایی، تبلیغ بومی بارگیری نشد. |
iOS
| کد خطا | دامنه | دلیل |
|---|---|---|
| 1-10 | ارسال شده توسط Line SDK | خط SDK یک خطای خاص SDK را برگرداند. برای جزئیات بیشتر به مستندات لاین مراجعه کنید. |
| 101 | com.google.ads.mediation.line | پارامترهای سرور نامعتبر (به عنوان مثال شناسه برنامه یا شناسه شکاف از دست رفته). |
| 102 | com.google.ads.mediation.line | اندازه آگهی درخواستی با اندازه آگهی بنر پشتیبانی شده خط مطابقت ندارد. |
| 103 | com.google.ads.mediation.line | دارایی تصویر نماد اطلاعات در آگهی بومی بارگیری نشد. |
لاین یونیتی میانجی پلاگین تغییرات
نسخه 1.3.1
- از آداپتور لاین اندروید نسخه 2.8.20240808.0 پشتیبانی می کند.
- از آداپتور Line iOS نسخه 2.8.20240612.0 پشتیبانی می کند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.2.0.
نسخه 1.3.0
- از آداپتور لاین اندروید نسخه 2.8.20240722.0 پشتیبانی می کند.
- از آداپتور Line iOS نسخه 2.8.20240612.0 پشتیبانی می کند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.2.0.
نسخه 1.2.0
- از آداپتور لاین اندروید نسخه 2.7.20240515.0 پشتیبانی می کند.
- از آداپتور Line iOS نسخه 2.8.20240612.0 پشتیبانی می کند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.1.1.
نسخه 1.1.2
- از آداپتور لاین اندروید نسخه 2.7.20240515.0 پشتیبانی می کند.
- از آداپتور Line iOS نسخه 2.7.20240411.0 پشتیبانی می کند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.1.0.
نسخه 1.1.1
- از آداپتور لاین اندروید نسخه 2.7.20240214.1 پشتیبانی می کند.
- از آداپتور Line iOS نسخه 2.7.20240411.0 پشتیبانی می کند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.1.0.
نسخه 1.1.0
- کلاس
LineMediationExtrasرا با متدهای زیر برای پشتیبانی از انتقال اضافی واسطه اضافه کرد.-
SetEnabledAdSound(bool)
-
- از آداپتور لاین اندروید نسخه 2.7.20240214.1 پشتیبانی می کند.
- از آداپتور Line iOS نسخه 2.7.20240318.0 پشتیبانی می کند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.0.0.
نسخه 1.0.0
- انتشار اولیه.
- از آداپتور لاین اندروید نسخه 2.6.20230607.0 پشتیبانی می کند.
- از آداپتور Line iOS نسخه 2.6.20230609.0 پشتیبانی می کند.
- با افزونه Google Mobile Ads Unity نسخه 8.5.1 ساخته و آزمایش شده است.