Native Ad

abstract class NativeAd


یک تبلیغ بومی گوگل.

خلاصه

انواع تو در تو

abstract class NativeAd.AdChoicesInfo

اطلاعات انتساب

abstract class NativeAd.Image

دارایی تصویر تبلیغاتی بومی.

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

هنگام استفاده از ویژگی کلیک تأیید شده، برنامه‌های رابط شنونده می‌توانند برای دریافت رویدادهای کلیک تأیید نشده استفاده کنند.

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

توابع عمومی

abstract Unit

یک کلیک تأیید نشده را که قبلاً برای آگهی ثبت شده بود، لغو می کند.

abstract Unit

شیء تبلیغاتی را از بین می برد.

abstract Unit

این تابع منسوخ شده است.

از enableCustomClickGestureDirection استفاده کنید.

abstract NativeAd.AdChoicesInfo ?

اطلاعات مربوط به عنوان AdChoices را برمی گرداند.

abstract String ?

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

abstract String ?

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

abstract String ?

دعوت به اقدام تبلیغ را برمی‌گرداند (مانند «خرید» یا «نصب»).

abstract Bundle !

بسته‌ای از دارایی‌های اضافی مرتبط با آگهی بومی را برمی‌گرداند.

abstract String ?

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

abstract NativeAd.Image ?

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

abstract ( Mutable ) List < NativeAd.Image !>!

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

abstract MediaContent ?

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

abstract ( Mutable ) List < MuteThisAdReason !>!

دلایل بی‌صدا کردن این آگهی را برمی‌گرداند.

abstract Long

شناسه مکان را برای این NativeAd برمی‌گرداند.

abstract String ?

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

abstract ResponseInfo ?

شی ResponseInfo را برای تبلیغ بارگذاری شده برمی گرداند.

abstract Double ?

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

abstract String ?

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

abstract Boolean

این تابع منسوخ شده است.

هنگام بارگیری یک تبلیغ با استفاده از enableCustomClickGestureDirection ، همه تبلیغات بازگردانده شده از اشاره کلیک سفارشی پشتیبانی می کنند.

abstract Boolean

اگر بتوان این آگهی را به صورت برنامه‌ریزی بی‌صدا کرد، true برمی‌گردد.

abstract Unit
muteThisAd (muteThisAdReason: MuteThisAdReason !)

این آگهی را به صورت برنامه‌ریزی بی‌صدا می‌کند.

abstract Unit
performClick (clickData: Bundle !)

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

abstract Unit

این تابع منسوخ شده است.

Google Mobile Ads SDK اکنون حرکات کلیک سفارشی را با استفاده از جهت اشاره کلیک درخواست شده در enableCustomClickGestureDirection ردیابی می کند.

abstract Boolean
recordImpression (impressionData: Bundle !)

زمانی که آگهی برای اولین بار نمایش داده می شود باید تماس گرفته شود.

abstract Unit
reportTouchEvent (touchEventData: Bundle !)

زمانی که یک رویداد لمسی در آگهی اتفاق می‌افتد، باید فراخوانی شود.

abstract Unit

MuteThisAdListener برای آگهی تنظیم می کند.

abstract Unit

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

abstract Unit
setPlacementId (placementId: Long )

یک شناسه مکان برای آگهی بومی تنظیم می کند.

abstract Unit

UnconfirmedClickListener را برای آگهی تنظیم می کند.

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

Native Ad

NativeAd()

توابع عمومی

cancelUnconfirmed کلیک کنید

abstract fun cancelUnconfirmedClick(): Unit

یک کلیک تأیید نشده را که قبلاً برای آگهی ثبت شده بود، لغو می کند.

نابود کردن

abstract fun destroy(): Unit

شیء تبلیغاتی را از بین می برد. هیچ متد دیگری نباید روی شیء تبلیغی پس از فراخوانی destroy فراخوانی شود.

فعال کردن CustomClickGesture

abstract fun enableCustomClickGesture(): Unit

ناشران را قادر می‌سازد که کلیک‌ها را با استفاده از حرکات سفارشی برای این NativeAd گزارش کنند. واحد تبلیغات باید در لیست مجاز باشد تا بتوان از این روش استفاده کرد.

به‌طور پیش‌فرض SDK کلیک‌ها را روی نماهای دارایی ردیابی می‌کند. اگر این روش فراخوانی شود، SDK دیگر کلیک‌های این NativeAd را ردیابی نمی‌کند. قبل از نمایش آگهی باید تماس گرفته شود.

getAdChoicesInfo

abstract fun getAdChoicesInfo(): NativeAd.AdChoicesInfo?

اطلاعات مربوط به عنوان AdChoices را برمی گرداند.

دریافت تبلیغ

abstract fun getAdvertiser(): String?

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

getBody

abstract fun getBody(): String?

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

getCallToAction

abstract fun getCallToAction(): String?

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

دریافت اضافی

abstract fun getExtras(): Bundle!

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

getHeadline

