این راهنما به شما نشان میدهد که چگونه از Google Mobile Ads SDK برای بارگیری و نمایش تبلیغات از nend با استفاده از میانجیگری استفاده کنید که ادغامهای آبشار را پوشش میدهد. نحوه افزودن nend به پیکربندی میانجی واحد تبلیغات و نحوه ادغام nend SDK و آداپتور در برنامه Unity را پوشش میدهد.
رابط داشبورد برای nend از متن ژاپنی برای برچسبها، دکمهها و توضیحات خود استفاده میکند و تصاویر نمایش داده شده در زیر ترجمه نشدهاند. اما در متن این راهنما، برچسبها و دکمهها با نام انگلیسیشان ارجاع داده میشوند. برای مثال "URL スキーム"، "URL Scheme" و غیره است.
ادغام ها و قالب های تبلیغاتی پشتیبانی شده
ادغام | |
---|---|
مناقصه | |
آبشار | |
فرمت ها | |
بنر | |
بینابینی | |
پاداش داده شد |
الزامات
- یونیتی 4 یا بالاتر
- جدیدترین SDK تبلیغات موبایل گوگل
- برای استقرار در اندروید
- Android API سطح 21 یا بالاتر
- برای استقرار در iOS
- هدف استقرار iOS 12.0 یا بالاتر
- یک پروژه واحد کاری که با Google Mobile Ads SDK پیکربندی شده است. برای جزئیات بیشتر به شروع به کار مراجعه کنید.
- راهنمای شروع میانجیگری را کامل کنید
مرحله 1: تنظیمات را در nend UI تنظیم کنید
ثبت نام کنید یا به حساب کاربری خود وارد شوید .
برای افزودن برنامه خود به داشبورد nend، ابتدا روی برگه مدیریت مکان کلیک کنید و سپس سایت/برنامه را انتخاب کنید. روی دکمه افزودن برنامه کلیک کنید تا برنامه خود را برای پایان اضافه کنید.
یک برنامه کاربردی ایجاد کنید
نام برنامه خود را وارد کنید و پلتفرم برنامه خود را به عنوان نوع برنامه انتخاب کنید. URL را وارد کنید و بررسی کنید که آیا برنامه شما در فروشگاه برنامه مناسب فهرست شده است یا خیر
(اگر برنامه شما هنوز منتشر نشده است، به سؤالات متداول برنامه های منتشر نشده nend مراجعه کنید). یک دسته برای برنامه خود انتخاب کنید و پس از اتمام روی ایجاد کلیک کنید.
اندروید
iOS
برنامه شما پس از ایجاد روی داشبورد نشان داده می شود.
اندروید
iOS
یک مکان ایجاد کنید
پس از ثبت برنامه، می توانید به سمت ایجاد یک مکان بروید. برای ایجاد یک مکان برای تبلیغات بنری، به تب Placement Management رفته و روی Placement کلیک کنید. سپس روی دکمه Create a new placement کلیک کنید.
برنامه خود را در منوی کشویی انتخاب کنید. سپس، دستورالعملهای زیر را که با قالب تبلیغاتی دلخواه شما مطابقت دارد، دنبال کنید.
بنر
تصویر ثابت را برای نوع آگهی و بنر را برای نوع موجودی انتخاب کنید. پس از انجام این کار، نام مکان را وارد کنید، مقدمه موجودی را پر کنید، قالب موجودی را انتخاب کنید و در نهایت اندازه موجودی را انتخاب کنید. پس از اتمام، روی دکمه ایجاد کلیک کنید تا مکان خود را ایجاد کنید.
بینابینی
تصویر ثابت را برای نوع آگهی و بینابینی را برای نوع موجودی انتخاب کنید. پس از انجام این کار، نام مکان را وارد کنید، مقدمه موجودی را پر کنید و تعداد دفعات نمایش آگهی را از لیست کشویی انتخاب کنید. پس از اتمام، روی دکمه ایجاد کلیک کنید تا مکان خود را ایجاد کنید.
برای تبلیغات ویدیویی بینابینی، ویدیو را برای نوع آگهی و بینابینی را برای نوع موجودی انتخاب کنید. پس از انجام این کار، یک نام مکان وارد کنید، مقدمه موجودی را پر کنید و یک دسته مناسب را از لیست کشویی انتخاب کنید. پس از اتمام، روی دکمه ایجاد کلیک کنید تا مکان خود را ایجاد کنید.
پاداش داده شد
ویدیو را برای نوع تبلیغ و پاداش برای نوع موجودی را انتخاب کنید. پس از انجام این کار، یک نام مکان وارد کنید، مقدمه موجودی را پر کنید و یک دسته مناسب را از لیست کشویی انتخاب کنید.
در قسمت تنظیمات پاداش ، یک محتوای پاداش را با استفاده از لیست کشویی انتخاب کنید، نام ارز مجازی دلخواه خود را وارد کنید. پس از اتمام، روی دکمه ایجاد کلیک کنید تا مکان خود را ایجاد کنید.
بومی
تصویر ثابت را برای نوع آگهی و Native را برای نوع موجودی انتخاب کنید. پس از انجام این کار، یک نام مکان وارد کنید، مقدمه موجودی را پر کنید و یک تصویر انتخابی آگهی را انتخاب کنید. پس از اتمام، روی دکمه ایجاد کلیک کنید تا مکان خود را ایجاد کنید.
برای تبلیغات ویدیویی بومی، ویدیو را برای نوع آگهی و بومی (سفارشی) را برای نوع موجودی انتخاب کنید. پس از انجام این کار، یک نام مکان وارد کنید، مقدمه موجودی را پر کنید و یک دسته مناسب را از لیست کشویی انتخاب کنید.
در تنظیمات بومی ، یک جهت آگهی ویدیویی و نوع تبلیغات بومی را از لیست انتخاب کنید. پس از اتمام، روی دکمه ایجاد کلیک کنید تا مکان خود را ایجاد کنید.
برای تنظیم واحد تبلیغات AdMob خود در بخش بعدی، به apiKey و spotID برای هر مکان نیاز دارید. برای پیدا کردن آنها، به برگه مدیریت مکان بروید و دکمه SDK را در زیر نام برنامه خود انتخاب کنید.
apiKey و spotID را یادداشت کنید.
شما همچنین به API Key خود برای API گزارشدهی nend نیاز خواهید داشت که آن را API Key for Scraping مینامند. می توانید آن را در تب Tools پیدا کنید.
مرحله 2: تقاضای nend را در UI AdMob تنظیم کنید
تنظیمات میانجی را برای واحد تبلیغات خود پیکربندی کنید
اندروید
برای دستورالعملها، مرحله 2 را در راهنمایAndroid ببینید.
iOS
برای دستورالعملها، مرحله 2 را در راهنمایiOS ببینید.
مرحله 3: SDK و آداپتور nend را وارد کنید
آخرین نسخه افزونه میانجی گری تبلیغات موبایل گوگل را برای nend از لینک دانلود در Changelog دانلود کنید و بسته GoogleMobileAdsNendMediation.unitypackage
را از فایل zip
استخراج کنید.
در ویرایشگر پروژه Unity خود، Assets > Import Package > Custom Package را انتخاب کنید و فایل GoogleMobileAdsNendMediation.unitypackage
را که دانلود کرده اید پیدا کنید. مطمئن شوید که همه فایلها انتخاب شدهاند و روی Import کلیک کنید.
سپس، Assets > Play Services Resolver > Android Resolver > Force Resolve را انتخاب کنید. کتابخانه Unity Play Services Resolver تفکیک وابستگیها را از ابتدا انجام میدهد و وابستگیهای اعلامشده را در فهرست Assets/Plugins/Android
برنامه Unity شما کپی میکند.
مرحله 4: کد مورد نیاز را اضافه کنید
اندروید
هیچ کد اضافی برای ادغام nend مورد نیاز نیست.
iOS
ادغام SKAdNetwork
برای افزودن شناسه های SKAdNetwork به فایل Info.plist
پروژه خود ، مستندات nend را دنبال کنید.
مرحله 5: اجرای خود را آزمایش کنید
فعال کردن تبلیغات آزمایشی
مطمئن شوید که دستگاه آزمایشی خود را برایAdMob.برای دریافت آگهی های آزمایشی برای بنرها، مطالب بینابینی و پاداش، Nend توصیه می کند از کلیدهای API و شناسه های Spot ارائه شده در nend test units ad استفاده کنید. اینها را میتوان بهعنوان کلیدهای API و شناسههای نقطهای برای واحدهای تبلیغاتی AdMob شما در حین آزمایش وارد کرد و سپس وقتی برنامهتان آماده تولید شد، با یک کلید API واقعی و شناسه نقطه جایگزین شوند.
تبلیغات آزمایشی را تأیید کنید
برای تأیید اینکه آگهیهای آزمایشی را ازnendدریافت میکنید، با استفاده از منبع(های) آگهی nend (Waterfall) آزمایش منبع آگهی را در بازرس آگهی فعال کنید.
کدهای خطا
اگر آداپتور نتواند آگهی را از nend دریافت کند، ناشران میتوانند با استفاده از ResponseInfo
در کلاسهای زیر، خطای اساسی را از پاسخ آگهی بررسی کنند:
اندروید
com.google.ads.mediation.nend.NendAdapter
com.google.ads.mediation.nend.NendRewardedAdapter
com.google.ads.mediation.nend.NendMediationAdapter
iOS
GADMAdapterNend
GADMAdapterNend
GADMAdapterNendRewarded
GADMediationAdapterNend
در اینجا کدها و پیامهای همراهی وجود دارد که توسط آداپتور nend هنگام بارگیری یک تبلیغ انجام نمیشود:
اندروید
کد خطا | دامنه | دلیل |
---|---|---|
101 | com.google.ads.mediation.nend | nend برای بارگیری و نمایش تبلیغات به یک زمینه فعالیت نیاز دارد. |
102 | com.google.ads.mediation.nend | پارامترهای سرور nend پیکربندی شده در رابط کاربری AdMob وجود ندارد/نامعتبر است. |
103 | com.google.ads.mediation.nend | تبلیغ nend هنوز برای نمایش آماده نیست. |
104 | com.google.ads.mediation.nend | nend موفق به پخش آگهی نشد. |
105 | com.google.ads.mediation.nend | اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده مطابقت ندارد. |
106 | com.google.ads.mediation.nend | مرجع شی Context null است و/یا اخیراً از حافظه آزاد شده است. |
200-299 | net.nend.android | nend SDK یک خطای بارگیری آگهی بینابینی را برگرداند. برای جزئیات بیشتر به کد مراجعه کنید. |
300-399 | net.nend.android | nend SDK یک خطای نمایش تبلیغات بینابینی را برگرداند. برای جزئیات بیشتر به کد مراجعه کنید. |
400-499 | net.nend.android | nend SDK یک خطای تبلیغاتی را نشان داد. برای جزئیات بیشتر به کد مراجعه کنید. |
iOS
کد خطا | دامنه | دلیل |
---|---|---|
101 | com.google.mediation.nend | nend SDK یک تماس با شکست بار را بدون اطلاعات خطای اضافی برگرداند. |
102 | com.google.mediation.nend | nend SDK یک پاسخ تماس با شکست نمایش را بدون اطلاعات خطای اضافی برگرداند. |
103 | com.google.mediation.nend | پارامترهای سرور nend پیکربندی شده در رابط کاربری AdMob وجود ندارد/نامعتبر است. |
104 | com.google.mediation.nend | دارایی های تصویر تبلیغات بومی بارگیری نشد. |
105 | com.google.mediation.nend | به دلیل آماده نبودن آگهی، تبلیغات پایانی نشان داده نشد. |
106 | com.google.mediation.nend | اندازه بنر درخواستی با اندازه بنر پشتیبانی شده مطابقت ندارد. |
200-699 | ارسال شده توسط nend SDK. | nend SDK یک خطا برگرداند. برای جزئیات بیشتر به سند nend مراجعه کنید. |
nend Unity Mediation Plugin Changelog
نسخه 8.0.0
- از آداپتور نند اندروید نسخه 10.0.0.0 پشتیبانی می کند.
- از آداپتور نند iOS نسخه 8.2.0.0 پشتیبانی می کند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 8.6.0.
نسخه 7.0.0
- محتوای آداپتور به
GoogleMobileAds/Mediation/Nend/
منتقل شد. - فضای نام آداپتور برای استفاده از
GoogleMobileAds.Mediation.Nend
بازسازی شد. - از آداپتور نند اندروید نسخه 9.0.1.0 پشتیبانی می کند.
- از آداپتور نند iOS نسخه 8.0.1.0 پشتیبانی می کند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 8.1.0.
نسخه 6.0.1
- از آداپتور نند اندروید نسخه 9.0.0.0 پشتیبانی می کند.
- از آداپتور نند iOS نسخه 7.4.0.1 پشتیبانی می کند.
- با افزونه Google Mobile Ads Unity نسخه 7.4.1 ساخته و آزمایش شده است.
نسخه 6.0.0
- از آداپتور نند اندروید نسخه 9.0.0.0 پشتیبانی می کند.
- از آداپتور نند iOS نسخه 7.4.0.0 پشتیبانی می کند.
- با افزونه Google Mobile Ads Unity نسخه 7.2.0 ساخته و آزمایش شده است.
نسخه 5.2.0
- از آداپتور نند اندروید نسخه 8.1.0.1 پشتیبانی می کند.
- از آداپتور نند iOS نسخه 7.3.0.0 پشتیبانی می کند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 7.0.2.
نسخه 5.1.0
- از آداپتور اندروید nend نسخه 8.1.0.0 پشتیبانی می کند.
- از آداپتور نند iOS نسخه 7.2.0.0 پشتیبانی می کند.
- با افزونه Google Mobile Ads Unity نسخه 7.0.0 ساخته و آزمایش شده است.
نسخه 5.0.0
- از آداپتور اندروید nend نسخه 8.0.1.0 پشتیبانی می کند.
- از آداپتور نند iOS نسخه 7.1.0.0 پشتیبانی می کند.
نسخه 4.0.1
- از آداپتور نند اندروید نسخه 7.0.3.0 پشتیبانی می کند.
- از آداپتور نند iOS نسخه 7.0.5.0 پشتیبانی می کند.
نسخه 4.0.0
- از آداپتور نند اندروید نسخه 7.0.0.0 پشتیبانی می کند.
- از آداپتور نند iOS نسخه 7.0.0.0 پشتیبانی می کند.
نسخه 3.0.0
- از آداپتور نند اندروید نسخه 6.0.1.0 پشتیبانی می کند.
- از آداپتور نند iOS نسخه 6.0.1.0 پشتیبانی می کند.
نسخه 2.3.0
- از آداپتور نند اندروید نسخه 5.4.2.0 پشتیبانی می کند.
- از آداپتور نند iOS نسخه 5.4.1.0 پشتیبانی می کند.
نسخه 2.2.0
- از آداپتور نند اندروید نسخه 5.3.0.0 پشتیبانی می کند.
- از آداپتور نند iOS نسخه 5.3.0.0 پشتیبانی می کند.
نسخه 2.1.0
- افزونه را برای پشتیبانی از Rewarded API جدید به روز کرد.
- از آداپتور نند اندروید نسخه 5.1.0.2 پشتیبانی می کند.
- از آداپتور نند iOS نسخه 5.1.1.0 پشتیبانی می کند.
نسخه 2.0.3
- از آداپتور نند اندروید نسخه 5.0.2.1 پشتیبانی می کند.
- از آداپتور نند iOS نسخه 5.0.2.0 پشتیبانی می کند.
نسخه 2.0.2
- از آداپتور نند اندروید نسخه 5.0.2.0 پشتیبانی می کند.
- از آداپتور نند iOS نسخه 5.0.2.0 پشتیبانی می کند.
نسخه 2.0.1
- از آداپتور نند اندروید نسخه 5.0.2.0 پشتیبانی می کند.
- از آداپتور نند iOS نسخه 5.0.1.0 پشتیبانی می کند.
نسخه 2.0.0
- از آداپتور نند اندروید نسخه 5.0.0.0 پشتیبانی می کند.
- از آداپتور نند iOS نسخه 5.0.0.0 پشتیبانی می کند.
نسخه 1.0.2
- از آداپتور نند اندروید نسخه 4.0.5.0 پشتیبانی می کند.
- از آداپتور نند iOS نسخه 4.0.6.0 پشتیبانی می کند.
نسخه 1.0.1
- از Nend Android SDK نسخه 4.0.4 پشتیبانی می کند.
- پشتیبانی از nend iOS SDK نسخه 4.0.4.
نسخه 1.0.0
- اولین انتشار!
- پشتیبانی از اندروید SDK نسخه 4.0.2.
- پشتیبانی از nend iOS SDK نسخه 4.0.2.