Nend را با Mediation ادغام کنید

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

رابط داشبورد برای nend از متن ژاپنی برای برچسب‌ها، دکمه‌ها و توضیحات خود استفاده می‌کند و تصاویر نمایش داده شده در زیر ترجمه نشده‌اند. در این راهنما، برچسب ها و دکمه ها با معادل انگلیسی خود ارجاع داده می شوند. برای مثال "URL スキーム"، "URL Scheme" و غیره است.

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

آداپتور میانجی Ad Manager برای nend دارای قابلیت های زیر است:

ادغام
مناقصه
آبشار
فرمت ها
بنر
بینابینی
پاداش داده شد
بومی

الزامات

• Android API سطح 21 یا بالاتر

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

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

مرحله 1: تنظیمات را در nend UI تنظیم کنید

ثبت نام کنید یا به حساب کاربری خود وارد شوید .

برای افزودن برنامه خود به داشبورد nend، ابتدا روی برگه مدیریت مکان کلیک کنید و سپس سایت/برنامه را انتخاب کنید. روی دکمه افزودن برنامه کلیک کنید تا برنامه خود را برای پایان اضافه کنید.

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

نام برنامه خود را وارد کنید و پلتفرم برنامه خود را به عنوان نوع برنامه انتخاب کنید. URL را وارد کنید و بررسی کنید که آیا برنامه شما در فروشگاه برنامه مناسب فهرست شده است یا خیر

(اگر برنامه شما هنوز منتشر نشده است، به سؤالات متداول برنامه های منتشر نشده nend مراجعه کنید). یک دسته برای برنامه خود انتخاب کنید و پس از اتمام روی ایجاد کلیک کنید.

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

یک مکان ایجاد کنید

پس از ثبت برنامه، می توانید به سمت ایجاد یک مکان بروید. برای ایجاد یک مکان برای تبلیغات بنری، به تب Placement Management رفته و روی Placement کلیک کنید. سپس روی دکمه Create a new placement کلیک کنید.

برنامه خود را در منوی کشویی انتخاب کنید. سپس، دستورالعمل‌های زیر را که با قالب تبلیغاتی دلخواه شما مطابقت دارد، دنبال کنید.

بنر

تصویر ثابت را برای نوع آگهی و بنر را برای نوع موجودی انتخاب کنید. پس از انجام این کار، نام مکان را وارد کنید، مقدمه موجودی را پر کنید، قالب موجودی را انتخاب کنید و در نهایت اندازه موجودی را انتخاب کنید. پس از اتمام، روی دکمه ایجاد کلیک کنید تا مکان خود را ایجاد کنید.

توجه: اندازه بنر انتخاب شده در اینجا باید با اندازه درخواستی برنامه شما مطابقت داشته باشد.

بینابینی

تصویر ثابت را برای نوع آگهی و بینابینی را برای نوع موجودی انتخاب کنید. پس از انجام این کار، نام مکان را وارد کنید، مقدمه موجودی را پر کنید و تعداد دفعات نمایش آگهی را از لیست کشویی انتخاب کنید. پس از اتمام، روی دکمه ایجاد کلیک کنید تا مکان خود را ایجاد کنید.

برای تبلیغات ویدیویی بینابینی، ویدیو را برای نوع آگهی و بینابینی را برای نوع موجودی انتخاب کنید. پس از انجام این کار، یک نام مکان وارد کنید، مقدمه موجودی را پر کنید و یک دسته مناسب را از لیست کشویی انتخاب کنید. پس از اتمام، روی دکمه ایجاد کلیک کنید تا مکان خود را ایجاد کنید.

پاداش داده شد

ویدیو را برای نوع تبلیغ و پاداش برای نوع موجودی را انتخاب کنید. پس از انجام این کار، یک نام مکان وارد کنید، مقدمه موجودی را پر کنید و یک دسته مناسب را از لیست کشویی انتخاب کنید.

در قسمت تنظیمات پاداش ، یک محتوای پاداش را با استفاده از لیست کشویی انتخاب کنید، نام ارز مجازی دلخواه خود را وارد کنید. پس از اتمام، روی دکمه ایجاد کلیک کنید تا مکان خود را ایجاد کنید.

بومی

تصویر ثابت را برای نوع آگهی و Native را برای نوع موجودی انتخاب کنید. پس از انجام این کار، یک نام مکان وارد کنید، مقدمه موجودی را پر کنید و یک تصویر انتخابی آگهی را انتخاب کنید. پس از اتمام، روی دکمه ایجاد کلیک کنید تا مکان خود را ایجاد کنید.

