NativeAdMapper

کاتلین | جاوا

public abstract class NativeAdMapper

---

کلاس نقشه برداری برای تبلیغات بومی Google AdMob.

آداپتورهای میانجی که یک تبلیغ بومی را بارگیری می‌کنند باید این کلاس را گسترش دهند تا نقشه‌ای از شی تبلیغاتی بومی شبکه تبلیغات واسطه‌شده به com.google.android.gms.ads.nativead.NativeAd ارائه کنند.

خلاصه

زمینه های عمومی
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

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

روش های عمومی
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 () اگر شبکه تبلیغاتی به تنهایی ردیابی برداشت را انجام دهد، درست است.
final String	getPrice () برای آگهی‌های مربوط به برنامه‌ها، رشته‌ای را برمی‌گرداند که نشان‌دهنده هزینه‌های برنامه است.
final Double	getStarRating () برای آگهی‌های مربوط به برنامه‌ها، رتبه‌بندی ستاره‌ای از ۰ تا ۵ نشان می‌دهد که نشان‌دهنده تعداد ستاره‌های برنامه در فروشگاهی است که آن را ارائه می‌دهد.
final String	getStore () برای آگهی‌های مربوط به برنامه‌ها، نام فروشگاهی را که برنامه را برای دانلود ارائه می‌دهد، برمی‌گرداند.
void	handleClick ( View view) اگر شبکه از برنامه‌نویس می‌خواهد که رویدادهای کلیک نماهایی را که روی صفحه نمایش داده می‌شوند، به طور صریح مدیریت کند، کلاس‌های فرعی باید این روش را اجرا کنند.
boolean	hasVideoContent () اگر تبلیغ فعلی محتوای ویدیویی داشته باشد، درست است.
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) مجموعه‌ای از موارد اضافی شامل دارایی‌ها یا ویژگی‌هایی را تنظیم می‌کند که مستقیماً با موارد مورد انتظار برای یک شی تبلیغاتی بومی Google (عنوان، متن و غیره) نگاشت نمی‌شوند.
void	setHasVideoContent (boolean hasVideoContent) اگر تبلیغ فعلی دارای محتوای ویدیویی باشد، روی true تنظیم کنید.
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) اگر شبکه تبلیغاتی به تنهایی ردیابی برداشت را انجام دهد، روی true تنظیم کنید.
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 شبکه میانجی راهی برای توقف ردیابی نمای تبلیغاتی بومی برای آگهی نگاشت شده توسط این شی ارائه می دهد، کلاس های فرعی باید این روش را اجرا کنند.

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

adChoicesContent

public View adChoicesContent

تبلیغ کننده

public String advertiser

بدن

public String body

callToAction

public String callToAction

اضافی

public Bundle extras

عنوان

public String headline

نماد

public NativeAd.Image icon

تصاویر

public List<NativeAd.Image> images

mediaContentAspect Ratio

public float mediaContentAspectRatio

overrideClickHandling

public boolean overrideClickHandling

overrideImpressionRecording

public boolean overrideImpressionRecording

قیمت

public String price

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

public Double starRating

فروشگاه

public String store

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

NativeAdMapper

public NativeAdMapper()

روش های عمومی

getAdChoicesContent

public View getAdChoicesContent()

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

دریافت تبلیغ

public final String getAdvertiser()

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

getBody

public final String getBody()

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

getCallToAction

public final String getCallToAction()

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

getCurrentTime

public float getCurrentTime()

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

دریافت مدت

public float getDuration()

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

دریافت اضافی

public final Bundle getExtras()

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

getHeadline

public final String getHeadline()

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

getIcon

public final NativeAd.Image getIcon()

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

getImages

public final List<NativeAd.Image> getImages()

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

getMediaContentAspectRatio

public float getMediaContentAspectRatio()

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

getOverrideClickHandling

public final boolean getOverrideClickHandling()

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

getOverrideImpressionRecording

public final boolean getOverrideImpressionRecording()

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

getPrice

public final String getPrice()

برای آگهی‌های مربوط به برنامه‌ها، رشته‌ای را برمی‌گرداند که نشان‌دهنده هزینه‌های برنامه است.

getStarRating

public final Double getStarRating()

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

getStore

public final String getStore()

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

handleClick

public void handleClick(View view)

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

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

public boolean hasVideoContent()

اگر تبلیغ فعلی محتوای ویدیویی داشته باشد، درست است.

recordImpression

public void recordImpression()

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

setAdChoicesContent

public void setAdChoicesContent(View adChoicesContent)

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

setAdvertiser

public final void setAdvertiser(String advertiser)

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

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

setBody

public final void setBody(String body)

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

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

setCallToAction

public final void setCallToAction(String callToAction)

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

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

setExtras

public final void setExtras(Bundle extras)

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

setHasVideoContent

public void setHasVideoContent(boolean hasVideoContent)

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

setheadline

public final void setHeadline(String headline)

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

setIcon

public final void setIcon(NativeAd.Image icon)

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

setImages

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

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

setMediaContentAspectRatio

public void setMediaContentAspectRatio(float mediaContentAspectRatio)

نسبت تصویر رسانه ای را که باید در MediaView ارائه شود را تنظیم می کند.

پارامترها
float mediaContentAspectRatio	نسبت تصویر به تنظیم

setMediaView

public void setMediaView(View mediaView)

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

setOverrideClickHandling

public final void setOverrideClickHandling(boolean overrideClickHandling)

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

setOverrideImpressionRecording

public final void setOverrideImpressionRecording(boolean overrideImpressionRecording)

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

setPrice

public final void setPrice(String price)

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

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

setStarRating

public final void setStarRating(Double starRating)

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

setStore

public final void setStore(String store)

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

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

trackViews

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

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

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

untrackView

public void untrackView(View view)

اگر SDK شبکه میانجی راهی برای توقف ردیابی نمای تبلیغاتی بومی برای آگهی نگاشت شده توسط این شی ارائه می دهد، کلاس های فرعی باید این روش را اجرا کنند.