بومی اد

کاتلین | جاوا

abstract class NativeAd

---

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

خلاصه

انواع تو در تو
abstract class NativeAd.AdChoicesInfo اطلاعات انتساب.
abstract class NativeAd.Image یک تصویر تبلیغاتی بومی.
interface NativeAd.OnNativeAdLoadedListener تعریف رابط برای فراخوانی یک فراخوانی مجدد هنگام بارگذاری موفقیت‌آمیز یک تبلیغ بومی.
interface NativeAd.UnconfirmedClickListener برنامه‌های رابط شنونده می‌توانند هنگام استفاده از ویژگی کلیک تأیید شده، رویدادهای کلیک تأیید نشده را دریافت کنند.

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

کارکردهای عمومی
abstract Unit	cancelUnconfirmedClick () کلیک تایید نشده‌ای که قبلاً برای تبلیغ ثبت شده بود را لغو می‌کند.
abstract Unit	destroy () شیء تبلیغ را از بین می‌برد.
abstract Unit	enableCustomClickGesture () این تابع منسوخ شده است. از enableCustomClickGestureDirection استفاده کنید.
abstract NativeAd.AdChoicesInfo ?	getAdChoicesInfo () اطلاعات مربوط به انتساب AdChoices را برمی‌گرداند.
abstract String ?	getAdvertiser () متنی را برمی‌گرداند که تبلیغ‌کننده را مشخص می‌کند.
abstract String ?	getBody () متن بدنه را برمی‌گرداند.
abstract String ?	getCallToAction () فراخوان عمل تبلیغ (مانند «خرید» یا «نصب») را برمی‌گرداند.
abstract Bundle !	getExtras () مجموعه‌ای از دارایی‌های اضافی مرتبط با تبلیغ بومی را برمی‌گرداند.
abstract String ?	getHeadline () عنوان اصلی متن را برمی‌گرداند.
abstract NativeAd.Image ?	getIcon () یک تصویر کوچک که تبلیغ‌کننده را شناسایی می‌کند، برمی‌گرداند.
abstract ( Mutable ) List < NativeAd.Image !>!	getImages () لیستی از تصاویر بزرگ را برمی‌گرداند.
abstract MediaContent ?	getMediaContent () MediaContent مرتبط با این تبلیغ را برمی‌گرداند.
abstract ( Mutable ) List < MuteThisAdReason !>!	getMuteThisAdReasons () دلایل موجود برای این تبلیغ: بی‌صدا کردن این تبلیغ.
abstract Long	getPlacementId () شناسه قرارگیری برای این NativeAd را برمی‌گرداند.
abstract String ?	getPrice () برای تبلیغات مربوط به برنامه‌ها، رشته‌ای را برمی‌گرداند که نشان می‌دهد هزینه برنامه چقدر است.
abstract ResponseInfo ?	getResponseInfo () شیء ResponseInfo را برای تبلیغ بارگذاری شده برمی‌گرداند.
abstract Double ?	getStarRating () برای تبلیغات مربوط به برنامه‌ها، امتیاز ستاره‌ای از ۰ تا ۵ را برمی‌گرداند که نشان می‌دهد برنامه در فروشگاه چند ستاره دارد.
abstract String ?	getStore () برای تبلیغات مربوط به برنامه‌ها، نام فروشگاهی که برنامه را برای دانلود ارائه می‌دهد، برمی‌گرداند.
abstract Boolean	isCustomClickGestureEnabled () این تابع منسوخ شده است. هنگام بارگذاری یک تبلیغ با استفاده از enableCustomClickGestureDirection ، تمام تبلیغات نمایش داده شده از ژست کلیک سفارشی پشتیبانی می‌کنند.
abstract Boolean	isCustomMuteThisAdEnabled () اگر بتوان این تبلیغ را از طریق برنامه‌نویسی بی‌صدا کرد، true را برمی‌گرداند.
abstract Unit	muteThisAd (muteThisAdReason: MuteThisAdReason !) این تبلیغ را به صورت برنامه‌ریزی‌شده بی‌صدا می‌کند.
abstract Unit	performClick (clickData: Bundle !) باید زمانی فراخوانی شود که کاربر روی تبلیغ کلیک کرده باشد.
abstract Unit	recordCustomClickGesture () این تابع منسوخ شده است. کیت توسعه نرم‌افزاری تبلیغات موبایل گوگل (SDK) اکنون حرکات کلیک سفارشی را با استفاده از جهت حرکت کلیک درخواست‌شده در enableCustomClickGestureDirection ردیابی می‌کند.
abstract Boolean	recordImpression (impressionData: Bundle !) باید هنگام اولین نمایش تبلیغ فراخوانی شود.
abstract Unit	reportTouchEvent (touchEventData: Bundle !) باید زمانی فراخوانی شود که یک رویداد لمسی در تبلیغ رخ دهد.
abstract Unit	setMuteThisAdListener (listener: MuteThisAdListener !) MuteThisAdListener را برای تبلیغ تنظیم می‌کند.
abstract Unit	setOnPaidEventListener (listener: OnPaidEventListener ?) یک فراخوان ثبت کنید تا وقتی تخمین زده شد که این تبلیغ درآمد کسب کرده است، فراخوانی شود.
abstract Unit	setPlacementId (placementId: Long ) یک شناسه قرارگیری برای تبلیغ بومی تنظیم می‌کند.
abstract Unit	setUnconfirmedClickListener ( listener: NativeAd.UnconfirmedClickListener ! ) UnconfirmedClickListener را برای تبلیغ تنظیم می‌کند.

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

