بومی اد

کاتلین | جاوا

public abstract class NativeAd

---

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

خلاصه

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

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

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

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

بومی اد

public NativeAd()

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

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

public abstract void cancelUnconfirmedClick()

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

نابود کردن

public abstract void destroy()

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

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

public abstract void enableCustomClickGesture()

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

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

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

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

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

public abstract @Nullable NativeAd.AdChoicesInfo getAdChoicesInfo()

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

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

public abstract @Nullable String getAdvertiser()

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

دریافت بدن

public abstract @Nullable String getBody()

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

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

public abstract @Nullable String getCallToAction()

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

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

public abstract Bundle getExtras()

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

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

public abstract @Nullable String getHeadline()

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

دریافت آیکون

public abstract @Nullable NativeAd.Image getIcon()

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

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

public abstract List<NativeAd.Image> getImages()

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

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

public abstract @Nullable MediaContent getMediaContent()

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

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

public abstract List<MuteThisAdReason> getMuteThisAdReasons()

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

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

public abstract long getPlacementId()

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

دریافت قیمت

public abstract @Nullable String getPrice()

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

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

public abstract @Nullable ResponseInfo getResponseInfo()

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

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

public abstract @Nullable Double getStarRating()

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

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

public abstract @Nullable String getStore()

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

isCustomClickGestureEnabled

public abstract boolean isCustomClickGestureEnabled()

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

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

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

isCustomMuteThisAdEnabled

public abstract boolean isCustomMuteThisAdEnabled()

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

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

public abstract void muteThisAd(MuteThisAdReason muteThisAdReason)

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

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

اجراکلیک

public abstract void performClick(Bundle clickData)

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

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

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

public abstract void recordCustomClickGesture()

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

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

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

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

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

public abstract boolean recordImpression(Bundle impressionData)

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

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

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

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

public abstract void reportTouchEvent(Bundle touchEventData)

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

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

public abstract void setMuteThisAdListener(MuteThisAdListener listener)

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

setOnPaidEventListener

public abstract void setOnPaidEventListener(@Nullable OnPaidEventListener listener)

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

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

public abstract void setPlacementId(long placementId)

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

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

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

setUnconfirmedClickListener

public abstract void setUnconfirmedClickListener(
    NativeAd.UnconfirmedClickListener listener
)

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