ساخت تبلیغگاه
ابتدا از پنل یلوادوایز یک تبلیغگاه (zone) همسان بسازید و zoneId
را زمان درخواست و نمایش تبلیغ استفاده کنید.
ساخت AdHolder
در صفحهای که قصد دارید بنر همسان نمایش بدهید باید یک ViewGroup
به عنوان فضایی که قصد دارید تبلیغات در آن نمایش داده شود اضافه کنید (adContainer).
<?xml version="1.0" encoding="utf-8"?>
<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent">
<FrameLayout
android:id="@+id/adContainer"
android:layout_width="match_parent"
android:layout_height="wrap_content">
</FrameLayout>
</FrameLayout>
نمونه قالبهای طراحی شده پیشفرض برای نمایش تبلیغات همسان در فایلهای yelloadwise_content_banner_ad_template
و yelloadwise_app_installation_banner_ad_template
قابل مشاهده هستند.
اگر قصد تغییر قالب پیش فرض را دارید، یک layout
دلخواه بسازید و id
و نوع بخشهای مختلف را مطابق جدول زیر تغییر دهید:
view | id | type |
---|---|---|
logo | yelloadwise_nativead_logo | ImageView |
title | yelloadwise_nativead_title | TextView |
ad indicator | yelloadwise_nativead_sponsored | View |
description | yelloadwise_nativead_description | TextView |
banner | yelloadwise_nativead_banner | ir.yelloadwise.app.nativeads.views.RatioImageView |
button | yelloadwise_nativead_cta | TextView |
clickable view | yelloadwise_nativead_cta_view | View |
- در صورتی که در طراحی دکمهای برای کلیک کردن وجود ندارد میتوانید از clickable view استفاده کنید.
- نوع ویوها میتواند از نوعهای گفته شده ارث بری کرده باشند.
مطابق قطعه کد زیر adContainer
و شناسه layout تبلیغ را به یلوادوایز بدهید تا یک YelloadwiseNativeBannerViewManager
بسازید.
import ir.yelloadwise.app.nativeads.YelloadwiseNativeBannerManager;
import ir.yelloadwise.app.nativeads.YelloadwiseNativeBannerViewManager;;
...
ViewGroup adContainer = findViewById(R.id.adContainer);
...
YelloadwiseNativeBannerViewManager nativeBannerViewManager = new YelloadwiseNativeBannerManager
.Builder()
.setParentView(adContainer)
.setContentViewTemplate(R.layout.yelloadwise_content_banner_ad_template)
.setAppInstallationViewTemplate(R.layout.yelloadwise_app_installation_banner_ad_template)
.inflateTemplate(CONTEXT);
درخواست تبلیغ
با کمک متد getAd
و به روش زیر درخواست تبلیغ بدهید.
import ir.yelloadwise.app.AdRequestCallback;
import ir.yelloadwise.app.nativeads.YelloadwiseNativeBannerManager;
.......
private void requestAd() {
YelloadwiseNativeBannerManager.getAd(CONTEXT, ZONE_ID_NATIVE,
new AdRequestCallback() {
@Override
public void onResponse(String[] adId) {
//ad is ready to show
}
@Override
public void onFailed(String message) {
}
});
}
اگر تمایل دارید در کالبک onFailed مجددا درخواست تبلیغ کنید، حتما این کار را به کمک متغیری به عنوان شمارنده انجام دهید. زیرا به کمک آن متغیر میتوانید محدودیت تعداد دفعات را برای درخواست لحاظ کنید. به عنوان مثال وقتی این جایگاه تبلیغاتی را از پنل غیرفعال نمودید، اگر بدون محدود کردن دفعات، هر بار در کالبک onFailed مجددا درخواست تبلیغ دهید، برنامهتان در یک حلقهی بینهایت میافتد و عملکرد آن مختل میشود.
نمایش تبلیغ
بعد از اجرای متد onResponse
تبلیغ آماده نمایش است و میتوانید مطابق روش زیر نمایش دهید.
import ir.yelloadwise.app.nativeads.YelloadwiseNativeBannerManager;
........
private void showAd() {
YelloadwiseNativeBannerManager.bindAd(
CONTEXT,
nativeBannerViewManager,
ZONE_ID_NATIVE,
adId[0]);
}