توجه: توصیه می کنیم از تصویر تبلیغاتی بزرگ افقی (5: 3) به عنوان انتخاب تصویر آگهی استفاده کنید زیرا شامل دارایی های تبلیغاتی بومی است که توصیه می شود ارائه شوند.

برای تبلیغات ویدیویی بومی، ویدیو را برای نوع آگهی و بومی (سفارشی) را برای نوع موجودی انتخاب کنید. پس از انجام این کار، یک نام مکان وارد کنید، مقدمه موجودی را پر کنید و یک دسته مناسب را از لیست کشویی انتخاب کنید.

در تنظیمات بومی ، یک جهت آگهی ویدیویی و نوع تبلیغات بومی را از لیست انتخاب کنید. پس از اتمام، روی دکمه ایجاد کلیک کنید تا مکان خود را ایجاد کنید.

برای تنظیم واحد تبلیغات Ad Manager خود در بخش بعدی، به apiKey و spotID برای هر مکان نیاز دارید. برای پیدا کردن آنها، به برگه مدیریت مکان بروید و دکمه SDK را در زیر نام برنامه خود انتخاب کنید.

apiKey و spotID را یادداشت کنید.

شما همچنین به API Key خود برای API گزارش‌دهی nend نیاز خواهید داشت که آن را API Key for Scraping می‌نامند. می توانید آن را در تب Tools پیدا کنید.

مرحله 2: تقاضای nend را در UI Ad Manager تنظیم کنید

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

به حساب Ad Manager خود وارد شوید.

به مسیر Delivery > Yield Groups بروید و روی دکمه گروه بازده جدید کلیک کنید.

یک نام منحصر به فرد برای گروه بازدهی خود وارد کنید، وضعیت را روی فعال تنظیم کنید، قالب تبلیغات خود را انتخاب کنید و نوع موجودی را روی برنامه موبایل تنظیم کنید. در بخش Targeting > Inventory ، واحد تبلیغاتی را در برنامه Inventory and Mobile که می‌خواهید میانجیگری را به آن اضافه کنید، انتخاب کنید.

بعد، روی دکمه افزودن شریک عملکرد کلیک کنید.

اگر از قبل شریک بازدهی برایnendدارید، می‌توانید آن را انتخاب کنید. در غیر این صورت، Create a new yield partner را انتخاب کنید.

nend به عنوان شبکه تبلیغات انتخاب کنید، یک نام منحصر به فرد وارد کنید و Mediation را فعال کنید.

جمع‌آوری خودکار داده‌ها را روشن کنید وReporting API Key from the API Key for Scrapingرا که در بخش قبل به دست آمد، وارد کنید.

پس از انتخاب شریک Yield ، Mobile SDK Mediation را به عنوان نوع یکپارچه سازی ، Android به عنوان پلتفرم و Active را به عنوان وضعیت انتخاب کنید.Slot ID and API Key به دست آمده در بخش قبل را وارد کنید. سپس، یک مقدار پیش فرض CPM را وارد کنید.

پس از اتمام روی ذخیره در پایین صفحه کلیک کنید.

توجه: جمع‌آوری خودکار داده‌ها چند روز طول می‌کشد تا داده‌ها را به‌طور دقیق محاسبه کند تا بتواند مقدار پویا CPM را برای یک شبکه میانجی محاسبه کند. پس از محاسبه eCPM، به‌طور خودکار از طرف شما به‌روزرسانی می‌شود.

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

توجه: عدم ادغام نسخه‌های Nend سازگار و Google Mobile Ads SDK ممکن است منجر به مشکلات ساخت شود.

ادغام Android Studio (توصیه می شود)

در فایل settings.gradle.kts سطح پروژه خود، مخازن زیر را اضافه کنید:

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://fan-adn.github.io/nendSDK-Android-lib/library")
    }
  }
}

سپس، در فایل build.gradle.kts در سطح برنامه خود، وابستگی ها و پیکربندی های پیاده سازی زیر را اضافه کنید. از آخرین نسخه‌های nend SDK و آداپتور استفاده کنید:

l10n

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.0.0")
    implementation("com.google.ads.mediation:nend:10.0.0.1")
}

ادغام دستی

1. آخرین نسخه Nend Android SDK را دانلود کنید و آن را به پروژه خود اضافه کنید.

2. به مصنوعات آداپتور nend در مخزن Maven Google بروید. آخرین نسخه را انتخاب کنید، فایل .aar آداپتور nend را دانلود کنید و آن را به پروژه خود اضافه کنید.

مرحله 5: کد مورد نیاز را اضافه کنید

