NativeAd

public abstract class NativeAd

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

สรุป

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

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

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

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

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

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

วิธีการสาธารณะ
abstract void

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

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

เลิกใช้เมธอดนี้แล้ว

ใช้ enableCustomClickGestureDirection
abstract @Nullable NativeAd.AdChoicesInfo

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

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

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

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

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

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

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

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

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

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

NativeAd

public NativeAd()

วิธีการสาธารณะ

cancelUnconfirmedClick

public abstract void cancelUnconfirmedClick()

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

ทำลาย

public abstract void destroy()

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

enableCustomClickGesture

public abstract void enableCustomClickGesture()

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

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

getAdChoicesInfo

public abstract @Nullable NativeAd.AdChoicesInfo getAdChoicesInfo()

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

getAdvertiser

public abstract @Nullable String getAdvertiser()

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

getBody

public abstract @Nullable String getBody()

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

getCallToAction

public abstract @Nullable String getCallToAction()

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

getExtras

public abstract Bundle getExtras()

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

getHeadline

public abstract @Nullable String getHeadline()

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

getIcon

public abstract @Nullable NativeAd.Image getIcon()

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

getImages

public abstract List<NativeAd.Image> getImages()

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

getMediaContent

public abstract @Nullable MediaContent getMediaContent()

แสดง MediaContent ที่เชื่อมโยงกับโฆษณานี้

getMuteThisAdReasons

public abstract List<MuteThisAdReason> getMuteThisAdReasons()

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

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()

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

getStore

public abstract @Nullable String getStore()

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

isCustomClickGestureEnabled

public abstract boolean isCustomClickGestureEnabled()

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

isCustomMuteThisAdEnabled

public abstract boolean isCustomMuteThisAdEnabled()

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

muteThisAd

public abstract void muteThisAd(MuteThisAdReason muteThisAdReason)

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

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

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

performClick

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 

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

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

setPlacementId

public abstract void setPlacementId(long placementId)

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

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

พารามิเตอร์
long placementId

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

setUnconfirmedClickListener

public abstract void setUnconfirmedClickListener(
    NativeAd.UnconfirmedClickListener listener
)

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