NativeAd

abstract class NativeAd

โฆษณาเนทีฟของ Google

สรุป

ประเภทที่ซ้อนกัน
abstract class NativeAd.AdChoicesInfo

ข้อมูลการระบุแหล่งที่มา
abstract class NativeAd.Image

ชิ้นงานรูปภาพโฆษณาเนทีฟ

คำจำกัดความของอินเทอร์เฟซสำหรับ Callback ที่จะเรียกใช้เมื่อโหลดโฆษณาเนทีฟสำเร็จ

อินเทอร์เฟซ Listener ที่แอปใช้เพื่อรับเหตุการณ์คลิกที่ยังไม่ได้รับการยืนยันเมื่อใช้ฟีเจอร์คลิกที่ยืนยันแล้ว

ผู้รับเหมาสาธารณะ

ฟังก์ชันสาธารณะ
abstract Unit

ยกเลิกการคลิกที่ยังไม่ได้รับการยืนยันซึ่งบันทึกไว้ก่อนหน้านี้สำหรับโฆษณา
abstract Unit

ทำลายออบเจ็กต์โฆษณา
abstract Unit

ฟังก์ชันนี้เลิกใช้งานแล้ว

ใช้ enableCustomClickGestureDirection
abstract NativeAd.AdChoicesInfo?

แสดงข้อมูลสำหรับการระบุแหล่งที่มาของตัวเลือกโฆษณาอื่นๆ
abstract String?

แสดงข้อความที่ระบุผู้ลงโฆษณา
abstract String?

แสดงข้อความเนื้อหา
abstract String?

แสดงคำกระตุ้นให้ดำเนินการ (Call-To-Action) ของโฆษณา (เช่น "ซื้อ" หรือ "ติดตั้ง")
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?

สำหรับโฆษณาเกี่ยวกับแอป จะแสดงคะแนนเป็นดาวตั้งแต่ 0 ถึง 5 ซึ่งแสดงจำนวนดาวที่แอปมีในร้านค้าที่เสนอแอป
abstract String?

สําหรับโฆษณาเกี่ยวกับแอป จะแสดงชื่อของ Store ที่เสนอแอปให้ดาวน์โหลด
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

ลงทะเบียน Callback ที่จะเรียกใช้เมื่อระบบประเมินว่าโฆษณานี้สร้างรายได้
abstract Unit
setPlacementId(placementId: Long)

ตั้งค่ารหัสตำแหน่งสำหรับโฆษณาเนทีฟ
abstract Unit

ตั้งค่า UnconfirmedClickListener สำหรับโฆษณา

ผู้รับเหมาสาธารณะ

NativeAd

NativeAd()

ฟังก์ชันสาธารณะ

cancelUnconfirmedClick

abstract fun cancelUnconfirmedClick(): Unit

ยกเลิกการคลิกที่ยังไม่ได้รับการยืนยันซึ่งบันทึกไว้ก่อนหน้านี้สำหรับโฆษณา

ทำลาย

abstract fun destroy(): Unit

ทำลายออบเจ็กต์โฆษณา ไม่ควรเรียกใช้เมธอดอื่นๆ ในออบเจ็กต์โฆษณาหลังจากเรียกใช้ destroy

enableCustomClickGesture

abstract fun enableCustomClickGesture(): Unit

ช่วยให้ผู้เผยแพร่โฆษณารายงานการคลิกโดยใช้ท่าทางสัมผัสที่กำหนดเองสำหรับ NativeAd นี้ หน่วยโฆษณาต้องอยู่ในรายการที่อนุญาตจึงจะใช้วิธีนี้ได้

โดยค่าเริ่มต้น SDK จะติดตามการคลิกในมุมมองชิ้นงาน หากเรียกใช้เมธอดนี้ SDK จะไม่ติดตามการคลิกสำหรับ NativeAd นี้อีกต่อไป ควรเรียกใช้ก่อนแสดงโฆษณา

getAdChoicesInfo

abstract fun getAdChoicesInfo(): NativeAd.AdChoicesInfo?

แสดงข้อมูลสำหรับการระบุแหล่งที่มาของตัวเลือกโฆษณาอื่นๆ

getAdvertiser

abstract fun getAdvertiser(): String?

แสดงข้อความที่ระบุผู้ลงโฆษณา แอปไม่จำเป็นต้องแสดงชิ้นงานนี้ แต่เราขอแนะนำให้แสดง

getBody

abstract fun getBody(): String?

แสดงข้อความเนื้อหา แอปต้องแสดงชิ้นงานนี้

getCallToAction

abstract fun getCallToAction(): String?

