UnifiedNativeAdMapper

کاتلین | جاوا

public abstract class UnifiedNativeAdMapper

---

کلاس نگاشت برای تبلیغات بومی یکپارچه گوگل ادموب.

آداپتورهای میانجی‌گری که یک تبلیغ بومی را بارگذاری می‌کنند، باید این کلاس را بسط دهند تا نگاشتی از شیء تبلیغ بومی شبکه تبلیغ میانجی‌گری شده به com.google.android.gms.ads.formats.UnifiedNativeAd ارائه دهند.

خلاصه

زمینه‌های عمومی
View	adChoicesContent
String	advertiser
String	body
String	callToAction
Bundle	extras
String	headline
NativeAd.Image	icon
List < NativeAd.Image >	images
float	mediaContentAspectRatio
boolean	overrideClickHandling
boolean	overrideImpressionRecording
String	price
Double	starRating
String	store

سازندگان عمومی
UnifiedNativeAdMapper ()

روش‌های عمومی
void	destroy () اگر SDK شبکه واسطه راهی برای از بین بردن شیء تبلیغ بومی ارائه دهد، زیرکلاس‌ها باید این روش را پیاده‌سازی کنند.
View	getAdChoicesContent () نمایی که به عنوان محتوای AdChoices استفاده می‌شود را برمی‌گرداند.
final String	getAdvertiser () متنی را که تبلیغ‌کننده را مشخص می‌کند، برمی‌گرداند.
final String	getBody () متن بدنه را برمی‌گرداند.
final String	getCallToAction () متنی را برمی‌گرداند که کاربر را تشویق می‌کند تا با تبلیغ اقدامی انجام دهد.
float	getCurrentTime () زمان فعلی ویدیو را دریافت می‌کند.
float	getDuration () مدت زمان ویدیو را دریافت می‌کند.
final Bundle	getExtras () مجموعه‌ی موارد اضافی ارسال شده از طریق متد setExtras را برمی‌گرداند.
final String	getHeadline () عنوان اصلی متن را برمی‌گرداند.
final NativeAd.Image	getIcon () یک تصویر کوچک که تبلیغ‌کننده را شناسایی می‌کند، برمی‌گرداند.
final List < NativeAd.Image >	getImages () لیستی از تصاویر بزرگ را برمی‌گرداند.
float	getMediaContentAspectRatio () نسبت ابعاد رسانه‌ای که قرار است در MediaView رندر شود را برمی‌گرداند.
final boolean	getOverrideClickHandling () اگر شبکه تبلیغاتی خودش مدیریت کلیک را انجام دهد، مقدار true را برمی‌گرداند.
final boolean	getOverrideImpressionRecording () اگر شبکه تبلیغاتی خودش ردیابی نمایش تبلیغات را انجام دهد، مقدار true را برمی‌گرداند.
final String	getPrice () برای تبلیغات مربوط به برنامه‌ها، رشته‌ای را برمی‌گرداند که نشان می‌دهد هزینه برنامه چقدر است.
final Double	getStarRating () برای تبلیغات مربوط به برنامه‌ها، امتیاز ستاره‌ای از ۰ تا ۵ را برمی‌گرداند که نشان می‌دهد برنامه در فروشگاه چند ستاره دارد.
final String	getStore () برای تبلیغات مربوط به برنامه‌ها، نام فروشگاهی که برنامه را برای دانلود ارائه می‌دهد، برمی‌گرداند.
void	handleClick ( View view) اگر شبکه از توسعه‌دهنده بخواهد که رویدادهای کلیک نماهای رندر شده روی صفحه را صریحاً مدیریت کند، زیرکلاس‌ها باید این روش را پیاده‌سازی کنند.
boolean	hasVideoContent () اگر تبلیغ فعلی محتوای ویدیویی داشته باشد، مقدار true را برمی‌گرداند.
void	recordImpression () اگر شبکه از توسعه‌دهنده بخواهد که صریحاً برداشتی از نمای رندر شده روی صفحه را ثبت کند، زیرکلاس‌ها باید این روش را پیاده‌سازی کنند.
void	setAdChoicesContent ( View adChoicesContent) نمایی را برای استفاده به عنوان محتوای AdChoices تنظیم می‌کند.
final void	setAdvertiser ( String advertiser) متنی را تنظیم می‌کند که تبلیغ‌کننده را مشخص می‌کند.
final void	setBody ( String body) متن بدنه را تنظیم می‌کند.
final void	setCallToAction ( String callToAction) فراخوان عمل تبلیغ (مانند «خرید» یا «نصب») را تنظیم می‌کند.
final void	setExtras ( Bundle extras) مجموعه‌ای از موارد اضافی حاوی دارایی‌ها یا ویژگی‌هایی را تنظیم می‌کند که مستقیماً به موارد مورد انتظار برای یک شیء تبلیغ بومی گوگل (عنوان، بدنه و غیره) نگاشت نمی‌شوند.
void	setHasVideoContent (boolean hasVideoContent) اگر تبلیغ فعلی محتوای ویدیویی دارد، روی درست تنظیم کنید.
final void	setHeadline ( String headline) عنوان اصلی متن را تنظیم می‌کند.
final void	setIcon ( NativeAd.Image icon) یک تصویر کوچک برای شناسایی تبلیغ‌کننده تنظیم می‌کند.
final void	setImages ( List < NativeAd.Image > images) فهرستی از تصاویر بزرگ را تنظیم می‌کند.
void	setMediaContentAspectRatio (float mediaContentAspectRatio) نسبت ابعاد رسانه‌ای که قرار است در MediaView رندر شود را تنظیم می‌کند.
void	setMediaView ( View mediaView) نمای واسطه‌ای را تنظیم می‌کند که رسانه را نمایش می‌دهد.
final void	setOverrideClickHandling (boolean overrideClickHandling) اگر شبکه تبلیغاتی خودش مدیریت کلیک‌ها را انجام می‌دهد، روی true تنظیم کنید.
final void	setOverrideImpressionRecording (boolean overrideImpressionRecording) اگر شبکه تبلیغاتی خودش ردیابی نمایش تبلیغات را انجام می‌دهد، روی درست تنظیم کنید.
final void	setPrice ( String price) برای تبلیغات مربوط به برنامه‌ها، رشته‌ای را تنظیم کنید که نشان دهنده هزینه برنامه باشد.
final void	setStarRating ( Double starRating) برای تبلیغات مربوط به برنامه‌ها، امتیاز ستاره‌ای از ۰ تا ۵ تعیین کنید که نشان می‌دهد برنامه در فروشگاه چند ستاره دارد.
final void	setStore ( String store) برای تبلیغات مربوط به برنامه‌ها، نام فروشگاهی که برنامه را برای دانلود ارائه می‌دهد، تنظیم می‌شود.
void	trackViews ( View containerView, Map < String , View > clickableAssetViews, Map < String , View > nonclickableAssetViews ) اگر شبکه از توسعه‌دهنده بخواهد که قبل از رندر شدن یک نما روی صفحه، وضعیت را برای ثبت یک نمایش و/یا کلیک آماده کند، زیرکلاس‌ها باید این متد را پیاده‌سازی کنند.
void	untrackView ( View view) اگر SDK شبکه‌ی واسط، راهی برای متوقف کردن ردیابی نمای تبلیغ بومی برای تبلیغی که توسط این شیء نگاشت شده است، ارائه دهد، زیرکلاس‌ها باید این روش را پیاده‌سازی کنند.