abstract fun getHeadline(): String?

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

getIcon

abstract fun getIcon(): NativeAd.Image?

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

getImages

abstract fun getImages(): (Mutable)List<NativeAd.Image!>!

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

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

abstract fun getMediaContent(): MediaContent?

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

getMuteThisAdReasons

abstract fun getMuteThisAdReasons(): (Mutable)List<MuteThisAdReason!>!

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

getPlacementId

abstract fun getPlacementId(): Long

شناسه مکان را برای این NativeAd برمی‌گرداند.

getPrice

abstract fun getPrice(): String?

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

getResponseInfo

abstract fun getResponseInfo(): ResponseInfo?

شی ResponseInfo را برای تبلیغ بارگذاری شده برمی گرداند. تا زمانی که آگهی با موفقیت بارگیری شود، null برمی‌گرداند.

getStarRating

abstract fun getStarRating(): Double?

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

getStore

abstract fun getStore(): String?

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

isCustomClickGestureEnabled است

abstract fun isCustomClickGestureEnabled(): Boolean

نشان می دهد که آیا می توان کلیک ها را با استفاده از حرکات کلیک سفارشی گزارش کرد یا خیر. با مدیر حساب خود تماس بگیرید تا واحد تبلیغات خود را برای این ویژگی در لیست مجاز قرار دهد.

isCustomMuteThisAdEnabled

abstract fun isCustomMuteThisAdEnabled(): Boolean

اگر بتوان این آگهی را به صورت برنامه‌ریزی بی‌صدا کرد، true برمی‌گردد. برای درخواست اجرای سفارشی Mute This Ad از setRequestCustomMuteThisAd استفاده کنید.

muteThisAd

abstract fun muteThisAd(muteThisAdReason: MuteThisAdReason!): Unit

این آگهی را به صورت برنامه‌ریزی بی‌صدا می‌کند.

پارامترها
muteThisAdReason: MuteThisAdReason !

دلیل بی صدا انتخاب شده توسط کاربر. دلایل نادیده گرفتن را از getMuteThisAdReasons دریافت کنید. null برای نادیده گرفتن این آگهی با دلیل پیش فرض استفاده کنید.

اجرا کلیک کنید

abstract fun performClick(clickData: Bundle!): Unit

زمانی که کاربر روی تبلیغ کلیک کرده است باید تماس گرفته شود. واحد تبلیغات باید در لیست مجاز باشد تا بتوانید از این api استفاده کنید. این روش فقط باید توسط ناشران افزونه Unity استفاده شود.

پارامترها
clickData: Bundle !

بسته ای از محیط برنامه زمانی که کلیک اتفاق می افتد. برای جزئیات ساخت Bundle داده کلیکی، NativeAdConstants را ببینید.

recordCustomClickGesture

abstract fun recordCustomClickGesture(): Unit

با استفاده از اشاره کلیک سفارشی، کلیک‌ها را برای این NativeAd گزارش می‌کند. واحد تبلیغات باید در لیست مجاز باشد تا بتوان از این روش استفاده کرد.

enableCustomClickGesture باید قبل از فراخوانی این متد فراخوانی شود.

recordImpression

abstract fun recordImpression(impressionData: Bundle!): Boolean

زمانی که آگهی برای اولین بار نمایش داده می شود باید تماس گرفته شود. واحد تبلیغات باید در لیست مجاز باشد تا بتوانید از این api استفاده کنید.

پارامترها
impressionData: Bundle !

بسته‌ای از محیط برنامه زمانی که برداشت اتفاق می‌افتد. برای جزئیات ساخت Bundle داده کلیکی، NativeAdConstants را ببینید.

برمی گرداند
Boolean

درست است اگر برداشت با موفقیت ثبت شود

ReportTouchEvent

abstract fun reportTouchEvent(touchEventData: Bundle!): Unit

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

پارامترها
touchEventData: Bundle !

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

نمونه نمایش JSON از touchEventData Bundle:

  {    "x": "100",  // The x-coordinate of the touch event relative to the window.    "y": "50",  // The y-coordinate of the touch event relative to the window.    "duration_millis": "500",  // The amount of milliseconds the user pressed on the asset.  }

setMuteThisAdListener

abstract fun setMuteThisAdListener(listener: MuteThisAdListener!): Unit

MuteThisAdListener برای آگهی تنظیم می کند.

setOnPaidEventListener

abstract fun setOnPaidEventListener(listener: OnPaidEventListener?): Unit

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

setPlacementId

abstract fun setPlacementId(placementId: Long): Unit

یک شناسه مکان برای آگهی بومی تنظیم می کند.

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

پارامترها
placementId: Long

یک عدد صحیح طولانی که توسط AdMob UI برای مکان پیکربندی شده ارائه شده است.

setUnconfirmedClickListener

abstract fun setUnconfirmedClickListener(
    listener: NativeAd.UnconfirmedClickListener!
): Unit

UnconfirmedClickListener را برای آگهی تنظیم می کند.