این راهنما به شما نشان میدهد که چگونه از Google Mobile Ads SDK برای بارگیری و نمایش تبلیغات از شبکه LINE Ads با استفاده از میانجیگری استفاده کنید که ادغامهای آبشار را پوشش میدهد. نحوه افزودن LINE Ads Network به پیکربندی میانجی واحد تبلیغات و نحوه ادغام LINE Ads Network SDK و آداپتور را در برنامه Unity پوشش می دهد.
ادغام ها و قالب های تبلیغاتی پشتیبانی شده
را Ad Manager آداپتور میانجی برای LINE Ads Network دارای قابلیت های زیر است:
یکپارچه سازی | |
---|---|
مناقصه | |
آبشار | 1 |
فرمت ها | |
بنر | |
بینابینی | |
پاداش داده شد |
1ادغام Waterfall در نسخه بتا بسته است، برای درخواست دسترسی با مدیر حساب خود تماس بگیرید.
الزامات
- یونیتی 4 یا بالاتر
- جدیدترین SDK تبلیغات موبایل گوگل
- برای استقرار در اندروید
- Android API سطح 21 یا بالاتر
- برای استقرار در iOS
- هدف استقرار iOS 12.0 یا بالاتر
- یک پروژه واحد کاری که با Google Mobile Ads SDK پیکربندی شده است. برای جزئیات بیشتر به شروع به کار مراجعه کنید.
- راهنمای شروع میانجیگری را کامل کنید
مرحله 1: تنظیمات را در Line UI تنظیم کنید
به حساب LINE Ads Network خود وارد شوید .
یک برنامه جدید اضافه کنید
کلیک کنید広告枠管理 (مدیریت جایگاه آگهی) >メディア (رسانه) . سپس، روی新規作成 (ایجاد جدید) کلیک کنید.
فرم را پر کنید و روی登録 (ثبت نام) کلیک کنید.
به شناسه برنامه توجه داشته باشید.
یک مکان تبلیغاتی ایجاد کنید
روی شناسه برنامهای که میخواهید درج آگهی اضافه کنید کلیک کنید. سپس،詳細 (جزئیات) را انتخاب کنید.
رویスロット 追加 (افزودن شکاف) کلیک کنید.
فرم را پر کنید و پس از انجام، روی (登録) ثبت نام کلیک کنید.
به شناسه اسلات توجه داشته باشید.
مرحله 2: تقاضای شبکه تبلیغات LINE را در آن تنظیم کنید Ad Manager UI
تنظیمات میانجی را برای واحد تبلیغات خود پیکربندی کنید
اندروید
برای دستورالعملها، به مرحله 2 در راهنمای Android مراجعه کنید.
iOS
برای دستورالعملها، مرحله 2 را در راهنمای iOS ببینید.
مرحله 3: LINE Ads Network SDK و آداپتور را وارد کنید
OpenUPM-CLI
اگر OpenUPM-CLI را نصب کردهاید، میتوانید با اجرای دستور زیر از دایرکتوری ریشه پروژه خود، پلاگین میانجی شبکه تبلیغاتی Google Mobile Ads LINE Ads for Unity را در پروژه خود نصب کنید:
openupm add com.google.ads.mobile.mediation.line
OpenUPM
در ویرایشگر پروژه Unity خود، Edit > Project Settings > Package Manager را انتخاب کنید تا تنظیمات Unity Package Manager باز شود.
در برگه Scoped Registries ، OpenUPM را به عنوان یک رجیستری محدوده با جزئیات زیر اضافه کنید:
- نام:
OpenUPM
- آدرس اینترنتی:
https://package.openupm.com
- محدوده (ها):
com.google
سپس به مسیر Window > Package Manager بروید تا Unity Package Manager را باز کنید و My Registries را از منوی کشویی انتخاب کنید.
بسته Google Mobile Ads LINE Ads Network Mediation را انتخاب کنید و روی Install کلیک کنید.
پکیج یونیتی
آخرین نسخه افزونه میانجیگری تبلیغات موبایلی گوگل برای شبکه تبلیغاتی LINE را از لینک دانلود در Changelog دانلود کنید و GoogleMobileAdsLineMediation.unitypackage
را از فایل فشرده استخراج کنید.
در ویرایشگر پروژه Unity خود، Assets > Import Package > Custom Package را انتخاب کنید و فایل GoogleMobileAdsLineMediation.unitypackage
را که دانلود کرده اید پیدا کنید. مطمئن شوید که همه فایلها انتخاب شدهاند و روی Import کلیک کنید.
سپس، Assets > External Dependency Manager > Android Resolver > Force Resolve را انتخاب کنید. کتابخانه External Dependency Manager تفکیک وابستگی را از ابتدا انجام می دهد و وابستگی های اعلام شده را در فهرست Assets/Plugins/Android
برنامه Unity شما کپی می کند.
مرحله 4: کد مورد نیاز را اضافه کنید
اندروید
هیچ کد اضافی برای ادغام LINE Ads Network مورد نیاز نیست.
iOS
ادغام SKAdNetwork
مستندات LINE Ads Network را دنبال کنید تا شناسه های SKAdNetwork را به فایل Info.plist
پروژه خود اضافه کنید.
مرحله 5: اجرای خود را آزمایش کنید
فعال کردن تبلیغات آزمایشی
مطمئن شوید که دستگاه آزمایشی خود را برای AdMob ثبت کرده اید.
تبلیغات آزمایشی را تأیید کنید
برای تأیید اینکه آگهیهای آزمایشی را از شبکه LINE Ads دریافت میکنید، با استفاده از منبع(های) تبلیغات LINE Ads Network (Waterfall) آزمایش منبع آگهی را در بازرس آگهی فعال کنید.
مراحل اختیاری
پارامترهای خاص شبکه
افزونه میانجیگری LINE Ads Network 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 Ads Network دریافت کند، ناشران میتوانند با استفاده ResponseInfo
در کلاسهای زیر، خطای اساسی در پاسخ آگهی را بررسی کنند:
اندروید
com.line.ads
com.google.ads.mediation.line.LineMediationAdapter
iOS
GADMediationAdapterLine
در اینجا کدها و پیامهای همراهی وجود دارد که توسط آداپتور شبکه LINE Ads هنگام بارگیری نشدن آگهی ارسال میشود:
اندروید
کد خطا | دامنه | دلیل |
---|---|---|
1-10 | com.five_corp.ad | LINE Ads Network SDK یک خطای خاص SDK را برگرداند. برای جزئیات بیشتر به مستندات LINE Ads Network مراجعه کنید. |
101 | com.google.ads.mediation.line | شناسه برنامه موجود نیست یا نامعتبر است. |
102 | com.google.ads.mediation.line | شناسه اسلات وجود ندارد یا نامعتبر است. |
103 | com.google.ads.mediation.line | اندازه تبلیغ درخواستی با اندازه تبلیغات بنری پشتیبانی شده از شبکه LINE Ads مطابقت ندارد. |
104 | com.google.ads.mediation.line | به دلیل نداشتن زمینه فعالیت، یک آگهی بینابینی یا پاداش بارگیری نشد. |
105 | com.google.ads.mediation.line | LINE Ads Network SDK نتوانست یک تبلیغ بینابینی یا دارای پاداش را نشان دهد. |
106 | com.google.ads.mediation.line | به دلیل کمبود دارایی، آگهی بومی بارگیری نشد. |
iOS
کد خطا | دامنه | دلیل |
---|---|---|
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 | دارایی تصویر نماد اطلاعات در آگهی بومی بارگیری نشد. |
لاین Unity Mediation Plugin Changelog
نسخه 1.4.0
- از آداپتور لاین اندروید نسخه 2.8.20240827.0 پشتیبانی می کند.
- از آداپتور Line iOS نسخه 2.9.20241106.1 پشتیبانی می کند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.4.0.
نسخه 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 ساخته و آزمایش شده است.