زمینه‌های عمومی

محتوای adChoices

public View adChoicesContent

تبلیغ کننده

public String advertiser

بدن

public String body

فراخوانی برای اقدام

public String callToAction

موارد اضافی

public Bundle extras

تیتر خبر

public String headline

آیکون

public NativeAd.Image icon

تصاویر

public List<NativeAd.Image> images

نسبت ابعاد محتوا رسانه

public float mediaContentAspectRatio

overrideClickHandling

public boolean overrideClickHandling

overrideImpressionRecording

public boolean overrideImpressionRecording

قیمت

public String price

رتبه‌بندی ستاره‌ای

public Double starRating

فروشگاه

public String store

سازندگان عمومی

UnifiedNativeAdMapper

public UnifiedNativeAdMapper()

روش‌های عمومی

نابود کردن

public void destroy()

اگر SDK شبکه واسطه راهی برای از بین بردن شیء تبلیغ بومی ارائه دهد، زیرکلاس‌ها باید این روش را پیاده‌سازی کنند.

محتوای انتخاب‌های تبلیغاتی (getAdChoicesContent)

public View getAdChoicesContent()

نمایی که به عنوان محتوای AdChoices استفاده می‌شود را برمی‌گرداند.

دریافت تبلیغ‌کننده

public final String getAdvertiser()

متنی را که تبلیغ‌کننده را مشخص می‌کند، برمی‌گرداند.

دریافت بدن

public final String getBody()

متن بدنه را برمی‌گرداند.

دریافت فراخوان برای اقدام

public final String getCallToAction()

متنی را برمی‌گرداند که کاربر را تشویق می‌کند تا با تبلیغ اقدامی انجام دهد.