هیچ کد اضافی برای ادغام nend مورد نیاز نیست.

مرحله 6: اجرای خود را آزمایش کنید

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

مطمئن شوید که دستگاه آزمایشی خود را برایAd Manager.برای دریافت آگهی های آزمایشی برای بنرها، مطالب بینابینی و پاداش، Nend توصیه می کند از کلیدهای API و شناسه های Spot ارائه شده در nend test units استفاده کنید. اینها را می‌توان به‌عنوان کلیدهای API و شناسه‌های نقطه‌ای برای واحدهای تبلیغاتی AdMob شما در حین آزمایش وارد کرد و سپس وقتی برنامه‌تان آماده تولید شد، با یک کلید API واقعی و شناسه نقطه جایگزین شوند.

مهم: قبل از انتشار برنامه، حالت تست را برای Ad Manager وnend غیرفعال کنید.

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

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

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

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

آداپتور nend از پارامترهای درخواست اضافی پشتیبانی می کند که می تواند با استفاده از کلاس NendExtrasBundleBuilder به آداپتور ارسال شود. این کلاس شامل متدهای زیر است:

• setInterstitialType(InterstitialType) : Nend گزینه انتخاب TYPE_NORMAL را برای تبلیغات بینابینی معمولی یا TYPE_VIDEO برای تبلیغات ویدئویی بینابینی فراهم می کند. اگر این پارامتر اضافی اضافه نشود، Nend به‌طور پیش‌فرض از TYPE_NORMAL به عنوان نوع بینابینی استفاده می‌کند.

• setNativeAdsType(nativeAdsType) : Nend گزینه انتخاب TYPE_NORMAL برای تبلیغات بومی معمولی یا TYPE_VIDEO برای تبلیغات ویدیویی بومی فراهم می کند. اگر این پارامتر اضافی اضافه نشود، Nend به‌طور پیش‌فرض از TYPE_NORMAL به‌عنوان نوع آگهی بومی استفاده می‌کند.

جاوا

Bundle bundle = new NendAdapter.NendExtrasBundleBuilder()
                        .setInterstitialType(InterstitialType.TYPE_NORMAL)
                        .setNativeAdsType(FormatType.TYPE_NORMAL)
                        .build();

AdManagerAdRequest adRequest = new AdManagerAdRequest.Builder()
    .addNetworkExtrasBundle(NendAdapter.class, bundle)
    .build();

adLoader.loadAd(adRequest);

کاتلین

val bundle = NendAdapter.NendExtrasBundleBuilder()
                     .setInterstitialType(InterstitialType.TYPE_NORMAL)
                     .setNativeAdsType(FormatType.TYPE_NORMAL)
                     .build()

val adRequest = AdManagerAdRequest.Builder()
    .addNetworkExtrasBundle(NendAdapter.class, bundle)
    .build()

adLoader.loadAd(adRequest)

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

رندر آگهی

آداپتور Nend تبلیغات بومی خود را به عنوان اشیاءNativeAdبرمی گرداند.فیلدهایرا برایNativeAd .

رشته	پر شده توسط آداپتور Nend
عنوان
تصویر	1
بدن
نماد برنامه	2
فراخوانی برای اقدام
نام تبلیغ کننده
رتبه بندی ستاره ای
فروشگاه
قیمت

¹ Nend فقط دارایی تصویر را برای مکان‌های بومی ارائه می‌کند که با انتخاب تصویر تبلیغاتی روی تصویر تبلیغاتی بزرگ افقی (5: 3) تنظیم شده است.

² Nend دارایی نماد را برای مکان‌های بومی که با انتخاب تصویر آگهی تنظیم شده روی بدون تصویر (فقط متن) پیکربندی شده است، ارائه نمی‌کند .

کدهای خطا

اگر آداپتور نتواند تبلیغی را از nend دریافت کند، ناشران می‌توانند با استفاده ازResponseInfo.getAdapterResponse() در کلاس‌های زیر، خطای اساسی از پاسخ آگهی را بررسی کنند:

قالب	نام کلاس
بنر	com.google.ads.mediation.nend.NendAdapter
بینابینی	com.google.ads.mediation.nend.NendAdapter
پاداش داده شد	com.google.ads.mediation.nend.NendRewardedAdapter
بومی	com.google.ads.mediation.nend.NendMediationAdapter

در اینجا کدها و پیام‌های همراهی وجود دارد که توسط آداپتور nend هنگام بارگیری یک تبلیغ انجام نمی‌شود:

