Google กำลังสร้างแพลตฟอร์มในอุปกรณ์ที่จัดระเบียบแอปของผู้ใช้ตามประเภทธุรกิจ และสร้างประสบการณ์ที่สมจริงแบบใหม่สำหรับการบริโภคและการค้นพบเนื้อหาของแอปที่ปรับเปลี่ยนในแบบของคุณ ประสบการณ์แบบเต็มหน้าจอนี้เปิดโอกาสให้พาร์ทเนอร์นักพัฒนาแอปได้แสดงเนื้อหาริชมีเดียที่ดีที่สุดในช่องทางเฉพาะนอกแอป
เอกสารนี้มีวิธีการสำหรับพาร์ทเนอร์นักพัฒนาซอฟต์แวร์ในการผสานรวมเนื้อหาใหม่ เช่น การจอง กิจกรรม ที่พัก สถานที่ที่น่าสนใจ ผู้คน และเนื้อหาอื่นๆ ซึ่งอาจไม่ได้อยู่ในหมวดหมู่ใดๆ เหล่านี้โดยใช้ Engage SDK ในการเติมข้อมูลพื้นที่ใหม่นี้
รายละเอียดการผสานรวม
คำศัพท์
การผสานรวมนี้ประกอบด้วยคลัสเตอร์ 3 ประเภท ได้แก่ คําแนะนํา แนะนํา และต่อเนื่อง
กลุ่มคําแนะนําจะแสดงคําแนะนําที่ปรับเปลี่ยนในแบบของคุณจากพาร์ทเนอร์นักพัฒนาแอปรายบุคคล โดยเป็นมุมมอง UI ที่มีกลุ่มคําแนะนําจากพาร์ทเนอร์นักพัฒนาแอปรายเดียวกัน
ArticleEntity: ArticleEntity ที่แสดงคำแนะนำแบบข้อความสำหรับเนื้อหาที่เกี่ยวข้องกับเนื้อหามากกว่า 1 หมวดหมู่ รายการ ArticleEntity ช่วยให้นักพัฒนาแอประบุเนื้อหาข้อความและรูปภาพได้หลากหลายพร้อมข้อมูลเมตาเพิ่มเติมเพื่ออธิบายข้อมูลแก่ผู้ใช้ได้เมื่อเทียบกับ GenericFeaturedEntity เช่น เนื้อหาการตลาด ตัวอย่างข้อมูลข่าว
EventEntity: EventEntity แสดงถึงเหตุการณ์ที่เกิดขึ้นในอนาคต เวลาเริ่มต้นของกิจกรรมเป็นข้อมูลสำคัญที่จำเป็นต้องแจ้งให้ผู้ใช้ทราบ
LodgingEntity: LodgingEntity แสดงที่พัก เช่น โรงแรม อพาร์ตเมนต์ บ้านพักให้เช่าระยะสั้นและระยะยาว
StoreEntity: StoreEntity แสดงถึงร้านค้า ร้านอาหาร คาเฟ่ ฯลฯ โดยจะไฮไลต์เนื้อหาที่สถานที่รับประทานอาหารหรือร้านค้าเป็นข้อมูลสำคัญที่ต้องสื่อให้ผู้ใช้
PointOfInterestEntity: PointOfInterestEntity แสดงถึงสถานที่ที่น่าสนใจ เช่น ปั๊มน้ำมัน สถานที่จัดงาน สวนสนุก พิพิธภัณฑ์ สถานที่ท่องเที่ยว เส้นทางเดินป่า ฯลฯ โดยจะไฮไลต์เนื้อหาที่ตำแหน่งเป็นข้อมูลสำคัญที่ต้องสื่อให้ผู้ใช้ทราบ ไม่ควรใช้กับที่พัก ร้านค้า หรือสถานที่รับประทานอาหาร
PersonEntity: PersonEntity แสดงถึงบุคคล คำแนะนำอาจเป็นการไฮไลต์บุคคลในหมวดหมู่ต่างๆ เช่น สุขภาพและการออกกำลังกาย กีฬา การหาคู่ และอื่นๆ
คลัสเตอร์ความต่อเนื่องจะแสดงเนื้อหาที่ผู้ใช้เพิ่งมีส่วนร่วมเมื่อเร็วๆ นี้จากพาร์ทเนอร์นักพัฒนาซอฟต์แวร์หลายรายในการจัดกลุ่ม UI เดียว พาร์ทเนอร์นักพัฒนาแอปแต่ละรายจะออกอากาศได้สูงสุด 10 รายการในกลุ่มการออกอากาศต่อเนื่อง
เนื้อหาต่อสามารถมีโครงสร้างดังต่อไปนี้
ArticleEntity: ArticleEntity ที่แสดงคําแนะนําแบบข้อความสําหรับเนื้อหาที่เกี่ยวข้องกับหมวดหมู่เนื้อหามากกว่า 1 หมวดหมู่ เอนทิตีนี้สามารถใช้เพื่อแสดงบทความข่าวที่อ่านไม่จบหรือเนื้อหาอื่นๆ ที่ผู้ใช้ต้องการรับชมต่อจากจุดที่อ่านค้างไว้ เช่น เนื้อหาการตลาด ตัวอย่างข้อมูลข่าว
RestaurantReservationEntity: RestaurantReservationEntity แสดงการจองร้านอาหารหรือคาเฟ่ และช่วยให้ผู้ใช้ติดตามการจองร้านอาหารที่กําลังจะเกิดขึ้นหรืออยู่ระหว่างดำเนินการได้
EventReservationEntity: EventReservationEntity แสดงถึงการจองกิจกรรมและช่วยให้ผู้ใช้ติดตามการจองกิจกรรมที่กําลังจะเกิดขึ้นหรือกําลังดำเนินอยู่ กิจกรรมอาจรวมถึงแต่ไม่จำกัดเพียงกิจกรรมต่อไปนี้
- กิจกรรมกีฬา เช่น การจองตั๋วเข้าชมการแข่งขันฟุตบอล
- กิจกรรมเกี่ยวกับเกม เช่น การจอง eSports
- กิจกรรมบันเทิง เช่น การจองตั๋วภาพยนตร์ในโรงภาพยนตร์ คอนเสิร์ต โรงละคร การเซ็นหนังสือ
- การจองการเดินทางหรือสถานที่น่าสนใจ เช่น ทัวร์ชมพร้อมไกด์ ตั๋วเข้าชมพิพิธภัณฑ์
- การจองงานสังคม / สัมมนา / ประชุม
- การจองเซสชันการศึกษา/การฝึกอบรม
LodgingReservationEntity: LodgingEntityReservation แสดงการจองที่พักสำหรับการเดินทาง และช่วยให้ผู้ใช้ติดตามการจองโรงแรมหรือที่พักให้เช่าที่กําลังจะเกิดขึ้นหรือเกิดขึ้นอยู่
TransportationReservationEntity: TransportationReservationEntity แสดงการจองสำหรับการเดินทางด้วยรูปแบบใดก็ได้ และช่วยให้ผู้ใช้ติดตามการจองสำหรับเที่ยวบิน เรือเฟอร์รี่ รถไฟ รถประจำทาง บริการเรียกรถ หรือเรือสำราญที่กําลังจะเกิดขึ้นหรือเกิดขึ้นอยู่
VehicleRentalReservationEntity: VehicleRentalReservationEntity แสดงการจองรถเช่าและช่วยให้ผู้ใช้ติดตามการจองรถเช่าที่กําลังจะเกิดขึ้นหรืออยู่ระหว่างดำเนินการ
กลุ่มแนะนําคือมุมมอง UI ที่แสดงแอปฮีโร่ที่เลือกจากพาร์ทเนอร์นักพัฒนาแอปจํานวนมากในการรวมกลุ่ม UI กลุ่มเดียว คลัสเตอร์แนะนำจะมีเพียงกลุ่มเดียว ซึ่งจะแสดงอยู่ใกล้กับด้านบนของ UI โดยมีตำแหน่งที่มีความสำคัญเหนือกว่าคลัสเตอร์คำแนะนำทั้งหมด พาร์ทเนอร์นักพัฒนาแอปแต่ละรายได้รับอนุญาตให้เผยแพร่เอนทิตีเดียวของประเภทที่รองรับใน "แนะนำ" โดยมีเอนทิตีจำนวนมาก (อาจเป็นคนละประเภท) จากนักพัฒนาแอปหลายรายในคลัสเตอร์ "แนะนำ"
GenericFeaturedEntity: GenericFeaturedEntity แตกต่างจากรายการคำแนะนำตรงที่ควรใช้รายการแนะนำสำหรับเนื้อหายอดนิยมรายการเดียวจากนักพัฒนาแอป และควรแสดงเนื้อหาที่สำคัญที่สุดรายการเดียวที่จะน่าสนใจและเกี่ยวข้องกับผู้ใช้
งานก่อนเริ่มเวิร์กช็อป
ระดับ API ขั้นต่ำ: 19
วิธีเพิ่มคลัง com.google.android.engage:engage-core
ลงในแอป
dependencies {
// Make sure you also include that repository in your project's build.gradle file.
implementation 'com.google.android.engage:engage-core:1.5.2'
}
สรุป
การออกแบบนี้อิงตามการใช้งานบริการที่เชื่อมโยง
ข้อมูลที่ไคลเอ็นต์เผยแพร่ได้จะขึ้นอยู่กับขีดจำกัดต่อไปนี้สำหรับประเภทคลัสเตอร์ต่างๆ
ประเภทคลัสเตอร์ | ขีดจำกัดของคลัสเตอร์ | ขีดจำกัดเอนทิตีขั้นต่ำในคลัสเตอร์ | ขีดจํากัดสูงสุดของเอนทิตีในคลัสเตอร์ |
---|---|---|---|
กลุ่มคําแนะนํา | ไม่เกิน 5 | อย่างน้อย 5 | ไม่เกิน 25 (ArticleEntity , EventEntity ,
LodgingEntity , StoreEntity ,
PointOfInterestEntity หรือ PersonEntity ) |
คลัสเตอร์ความต่อเนื่อง | ไม่เกิน 1 | อย่างน้อย 1 | ไม่เกิน 10 รายการ (ArticleEntity ,
EventReservationEntity ,
LodgingReservationEntity ,
TransportationReservationEntity หรือ
VehicleRentalReservationEntity ) |
คลัสเตอร์แนะนำ | ไม่เกิน 1 | อย่างน้อย 1 รายการ | ไม่เกิน 10 (GenericFeaturedEntity ) |
ขั้นตอนที่ 1: ระบุข้อมูลเอนทิตี
SDK ได้กําหนดเอนทิตีต่างๆ เพื่อแสดงรายการแต่ละประเภท เรารองรับเอนทิตีต่อไปนี้สำหรับหมวดหมู่อื่นๆ
GenericFeaturedEntity
ArticleEntity
EventEntity
LodgingEntity
StoreEntity
PointOfInterestEntity
PersonEntity
RestaurantReservationEntity
EventReservationEntity
LodgingReservationEntity
TransportationReservationEntity
VehicleRentalReservationEntity
แผนภูมิด้านล่างแสดงแอตทริบิวต์และข้อกําหนดที่ใช้ได้สําหรับแต่ละประเภท
GenericFeaturedEntity
แอตทริบิวต์ | ข้อกำหนด | คำอธิบาย | รูปแบบ |
---|---|---|---|
URI การดำเนินการ | ต้องระบุ |
Deep Link ไปยังเอนทิตีในแอปของผู้ให้บริการ หมายเหตุ: คุณสามารถใช้ Deep Link สําหรับการระบุแหล่งที่มาได้ ดูคำถามที่พบบ่อยนี้ |
URI |
ภาพโปสเตอร์ | ต้องระบุ | เราจะแสดงเพียง 1 ภาพหากมีหลายภาพ สัดส่วนภาพที่แนะนำคือ 16:9 หมายเหตุ: หากมีป้าย ให้เว้นพื้นที่ปลอดภัย 24 dp ทั้งด้านบนและด้านล่างของรูปภาพ |
โปรดดูข้อกำหนดเกี่ยวกับรูปภาพสำหรับคำแนะนำ |
ชื่อ | ไม่บังคับ | ชื่อของเอนทิตี | ข้อความอิสระ ขนาดข้อความที่แนะนำ: 50 อักขระ |
คำอธิบาย | ไม่บังคับ | ข้อความ 1 ย่อหน้าเพื่ออธิบายเอนทิตี หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น |
ข้อความอิสระ ขนาดข้อความที่แนะนำ: 180 อักขระ |
รายการคำบรรยาย | ไม่บังคับ | คำบรรยายได้สูงสุด 3 รายการ โดยคำบรรยายแต่ละรายการจะเป็นข้อความบรรทัดเดียว หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น |
ข้อความอิสระ ขนาดข้อความที่แนะนำสำหรับคำบรรยายแต่ละรายการ: สูงสุด 50 อักขระ |
ป้าย | ไม่บังคับ | ป้ายแต่ละป้ายจะเป็นข้อความอิสระ (ไม่เกิน 15 อักขระ) หรือรูปภาพขนาดเล็ก การจัดการ UX พิเศษบนรูปภาพ/วิดีโอ เช่น วางซ้อนป้ายบนรูปภาพ
|
|
ป้าย - ข้อความ | ไม่บังคับ | ชื่อป้าย หมายเหตุ: ต้องมีข้อความหรือรูปภาพสำหรับป้าย |
ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด 15 อักขระ |
ป้าย - รูปภาพ | ไม่บังคับ | รูปภาพขนาดเล็ก การจัดการ UX พิเศษ เช่น การวางซ้อนป้ายบนภาพ/วิดีโอขนาดย่อ หมายเหตุ: ต้องมีข้อความหรือรูปภาพสำหรับป้าย |
ดูคำแนะนำได้ที่ข้อกำหนดเกี่ยวกับรูปภาพ |
หมวดหมู่เนื้อหา | ไม่บังคับ | อธิบายหมวดหมู่ของเนื้อหาในเอนทิตี | รายการ Enum ดูคำแนะนำได้ที่ส่วนหมวดหมู่เนื้อหา |
ArticleEntity
แอตทริบิวต์ | ข้อกำหนด | คำอธิบาย | รูปแบบ |
---|---|---|---|
URI การดำเนินการ | ต้องระบุ |
Deep Link ไปยังเอนทิตีในแอปของผู้ให้บริการ หมายเหตุ: คุณใช้ Deep Link เพื่อการระบุแหล่งที่มาได้ โปรดดูคำถามที่พบบ่อยนี้ |
URI |
ชื่อ | ต้องระบุ | ชื่อของเอนทิตี | ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด 50 อักขระ |
ภาพโปสเตอร์ | ไม่บังคับ | เราจะแสดงรูปภาพเพียง 1 รูปเมื่อมีการระบุรูปภาพหลายรูป สัดส่วนภาพที่แนะนำคือ 16:9 หมายเหตุ: ขอแนะนําให้ใช้รูปภาพ หากมีป้าย ให้เว้นพื้นที่ปลอดภัย 24 dps ทั้งด้านบนและด้านล่างของรูปภาพ |
ดูคำแนะนำได้ที่ข้อกำหนดเกี่ยวกับรูปภาพ |
แหล่งที่มา - ชื่อ | ไม่บังคับ | ชื่อผู้เขียน องค์กร หรือผู้รายงาน | ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 25 อักขระ |
แหล่งที่มา - รูปภาพ | ไม่บังคับ | รูปภาพของแหล่งที่มา เช่น ผู้เขียน องค์กร ผู้รายงาน | โปรดดูข้อกำหนดเกี่ยวกับรูปภาพสำหรับคำแนะนำ |
คำอธิบาย | ไม่บังคับ | ข้อความ 1 ย่อหน้าเพื่ออธิบายเอนทิตี หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น |
ข้อความอิสระ ขนาดข้อความที่แนะนำ: 180 อักขระ |
รายการคำบรรยาย | ไม่บังคับ | คำบรรยายได้สูงสุด 3 รายการ โดยคำบรรยายแต่ละรายการจะเป็นข้อความบรรทัดเดียว หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น |
ข้อความอิสระ ขนาดข้อความที่แนะนำสำหรับคำบรรยายแต่ละรายการ: สูงสุด 50 อักขระ |
ป้าย | ไม่บังคับ | ป้ายแต่ละป้ายจะเป็นข้อความอิสระ (ไม่เกิน 15 อักขระ) หรือรูปภาพขนาดเล็ก การจัดการ UX พิเศษบนรูปภาพ/วิดีโอ เช่น การวางป้ายซ้อนบนรูปภาพ
|
|
ป้าย - ข้อความ | ไม่บังคับ | ชื่อป้าย หมายเหตุ: ต้องมีข้อความหรือรูปภาพสำหรับป้าย |
ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด 15 อักขระ |
ป้าย - รูปภาพ | ไม่บังคับ | รูปภาพขนาดเล็ก การจัดการ UX พิเศษ เช่น การวางซ้อนป้ายบนภาพ/วิดีโอขนาดย่อ หมายเหตุ: ต้องมีข้อความหรือรูปภาพสำหรับป้าย |
ดูคำแนะนำได้ที่ข้อกำหนดเกี่ยวกับรูปภาพ |
เวลาเผยแพร่เนื้อหา | ไม่บังคับ | นี่คือการประทับเวลาตามยุคสมัยเป็นมิลลิวินาทีเมื่อมีการเผยแพร่/อัปเดตเนื้อหาในแอป | การประทับเวลา Epoch เป็นมิลลิวินาที |
เวลาในการมีส่วนร่วมครั้งล่าสุด | ต้องระบุ (แบบมีเงื่อนไข) | การประทับเวลาตามยุคสมัยเป็นมิลลิวินาทีเมื่อผู้ใช้โต้ตอบกับเอนทิตีนี้ครั้งล่าสุด หมายเหตุ: ต้องกรอกช่องนี้หากเอนทิตีนี้เป็นส่วนหนึ่งของคลัสเตอร์การต่อ |
การประทับเวลา Epoch เป็นมิลลิวินาที |
เปอร์เซ็นต์ความคืบหน้า | ต้องระบุ (แบบมีเงื่อนไข) | เปอร์เซ็นต์ของเนื้อหาทั้งหมดที่ผู้ใช้บริโภคจนถึงปัจจุบัน หมายเหตุ: ต้องกรอกช่องนี้หากเอนทิตีนี้เป็นส่วนหนึ่งของคลัสเตอร์การต่อ |
ค่า int ระหว่าง 0 ถึง 100 |
หมวดหมู่เนื้อหา | ไม่บังคับ | อธิบายหมวดหมู่ของเนื้อหาในเอนทิตี | รายการ Enum ดูคำแนะนำได้ที่ส่วนหมวดหมู่เนื้อหา |
EventEntity
แอตทริบิวต์ | ข้อกำหนด | คำอธิบาย | รูปแบบ |
---|---|---|---|
URI การดำเนินการ | ต้องระบุ |
Deep Link ไปยังเอนทิตีในแอปของผู้ให้บริการ หมายเหตุ: คุณใช้ Deep Link เพื่อการระบุแหล่งที่มาได้ โปรดดูคำถามที่พบบ่อยนี้ |
URI |
ชื่อ | ต้องระบุ | ชื่อของเอนทิตี | สตริง ขนาดข้อความที่แนะนำ: สูงสุด 50 อักขระ |
เวลาเริ่มต้น | ต้องระบุ |
การประทับเวลาตามยุคสมัยเมื่อคาดว่ากิจกรรมจะเริ่ม หมายเหตุ: ค่านี้จะแสดงเป็นมิลลิวินาที |
การประทับเวลา Epoch เป็นมิลลิวินาที |
โหมดเหตุการณ์ | ต้องระบุ | ช่องสำหรับระบุว่ากิจกรรมจะเป็นแบบเสมือนจริง เข้าร่วมด้วยตนเอง หรือทั้ง 2 แบบ |
อาร์เรย์แบบจำกัด: VIRTUAL, IN_PERSON หรือ HYBRID |
ภาพโปสเตอร์ | ต้องระบุ | เราจะแสดงรูปภาพเพียง 1 รูปเมื่อมีการระบุรูปภาพหลายรูป สัดส่วนภาพที่แนะนำคือ 16:9 หมายเหตุ: ขอแนะนำอย่างยิ่งให้เพิ่มรูปภาพ หากมีป้าย ให้เว้นพื้นที่ปลอดภัย 24 dps ทั้งด้านบนและด้านล่างของรูปภาพ |
ดูคำแนะนำได้ที่ข้อกำหนดเกี่ยวกับรูปภาพ |
สถานที่ตั้ง - ประเทศ | ต้องระบุแบบมีเงื่อนไข | ประเทศที่จัดกิจกรรม หมายเหตุ: จำเป็นต้องใช้สำหรับกิจกรรมที่เป็น IN_PERSON หรือ HYBRID |
ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ |
สถานที่ตั้ง - เมือง | ต้องระบุ (แบบมีเงื่อนไข) | เมืองที่จัดกิจกรรม หมายเหตุ: จำเป็นต้องใช้สำหรับกิจกรรมที่เป็น IN_PERSON หรือ HYBRID |
ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด ~20 อักขระ |
สถานที่ตั้ง - ที่อยู่สำหรับแสดง | ต้องระบุ (แบบมีเงื่อนไข) | ที่อยู่หรือชื่อสถานที่ที่จัดกิจกรรมซึ่งควรแสดงต่อผู้ใช้ หมายเหตุ: จำเป็นต้องใช้สำหรับกิจกรรมที่เป็น IN_PERSON หรือ HYBRID |
ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ |
สถานที่ตั้ง - ที่อยู่ | ไม่บังคับ | ที่อยู่ (หากมี) ของสถานที่จัดอีเวนต์ | ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด ~20 อักขระ |
สถานที่ - รัฐ | ไม่บังคับ | รัฐหรือจังหวัด (หากมี) ที่จัดกิจกรรม | ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ |
สถานที่ตั้ง - รหัสไปรษณีย์ | ไม่บังคับ | รหัสไปรษณีย์ (หากมี) ของสถานที่จัดกิจกรรม | ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด ~20 อักขระ |
สถานที่ตั้ง - ย่าน | ไม่บังคับ | ย่าน (หากมี) ที่จัดกิจกรรม | ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด ~20 อักขระ |
เวลาสิ้นสุด | ไม่บังคับ |
การประทับเวลาตามยุคสมัยเมื่อคาดว่ากิจกรรมจะสิ้นสุด หมายเหตุ: ค่านี้จะแสดงเป็นมิลลิวินาที |
การประทับเวลา Epoch เป็นมิลลิวินาที |
คำอธิบาย | ไม่บังคับ | ข้อความ 1 ย่อหน้าเพื่ออธิบายเอนทิตี หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น |
ข้อความอิสระ ขนาดข้อความที่แนะนำ: 180 อักขระ |
รายการคำบรรยาย | ไม่บังคับ | คำบรรยายได้สูงสุด 3 รายการ โดยคำบรรยายแต่ละรายการจะเป็นข้อความบรรทัดเดียว หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น |
ข้อความอิสระ ขนาดข้อความที่แนะนำสำหรับคำบรรยายแต่ละรายการ: สูงสุด 50 อักขระ |
ป้าย | ไม่บังคับ |
ป้ายแต่ละป้ายจะเป็นข้อความอิสระ (ไม่เกิน 15 อักขระ) หรือรูปภาพขนาดเล็ก |
|
ป้าย - ข้อความ | ไม่บังคับ | ชื่อป้าย หมายเหตุ: ต้องมีข้อความหรือรูปภาพสำหรับป้าย |
ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด 15 อักขระ |
ป้าย - รูปภาพ | ไม่บังคับ | รูปภาพขนาดเล็ก การจัดการ UX พิเศษ เช่น การวางซ้อนป้ายบนภาพ/วิดีโอขนาดย่อ หมายเหตุ: ป้ายต้องมีข้อความหรือรูปภาพ |
ดูคำแนะนำได้ที่ข้อกำหนดเกี่ยวกับรูปภาพ |
ราคา - CurrentPrice | ต้องระบุแบบมีเงื่อนไข |
ราคาปัจจุบันของตั๋ว/บัตรเข้าชมกิจกรรม ต้องระบุหากระบุราคาที่มีการขีดทับ |
ข้อความอิสระ |
ราคา - StrikethroughPrice | ไม่บังคับ | ราคาเดิมของตั๋ว/บัตรเข้างาน | ข้อความอิสระ |
ข้อความไฮไลต์ราคา | ไม่บังคับ | ข้อความไฮไลต์ราคาเพื่อแสดงโปรโมชัน กิจกรรม ส่วนลดสำหรับสมาชิก (หากมี) | ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 45 อักขระ (ข้อความที่ยาวเกินไปอาจแสดงจุดไข่ปลา) |
หมวดหมู่เนื้อหา | ไม่บังคับ | อธิบายหมวดหมู่ของเนื้อหาในเอนทิตี | รายการ Enum ที่มีสิทธิ์
ดูคำแนะนำได้ที่ส่วนหมวดหมู่เนื้อหา |
LodgingEntity
แอตทริบิวต์ | ข้อกำหนด | คำอธิบาย | รูปแบบ |
---|---|---|---|
URI การดำเนินการ | ต้องระบุ |
Deep Link ไปยังเอนทิตีในแอปของผู้ให้บริการ หมายเหตุ: คุณใช้ Deep Link เพื่อการระบุแหล่งที่มาได้ โปรดดูคำถามที่พบบ่อยนี้ |
URI |
ชื่อ | ต้องระบุ | ชื่อของเอนทิตี | สตริง ขนาดข้อความที่แนะนำ: สูงสุด 50 อักขระ |
ภาพโปสเตอร์ | ต้องระบุ |
เราจะแสดงรูปภาพเพียง 1 รูปเมื่อมีการระบุรูปภาพหลายรูป สัดส่วนภาพที่แนะนําคือ 16:9 หมายเหตุ: หากมีป้าย ให้เว้นพื้นที่ปลอดภัย 24 dp ทั้งด้านบนและด้านล่างของรูปภาพ |
โปรดดูข้อกำหนดเกี่ยวกับรูปภาพสำหรับคำแนะนำ |
สถานที่ตั้ง - ประเทศ | ต้องระบุ | ประเทศที่ที่พักตั้งอยู่ | ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ |
สถานที่ตั้ง - เมือง | ต้องระบุ | เมืองที่ที่พักตั้งอยู่ | ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด ~20 อักขระ |
สถานที่ตั้ง - ที่อยู่สำหรับแสดง | ต้องระบุ | ที่อยู่ของที่พักที่จะแสดงต่อผู้ใช้ | ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ |
สถานที่ตั้ง - ที่อยู่ | ไม่บังคับ | ที่อยู่ (หากมี) ของที่พัก | ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด ~20 อักขระ |
สถานที่ - รัฐ | ไม่บังคับ | รัฐหรือจังหวัด (หากมี) ที่ที่พักตั้งอยู่ | ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ |
สถานที่ตั้ง - รหัสไปรษณีย์ | ไม่บังคับ | รหัสไปรษณีย์ (หากมี) ของที่พัก | ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด ~20 อักขระ |
สถานที่ตั้ง - ย่าน | ไม่บังคับ | ย่านที่พัก (หากมี) | ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ |
ป้าย | ไม่บังคับ |
ป้ายแต่ละป้ายจะเป็นข้อความอิสระ (ไม่เกิน 15 อักขระ) หรือรูปภาพขนาดเล็ก |
|
ป้าย - ข้อความ | ไม่บังคับ | ชื่อป้าย หมายเหตุ: ต้องมีข้อความหรือรูปภาพสำหรับป้าย |
ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด 15 อักขระ |
ป้าย - รูปภาพ | ไม่บังคับ | รูปภาพขนาดเล็ก การจัดการ UX พิเศษ เช่น การวางซ้อนป้ายบนภาพ/วิดีโอขนาดย่อ หมายเหตุ: ต้องมีข้อความหรือรูปภาพสำหรับป้าย |
ดูคำแนะนำได้ที่ข้อกำหนดเกี่ยวกับรูปภาพ |
คำอธิบาย | ไม่บังคับ | ข้อความ 1 ย่อหน้าเพื่ออธิบายเอนทิตี หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น |
ข้อความอิสระ ขนาดข้อความที่แนะนำ: 180 อักขระ |
รายการคำบรรยาย | ไม่บังคับ | คำบรรยายได้สูงสุด 3 รายการ โดยคำบรรยายแต่ละรายการจะเป็นข้อความบรรทัดเดียว หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น |
ข้อความอิสระ ขนาดข้อความที่แนะนำสำหรับคำบรรยายแต่ละรายการ: สูงสุด 50 อักขระ |
AvailabilityTimeWindow - Start Time | ไม่บังคับ | การประทับเวลา Epoch ในหน่วยมิลลิวินาทีเมื่อคาดว่าที่พักจะเปิด/พร้อมใช้งาน | การประทับเวลา Epoch เป็นมิลลิวินาที |
AvailabilityTimeWindow - End Time | ไม่บังคับ | การประทับเวลาตามยุคสมัยเป็นมิลลิวินาทีจนกว่าที่พักจะเปิด/พร้อมให้บริการ | การประทับเวลา Epoch เป็นมิลลิวินาที |
การจัดประเภท - ค่าสูงสุด | ไม่บังคับ | ค่าสูงสุดของรูปแบบการให้คะแนน ต้องระบุหากระบุค่าปัจจุบันของคะแนนด้วย |
ตัวเลข >= 0.0 |
การจัดประเภท - ค่าปัจจุบัน | ไม่บังคับ | ค่าปัจจุบันของสเกลการให้คะแนน ต้องระบุหากระบุค่าสูงสุดของการจัดประเภทด้วย |
จำนวน >= 0.0 |
คะแนน - จำนวน | ไม่บังคับ | จํานวนการให้คะแนนที่พัก หมายเหตุ: ระบุช่องนี้หากแอปของคุณควบคุมวิธีแสดงจำนวนต่อผู้ใช้ ใช้สตริงที่กระชับ เช่น หากจํานวนคือ 1,000,000 ให้ลองใช้ตัวย่อ เช่น 1 ล้าน เพื่อไม่ให้ระบบตัดจํานวนตัวเลขในขนาดการแสดงผลที่เล็กลง |
สตริง |
การจัดประเภท - ค่าจำนวน | ไม่บังคับ | จํานวนการให้คะแนนที่พัก หมายเหตุ: ระบุช่องนี้หากคุณไม่ได้จัดการตรรกะการแสดงตัวย่อด้วยตนเอง หากมีทั้งจํานวน (Count) และค่าจํานวน (Count Value) ระบบจะแสดงจํานวนต่อผู้ใช้ |
ยาว |
ราคา - CurrentPrice | ต้องระบุแบบมีเงื่อนไข | ราคาปัจจุบันของที่พัก ต้องระบุหากมีการระบุราคาที่มีขีดทับ |
ข้อความอิสระ |
ราคา - StrikethroughPrice | ไม่บังคับ | ราคาเดิมของที่พัก ซึ่งจะมีการขีดทับใน UI | ข้อความอิสระ |
ข้อความไฮไลต์ราคา | ไม่บังคับ | ข้อความไฮไลต์ราคาเพื่อแสดงโปรโมชัน กิจกรรม ส่วนลดสำหรับสมาชิก (หากมี) | ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 45 อักขระ (ข้อความที่ยาวเกินไปอาจแสดงจุดไข่ปลา) |
StoreEntity
ออบเจ็กต์ StoreEntity
แสดงร้านค้าแต่ละแห่งที่พาร์ทเนอร์นักพัฒนาแอปต้องการเผยแพร่ เช่น ร้านอาหารหรือร้านขายของชำ
แอตทริบิวต์ | ข้อกำหนด | คำอธิบาย | รูปแบบ |
---|---|---|---|
ภาพโปสเตอร์ | ต้องระบุ | ต้องระบุรูปภาพอย่างน้อย 1 รูป | โปรดดูข้อกำหนดเกี่ยวกับรูปภาพสำหรับคำแนะนำ |
URI การดำเนินการ | ต้องระบุ |
Deep Link ไปยังเอนทิตีในแอปของผู้ให้บริการ หมายเหตุ: คุณใช้ Deep Link เพื่อการระบุแหล่งที่มาได้ ดูคำถามที่พบบ่อยนี้ |
URI |
ชื่อ | ไม่บังคับ | ชื่อร้านค้า | ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 45 อักขระ (ข้อความที่ยาวเกินไปอาจแสดงจุดไข่ปลา) |
ตำแหน่ง | ไม่บังคับ | ตำแหน่งของร้านค้า | ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 45 อักขระ (ข้อความที่ยาวเกินไปอาจแสดงจุดไข่ปลา) |
ข้อความเสริม | ไม่บังคับ | ข้อความไฮไลต์เพื่อแสดงโปรโมชัน กิจกรรม หรือข้อมูลอัปเดตสำหรับร้านค้า หากมี | ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 45 อักขระ (ข้อความที่ยาวเกินไปอาจแสดงจุดไข่ปลา) |
รายละเอียดข้อความไฮไลต์ | ไม่บังคับ | ข้อความไฮไลต์ | ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 45 อักขระ (ข้อความที่ยาวเกินไปอาจแสดงจุดไข่ปลา) |
คำอธิบาย | ไม่บังคับ | คำอธิบายร้านค้า | ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 90 อักขระ (ข้อความที่ยาวเกินไปอาจแสดงจุดไข่ปลา) |
การให้คะแนน - ค่าสูงสุด | ไม่บังคับ | ค่าสูงสุดของรูปแบบการให้คะแนน ต้องระบุหากระบุค่าปัจจุบันของคะแนนด้วย |
ตัวเลข >= 0.0 |
การจัดประเภท - ค่าปัจจุบัน | ไม่บังคับ | ค่าปัจจุบันของสเกลการให้คะแนน ต้องระบุหากระบุค่าสูงสุดของการจัดประเภทด้วย |
จำนวน >= 0.0 |
คะแนน - จำนวน | ไม่บังคับ | จํานวนการให้คะแนนที่พัก หมายเหตุ: ระบุช่องนี้หากแอปต้องการควบคุมวิธีแสดงข้อมูลนี้ต่อผู้ใช้ ระบุสตริงที่กระชับซึ่งแสดงต่อผู้ใช้ได้ เช่น หากจํานวนคือ 1,000,000 ให้พิจารณาใช้ตัวย่อ เช่น 1 ล้าน เพื่อไม่ให้ถูกตัดในขนาดการแสดงผลที่เล็กลง |
สตริง |
การจัดประเภท - ค่าจำนวน | ไม่บังคับ | จํานวนการให้คะแนนที่พัก หมายเหตุ: ระบุช่องนี้หากไม่ต้องการจัดการตรรกะการแสดงตัวย่อด้วยตนเอง หากมีทั้ง Count และ Count Value เราจะใช้ Count เพื่อแสดงต่อผู้ใช้ |
ยาว |
PointOfInterestEntity
แอตทริบิวต์ | ข้อกำหนด | คำอธิบาย | รูปแบบ |
---|---|---|---|
URI การดำเนินการ | ต้องระบุ |
Deep Link ไปยังเอนทิตีในแอปของผู้ให้บริการ หมายเหตุ: คุณใช้ Deep Link เพื่อการระบุแหล่งที่มาได้ ดูคำถามที่พบบ่อยนี้ |
URI |
ชื่อ | ต้องระบุ | ชื่อของเอนทิตี | สตริง ขนาดข้อความที่แนะนำ: สูงสุด 50 อักขระ |
ภาพโปสเตอร์ | ต้องระบุ | เราจะแสดงรูปภาพเพียง 1 รูปเมื่อมีการระบุรูปภาพหลายรูป สัดส่วนภาพที่แนะนำคือ 16:9 หมายเหตุ: ขอแนะนําให้ใช้รูปภาพ หากมีป้าย ให้เว้นพื้นที่ปลอดภัย 24 dps ทั้งด้านบนและด้านล่างของรูปภาพ |
ดูคำแนะนำได้ที่ข้อกำหนดเกี่ยวกับรูปภาพ |
สถานที่ - ประเทศ | ต้องระบุ | ประเทศที่จุดที่น่าสนใจเกิดขึ้น | ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ |
สถานที่ตั้ง - เมือง | ต้องระบุ | เมืองที่จุดที่น่าสนใจเกิดขึ้น | ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด ~20 อักขระ |
สถานที่ตั้ง - ที่อยู่สำหรับแสดง | ต้องระบุ | ที่อยู่ของจุดที่น่าสนใจที่จะแสดงต่อผู้ใช้ | ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ |
สถานที่ตั้ง - ที่อยู่ | ไม่บังคับ | ที่อยู่ (หากมี) ของจุดที่น่าสนใจ | ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด ~20 อักขระ |
สถานที่ - รัฐ | ไม่บังคับ | รัฐหรือจังหวัด (หากมี) ที่จุดสนใจตั้งอยู่ | ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ |
สถานที่ตั้ง - รหัสไปรษณีย์ | ไม่บังคับ | รหัสไปรษณีย์ (หากมี) ของจุดที่น่าสนใจ | ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด ~20 อักขระ |
สถานที่ตั้ง - ย่าน | ไม่บังคับ | ย่าน (หากมี) ของจุดที่น่าสนใจ | ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ |
AvailabilityTimeWindow - Start Time | ไม่บังคับ | การประทับเวลา Epoch เป็นมิลลิวินาทีเมื่อคาดว่าจุดที่น่าสนใจจะเปิด/พร้อมใช้งาน | การประทับเวลา Epoch ในหน่วยมิลลิวินาที |
AvailabilityTimeWindow - End Time | ไม่บังคับ | การประทับเวลา Epoch ในหน่วยมิลลิวินาทีจนกระทั่งคาดว่าจุดที่น่าสนใจจะเปิด/พร้อมใช้งาน | การประทับเวลา Epoch ในหน่วยมิลลิวินาที |
ป้าย | ไม่บังคับ |
ป้ายแต่ละป้ายจะเป็นข้อความอิสระ (ไม่เกิน 15 อักขระ) หรือรูปภาพขนาดเล็ก |
|
ป้าย - ข้อความ | ไม่บังคับ | ชื่อป้าย หมายเหตุ: ต้องมีข้อความหรือรูปภาพสำหรับป้าย |
ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด 15 อักขระ |
ป้าย - รูปภาพ | ไม่บังคับ | รูปภาพขนาดเล็ก การจัดการ UX พิเศษ เช่น การวางซ้อนป้ายบนภาพ/วิดีโอขนาดย่อ หมายเหตุ: ต้องมีข้อความหรือรูปภาพสำหรับป้าย |
ดูคำแนะนำได้ที่ข้อกำหนดเกี่ยวกับรูปภาพ |
คำอธิบาย | ไม่บังคับ | ข้อความ 1 ย่อหน้าเพื่ออธิบายเอนทิตี หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น |
ข้อความอิสระ ขนาดข้อความที่แนะนำ: 180 อักขระ |
รายการคำบรรยาย | ไม่บังคับ | คำบรรยายได้สูงสุด 3 รายการ โดยคำบรรยายแต่ละรายการจะเป็นข้อความบรรทัดเดียว หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น |
ข้อความอิสระ ขนาดข้อความที่แนะนำสำหรับคำบรรยายแต่ละรายการ: สูงสุด 50 อักขระ |
การจัดประเภท - ค่าสูงสุด | ไม่บังคับ | ค่าสูงสุดของรูปแบบการให้คะแนน ต้องระบุหากระบุค่าปัจจุบันของคะแนนด้วย |
ตัวเลข >= 0.0 |
การจัดประเภท - ค่าปัจจุบัน | ไม่บังคับ | ค่าปัจจุบันของสเกลการให้คะแนน ต้องระบุหากระบุค่าสูงสุดของการจัดประเภทด้วย |
จำนวน >= 0.0 |
คะแนน - จำนวน | ไม่บังคับ | จำนวนการให้คะแนนสำหรับจุดที่น่าสนใจ หมายเหตุ: ระบุช่องนี้หากแอปของคุณควบคุมวิธีการแสดงจำนวนต่อผู้ใช้ ใช้สตริงที่กระชับ เช่น หากจำนวนนับคือ 1,000,000 ให้ลองใช้ตัวย่ออย่าง 1M เพื่อไม่ให้จำนวนการแสดงถูกตัดออกในขนาดจอแสดงผลที่เล็กกว่า |
สตริง |
การจัดประเภท - ค่าจำนวน | ไม่บังคับ | จำนวนการให้คะแนนสำหรับจุดที่น่าสนใจ หมายเหตุ: ระบุช่องนี้หากคุณไม่ได้จัดการตรรกะการแสดงตัวย่อด้วยตนเอง หากมีทั้งจํานวน (Count) และค่าจํานวน (Count Value) ระบบจะแสดงจํานวนต่อผู้ใช้ |
ยาว |
ราคา - CurrentPrice | ต้องระบุแบบมีเงื่อนไข |
ราคาปัจจุบันของตั๋ว/บัตรผ่านสำหรับจุดที่น่าสนใจ ต้องระบุหากระบุราคาที่มีการขีดทับ |
ข้อความอิสระ |
ราคา - StrikethroughPrice | ไม่บังคับ | ราคาเดิมของตั๋ว/บัตรเข้าชมจุดสนใจ | ข้อความอิสระ |
ข้อความไฮไลต์ราคา | ไม่บังคับ | ข้อความไฮไลต์ราคาเพื่อแสดงโปรโมชัน กิจกรรม ส่วนลดสำหรับสมาชิก (หากมี) |
ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 45 อักขระ (ข้อความที่ยาวเกินไปอาจแสดงจุดไข่ปลา) |
หมวดหมู่เนื้อหา | ไม่บังคับ | อธิบายหมวดหมู่ของเนื้อหาในเอนทิตี | รายการ Enum ที่มีสิทธิ์
ดูคำแนะนำได้ที่ส่วนหมวดหมู่เนื้อหา |
PersonEntity
แอตทริบิวต์ | ข้อกำหนด | คำอธิบาย | รูปแบบ |
---|---|---|---|
URI การดำเนินการ | ต้องระบุ |
Deep Link ไปยังเอนทิตีในแอปของผู้ให้บริการ หมายเหตุ: คุณใช้ Deep Link เพื่อการระบุแหล่งที่มาได้ โปรดดูคำถามที่พบบ่อยนี้ |
URI |
โปรไฟล์ - ชื่อ | ต้องระบุ | ชื่อหรือรหัสหรือแฮนเดิลของโปรไฟล์ เช่น "John Doe", "@TeamPixel" ฯลฯ | สตริง ขนาดข้อความที่แนะนำ: สูงสุด 50 อักขระ |
โปรไฟล์ - รูปโปรไฟล์ | ต้องระบุ |
รูปโปรไฟล์หรือรูปโปรไฟล์ของผู้ใช้ หมายเหตุ: ต้องเป็นรูปภาพสี่เหลี่ยมจัตุรัสขนาด 1:1 |
ดูคำแนะนำได้ที่ข้อกำหนดเกี่ยวกับรูปภาพ |
โปรไฟล์ - ข้อความเพิ่มเติม | ไม่บังคับ | ข้อความอิสระ เช่น แฮนเดิลโปรไฟล์ | ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด 15 อักขระ |
โปรไฟล์ - รูปภาพเพิ่มเติม | ไม่บังคับ | รูปภาพขนาดเล็ก เช่น เครื่องหมายยืนยัน | ดูคำแนะนำได้ที่ข้อกำหนดเกี่ยวกับรูปภาพ |
รูปภาพส่วนหัว | ไม่บังคับ | เราจะแสดงรูปภาพเพียง 1 รูปเมื่อมีการระบุรูปภาพหลายรูป สัดส่วนภาพที่แนะนำคือ 16:9 หมายเหตุ: ขอแนะนําให้ใช้รูปภาพ หากมีป้าย โปรดตรวจดูว่ามีระยะห่างของจุดที่ปลอดภัย (24 dp) ทั้งด้านบนและด้านล่างของรูปภาพ |
ดูคำแนะนำได้ที่ข้อกำหนดเกี่ยวกับรูปภาพ |
ความนิยม - จํานวน | ไม่บังคับ |
ระบุจำนวนผู้ติดตามหรือค่าความนิยม เช่น - "3.7 ล้าน" หมายเหตุ: หากมีทั้งค่าการนับและค่าการนับ ระบบจะใช้จำนวน |
สตริง ขนาดข้อความที่แนะนำ: อักขระไม่เกิน 20 ตัวสำหรับจำนวน + ป้ายกำกับรวมกัน |
ความนิยม - ค่าการนับ | ไม่บังคับ | จำนวนผู้ติดตามหรือค่าความนิยม หมายเหตุ: ระบุค่าการนับหากแอปไม่ต้องการจัดการตรรกะเกี่ยวกับวิธีเพิ่มประสิทธิภาพตัวเลขจำนวนมากสำหรับขนาดการแสดงผลที่แตกต่างกัน หากระบุทั้ง Count และ Count Value ระบบจะใช้ Count |
ยาว |
ความนิยม - ป้ายกํากับ | ไม่บังคับ | ระบุป้ายกำกับความนิยม เช่น "ชอบ" | สตริง ขนาดข้อความที่แนะนำ: อักขระสูงสุด 20 ตัวสำหรับจำนวน + ป้ายกำกับรวมกัน |
ความนิยม - ภาพ | ไม่บังคับ |
ระบุวัตถุประสงค์ของการโต้ตอบ เช่น รูปภาพแสดงไอคอนชอบ อีโมจิ ใส่รูปภาพได้มากกว่า 1 รูป แต่อาจไม่แสดงในอุปกรณ์ทุกรูปแบบ หมายเหตุ: ต้องเป็นรูปภาพสี่เหลี่ยมจัตุรัส 1:1 |
ดูคำแนะนำได้ที่ข้อกำหนดเกี่ยวกับรูปภาพ |
การจัดประเภท - ค่าสูงสุด | ต้องระบุ | ค่าสูงสุดของรูปแบบการให้คะแนน ต้องระบุหากระบุค่าปัจจุบันของคะแนนด้วย |
ตัวเลข >= 0.0 |
การจัดประเภท - ค่าปัจจุบัน | ต้องระบุ | ค่าปัจจุบันของสเกลการให้คะแนน ต้องระบุหากระบุค่าสูงสุดของการจัดประเภทด้วย |
จำนวน >= 0.0 |
คะแนน - จำนวน | ไม่บังคับ | จํานวนการให้คะแนนสําหรับเอนทิตี หมายเหตุ: ระบุข้อมูลในช่องนี้หากแอปของคุณต้องการควบคุมวิธีแสดงต่อผู้ใช้ ระบุสตริงที่กระชับซึ่งแสดงต่อผู้ใช้ได้ เช่น หากจำนวนนับคือ 1,000,000 ครั้ง ให้ลองใช้ตัวย่อ เช่น 1M เพื่อไม่ให้ถูกตัดให้สั้นลงในขนาดจอแสดงผลที่เล็กกว่า |
สตริง |
การจัดประเภท - ค่าจำนวน | ไม่บังคับ | จํานวนการให้คะแนนสําหรับเอนทิตี หมายเหตุ: ระบุช่องนี้หากไม่ต้องการจัดการตรรกะการแสดงตัวย่อด้วยตนเอง หากมีทั้ง Count และ Count Value เราจะใช้ Count เพื่อแสดงต่อผู้ใช้ |
ยาว |
สถานที่ตั้ง - ประเทศ | ไม่บังคับ | ประเทศที่บุคคลนั้นอยู่หรือให้บริการ | ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ |
สถานที่ - เมือง | ไม่บังคับ | เมืองที่บุคคลนั้นอาศัยอยู่หรือให้บริการ | ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด ~20 อักขระ |
สถานที่ตั้ง - ที่อยู่สำหรับแสดง | ไม่บังคับ | ระบบจะแสดงที่อยู่ของบุคคลที่ให้บริการหรืออยู่ที่ผู้ใช้ | ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ |
สถานที่ตั้ง - ที่อยู่ | ไม่บังคับ | ที่อยู่ (หากมี) ที่บุคคลนั้นตั้งอยู่หรือให้บริการ | ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด ~20 อักขระ |
สถานที่ - รัฐ | ไม่บังคับ | รัฐ (หากมี) ที่บุคคลนั้นอาศัยอยู่หรือให้บริการ | ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ |
สถานที่ตั้ง - รหัสไปรษณีย์ | ไม่บังคับ | รหัสไปรษณีย์ (หากมี) ของสถานที่ที่บุคคลนั้นอยู่หรือให้บริการ | ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด ~20 อักขระ |
สถานที่ตั้ง - ย่าน | ไม่บังคับ | ย่านใกล้เคียง (หากมี) ที่บุคคลอาศัยอยู่หรือให้บริการ | ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ |
ป้าย | ไม่บังคับ |
ป้ายแต่ละป้ายจะเป็นข้อความอิสระ (ไม่เกิน 15 อักขระ) หรือรูปภาพขนาดเล็ก |
|
ป้าย - ข้อความ | ไม่บังคับ | ชื่อป้าย หมายเหตุ: ต้องมีข้อความหรือรูปภาพสำหรับป้าย |
ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด 15 อักขระ |
ป้าย - รูปภาพ | ไม่บังคับ | รูปภาพขนาดเล็ก การจัดการ UX พิเศษ เช่น การวางซ้อนป้ายบนภาพ/วิดีโอขนาดย่อ หมายเหตุ: ต้องมีข้อความหรือรูปภาพสำหรับป้าย |
ดูคำแนะนำได้ที่ข้อกำหนดเกี่ยวกับรูปภาพ |
คำอธิบาย | ไม่บังคับ | ข้อความ 1 ย่อหน้าเพื่ออธิบายเอนทิตี หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น |
ข้อความอิสระ ขนาดข้อความที่แนะนำ: 180 อักขระ |
รายการคำบรรยาย | ไม่บังคับ | คำบรรยายได้สูงสุด 3 รายการ โดยคำบรรยายแต่ละรายการจะเป็นข้อความบรรทัดเดียว หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น |
ข้อความอิสระ ขนาดข้อความที่แนะนำสำหรับคำบรรยายแต่ละรายการ: สูงสุด 50 อักขระ |
หมวดหมู่เนื้อหา | ไม่บังคับ | อธิบายหมวดหมู่ของเนื้อหาในเอนทิตี | รายการ Enum ที่มีสิทธิ์
ดูคำแนะนำได้ที่ส่วนหมวดหมู่เนื้อหา |
RestaurantReservationEntity
แอตทริบิวต์ | ข้อกำหนด | คำอธิบาย | รูปแบบ |
---|---|---|---|
URI การดำเนินการ | ต้องระบุ |
Deep Link ไปยังเอนทิตีในแอปของผู้ให้บริการ หมายเหตุ: คุณใช้ Deep Link เพื่อการระบุแหล่งที่มาได้ โปรดดูคำถามที่พบบ่อยนี้ |
URI |
ชื่อ | ต้องระบุ | ชื่อของเอนทิตี | สตริง ขนาดข้อความที่แนะนำ: สูงสุด 50 อักขระ |
เวลาเริ่มต้นการจอง | ต้องระบุ | การประทับเวลา Epoch เป็นมิลลิวินาทีเมื่อคาดว่าการจองจะเริ่มขึ้น | การประทับเวลา Epoch เป็นมิลลิวินาที |
สถานที่ - ประเทศ | ต้องระบุ | ประเทศที่ร้านอาหารเปิดให้บริการ | ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ |
สถานที่ตั้ง - เมือง | ต้องระบุ | เมืองที่ร้านอาหารตั้งอยู่ | ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด ~20 อักขระ |
สถานที่ตั้ง - ที่อยู่สำหรับแสดง | ต้องระบุ | ที่อยู่ของร้านอาหารที่จะแสดงต่อผู้ใช้ | ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ |
สถานที่ตั้ง - ที่อยู่ | ไม่บังคับ | ที่อยู่ (หากมี) ของร้านอาหาร | ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด ~20 อักขระ |
สถานที่ - รัฐ | ไม่บังคับ | รัฐหรือจังหวัด (หากมี) ที่ร้านอาหารตั้งอยู่ | ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ |
สถานที่ตั้ง - รหัสไปรษณีย์ | ไม่บังคับ | รหัสไปรษณีย์ (หากมี) ของร้านอาหาร | ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด ~20 อักขระ |
สถานที่ตั้ง - ย่าน | ไม่บังคับ | ย่านใกล้เคียง (หากมี) ของร้านอาหาร | ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ |
ภาพโปสเตอร์ | ไม่บังคับ | เราจะแสดงเพียง 1 ภาพหากมีหลายภาพ สัดส่วนภาพที่แนะนําคือ 16:9 | ดูคำแนะนำได้ที่ข้อกำหนดเกี่ยวกับรูปภาพ |
คำอธิบาย | ไม่บังคับ | ข้อความ 1 ย่อหน้าเพื่ออธิบายเอนทิตี หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น |
ข้อความอิสระ ขนาดข้อความที่แนะนำ: 180 อักขระ |
รายการคำบรรยาย | ไม่บังคับ | คำบรรยายได้สูงสุด 3 รายการ โดยคำบรรยายแต่ละรายการจะเป็นข้อความบรรทัดเดียว หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น |
ข้อความอิสระ ขนาดข้อความที่แนะนำสำหรับคำบรรยายแต่ละรายการ: สูงสุด 50 อักขระ |
ขนาดตาราง | ไม่บังคับ | จำนวนคนในกลุ่มการจอง | จำนวนเต็ม > 0 |
EventReservationEntity
แอตทริบิวต์ | ข้อกำหนด | คำอธิบาย | รูปแบบ |
---|---|---|---|
URI การดำเนินการ | ต้องระบุ |
Deep Link ไปยังเอนทิตีในแอปของผู้ให้บริการ หมายเหตุ: คุณใช้ Deep Link เพื่อการระบุแหล่งที่มาได้ โปรดดูคำถามที่พบบ่อยนี้ |
URI |
ชื่อ | ต้องระบุ | ชื่อของเอนทิตี | สตริง ขนาดข้อความที่แนะนำ: สูงสุด 50 อักขระ |
เวลาเริ่มต้น | ต้องระบุ |
การประทับเวลาตามยุคสมัยเมื่อคาดว่ากิจกรรมจะเริ่ม หมายเหตุ: ค่านี้จะแสดงเป็นมิลลิวินาที |
การประทับเวลา Epoch เป็นมิลลิวินาที |
โหมดเหตุการณ์ | ต้องระบุ | ช่องสำหรับระบุว่ากิจกรรมจะเป็นแบบเสมือนจริง เข้าร่วมด้วยตนเอง หรือทั้ง 2 แบบ |
อาร์เรย์แบบจำกัด: VIRTUAL, IN_PERSON หรือ HYBRID |
สถานที่ตั้ง - ประเทศ | ต้องระบุแบบมีเงื่อนไข | ประเทศที่จัดกิจกรรม หมายเหตุ: จำเป็นต้องใช้สำหรับกิจกรรมที่เป็น IN_PERSON หรือ HYBRID |
ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ |
สถานที่ตั้ง - เมือง | ต้องระบุ (แบบมีเงื่อนไข) | เมืองที่จัดกิจกรรม หมายเหตุ: จำเป็นต้องใช้สำหรับกิจกรรมที่เป็น IN_PERSON หรือ HYBRID |
ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด ~20 อักขระ |
สถานที่ตั้ง - ที่อยู่สำหรับแสดง | ต้องระบุ (แบบมีเงื่อนไข) | ที่อยู่หรือชื่อสถานที่ที่จัดกิจกรรมซึ่งควรแสดงต่อผู้ใช้ หมายเหตุ: จำเป็นต้องใช้สำหรับกิจกรรมที่เป็น IN_PERSON หรือ HYBRID |
ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ |
สถานที่ตั้ง - ที่อยู่ | ไม่บังคับ | ที่อยู่ (หากมี) ของสถานที่จัดอีเวนต์ | ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด ~20 อักขระ |
สถานที่ - รัฐ | ไม่บังคับ | รัฐหรือจังหวัด (หากมี) ที่จัดกิจกรรม | ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ |
สถานที่ตั้ง - รหัสไปรษณีย์ | ไม่บังคับ | รหัสไปรษณีย์ (หากมี) ของสถานที่จัดกิจกรรม | ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด ~20 อักขระ |
สถานที่ตั้ง - ย่าน | ไม่บังคับ | ย่าน (หากมี) ที่จัดกิจกรรม | ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ |
ภาพโปสเตอร์ | ไม่บังคับ | เราจะแสดงรูปภาพเพียง 1 รูปเมื่อมีการระบุรูปภาพหลายรูป สัดส่วนภาพที่แนะนำคือ 16:9 หมายเหตุ: ขอแนะนําให้ใช้รูปภาพ หากมีป้าย ให้เว้นพื้นที่ปลอดภัย 24 dps ทั้งด้านบนและด้านล่างของรูปภาพ |
ดูคำแนะนำได้ที่ข้อกำหนดเกี่ยวกับรูปภาพ |
เวลาสิ้นสุด | ไม่บังคับ |
การประทับเวลาตามยุคสมัยเมื่อคาดว่ากิจกรรมจะสิ้นสุด หมายเหตุ: ค่านี้จะแสดงเป็นมิลลิวินาที |
การประทับเวลา Epoch เป็นมิลลิวินาที |
ผู้ให้บริการ - ชื่อ | ไม่บังคับ |
ชื่อผู้ให้บริการ หมายเหตุ: ต้องมีข้อความหรือรูปภาพสำหรับผู้ให้บริการ |
ข้อความอิสระ เช่น ชื่อผู้จัด/ทัวร์ |
ผู้ให้บริการ - รูปภาพ | ไม่บังคับ |
โลโก้/รูปภาพของผู้ให้บริการ หมายเหตุ: ต้องมีข้อความหรือรูปภาพสำหรับผู้ให้บริการ |
ดูคำแนะนำได้ที่ข้อกำหนดเกี่ยวกับรูปภาพ |
คำอธิบาย | ไม่บังคับ | ข้อความ 1 ย่อหน้าเพื่ออธิบายเอนทิตี หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น |
ข้อความอิสระ ขนาดข้อความที่แนะนำ: 180 อักขระ |
รายการคำบรรยาย | ไม่บังคับ | คำบรรยายได้สูงสุด 3 รายการ โดยคำบรรยายแต่ละรายการจะเป็นข้อความบรรทัดเดียว หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น |
ข้อความอิสระ ขนาดข้อความที่แนะนำสำหรับคำบรรยายแต่ละรายการ: สูงสุด 50 อักขระ |
ป้าย | ไม่บังคับ |
ป้ายแต่ละป้ายจะเป็นข้อความอิสระ (ไม่เกิน 15 อักขระ) หรือรูปภาพขนาดเล็ก |
|
ป้าย - ข้อความ | ไม่บังคับ | ชื่อป้าย หมายเหตุ: ต้องมีข้อความหรือรูปภาพสำหรับป้าย |
ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด 15 อักขระ |
ป้าย - รูปภาพ | ไม่บังคับ | รูปภาพขนาดเล็ก การจัดการ UX พิเศษ เช่น การวางซ้อนป้ายบนภาพ/วิดีโอขนาดย่อ หมายเหตุ: ต้องมีข้อความหรือรูปภาพสำหรับป้าย |
โปรดดูข้อกำหนดเกี่ยวกับรูปภาพสำหรับคำแนะนำ |
รหัสการจอง | ไม่บังคับ | รหัสการจองสำหรับกิจกรรม | ข้อความอิสระ |
ราคา - CurrentPrice | ต้องระบุแบบมีเงื่อนไข |
ราคาปัจจุบันของตั๋ว/บัตรเข้าชมกิจกรรม ต้องระบุหากระบุราคาที่มีการขีดทับ |
ข้อความอิสระ |
ราคา - StrikethroughPrice | ไม่บังคับ | ราคาเดิมของตั๋ว/บัตรเข้างาน | ข้อความอิสระ |
ข้อความไฮไลต์ราคา | ไม่บังคับ | ข้อความไฮไลต์ราคาเพื่อแสดงโปรโมชัน กิจกรรม ส่วนลดสำหรับสมาชิก (หากมี) | ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 45 อักขระ (ข้อความที่ยาวเกินไปอาจแสดงจุดไข่ปลา) |
การจัดประเภท - ค่าสูงสุด | ไม่บังคับ | ค่าสูงสุดของรูปแบบการให้คะแนน ต้องระบุหากระบุค่าปัจจุบันของคะแนนด้วย |
ตัวเลข >= 0.0 |
การจัดประเภท - ค่าปัจจุบัน | ไม่บังคับ | ค่าปัจจุบันของสเกลการให้คะแนน ต้องระบุหากระบุค่าสูงสุดของการจัดประเภทด้วย |
จำนวน >= 0.0 |
คะแนน - จำนวน | ไม่บังคับ | จำนวนการให้คะแนนกิจกรรม หมายเหตุ: ระบุช่องนี้หากแอปต้องการควบคุมวิธีแสดงข้อมูลนี้ต่อผู้ใช้ ระบุสตริงที่กระชับซึ่งแสดงต่อผู้ใช้ได้ เช่น หากจํานวนคือ 1,000,000 ให้พิจารณาใช้ตัวย่อ เช่น 1 ล้าน เพื่อไม่ให้ถูกตัดในขนาดการแสดงผลที่เล็กลง |
สตริง |
การจัดประเภท - ค่าจำนวน | ไม่บังคับ | จํานวนการให้คะแนนสําหรับกิจกรรม หมายเหตุ: โปรดระบุช่องนี้หากคุณไม่ต้องการจัดการตรรกะตัวย่อการแสดงผลด้วยตนเอง หากมีทั้งค่าการนับและค่าการนับ เราจะใช้จำนวนเพื่อแสดงต่อผู้ใช้ |
ยาว |
หมวดหมู่เนื้อหา | ไม่บังคับ | อธิบายหมวดหมู่ของเนื้อหาในเอนทิตี | รายการ Enum ที่มีสิทธิ์
ดูหลักเกณฑ์ในส่วนหมวดหมู่เนื้อหา |
LodgingReservationEntity
แอตทริบิวต์ | ข้อกำหนด | คำอธิบาย | รูปแบบ |
---|---|---|---|
URI การดำเนินการ | ต้องระบุ |
Deep Link ไปยังเอนทิตีในแอปของผู้ให้บริการ หมายเหตุ: คุณใช้ Deep Link เพื่อการระบุแหล่งที่มาได้ โปรดดูคำถามที่พบบ่อยนี้ |
URI |
ชื่อ | ต้องระบุ | ชื่อของเอนทิตี | ข้อความอิสระ เช่น "การเข้าพักของคุณตั้งแต่วันที่ 12 ธ.ค." ขนาดข้อความที่แนะนำ: สูงสุด 50 อักขระ |
เวลาเช็คอิน | ต้องระบุ | การประทับเวลา Epoch เป็นมิลลิวินาทีที่แสดงเวลาเช็คอินสำหรับการจอง | การประทับเวลา Epoch เป็นมิลลิวินาที |
เวลาเช็คเอาต์ | ต้องระบุ | การประทับเวลา Epoch เป็นมิลลิวินาทีที่แสดงเวลาเช็คเอาต์สำหรับการจอง | การประทับเวลา Epoch เป็นมิลลิวินาที |
สถานที่ - ประเทศ | ต้องระบุ | ประเทศที่ที่พักตั้งอยู่ | ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ |
สถานที่ตั้ง - เมือง | ต้องระบุ | เมืองที่ที่พักตั้งอยู่ | ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด ~20 อักขระ |
สถานที่ตั้ง - ที่อยู่สำหรับแสดง | ต้องระบุ | ที่อยู่ของที่พักที่จะแสดงต่อผู้ใช้ | ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ |
สถานที่ตั้ง - ที่อยู่ | ไม่บังคับ | ที่อยู่ (หากมี) ของที่พัก | ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด ~20 อักขระ |
สถานที่ - รัฐ | ไม่บังคับ | รัฐหรือจังหวัด (หากมี) ที่ที่พักตั้งอยู่ | ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ |
สถานที่ตั้ง - รหัสไปรษณีย์ | ไม่บังคับ | รหัสไปรษณีย์ (หากมี) ของที่พัก | ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด ~20 อักขระ |
สถานที่ตั้ง - ย่าน | ไม่บังคับ | ย่านที่พัก (หากมี) | ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ |
ภาพโปสเตอร์ | ไม่บังคับ |
เราจะแสดงเพียง 1 ภาพหากมีหลายภาพ สัดส่วนภาพที่แนะนําคือ 16:9 หมายเหตุ: หากระบบแสดงป้าย โปรดตรวจสอบว่าคุณได้เว้นระยะห่างที่เหมาะสมไว้ที่ 24 dps ทั้งด้านบนและด้านล่างของรูปภาพ |
โปรดดูข้อกำหนดเกี่ยวกับรูปภาพสำหรับคำแนะนำ |
คำอธิบาย | ไม่บังคับ | ข้อความ 1 ย่อหน้าเพื่ออธิบายเอนทิตี หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น |
ข้อความอิสระ ขนาดข้อความที่แนะนำ: 180 อักขระ |
รายการคำบรรยาย | ไม่บังคับ | คำบรรยายได้สูงสุด 3 รายการ โดยคำบรรยายแต่ละรายการจะเป็นข้อความบรรทัดเดียว หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น |
ข้อความอิสระ ขนาดข้อความที่แนะนำสำหรับคำบรรยายแต่ละรายการ: สูงสุด 50 อักขระ |
รหัสการจอง | ไม่บังคับ | รหัสการจองสำหรับที่พัก | ข้อความอิสระ |
การจัดประเภท - ค่าสูงสุด | ไม่บังคับ | ค่าสูงสุดของรูปแบบการให้คะแนน ต้องระบุหากระบุค่าปัจจุบันของคะแนนด้วย |
ตัวเลข >= 0.0 |
การจัดประเภท - ค่าปัจจุบัน | ไม่บังคับ | ค่าปัจจุบันของสเกลการให้คะแนน ต้องระบุหากระบุค่าสูงสุดของการจัดประเภทด้วย |
จำนวน >= 0.0 |
คะแนน - จำนวน | ไม่บังคับ | จํานวนการให้คะแนนที่พัก หมายเหตุ: ระบุช่องนี้หากแอปต้องการควบคุมวิธีแสดงข้อมูลนี้ต่อผู้ใช้ ระบุสตริงที่กระชับซึ่งแสดงต่อผู้ใช้ได้ เช่น หากจํานวนคือ 1,000,000 ให้พิจารณาใช้ตัวย่อ เช่น 1 ล้าน เพื่อไม่ให้ถูกตัดในขนาดการแสดงผลที่เล็กลง |
สตริง |
การจัดประเภท - ค่าจำนวน | ไม่บังคับ | จํานวนการให้คะแนนที่พัก หมายเหตุ: ระบุช่องนี้หากไม่ต้องการจัดการตรรกะการแสดงตัวย่อด้วยตนเอง หากมีทั้ง Count และ Count Value เราจะใช้ Count เพื่อแสดงต่อผู้ใช้ |
ยาว |
ราคา - CurrentPrice | ต้องระบุแบบมีเงื่อนไข | ราคาปัจจุบันของที่พัก ต้องระบุหากมีการระบุราคาที่มีขีดทับ |
ข้อความอิสระ |
ราคา - StrikethroughPrice | ไม่บังคับ | ราคาเดิมของที่พัก ซึ่งจะมีการขีดทับใน UI | ข้อความอิสระ |
ข้อความไฮไลต์ราคา | ไม่บังคับ | ข้อความไฮไลต์ราคาเพื่อแสดงโปรโมชัน กิจกรรม ส่วนลดสำหรับสมาชิก (หากมี) | ข้อความอิสระ ขนาดข้อความที่แนะนำ: น้อยกว่า 45 อักขระ (ข้อความยาวเกินไปอาจแสดงจุดไข่ปลา) |
TransportationReservationEntity
แอตทริบิวต์ | ข้อกำหนด | คำอธิบาย | รูปแบบ |
---|---|---|---|
URI การดำเนินการ | ต้องระบุ |
Deep Link ไปยังเอนทิตีในแอปของผู้ให้บริการ หมายเหตุ: คุณใช้ Deep Link เพื่อการระบุแหล่งที่มาได้ ดูคำถามที่พบบ่อยนี้ |
URI |
ชื่อ | ต้องระบุ | ชื่อของเอนทิตี | ข้อความอิสระ เช่น "SFO to SAN" ขนาดข้อความที่แนะนำ: สูงสุด 50 อักขระ |
ประเภทการขนส่ง | ต้องระบุ | รูปแบบ/ประเภทการเดินทางสำหรับการจอง | Enum: FLIGHT, TRAIN, BUS หรือ FERRY |
เวลาออกเดินทาง | ต้องระบุ | การประทับเวลา Epoch เป็นมิลลิวินาทีที่แสดงเวลาออกเดินทาง | การประทับเวลา Epoch เป็นมิลลิวินาที |
เวลาถึง | ต้องระบุ | การประทับเวลา Epoch เป็นมิลลิวินาทีที่แสดงถึงเวลาถึง | การประทับเวลา Epoch เป็นมิลลิวินาที |
สถานที่ออกเดินทาง - ประเทศ | ไม่บังคับ | ประเทศต้นทาง | ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ |
สถานที่ออกเดินทาง - เมือง | ไม่บังคับ | เมืองต้นทาง | ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ |
สถานที่ออกเดินทาง - ที่อยู่สำหรับแสดง | ไม่บังคับ | ตำแหน่งเวลาออกเดินทางที่จะแสดงต่อผู้ใช้ | ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ |
สถานที่ออกเดินทาง - ที่อยู่ | ไม่บังคับ | ที่อยู่ (หากมี) ของต้นทาง | ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ |
สถานที่ออกเดินทาง - รัฐ | ไม่บังคับ | รัฐหรือจังหวัด (หากมี) ของจุดออกเดินทาง | ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ |
สถานที่ออกเดินทาง - รหัสไปรษณีย์ | ไม่บังคับ | รหัสไปรษณีย์ (หากมี) ของจุดเริ่มต้น | ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ |
สถานที่ออกเดินทาง - ย่านใกล้เคียง | ไม่บังคับ | ย่าน (หากมี) ของจุดเริ่มต้น | ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ |
สถานที่มาถึง - ประเทศ | ไม่บังคับ | ประเทศที่มาถึง | ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ |
สถานที่มาถึง - เมือง | ไม่บังคับ | เมืองปลายทาง | ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ |
สถานที่มาถึง - ที่อยู่สำหรับแสดง | ไม่บังคับ | สถานที่ถึงที่จะแสดงต่อผู้ใช้ | ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด ~20 อักขระ |
สถานที่มาถึง - ที่อยู่ | ไม่บังคับ | ที่อยู่ (หากมี) ของสถานที่ที่จะนำส่ง | ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ |
สถานที่มาถึง - รัฐ | ไม่บังคับ | รัฐหรือจังหวัด (หากมี) ของสถานที่ถึง | ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ |
สถานที่ปลายทาง - รหัสไปรษณีย์ | ไม่บังคับ | รหัสไปรษณีย์ (หากมี) ของสถานที่ถึง | ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ |
สถานที่มาถึง - ย่านใกล้เคียง | ไม่บังคับ | ละแวกใกล้เคียง (หากมี) ของสถานที่ปลายทาง | ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด ~20 อักขระ |
ผู้ให้บริการ - ชื่อ | ไม่บังคับ |
ชื่อผู้ให้บริการ หมายเหตุ: ต้องมีข้อความหรือรูปภาพสำหรับผู้ให้บริการ |
ข้อความอิสระ เช่น ชื่อสายการบิน |
ผู้ให้บริการ - รูปภาพ | ไม่บังคับ |
โลโก้/รูปภาพของผู้ให้บริการ หมายเหตุ: ต้องมีข้อความหรือรูปภาพสำหรับผู้ให้บริการ |
โปรดดูข้อกำหนดเกี่ยวกับรูปภาพสำหรับคำแนะนำ |
ภาพโปสเตอร์ | ไม่บังคับ |
เราจะแสดงรูปภาพเพียง 1 รูปเมื่อมีการระบุรูปภาพหลายรูป สัดส่วนภาพที่แนะนําคือ 16:9 |
ดูคำแนะนำได้ที่ข้อกำหนดเกี่ยวกับรูปภาพ |
คำอธิบาย | ไม่บังคับ | ข้อความ 1 ย่อหน้าเพื่ออธิบายเอนทิตี หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น |
ข้อความอิสระ ขนาดข้อความที่แนะนำ: 180 อักขระ |
รายการคำบรรยาย | ไม่บังคับ | คำบรรยายได้สูงสุด 3 รายการ โดยคำบรรยายแต่ละรายการจะเป็นข้อความบรรทัดเดียว หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น |
ข้อความอิสระ ขนาดข้อความที่แนะนำสำหรับคำบรรยายแต่ละรายการ: สูงสุด 50 อักขระ |
รหัสการจอง | ไม่บังคับ | รหัสการจองสำหรับการสำรองการเดินทาง | ข้อความอิสระ |
ราคา - CurrentPrice | ต้องระบุแบบมีเงื่อนไข | ราคาปัจจุบันของการจอง ต้องระบุหากระบุราคาที่มีการขีดทับ |
ข้อความอิสระ |
ราคา - StrikethroughPrice | ไม่บังคับ | ราคาเดิมของการจอง ซึ่งจะมีการขีดทับใน UI | ข้อความอิสระ |
ข้อความไฮไลต์ราคา | ไม่บังคับ | ข้อความไฮไลต์ราคาเพื่อแสดงโปรโมชัน กิจกรรม ส่วนลดสำหรับสมาชิก (หากมี) | ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 45 อักขระ (ข้อความที่ยาวเกินไปอาจแสดงจุดไข่ปลา) |
หมายเลขการขนส่ง | ต้องระบุ | หมายเลขเที่ยวบิน หมายเลขรถประจำทาง หมายเลขรถไฟ หรือหมายเลขเรือเฟอร์รี่/เรือสำราญ | ข้อความอิสระ |
เวลาขึ้นเครื่อง | ต้องระบุ | การประทับเวลาตามยุคสมัยที่แสดงเวลาขึ้นเครื่องสำหรับการจอง (หากมี) | การประทับเวลา Epoch เป็นมิลลิวินาที |
VehicleRentalReservationEntity
แอตทริบิวต์ | ข้อกำหนด | คำอธิบาย | รูปแบบ |
---|---|---|---|
URI การดำเนินการ | ต้องระบุ |
Deep Link ไปยังเอนทิตีในแอปของผู้ให้บริการ หมายเหตุ: คุณใช้ Deep Link เพื่อการระบุแหล่งที่มาได้ ดูคำถามที่พบบ่อยนี้ |
URI |
ชื่อ | ต้องระบุ | ชื่อของเอนทิตี | ข้อความอิสระ เช่น "Avis Union Square SF" ขนาดข้อความที่แนะนำ: สูงสุด 50 อักขระ |
เวลารับสินค้า | ต้องระบุ | การประทับเวลาตามยุคที่แสดงเวลารับรถสำหรับการจอง | การประทับเวลา Epoch เป็นมิลลิวินาที |
เวลากลับ | ไม่บังคับ | การประทับเวลา Epoch ที่แสดงเวลาเช็คเอาต์สำหรับการจอง | การประทับเวลา Epoch เป็นมิลลิวินาที |
ที่อยู่ในการรับ - ประเทศ | ไม่บังคับ | ประเทศของสถานที่รับสินค้า | ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ |
ที่อยู่ในการรับ - เมือง | ไม่บังคับ | เมืองของจุดรับรถ | ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ |
ที่อยู่ในการรับ - ที่อยู่ที่แสดง | ไม่บังคับ | สถานที่รับสินค้าที่จะแสดงให้ผู้ใช้เห็น | ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ |
ที่อยู่ในการรับ - ที่อยู่ | ไม่บังคับ | ที่อยู่ (หากมี) ของจุดรับสินค้า | ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ |
ที่อยู่ในการรับ - รัฐ | ไม่บังคับ | รัฐหรือจังหวัด (หากมี) ของจุดรับสินค้า | ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ |
ที่อยู่ในการรับ - รหัสไปรษณีย์ | ไม่บังคับ | รหัสไปรษณีย์ (หากมี) ของจุดรับสินค้า | ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ |
ที่อยู่ในการรับ - ย่าน | ไม่บังคับ | ย่าน (หากมี) ของจุดรับสินค้า | ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ |
ที่อยู่สำหรับคืนสินค้า - ประเทศ | ไม่บังคับ | ประเทศของสถานที่ตั้งสำหรับการคืนสินค้า | ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด ~20 อักขระ |
ที่อยู่สำหรับคืนสินค้า - เมือง | ไม่บังคับ | เมืองของสถานที่คืนสินค้า | ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ |
ที่อยู่สำหรับคืนสินค้า - ที่อยู่ที่แสดง | ไม่บังคับ | ตำแหน่งที่แสดงผลต่อผู้ใช้ | ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ |
ที่อยู่สำหรับคืนสินค้า - ที่อยู่ | ไม่บังคับ | ที่อยู่ (หากมี) ของสถานที่คืนสินค้า | ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ |
ที่อยู่สำหรับคืนสินค้า - รัฐ | ไม่บังคับ | รัฐหรือจังหวัด (หากมี) ของสถานที่ส่งคืน | ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ |
ที่อยู่สำหรับคืนสินค้า - รหัสไปรษณีย์ | ไม่บังคับ | รหัสไปรษณีย์ (หากมี) ของสถานที่ส่งคืน | ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ |
ที่อยู่สำหรับคืนสินค้า - ย่าน | ไม่บังคับ | ย่าน (หากมี) ของสถานที่คืนสินค้า | ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด ~20 อักขระ |
ผู้ให้บริการ - ชื่อ | ไม่บังคับ |
ชื่อผู้ให้บริการ หมายเหตุ: ต้องมีข้อความหรือรูปภาพสำหรับผู้ให้บริการ |
ข้อความอิสระ เช่น "Avis Car Rental" |
ผู้ให้บริการ - รูปภาพ | ไม่บังคับ |
โลโก้/รูปภาพของผู้ให้บริการ หมายเหตุ: ต้องมีข้อความหรือรูปภาพสำหรับผู้ให้บริการ |
ดูคำแนะนำได้ที่ข้อกำหนดเกี่ยวกับรูปภาพ |
ภาพโปสเตอร์ | ไม่บังคับ |
เราจะแสดงรูปภาพเพียง 1 รูปเมื่อมีการระบุรูปภาพหลายรูป สัดส่วนภาพที่แนะนําคือ 16:9 |
โปรดดูข้อกำหนดเกี่ยวกับรูปภาพสำหรับคำแนะนำ |
คำอธิบาย | ไม่บังคับ | ข้อความ 1 ย่อหน้าเพื่ออธิบายเอนทิตี หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น |
ข้อความอิสระ ขนาดข้อความที่แนะนำ: 180 อักขระ |
รายการคำบรรยาย | ไม่บังคับ | คำบรรยายได้สูงสุด 3 รายการ โดยคำบรรยายแต่ละรายการจะเป็นข้อความบรรทัดเดียว หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น |
ข้อความอิสระ ขนาดข้อความที่แนะนำสำหรับคำบรรยายแต่ละรายการ: สูงสุด 50 อักขระ |
รหัสยืนยัน | ไม่บังคับ | รหัสยืนยันสำหรับการจองรถเช่า | ข้อความอิสระ |
ราคา - CurrentPrice | ต้องระบุแบบมีเงื่อนไข | ราคาปัจจุบันของการจอง ต้องระบุหากระบุราคาที่มีการขีดทับ |
ข้อความอิสระ |
ราคา - StrikethroughPrice | ไม่บังคับ | ราคาเดิมของการจอง ซึ่งจะมีการขีดทับใน UI | ข้อความอิสระ |
ข้อความไฮไลต์ราคา | ไม่บังคับ | ข้อความไฮไลต์ราคาเพื่อแสดงโปรโมชัน กิจกรรม ส่วนลดสำหรับสมาชิก (หากมี) | ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 45 อักขระ (ข้อความที่ยาวเกินไปอาจแสดงจุดไข่ปลา) |
ข้อกำหนดเกี่ยวกับรูปภาพ
ข้อกำหนดที่จำเป็นสำหรับชิ้นงานรูปภาพแสดงในตารางนี้
สัดส่วนภาพ | พิกเซลขั้นต่ำ | พิกเซลที่แนะนํา |
---|---|---|
สี่เหลี่ยมจัตุรัส (1x1) แนะนำ |
300x300 | 1200x1200 |
แนวนอน (1.91x1) | 600x314 | 1200x628 |
แนวตั้ง (4x5) | 480x600 | 960x1200 |
โดยรูปภาพจะต้องโฮสต์บน CDN สาธารณะเพื่อให้ Google เข้าถึงได้
รูปแบบไฟล์
PNG, JPG, GIF แบบภาพนิ่ง, WebP
ขนาดไฟล์สูงสุด
5,120 KB
คําแนะนําเพิ่มเติม
- พื้นที่ปลอดภัยของรูปภาพ: ใส่เนื้อหาสำคัญไว้ตรงกลาง ซึ่งก็คือ 80% ของรูปภาพนั้น
- ใช้พื้นหลังโปร่งใสเพื่อให้รูปภาพแสดงได้อย่างถูกต้องในการตั้งค่าธีมมืดและธีมสว่าง
หมวดหมู่เนื้อหา
หมวดหมู่เนื้อหาช่วยให้แอปเผยแพร่เนื้อหาที่อยู่ในหมวดหมู่ต่างๆ ได้ ซึ่งจะเชื่อมโยงเนื้อหากับหมวดหมู่ที่กำหนดไว้ล่วงหน้าบางหมวดหมู่ ได้แก่
TYPE_EDUCATION
TYPE_SPORTS
TYPE_MOVIES_AND_TV_SHOWS
TYPE_BOOKS
TYPE_AUDIOBOOKS
TYPE_MUSIC
TYPE_DIGITAL_GAMES
TYPE_TRAVEL_AND_LOCAL
TYPE_HOME_AND_AUTO
TYPE_BUSINESS
TYPE_NEWS
TYPE_FOOD_AND_DRINK
TYPE_SHOPPING
TYPE_HEALTH_AND_FITENESS
TYPE_MEDICAL
TYPE_PARENTING
TYPE_DATING
รูปภาพต้องโฮสต์ใน CDN สาธารณะเพื่อให้ Google เข้าถึงได้
หลักเกณฑ์ในการใช้หมวดหมู่เนื้อหา
- เอนทิตีบางรายการ เช่น ArticleEntity และ GenericFeaturedEntity มีสิทธิ์ใช้หมวดหมู่เนื้อหาใดก็ได้ สำหรับเอนทิตีอื่นๆ เช่น EventEntity, EventReservationEntity, PointOfInterestEntity เฉพาะหมวดหมู่ย่อยของหมวดหมู่เหล่านี้เท่านั้นที่มีสิทธิ์ ตรวจสอบรายการหมวดหมู่ที่มีสิทธิ์สำหรับประเภทเอนทิตีก่อนที่จะป้อนข้อมูลรายการ
ใช้ประเภทเอนทิตีที่เฉพาะเจาะจงสำหรับหมวดหมู่เนื้อหาบางหมวดหมู่แทนการใช้เอนทิตีทั่วไปร่วมกับ ContentCategory
- TYPE_MOVIES_AND_TV_SHOWS - ลองดูเอนทิตีจากดูคู่มือการผสานรวมก่อนใช้เอนทิตีทั่วไป
- TYPE_BOOKS - ดู EbookEntity ก่อนใช้เอนทิตีทั่วไป
- TYPE_AUDIOBOOKS - ดูAudiobookEntity ก่อนใช้เอนทิตีทั่วไป
- TYPE_SHOPPING - ตรวจสอบ ShoppingEntity ก่อนใช้เอนทิตีทั่วไป
- TYPE_FOOD_AND_DRINK - ดูเอนทิตีจากคู่มือการผสานรวมอาหารก่อนใช้เอนทิตีทั่วไป
ช่อง ContentCategory เป็นช่องที่ไม่บังคับ และควรเว้นว่างไว้หากเนื้อหาไม่อยู่ในหมวดหมู่ใดๆ ที่ได้กล่าวถึงก่อนหน้านี้
ในกรณีที่ระบุหมวดหมู่เนื้อหาหลายหมวดหมู่ ให้ระบุหมวดหมู่ตามลำดับความเกี่ยวข้องกับเนื้อหา โดยให้หมวดหมู่เนื้อหาที่มีความเกี่ยวข้องมากที่สุดอยู่อันดับแรกในรายการ
ขั้นตอนที่ 2: ระบุข้อมูลคลัสเตอร์
เราขอแนะนำให้เรียกใช้งานเผยแพร่เนื้อหาในเบื้องหลัง (เช่น โดยใช้ WorkManager) และกำหนดเวลาเป็นประจำหรือตามเหตุการณ์ (เช่น ทุกครั้งที่ผู้ใช้เปิดแอปหรือเมื่อผู้ใช้เพิ่งเพิ่มรายการลงในรถเข็น)
AppEngagePublishClient
มีหน้าที่รับผิดชอบในการเผยแพร่คลัสเตอร์
API ต่อไปนี้ใช้เพื่อเผยแพร่คลัสเตอร์ในไคลเอ็นต์
isServiceAvailable
publishRecommendationClusters
publishFeaturedCluster
publishContinuationCluster
publishUserAccountManagementRequest
updatePublishStatus
deleteRecommendationsClusters
deleteFeaturedCluster
deleteContinuationCluster
deleteUserManagementCluster
deleteClusters
isServiceAvailable
API นี้ใช้เพื่อตรวจสอบว่าบริการพร้อมสำหรับการผสานรวมหรือไม่ และเนื้อหาแสดงในอุปกรณ์ได้หรือไม่
Kotlin
client.isServiceAvailable.addOnCompleteListener { task -> if (task.isSuccessful) { // Handle IPC call success if(task.result) { // Service is available on the device, proceed with content publish // calls. } else { // Service is not available, no further action is needed. } } else { // The IPC call itself fails, proceed with error handling logic here, // such as retry. } }
Java
client.isServiceAvailable().addOnCompleteListener(task - > { if (task.isSuccessful()) { // Handle success if(task.getResult()) { // Service is available on the device, proceed with content publish // calls. } else { // Service is not available, no further action is needed. } } else { // The IPC call itself fails, proceed with error handling logic here, // such as retry. } });
publishRecommendationClusters
API นี้ใช้เพื่อเผยแพร่รายการออบเจ็กต์ RecommendationCluster
รายการ
Kotlin
client.publishRecommendationClusters( PublishRecommendationClustersRequest.Builder() .addRecommendationCluster( RecommendationCluster.Builder() .addEntity(entity1) .addEntity(entity2) .setTitle("Top Picks For You") .build() ) .build() )
Java
client.publishRecommendationClusters( new PublishRecommendationClustersRequest.Builder() .addRecommendationCluster( new RecommendationCluster.Builder() .addEntity(entity1) .addEntity(entity2) .setTitle("Top Picks For You") .build()) .build());
เมื่อบริการได้รับคำขอ การดำเนินการต่อไปนี้จะเกิดขึ้นในธุรกรรมเดียว
- ระบบจะนำข้อมูล
RecommendationCluster
ที่มีอยู่ออกจากพาร์ทเนอร์นักพัฒนาแอป - ระบบจะแยกวิเคราะห์และจัดเก็บข้อมูลจากคำขอไว้ในคลัสเตอร์คำแนะนำที่อัปเดต
ในกรณีที่เกิดข้อผิดพลาด คำขอทั้งหมดจะถูกปฏิเสธและระบบจะคงสถานะที่มีอยู่ไว้
publishFeaturedCluster
API นี้ใช้เพื่อเผยแพร่รายการออบเจ็กต์ FeaturedCluster
Kotlin
client.publishFeaturedCluster( PublishFeaturedClusterRequest.Builder() .setFeaturedCluster( FeaturedCluster.Builder() .addEntity(entity1) .addEntity(entity2) .build()) .build())
Java
client.publishFeaturedCluster( new PublishFeaturedClustersRequest.Builder() .addFeaturedCluster( new FeaturedCluster.Builder() .addEntity(entity1) .addEntity(entity2) .build()) .build());
เมื่อบริการได้รับคําขอแล้ว ระบบจะดําเนินการต่อไปนี้ภายในธุรกรรมเดียว
- ระบบจะนำข้อมูล
FeaturedCluster
ที่มีอยู่จากพาร์ทเนอร์นักพัฒนาแอปออก - ระบบจะแยกวิเคราะห์และจัดเก็บข้อมูลจากคำขอไว้ในคลัสเตอร์เด่นที่มีการอัปเดต
ในกรณีที่เกิดข้อผิดพลาด ระบบจะปฏิเสธคำขอทั้งหมดและคงสถานะที่มีอยู่ไว้
publishContinuationCluster
API นี้ใช้เพื่อเผยแพร่ออบเจ็กต์ ContinuationCluster
Kotlin
client.publishContinuationCluster( PublishContinuationClusterRequest.Builder() .setContinuationCluster( ContinuationCluster.Builder() .addEntity(entity1) .addEntity(entity2) .build()) .build())
Java
client.publishContinuationCluster( new PublishContinuationClusterRequest.Builder() .setContinuationCluster( new ContinuationCluster.Builder() .addEntity(entity1) .addEntity(entity2) .build()) .build());
เมื่อบริการได้รับคําขอแล้ว ระบบจะดําเนินการต่อไปนี้ภายในธุรกรรมเดียว
- ระบบจะนำข้อมูล
ContinuationCluster
ที่มีอยู่ออกจากพาร์ทเนอร์นักพัฒนาแอป - ระบบจะแยกวิเคราะห์และจัดเก็บข้อมูลจากคําขอไว้ในคลัสเตอร์การต่ออายุที่อัปเดตแล้ว
ในกรณีที่เกิดข้อผิดพลาด ระบบจะปฏิเสธคำขอทั้งหมดและคงสถานะที่มีอยู่ไว้
publishUserAccountManagementRequest
API นี้ใช้เพื่อเผยแพร่การ์ดการลงชื่อเข้าใช้ การดำเนินการลงชื่อเข้าใช้จะนำผู้ใช้ไปยังหน้าลงชื่อเข้าใช้ของแอปเพื่อให้แอปเผยแพร่เนื้อหาได้ (หรือแสดงเนื้อหาที่ปรับเปลี่ยนในแบบของคุณมากขึ้น)
ข้อมูลเมตาต่อไปนี้เป็นส่วนหนึ่งของการ์ดลงชื่อเข้าใช้
แอตทริบิวต์ | ข้อกำหนด | คำอธิบาย |
---|---|---|
URI การดำเนินการ | ต้องระบุ | Deep Link ไปยังการดำเนินการ (เช่น ไปที่หน้าลงชื่อเข้าใช้แอป) |
รูปภาพ | ไม่บังคับ - หากไม่ระบุ จะต้องระบุชื่อ |
รูปภาพที่แสดงในการ์ด รูปภาพสัดส่วนภาพ 16:9 ที่มีความละเอียด 1264x712 |
ชื่อ | ไม่บังคับ - หากไม่ระบุ จะต้องระบุรูปภาพ | ชื่อบนการ์ด |
ข้อความการดําเนินการ | ไม่บังคับ | ข้อความที่แสดงใน CTA (เช่น ลงชื่อเข้าใช้) |
ชื่อรอง | ไม่บังคับ | คำบรรยายเสริมบนการ์ด |
Kotlin
var SIGN_IN_CARD_ENTITY = SignInCardEntity.Builder() .addPosterImage( Image.Builder() .setImageUri(Uri.parse("http://www.x.com/image.png")) .setImageHeightInPixel(500) .setImageWidthInPixel(500) .build()) .setActionText("Sign In") .setActionUri(Uri.parse("http://xx.com/signin")) .build() client.publishUserAccountManagementRequest( PublishUserAccountManagementRequest.Builder() .setSignInCardEntity(SIGN_IN_CARD_ENTITY) .build());
Java
SignInCardEntity SIGN_IN_CARD_ENTITY = new SignInCardEntity.Builder() .addPosterImage( new Image.Builder() .setImageUri(Uri.parse("http://www.x.com/image.png")) .setImageHeightInPixel(500) .setImageWidthInPixel(500) .build()) .setActionText("Sign In") .setActionUri(Uri.parse("http://xx.com/signin")) .build(); client.publishUserAccountManagementRequest( new PublishUserAccountManagementRequest.Builder() .setSignInCardEntity(SIGN_IN_CARD_ENTITY) .build());
เมื่อบริการได้รับคําขอแล้ว ระบบจะดําเนินการต่อไปนี้ภายในธุรกรรมเดียว
- ระบบจะนำข้อมูล
UserAccountManagementCluster
ที่มีอยู่จากพาร์ทเนอร์นักพัฒนาแอปออก - ระบบจะแยกวิเคราะห์และจัดเก็บข้อมูลจากคําขอไว้ในคลัสเตอร์ UserAccountManagementCluster ที่อัปเดตแล้ว
ในกรณีที่เกิดข้อผิดพลาด ระบบจะปฏิเสธคำขอทั้งหมดและคงสถานะที่มีอยู่ไว้
updatePublishStatus
หากไม่มีการเผยแพร่คลัสเตอร์ด้วยเหตุผลภายในทางธุรกิจ เราขอแนะนำให้อัปเดตสถานะการเผยแพร่โดยใช้ updatePublishStatus API ซึ่งเป็นสิ่งสำคัญเนื่องจาก :
- การให้สถานะในทุกสถานการณ์ แม้ว่าเนื้อหาจะเผยแพร่แล้ว (STATUS == PUBLISHED) ก็ตาม เป็นสิ่งที่สําคัญในการป้อนข้อมูลแดชบอร์ดที่ใช้สภาวะที่ชัดเจนนี้เพื่อสื่อให้เห็นถึงสถานะและเมตริกอื่นๆ ของการผสานรวม
- หากไม่มีการเผยแพร่เนื้อหา แต่สถานะการผสานรวมยังไม่เสียหาย (STATUS == NOT_PUBLISHED) Google จะหลีกเลี่ยงการทริกเกอร์การแจ้งเตือนในแดชบอร์ดสถานะแอปได้ สถานะนี้ยืนยันว่าเนื้อหาไม่เผยแพร่เนื่องจากเป็นสถานการณ์ที่คาดไว้จากมุมมองของผู้ให้บริการ
- ซึ่งจะช่วยให้นักพัฒนาแอปสามารถให้ข้อมูลเชิงลึกเกี่ยวกับเวลาที่เผยแพร่ข้อมูลหรือไม่เผยแพร่
- Google อาจใช้รหัสสถานะเพื่อกระตุ้นให้ผู้ใช้ดำเนินการบางอย่างในแอปเพื่อให้ผู้ใช้ดูเนื้อหาของแอปหรือแก้ไขปัญหาได้
รายการรหัสสถานะการเผยแพร่ที่มีสิทธิ์มีดังนี้
// Content is published
AppEngagePublishStatusCode.PUBLISHED,
// Content is not published as user is not signed in
AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN,
// Content is not published as user is not subscribed
AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SUBSCRIPTION,
// Content is not published as user location is ineligible
AppEngagePublishStatusCode.NOT_PUBLISHED_INELIGIBLE_LOCATION,
// Content is not published as there is no eligible content
AppEngagePublishStatusCode.NOT_PUBLISHED_NO_ELIGIBLE_CONTENT,
// Content is not published as the feature is disabled by the client
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_FEATURE_DISABLED_BY_CLIENT,
// Content is not published as the feature due to a client error
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_CLIENT_ERROR,
// Content is not published as the feature due to a service error
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_SERVICE_ERROR,
// Content is not published due to some other reason
// Reach out to engage-developers@ before using this enum.
AppEngagePublishStatusCode.NOT_PUBLISHED_OTHER
หากเนื้อหาไม่เผยแพร่เนื่องจากผู้ใช้ไม่ได้เข้าสู่ระบบ Google จะแนะนำให้เผยแพร่การ์ดลงชื่อเข้าใช้ หากผู้ให้บริการไม่สามารถเผยแพร่การ์ดลงชื่อเข้าใช้ไม่ว่าด้วยเหตุผลใดก็ตาม เราขอแนะนำให้เรียกใช้ updatePublishStatus API ด้วยรหัสสถานะ NOT_PUBLISHED_REQUIRES_SIGN_IN
Kotlin
client.updatePublishStatus( PublishStatusRequest.Builder() .setStatusCode(AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN) .build())
Java
client.updatePublishStatus( new PublishStatusRequest.Builder() .setStatusCode(AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN) .build());
deleteRecommendationClusters
API นี้ใช้เพื่อลบเนื้อหาของคลัสเตอร์คําแนะนํา
Kotlin
client.deleteRecommendationClusters()
Java
client.deleteRecommendationClusters();
เมื่อบริการได้รับคําขอ ระบบจะนำข้อมูลที่มีอยู่ออกจากคลัสเตอร์คําแนะนํา ในกรณีที่เกิดข้อผิดพลาด ระบบจะปฏิเสธคำขอทั้งหมดและรักษาสถานะที่มีอยู่
deleteFeaturedCluster
API นี้ใช้เพื่อลบเนื้อหาของคลัสเตอร์แนะนำ
Kotlin
client.deleteFeaturedCluster()
Java
client.deleteFeaturedCluster();
เมื่อบริการได้รับคำขอ ระบบจะนำข้อมูลที่มีอยู่ออกจากคลัสเตอร์ที่แนะนำ ในกรณีที่เกิดข้อผิดพลาด ระบบจะปฏิเสธคำขอทั้งหมดและคงสถานะที่มีอยู่ไว้
deleteContinuationCluster
API นี้ใช้เพื่อลบเนื้อหาของคลัสเตอร์การต่อเรื่อง
Kotlin
client.deleteContinuationCluster()
Java
client.deleteContinuationCluster();
เมื่อบริการได้รับคําขอ ระบบจะนำข้อมูลที่มีอยู่ออกจากกลุ่มต่อเนื่อง ในกรณีที่เกิดข้อผิดพลาด ระบบจะปฏิเสธคำขอทั้งหมดและรักษาสถานะที่มีอยู่
deleteUserManagementCluster
API นี้ใช้เพื่อลบเนื้อหาของคลัสเตอร์ UserAccountManagement
Kotlin
client.deleteUserManagementCluster()
Java
client.deleteUserManagementCluster();
เมื่อบริการได้รับคําขอ ระบบจะนำข้อมูลที่มีอยู่ออกจากคลัสเตอร์การจัดการบัญชีผู้ใช้ ในกรณีที่เกิดข้อผิดพลาด ระบบจะปฏิเสธคำขอทั้งหมดและคงสถานะที่มีอยู่ไว้
deleteClusters
API นี้ใช้เพื่อลบเนื้อหาของคลัสเตอร์ประเภทหนึ่งๆ
Kotlin
client.deleteClusters( DeleteClustersRequest.Builder() .addClusterType(ClusterType.TYPE_CONTINUATION) .addClusterType(ClusterType.TYPE_FEATURED) .addClusterType(ClusterType.TYPE_RECOMMENDATION) .build())
Java
client.deleteClusters( new DeleteClustersRequest.Builder() .addClusterType(ClusterType.TYPE_CONTINUATION) .addClusterType(ClusterType.TYPE_FEATURED) .addClusterType(ClusterType.TYPE_RECOMMENDATION) .build());
เมื่อบริการได้รับคําขอ ระบบจะนำข้อมูลที่มีอยู่ออกจากคลัสเตอร์ทั้งหมดที่ตรงกับประเภทคลัสเตอร์ที่ระบุ โดยสามารถเลือกส่งคลัสเตอร์ประเภทเดียวหรือหลายประเภทก็ได้ ในกรณีที่เกิดข้อผิดพลาด ระบบจะปฏิเสธคำขอทั้งหมดและคงสถานะที่มีอยู่ไว้
การจัดการข้อผิดพลาด
ขอแนะนําอย่างยิ่งให้ฟังผลลัพธ์ของงานจาก API การเผยแพร่เพื่อให้ดําเนินการติดตามผลเพื่อกู้คืนและส่งงานที่สําเร็จอีกครั้งได้
Kotlin
client.publishRecommendationClusters( PublishRecommendationClustersRequest.Builder() .addRecommendationCluster(..) .build()) .addOnCompleteListener { task -> if (task.isSuccessful) { // do something } else { val exception = task.exception if (exception is AppEngageException) { @AppEngageErrorCode val errorCode = exception.errorCode if (errorCode == AppEngageErrorCode.SERVICE_NOT_FOUND) { // do something } } } }
Java
client.publishRecommendationClusters( new PublishRecommendationClustersRequest.Builder() .addRecommendationCluster(...) .build()) .addOnCompleteListener( task -> { if (task.isSuccessful()) { // do something } else { Exception exception = task.getException(); if (exception instanceof AppEngageException) { @AppEngageErrorCode int errorCode = ((AppEngageException) exception).getErrorCode(); if (errorCode == AppEngageErrorCode.SERVICE_NOT_FOUND) { // do something } } } });
ระบบจะแสดงข้อผิดพลาดเป็น AppEngageException
โดยระบุสาเหตุเป็นรหัสข้อผิดพลาด
รหัสข้อผิดพลาด | ชื่อข้อผิดพลาด | หมายเหตุ |
---|---|---|
1 |
SERVICE_NOT_FOUND |
บริการไม่พร้อมให้บริการในอุปกรณ์ที่ระบุ |
2 |
SERVICE_NOT_AVAILABLE |
บริการพร้อมใช้งานในอุปกรณ์หนึ่งๆ แต่ใช้งานไม่ได้ขณะโทร (เช่น มีการปิดใช้อย่างชัดเจน) |
3 |
SERVICE_CALL_EXECUTION_FAILURE |
การดำเนินการของงานล้มเหลวเนื่องจากปัญหาการแยกชุดข้อความ ในกรณีนี้ คุณสามารถลองอีกครั้ง |
4 |
SERVICE_CALL_PERMISSION_DENIED |
ผู้โทรไม่ได้รับอนุญาตให้โทรเรียกบริการ |
5 |
SERVICE_CALL_INVALID_ARGUMENT |
คำขอมีข้อมูลที่ไม่ถูกต้อง (เช่น มีจำนวนคลัสเตอร์มากกว่าที่อนุญาต) |
6 |
SERVICE_CALL_INTERNAL |
เกิดข้อผิดพลาดที่ฝั่งบริการ |
7 |
SERVICE_CALL_RESOURCE_EXHAUSTED |
การเรียกใช้บริการเกิดขึ้นบ่อยเกินไป |
ขั้นตอนที่ 3: จัดการการออกอากาศ Intent
นอกเหนือจากการเรียกใช้ API เผยแพร่เนื้อหาผ่านงานแล้ว คุณยังต้องตั้งค่า BroadcastReceiver
เพื่อรับคําขอเผยแพร่เนื้อหาด้วย
เป้าหมายของ Intent แบบออกอากาศมีไว้สำหรับการเปิดใช้งานแอปอีกครั้งและการบังคับให้ซิงค์ข้อมูลเป็นหลัก Intent แบบออกอากาศไม่ได้ออกแบบมาเพื่อส่งบ่อยครั้ง ระบบจะทริกเกอร์เฉพาะเมื่อบริการ Engage พิจารณาว่าเนื้อหาอาจล้าสมัย (เช่น เนื้อหาเก่า 1 สัปดาห์) วิธีนี้ช่วยให้มั่นใจมากขึ้นว่าผู้ใช้จะได้รับประสบการณ์การใช้งานเนื้อหาที่สดใหม่ แม้ว่าแอปพลิเคชันจะไม่ได้ใช้งานเป็นเวลานาน
BroadcastReceiver
ต้องตั้งค่าด้วย 2 วิธีต่อไปนี้
- ลงทะเบียนอินสแตนซ์ของคลาส
BroadcastReceiver
แบบไดนามิกโดยใช้Context.registerReceiver()
ซึ่งจะช่วยให้แอปพลิเคชันสื่อสารกันได้อยู่แม้ว่าจะยังอยู่ในหน่วยความจำ
Kotlin
class AppEngageBroadcastReceiver : BroadcastReceiver(){ // Trigger recommendation cluster publish when PUBLISH_RECOMMENDATION broadcast // is received // Trigger featured cluster publish when PUBLISH_FEATURED broadcast is received // Trigger continuation cluster publish when PUBLISH_CONTINUATION broadcast is // received } fun registerBroadcastReceivers(context: Context){ var context = context context = context.applicationContext // Register Recommendation Cluster Publish Intent context.registerReceiver(AppEngageBroadcastReceiver(), IntentFilter(Intents.ACTION_PUBLISH_RECOMMENDATION)) // Register Featured Cluster Publish Intent context.registerReceiver(AppEngageBroadcastReceiver(), IntentFilter(Intents.ACTION_PUBLISH_FEATURED)) // Register Continuation Cluster Publish Intent context.registerReceiver(AppEngageBroadcastReceiver(), IntentFilter(Intents.ACTION_PUBLISH_CONTINUATION)) }
Java
class AppEngageBroadcastReceiver extends BroadcastReceiver { // Trigger recommendation cluster publish when PUBLISH_RECOMMENDATION broadcast // is received // Trigger featured cluster publish when PUBLISH_FEATURED broadcast is received // Trigger continuation cluster publish when PUBLISH_CONTINUATION broadcast is // received } public static void registerBroadcastReceivers(Context context) { context = context.getApplicationContext(); // Register Recommendation Cluster Publish Intent context.registerReceiver(new AppEngageBroadcastReceiver(), new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_RECOMMENDATION)); // Register Featured Cluster Publish Intent context.registerReceiver(new AppEngageBroadcastReceiver(), new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_FEATURED)); // Register Continuation Cluster Publish Intent context.registerReceiver(new AppEngageBroadcastReceiver(), new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_CONTINUATION)); }
- ประกาศการติดตั้งใช้งานแบบคงที่ด้วยแท็ก
<receiver>
ในไฟล์AndroidManifest.xml
วิธีนี้ช่วยให้แอปพลิเคชันได้รับความตั้งใจในการออกอากาศ เมื่อไม่ได้ทำงานอยู่ และยังช่วยให้แอปพลิเคชันสามารถ เผยแพร่เนื้อหาได้
<application>
<receiver
android:name=".AppEngageBroadcastReceiver"
android:exported="true"
android:enabled="true">
<intent-filter>
<action android:name="com.google.android.engage.action.PUBLISH_RECOMMENDATION" />
</intent-filter>
<intent-filter>
<action android:name="com.google.android.engage.action.PUBLISH_FEATURED" />
</intent-filter>
<intent-filter>
<action android:name="com.google.android.engage.action.PUBLISH_CONTINUATION" />
</intent-filter>
</receiver>
</application>
Intent ต่อไปนี้จะส่งโดยบริการ
com.google.android.engage.action.PUBLISH_RECOMMENDATION
ขอแนะนำให้เริ่มการโทรpublishRecommendationClusters
เมื่อได้รับ Intent นี้com.google.android.engage.action.PUBLISH_FEATURED
เราขอแนะนำให้เริ่มpublishFeaturedCluster
การโทรเมื่อได้รับ Intent นี้com.google.android.engage.action.PUBLISH_CONTINUATION
ขอแนะนำให้เริ่มการโทรpublishContinuationCluster
เมื่อได้รับ Intent นี้
เวิร์กโฟลว์การผสานรวม
ดูคู่มือทีละขั้นตอนเกี่ยวกับการยืนยันการผสานรวมหลังจากดำเนินการเสร็จแล้วได้ที่หัวข้อเวิร์กโฟลว์การผสานรวมของนักพัฒนาแอป
คำถามที่พบบ่อย
ดูคำถามที่พบบ่อยได้ที่คำถามที่พบบ่อยเกี่ยวกับ Engage SDK
รายชื่อติดต่อ
โปรดติดต่อ engage-developers@google.com หากมีคำถามระหว่างกระบวนการผสานรวม
ขั้นตอนถัดไป
หลังจากการผสานรวมนี้เสร็จสมบูรณ์แล้ว ขั้นตอนถัดไปมีดังนี้
- ส่งอีเมลไปที่ Engage-developers@google.com และแนบ APK ที่ผสานรวมซึ่งพร้อมให้ทดสอบโดย Google
- Google จะดำเนินการยืนยันและตรวจสอบภายในเพื่อให้แน่ใจว่าการผสานรวมทำงานได้ตามที่คาดไว้ หากจำเป็นต้องทำการเปลี่ยนแปลง Google จะติดต่อคุณพร้อมรายละเอียดที่จำเป็น
- เมื่อการทดสอบเสร็จสมบูรณ์และไม่จำเป็นต้องมีการเปลี่ยนแปลงใดๆ Google จะติดต่อคุณเพื่อแจ้งให้ทราบว่าคุณสามารถเริ่มเผยแพร่ APK ที่อัปเดตและผสานรวมแล้วใน Play Store
- หลังจาก Google ยืนยันว่าได้เผยแพร่ APK ที่อัปเดตแล้วไปยัง Play Store แล้ว ระบบอาจเผยแพร่คลัสเตอร์คำแนะนำ แนะนํา และการต่อเรื่องให้ผู้ใช้เห็น