دریافت زمان فعلی

public float getCurrentTime()

زمان فعلی ویدیو را دریافت می‌کند. به طور پیش‌فرض صفر برمی‌گرداند. زیرکلاس‌ها باید این متد را برای برگرداندن زمان فعلی غیر صفر برای تبلیغات ویدیویی، بازنویسی کنند.

دریافت مدت زمان

public float getDuration()

مدت زمان ویدیو را دریافت می‌کند. به طور پیش‌فرض صفر برمی‌گرداند. زیرکلاس‌ها باید این متد را برای برگرداندن مدت زمان غیر صفر برای تبلیغات ویدیویی، بازنویسی کنند.

دریافت موارد اضافی

public final Bundle getExtras()

مجموعه‌ی موارد اضافی ارسال شده از طریق متد setExtras را برمی‌گرداند.

دریافت سرتیتر

public final String getHeadline()

عنوان اصلی متن را برمی‌گرداند.

دریافت آیکون

public final NativeAd.Image getIcon()

یک تصویر کوچک که تبلیغ‌کننده را شناسایی می‌کند، برمی‌گرداند.

دریافت تصاویر

public final List<NativeAd.Image> getImages()

لیستی از تصاویر بزرگ را برمی‌گرداند.

نسبت ابعاد محتوا به رسانه (getMediaContentAspectRatio)

public float getMediaContentAspectRatio()

نسبت ابعاد رسانه‌ای که قرار است در MediaView رندر شود را برمی‌گرداند. اگر نسبت ابعاد در دسترس نباشد، صفر را برمی‌گرداند.

دریافت OverrideClickHandling

public final boolean getOverrideClickHandling()

اگر شبکه تبلیغاتی خودش مدیریت کلیک را انجام دهد، مقدار true را برمی‌گرداند.

getOverrideImpressionRecording

public final boolean getOverrideImpressionRecording()

اگر شبکه تبلیغاتی خودش ردیابی نمایش تبلیغات را انجام دهد، مقدار true را برمی‌گرداند.

دریافت قیمت

public final String getPrice()

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

دریافت ستاره رتبه‌بندی

public final Double getStarRating()

برای تبلیغات مربوط به برنامه‌ها، امتیاز ستاره‌ای از ۰ تا ۵ را برمی‌گرداند که نشان می‌دهد برنامه در فروشگاه چند ستاره دارد.

فروشگاه دریافت

public final String getStore()

برای تبلیغات مربوط به برنامه‌ها، نام فروشگاهی که برنامه را برای دانلود ارائه می‌دهد، برمی‌گرداند. برای مثال، "Google Play".

کلیک روی دسته

public void handleClick(View view)

اگر شبکه از توسعه‌دهنده بخواهد که رویدادهای کلیک نماهای رندر شده روی صفحه را صریحاً مدیریت کند، زیرکلاس‌ها باید این روش را پیاده‌سازی کنند.

محتوای ویدیویی دارد

public boolean hasVideoContent()

اگر تبلیغ فعلی محتوای ویدیویی داشته باشد، مقدار true را برمی‌گرداند.

رکورد ایمپرشن

public void recordImpression()

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

تنظیم محتوای AdChoices

public void setAdChoicesContent(View adChoicesContent)

نمایی را برای استفاده به عنوان محتوای AdChoices تنظیم می‌کند.

setAdvertiser

public final void setAdvertiser(String advertiser)

متنی را تنظیم می‌کند که تبلیغ‌کننده را مشخص می‌کند. برنامه‌ها ملزم به نمایش این محتوا نیستند، اگرچه توصیه می‌شود.

پارامترها
String advertiser	متن برای تنظیم

بدنه تنظیم شده

public final void setBody(String body)

متن بدنه را تنظیم می‌کند. برنامه‌ها ملزم به نمایش این محتوا نیستند، هرچند توصیه می‌شود.

پارامترها
String body	توضیحاتی که باید تنظیم شود

تنظیم فراخوانی برای اقدام

public final void setCallToAction(String callToAction)

فراخوان عمل (call to action) تبلیغ را تنظیم می‌کند (مانند «خرید» یا «نصب»). اگرچه نمایش این ویژگی برای برنامه‌ها الزامی نیست، اما توصیه می‌شود.

پارامترها
String callToAction	متن برای تنظیم

مجموعه موارد اضافی

public final void setExtras(Bundle extras)

مجموعه‌ای از موارد اضافی حاوی دارایی‌ها یا ویژگی‌هایی را تنظیم می‌کند که مستقیماً به موارد مورد انتظار برای یک شیء تبلیغ بومی گوگل (عنوان، بدنه و غیره) نگاشت نمی‌شوند.