کد خطا	دامنه	دلیل
101	com.google.ads.mediation.nend	nend برای بارگیری و نمایش تبلیغات به یک زمینه فعالیت نیاز دارد.
102	com.google.ads.mediation.nend	پارامترهای سرور nend پیکربندی شده در رابط کاربری Ad Manager وجود ندارد/نامعتبر است.
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 یک خطای تبلیغاتی را نشان داد. برای جزئیات بیشتر به کد مراجعه کنید.

به پایان رسید Android Mediation Adapter Changelog

نسخه 10.0.0.1

• حداقل نسخه مورد نیاز Google Mobile Ads SDK به 23.0.0 به روز شد.
• سازگاری تایید شده با nend SDK 10.0.0.

ساخته و تست شده با

• Google Mobile Ads SDK نسخه 23.0.0.
• Nend SDK نسخه 10.0.0.

نسخه 10.0.0.0

• حداقل نسخه مورد نیاز Google Mobile Ads SDK به 22.3.0 به روز شد.
• سازگاری تایید شده با nend SDK 10.0.0.

ساخته و تست شده با

• Google Mobile Ads SDK نسخه 22.3.0.
• Nend SDK نسخه 10.0.0.

نسخه 9.0.1.0

• آداپتور به‌روزرسانی شده برای استفاده از کلاس جدید VersionInfo .
• حداقل نسخه مورد نیاز Google Mobile Ads SDK به 22.0.0 به روز شد.
• سازگاری تایید شده با nend SDK 9.0.1.

ساخته و تست شده با

• Google Mobile Ads SDK نسخه 22.0.0.
• Nend SDK نسخه 9.0.1.

نسخه 9.0.0.0

• سازگاری تایید شده با nend SDK 9.0.0.
• حداقل نسخه مورد نیاز Google Mobile Ads SDK به 21.2.0 به روز شد.

ساخته و تست شده با

• Google Mobile Ads SDK نسخه 21.2.0.
• Nend SDK نسخه 9.0.0.

نسخه 8.2.0.0

• سازگاری تایید شده با nend SDK 8.2.0.

ساخته و تست شده با

• Google Mobile Ads SDK نسخه 21.0.0.
• Nend SDK نسخه 8.2.0.

نسخه 8.1.0.1

• compileSdkVersion و targetSdkVersion را به API 31 به روز کرد.
• حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 21.0.0 به روز کرد.

ساخته و تست شده با

• Google Mobile Ads SDK نسخه 21.0.0.
• Nend SDK نسخه 8.1.0.

نسخه 8.1.0.0

• سازگاری تایید شده با nend SDK 8.1.0.
• رفع خرابی NullPointerException هنگامی که nend یک تصویر تبلیغاتی null یا نشانی وب نشان‌واره را برمی‌گرداند.
• حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 20.5.0 به روز کرد.

ساخته و تست شده با

• Google Mobile Ads SDK نسخه 20.5.0.
• Nend SDK نسخه 8.1.0.

نسخه 8.0.1.0

• سازگاری تایید شده با nend SDK 8.0.1.
• رفع اشکالی که در آن برخی از اشیاء AdError با استفاده از دامنه نادرست برگردانده شده بودند.
• حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 20.4.0 به روز کرد.

ساخته شده و تست شده با

• Google Mobile Ads SDK نسخه 20.4.0.
• Nend SDK نسخه 8.0.1.

نسخه 7.1.0.0

• سازگاری تایید شده با nend SDK 7.1.0.
• کدهای خطا به‌روزرسانی شد تا خطای ناپایدار UNSUPPORTED_DEVICE ثبت شود.
• حداقل نسخه مورد نیاز Google Mobile Ads SDK به 20.2.0 به روز شد.

ساخته شده و تست شده با

• Google Mobile Ads SDK نسخه 20.2.0.
• Nend SDK نسخه 7.1.0.

نسخه 7.0.3.0

• سازگاری تایید شده با nend SDK 7.0.3.
• کدهای خطای توصیفی و دلایل خرابی بارگذاری/نمایش آداپتور اضافه شد.
• حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 20.0.0 به روز کرد.

ساخته و تست شده با

• Google Mobile Ads SDK نسخه 20.0.0.
• Nend SDK نسخه 7.0.3.

نسخه 7.0.0.0

• سازگاری تایید شده با nend SDK 7.0.0.
• حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 19.4.0 به روز کرد.

ساخته و تست شده با

• Google Mobile Ads SDK نسخه 19.4.0.
• Nend SDK نسخه 7.0.0.

نسخه 6.0.1.0

• سازگاری تایید شده با nend SDK 6.0.1.
• حداقل نسخه مورد نیاز Google Mobile Ads SDK به 19.3.0 به روز شد.