แสดงคำกระตุ้นให้ดำเนินการ (Call-To-Action) ของโฆษณา (เช่น "ซื้อ" หรือ "ติดตั้ง") แอปไม่จำเป็นต้องแสดงชิ้นงานนี้ แต่เราขอแนะนำให้แสดง

getExtras

abstract fun getExtras(): Bundle!

แสดงผลชุดชิ้นงานเพิ่มเติมที่เชื่อมโยงกับโฆษณาเนทีฟ หากโฆษณาของพาร์ทเนอร์สื่อกลางมีชิ้นงานนอกเหนือจากชิ้นงานมาตรฐาน (ราคา ร้านค้า ฯลฯ) คุณจะตั้งค่าได้โดยการเรียกใช้เมธอดใน setExtras และเรียกข้อมูลได้ผ่านเมธอดนี้ สำหรับโฟลว์ที่ไม่ใช่สื่อกลาง ระบบจะแสดงผลกลุ่มว่าง

getHeadline

abstract fun getHeadline(): String?

แสดงบรรทัดแรกของข้อความหลัก แอปต้องแสดงชิ้นงานนี้

getIcon

abstract fun getIcon(): NativeAd.Image?

แสดงผลรูปภาพขนาดเล็กที่ระบุตัวตนของผู้ลงโฆษณา แอปไม่จำเป็นต้องแสดงชิ้นงานนี้ แต่เราขอแนะนำให้แสดง

getImages

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

แสดงรายการรูปภาพขนาดใหญ่ แอปไม่จำเป็นต้องแสดงชิ้นงานนี้ แต่เราขอแนะนำให้แสดง

getMediaContent

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?

สำหรับโฆษณาเกี่ยวกับแอป จะแสดงคะแนนเป็นดาวตั้งแต่ 0 ถึง 5 ซึ่งแสดงจำนวนดาวที่แอปมีในร้านค้าที่เสนอแอป แอปไม่จำเป็นต้องแสดงชิ้นงานนี้ แต่เราขอแนะนำให้แสดง

getStore

abstract fun getStore(): String?

สําหรับโฆษณาเกี่ยวกับแอป จะแสดงชื่อของ Store ที่เสนอแอปให้ดาวน์โหลด เช่น "Google Play" แอปไม่จำเป็นต้องแสดงชิ้นงานนี้ แต่เราขอแนะนำให้แสดง

isCustomClickGestureEnabled

abstract fun isCustomClickGestureEnabled(): Boolean

ระบุว่ารายงานการคลิกได้หรือไม่โดยใช้ท่าทางการคลิกที่กำหนดเอง โปรดติดต่อผู้จัดการฝ่ายดูแลลูกค้าเพื่อเพิ่มหน่วยโฆษณาของคุณลงในรายการที่อนุญาตสำหรับฟีเจอร์นี้

isCustomMuteThisAdEnabled

abstract fun isCustomMuteThisAdEnabled(): Boolean

แสดงผล true หากปิดเสียงโฆษณานี้โดยอัตโนมัติได้ ใช้ setRequestCustomMuteThisAd เพื่อขอการติดตั้งใช้งานฟีเจอร์ซ่อนโฆษณานี้ที่กำหนดเอง

muteThisAd

abstract fun muteThisAd(muteThisAdReason: MuteThisAdReason!): Unit

ซ่อนโฆษณานี้แบบเป็นโปรแกรม

พารามิเตอร์
muteThisAdReason: MuteThisAdReason!

เหตุผลที่ผู้ใช้เลือกปิดเสียง ดูเหตุผลที่ปิดเสียงจาก getMuteThisAdReasons ใช้ null เพื่อซ่อนโฆษณานี้ด้วยเหตุผลเริ่มต้น

performClick

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 

  {    "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

ลงทะเบียน Callback ที่จะเรียกใช้เมื่อระบบประเมินว่าโฆษณานี้สร้างรายได้

setPlacementId

abstract fun setPlacementId(placementId: Long): Unit

ตั้งค่ารหัสตำแหน่งสำหรับโฆษณาเนทีฟ

หากต้องการให้รวมรหัสการวางตำแหน่งนี้ไว้ในการรายงาน ให้เรียกใช้เมธอดนี้ก่อนเชื่อมโยงโฆษณากับ NativeAdView

พารามิเตอร์
placementId: Long

จำนวนเต็มแบบยาวที่ UI ของ AdMob ระบุสำหรับตําแหน่งที่กําหนดค่า

setUnconfirmedClickListener

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

ตั้งค่า UnconfirmedClickListener สำหรับโฆษณา