بومی اد

NativeAd()

کارکردهای عمومی

لغوتأیید نشدهکلیک کنید

abstract fun cancelUnconfirmedClick(): Unit

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

نابود کردن

abstract fun destroy(): Unit

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

فعال کردن ژست کلیک سفارشی

abstract fun enableCustomClickGesture(): Unit

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

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

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

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

اطلاعات مربوط به انتخاب‌های تبلیغاتی (getAdChoicesInfo)

abstract fun getAdChoicesInfo(): NativeAd.AdChoicesInfo?

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

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

abstract fun getAdvertiser(): String?

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

دریافت بدن

abstract fun getBody(): String?

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

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

abstract fun getCallToAction(): String?

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

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

abstract fun getExtras(): Bundle!

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

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

abstract fun getHeadline(): String?

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

دریافت آیکون

abstract fun getIcon(): NativeAd.Image?

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

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

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

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

دریافت محتوای رسانه‌ای

abstract fun getMediaContent(): MediaContent?

MediaContent مرتبط با این تبلیغ را برمی‌گرداند.

دلایل بی‌صدا کردن این تبلیغ

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

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

دریافت شناسه‌ی مکان

abstract fun getPlacementId(): Long

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

دریافت قیمت

abstract fun getPrice(): String?

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

دریافت اطلاعات پاسخ

abstract fun getResponseInfo(): ResponseInfo?

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

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

abstract fun getStarRating(): Double?

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

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

abstract fun getStore(): String?

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

isCustomClickGestureEnabled

abstract fun isCustomClickGestureEnabled(): Boolean

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

هنگام بارگذاری یک تبلیغ با استفاده از enableCustomClickGestureDirection ، تمام تبلیغات نمایش داده شده از ژست کلیک سفارشی پشتیبانی می‌کنند. اگر حساب شما برای این ویژگی مجاز نباشد، درخواست تبلیغ اجرا نخواهد شد.

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

isCustomMuteThisAdEnabled

abstract fun isCustomMuteThisAdEnabled(): Boolean

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

بی‌صدا کردن این تبلیغ

abstract fun muteThisAd(muteThisAdReason: MuteThisAdReason!): Unit

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

پارامترها
muteThisAdReason: MuteThisAdReason !	دلیل بی‌صدا کردن انتخاب شده توسط کاربر. دلایل بی‌صدا کردن را از getMuteThisAdReasons دریافت کنید. برای بی‌صدا کردن این تبلیغ با دلیل پیش‌فرض، null استفاده کنید.

اجراکلیک

abstract fun performClick(clickData: Bundle!): Unit

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

پارامترها
clickData: Bundle !	بسته‌ای از محیط برنامه هنگام کلیک. برای جزئیات بیشتر در مورد ساخت Bundle داده کلیک، به NativeAdConstants مراجعه کنید.

ژست کلیک سفارشی ضبط

abstract fun recordCustomClickGesture(): Unit

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

کیت توسعه نرم‌افزاری تبلیغات موبایل گوگل (SDK) اکنون حرکات کلیک سفارشی را با استفاده از جهت حرکت کلیک درخواست‌شده در enableCustomClickGestureDirection ردیابی می‌کند.

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

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

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

abstract fun recordImpression(impressionData: Bundle!): Boolean

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

پارامترها
impressionData: Bundle !	بسته‌ای از محیط برنامه هنگام وقوع نمایش. برای جزئیات بیشتر در مورد ساخت Bundle داده‌های نمایش، به NativeAdConstants مراجعه کنید.

بازگشت‌ها
Boolean	اگر برداشت با موفقیت ثبت شود، درست است

گزارش رویداد لمسی

abstract fun reportTouchEvent(touchEventData: Bundle!): Unit

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

پارامترها
touchEventData: Bundle !	مجموعه‌ای از مختصات و مدت زمان رویداد لمسی. مثالی از نمایش JSON از بسته touchEventData: { "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

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

شناسه‌ی جایگذاری را تنظیم کنید

abstract fun setPlacementId(placementId: Long): Unit

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

برای اطمینان از اینکه این شناسه‌ی قرارگیری در گزارش‌دهی لحاظ شده است، قبل از مرتبط کردن تبلیغ با NativeAdView، این متد را فراخوانی کنید.

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

setUnconfirmedClickListener

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

UnconfirmedClickListener را برای تبلیغ تنظیم می‌کند.