ساخته و تست شده با

• Google Mobile Ads SDK نسخه 19.3.0.
• Nend SDK نسخه 6.0.1.

نسخه 6.0.0.0

• سازگاری تایید شده با nend SDK 6.0.0.
• حداقل نسخه Android SDK به API 19 به‌روزرسانی شد.

ساخته و تست شده با

• Google Mobile Ads SDK نسخه 19.2.0.
• Nend SDK نسخه 6.0.0.

نسخه 5.4.2.1

• آداپتور را برای پشتیبانی از درخواست های بنر تطبیقی ​​درون خطی به روز کرد.
• یک خرابی نادر در شرایط مسابقه که ممکن است در هنگام از بین رفتن بنرهای هوشمند اتفاق بیفتد، برطرف شد.
• حداقل نسخه مورد نیاز Google Mobile Ads SDK به 19.2.0 به روز شد.

ساخته و تست شده با

• Google Mobile Ads SDK نسخه 19.2.0.
• Nend SDK نسخه 5.4.2.

نسخه 5.4.2.0

• پشتیبانی از تبلیغات بومی اضافه شده است.
• سازگاری تایید شده با nend SDK 5.4.2.
• حداقل نسخه مورد نیاز Google Mobile Ads SDK به 19.0.0 به روز شد.

ساخته و تست شده با

• Google Mobile Ads SDK نسخه 19.0.0.
• Nend SDK نسخه 5.4.2.

نسخه 5.3.0.0

• سازگاری تایید شده با nend SDK 5.3.0.
• حداقل نسخه مورد نیاز Google Mobile Ads SDK به 18.2.0 به روز شد.

ساخته شده و تست شده با

• Google Mobile Ads SDK نسخه 18.2.0.
• Nend SDK نسخه 5.3.0.

نسخه 5.2.0.0

• سازگاری تایید شده با nend SDK 5.2.0.
• حداقل نسخه مورد نیاز Google Mobile Ads SDK به 18.1.1 به روز شد.

نسخه 5.1.0.4

• مشکلی که در آن تبلیغات بنری و بینابینی رویداد onAdClicked() را ارسال نمی‌کردند برطرف شد.
• رفع مشکلی که در آن هنگام از بین رفتن یک بنر تبلیغاتی، NullPointerException پرتاب شد.
• آداپتور را به AndroidX منتقل کرد.
• حداقل نسخه مورد نیاز Google Mobile Ads SDK به 18.0.0 به روز شد.

نسخه 5.1.0.3

• پیاده سازی اضافه شده برای نمایش بخشی از بنر nend در SmartBanner. اندازه مناسب برای SmartBanner
  • پرتره و منظره
    • تلفن: 320×50
    • تبلت: 728×90 یا 320×50

نسخه 5.1.0.2

• پشتیبانی از اندازه های تبلیغاتی بنر انعطاف پذیر اضافه شده است.

نسخه 5.1.0.1

• آداپتور به‌روزرسانی شده برای پشتیبانی از API پاداش‌دهی بتا باز جدید.
• حداقل نسخه مورد نیاز Google Mobile Ads SDK به 17.2.0 به روز شد.

نسخه 5.1.0.0

• سازگاری تایید شده با nend SDK 5.1.0.

نسخه 5.0.2.1

• تابعی که ویژگی‌های کاربر را ارسال می‌کند حذف شد زیرا روش‌های زیر در AdRequest.Builder منسوخ شده‌اند.
  • setGender()
  • setBirthday()
  • setIsDesignedForFamiles()

نسخه 5.0.2.0

• سازگاری تایید شده با nend SDK 5.0.2.

نسخه 5.0.1.0

• سازگاری تایید شده با nend SDK 5.0.1.

نسخه 5.0.0.0

• سازگاری تایید شده با nend SDK 5.0.0.

نسخه 4.0.5.0

• سازگاری تایید شده با nend SDK 4.0.5.

نسخه 4.0.4.1

• روی روش RewardedVideoCompleted() RewardedVideoAdListener پشتیبانی می شود.

نسخه 4.0.4.0

• سازگاری تایید شده با nend SDK 4.0.4.

نسخه 4.0.2.1

• قابلیت ایجاد Bundle از میانجی‌های اضافی با استفاده از کلاس NendExtrasBundleBuilder اضافه شده است.

نسخه 4.0.2.0

• اولین نسخه در پروژه منبع باز Google Mobile Ads Mediation.
• پشتیبانی از تبلیغات بنر، بینابینی و ویدیویی با پاداش اضافه شد.