محتوای ویدیو setHas

public void setHasVideoContent(boolean hasVideoContent)

اگر تبلیغ فعلی محتوای ویدیویی دارد، روی درست تنظیم کنید.

تنظیم عنوان

public final void setHeadline(String headline)

عنوان متن اصلی را تنظیم می‌کند. برای نمایش این محتوا به برنامه‌ها نیاز است.

مجموعه آیکون

public final void setIcon(NativeAd.Image icon)

یک تصویر کوچک برای شناسایی تبلیغ‌کننده تنظیم می‌کند. برنامه‌ها ملزم به نمایش این ویژگی نیستند، هرچند توصیه می‌شود.

تصاویر تنظیم شده

public final void setImages(List<NativeAd.Image> images)

فهرستی از تصاویر بزرگ را تنظیم می‌کند. برنامه‌ها ملزم به نمایش این تصویر نیستند، هرچند توصیه می‌شود.

نسبت ابعاد محتوا به رسانه (setMediaContentAspectRatio)

public void setMediaContentAspectRatio(float mediaContentAspectRatio)

نسبت ابعاد رسانه‌ای که قرار است در MediaView رندر شود را تنظیم می‌کند.

پارامترها
float mediaContentAspectRatio	نسبت ابعاد برای تنظیم

تنظیم مدیا ویو

public void setMediaView(View mediaView)

نمای واسطه‌ای را تنظیم می‌کند که رسانه را نمایش می‌دهد. این معمولاً نمایی است که توسط SDK واسطه‌ای برای نمایش محتوای ویدیویی برای یک تبلیغ ارائه می‌شود، اما اگر ویدیویی وجود نداشته باشد، باید یک تصویر را نمایش دهد. انتظار می‌رود آداپتورها برای هر تبلیغ، یک نما برای این ویژگی تنظیم کنند.

تنظیم OverrideClickHandling

public final void setOverrideClickHandling(boolean overrideClickHandling)

اگر شبکه تبلیغاتی خودش مدیریت کلیک‌ها را انجام می‌دهد، روی true تنظیم کنید.

ضبط برداشت از طریق setOverride

public final void setOverrideImpressionRecording(boolean overrideImpressionRecording)

اگر شبکه تبلیغاتی خودش ردیابی نمایش تبلیغات را انجام می‌دهد، روی درست تنظیم کنید.

قیمت تعیین‌شده

public final void setPrice(String price)

برای تبلیغات مربوط به برنامه‌ها، رشته‌ای را تنظیم کنید که نشان دهنده هزینه برنامه باشد. برنامه‌ها ملزم به نمایش این ویژگی نیستند، اگرچه توصیه می‌شود.

پارامترها
String price	رشته‌ای که نشان می‌دهد هزینه برنامه چقدر است.

تنظیم رتبه‌بندی ستاره

public final void setStarRating(Double starRating)

برای تبلیغات مربوط به برنامه‌ها، یک امتیاز ستاره‌ای از ۰ تا ۵ تعیین کنید که نشان می‌دهد برنامه در فروشگاه چند ستاره برای ارائه آن دارد. برنامه‌ها ملزم به نمایش این ویژگی نیستند، اگرچه توصیه می‌شود.

فروشگاه تنظیم

public final void setStore(String store)

برای تبلیغات مربوط به برنامه‌ها، نام فروشگاهی که برنامه را برای دانلود ارائه می‌دهد را تنظیم کنید. برای مثال، "Google Play". برنامه‌ها ملزم به نمایش این ویژگی نیستند، اگرچه توصیه می‌شود.

پارامترها
String store	نام فروشگاه برنامه برای تنظیم

trackViews

public void trackViews(
    View containerView,
    Map<String, View> clickableAssetViews,
    Map<String, View> nonclickableAssetViews
)

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

پارامترها
View containerView	View کانتینر برای تبلیغ.
Map < String , View > clickableAssetViews	Map نام‌های دارایی‌های قابل کلیک به View مربوطه.
Map < String , View > nonclickableAssetViews	Map نام‌های دارایی‌های غیرقابل کلیک به View مربوطه.

مشاهده‌ی ردگیری

public void untrackView(View view)

اگر SDK شبکه‌ی واسط، راهی برای متوقف کردن ردیابی نمای تبلیغ بومی برای تبلیغی که توسط این شیء نگاشت شده است، ارائه دهد، زیرکلاس‌ها باید این روش را پیاده‌سازی کنند.