Native Ad

public abstract class NativeAd


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

خلاصه

انواع تو در تو

public abstract class NativeAd.AdChoicesInfo

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

public abstract class NativeAd.Image

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

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

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

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

روش های عمومی

abstract void

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

abstract void

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

abstract void

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

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

abstract @ Nullable NativeAd.AdChoicesInfo

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

abstract @ Nullable String

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

abstract @ Nullable String

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

abstract @ Nullable String

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

abstract Bundle

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

abstract @ Nullable String

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

abstract @ Nullable NativeAd.Image

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

abstract List < NativeAd.Image >

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

abstract @ Nullable MediaContent

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

abstract List < MuteThisAdReason >

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

abstract long

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

abstract @ Nullable String

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

abstract @ Nullable ResponseInfo

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

abstract @ Nullable Double

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

abstract @ Nullable String

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

abstract boolean

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

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

abstract boolean

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

abstract void
muteThisAd ( MuteThisAdReason muteThisAdReason)

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

abstract void
performClick ( Bundle clickData)

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

abstract void

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

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

abstract boolean
recordImpression ( Bundle impressionData)

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

abstract void
reportTouchEvent ( Bundle touchEventData)

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

abstract void

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

abstract void

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

abstract void
setPlacementId (long placementId)

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

abstract void

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

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

Native Ad

public NativeAd()

روش های عمومی

cancelUnconfirmed کلیک کنید

public abstract void cancelUnconfirmedClick()

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

نابود کردن

public abstract void destroy()

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

فعال کردن CustomClickGesture

public abstract void enableCustomClickGesture()

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

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

getAdChoicesInfo

public abstract @Nullable NativeAd.AdChoicesInfo getAdChoicesInfo()

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

دریافت تبلیغ

public abstract @Nullable String getAdvertiser()

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

getBody

public abstract @Nullable String getBody()

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

getCallToAction

public abstract @Nullable String getCallToAction()

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

دریافت اضافی

public abstract Bundle getExtras()

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

getHeadline

public abstract @Nullable String getHeadline()

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

getIcon

public abstract @Nullable NativeAd.Image getIcon()

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

getImages

public abstract List<NativeAd.ImagegetImages()

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

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

public abstract @Nullable MediaContent getMediaContent()

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

getMuteThisAdReasons

public abstract List<MuteThisAdReasongetMuteThisAdReasons()

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

getPlacementId

public abstract long getPlacementId()

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

getPrice

public abstract @Nullable String getPrice()

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

getResponseInfo

public abstract @Nullable ResponseInfo getResponseInfo()

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

getStarRating

public abstract @Nullable Double getStarRating()

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

getStore

public abstract @Nullable String getStore()

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

isCustomClickGestureEnabled است

public abstract boolean isCustomClickGestureEnabled()

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

isCustomMuteThisAdEnabled

public abstract boolean isCustomMuteThisAdEnabled()

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

muteThisAd

public abstract void muteThisAd(MuteThisAdReason muteThisAdReason)

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

پارامترها
MuteThisAdReason muteThisAdReason

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

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

public abstract void performClick(Bundle clickData)

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

پارامترها
Bundle clickData

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

recordCustomClickGesture

public abstract void recordCustomClickGesture()

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

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

recordImpression

public abstract boolean recordImpression(Bundle impressionData)

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

پارامترها
Bundle impressionData

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

برمی گرداند
boolean

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

ReportTouchEvent

public abstract void reportTouchEvent(Bundle touchEventData)

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

پارامترها
Bundle touchEventData

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

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

public abstract void setMuteThisAdListener(MuteThisAdListener listener)

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

setOnPaidEventListener

public abstract void setOnPaidEventListener(@Nullable OnPaidEventListener listener)

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

setPlacementId

public abstract void setPlacementId(long placementId)

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

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

پارامترها
long placementId

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

setUnconfirmedClickListener

public abstract void setUnconfirmedClickListener(
    NativeAd.UnconfirmedClickListener listener
)

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