Engage SDK Travel: คำแนะนำการผสานรวมทางเทคนิคของบุคคลที่สาม

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

รายละเอียดการผสานรวม

คำศัพท์

การผสานรวมนี้รวมถึงคลัสเตอร์ประเภทต่างๆ ต่อไปนี้ คําแนะนํา แนะนํา การจอง และค้นหาต่อ

  • กลุ่มคําแนะนําจะแสดงคําแนะนําการเดินทางและกิจกรรมที่ปรับเปลี่ยนในแบบของคุณจากพาร์ทเนอร์นักพัฒนาแอปแต่ละราย คำแนะนำเหล่านี้อาจปรับเปลี่ยนในแบบของผู้ใช้หรือเป็นแบบทั่วไป (เช่น รายการที่มาแรง) ใช้เพื่อแสดงบทความ กิจกรรม ที่พัก หรือสถานที่น่าสนใจที่แนะนํา

    • กลุ่มคําแนะนําอาจประกอบด้วยข้อมูล ArticleEntity, EventEntity, LodgingEntity, PointOfInterestEntity หรือ StoreEntity แต่ต้องไม่ผสมกับเอนทิตีประเภทต่างๆ

    คำแนะนำของคุณจะมีโครงสร้างดังต่อไปนี้

    • คลัสเตอร์คําแนะนํา: มุมมอง UI ที่มีกลุ่มคําแนะนําจากพาร์ทเนอร์นักพัฒนาแอปรายเดียวกัน

    • เอนทิตี: ออบเจ็กต์ที่แสดงรายการเดียวในคลัสเตอร์ การผสานรวมนี้แสดงเอนทิตีบางอย่างที่จะแสดงโดยใช้กลุ่มคําแนะนํา ดังนี้

      • ArticleEntity: ArticleEntity แสดงคําแนะนําสําหรับเนื้อหาที่เป็นข้อความซึ่งเกี่ยวข้องกับการเดินทางและกิจกรรม สามารถใช้กับบทความ บล็อกโพสต์ เนื้อหาการตลาด ตัวอย่างข่าว ฯลฯ

        รูปที่ 1: UI ที่แสดง ArticleEntity รายการเดียวภายในคลัสเตอร์คําแนะนํา

      • EventEntity: EventEntity แสดงถึงเหตุการณ์ที่เกิดขึ้นในอนาคต เวลาเริ่มต้นของกิจกรรมเป็นข้อมูลสำคัญที่จำเป็นต้องแจ้งให้ผู้ใช้ทราบ

        รูปที่ 2: UI ที่แสดง EventEntity รายการเดียวภายในกลุ่มคําแนะนํา

      • LodgingEntity: LodgingEntity แสดงที่พัก เช่น โรงแรม อพาร์ตเมนต์ บ้านพักให้เช่าระยะสั้นและระยะยาว

        รูปที่ 3: UI ที่แสดง LodgingEntity รายการเดียวภายในคลัสเตอร์คําแนะนํา

      • StoreEntity: StoreEntity แสดงถึงร้านค้า ร้านอาหาร คาเฟ่ ฯลฯ โดยจะไฮไลต์เนื้อหาที่ร้านอาหารหรือร้านค้าเป็นข้อมูลสำคัญที่ต้องสื่อให้ผู้ใช้ทราบ

        รูปที่ 4: UI ที่แสดง StoreEntity รายการเดียวภายในกลุ่มคําแนะนํา

      • PointOfInterestEntity: PointOfInterestEntity แสดงสถานที่น่าสนใจ เช่น ปั๊มน้ำมัน สถานที่จัดงาน สวนสนุก พิพิธภัณฑ์ สถานที่ท่องเที่ยว เส้นทางเดินป่า ฯลฯ โดยจะไฮไลต์เนื้อหาที่ตําแหน่งเป็นข้อมูลสําคัญที่ต้องสื่อให้ผู้ใช้ทราบ ไม่ควรใช้กับที่พัก ร้านค้า หรือสถานที่รับประทานอาหาร

        รูปที่ 5: UI ที่แสดง PointOfInterestEntity รายการเดียวภายในคลัสเตอร์คําแนะนํา

  • กลุ่มการจองจะแสดงเนื้อหาที่ผู้ใช้จากพาร์ทเนอร์นักพัฒนาแอปหลายรายมีส่วนร่วมเมื่อเร็วๆ นี้ในการรวมกลุ่ม UI เดียว พาร์ทเนอร์นักพัฒนาแอปแต่ละรายจะออกอากาศได้สูงสุด 10 รายการในกลุ่มการจอง

    เนื้อหาการจองของคุณมีโครงสร้างได้ดังนี้

    • RestaurantReservationEntity: RestaurantReservationEntity แสดงการจองร้านอาหารหรือคาเฟ่ และช่วยให้ผู้ใช้ติดตามการจองร้านอาหารที่กําลังจะเกิดขึ้นหรืออยู่ระหว่างดำเนินการได้

      รูปที่ 6 UI ที่แสดง RestaurantReservationEntity รายการเดียวภายในคลัสเตอร์การจอง

    • EventReservationEntity: EventReservationEntity แสดงถึงการจองกิจกรรมและช่วยให้ผู้ใช้ติดตามการจองกิจกรรมที่กําลังจะมีขึ้นหรือกําลังดำเนินอยู่ กิจกรรมอาจรวมถึงแต่ไม่จํากัดเพียงกิจกรรมต่อไปนี้

      • กิจกรรมกีฬา เช่น การจองตั๋วเข้าชมการแข่งขันฟุตบอล
      • กิจกรรมเกม เช่น การจองสำหรับอีสปอร์ต
      • กิจกรรมบันเทิง เช่น การจองตั๋วภาพยนตร์ในโรงภาพยนตร์ คอนเสิร์ต โรงละคร การเซ็นหนังสือ
      • การจองการเดินทางหรือสถานที่น่าสนใจ เช่น ทัวร์ชมพร้อมไกด์ ตั๋วเข้าชมพิพิธภัณฑ์
      • การจองเพื่องานสังคม / สัมมนา / การประชุม
      • การจองเซสชันการศึกษา / การฝึกอบรม
      รูปที่ 7 UI ที่แสดง EventReservationEntity รายการเดียวภายในคลัสเตอร์การจอง

    • LodgingReservationEntity: LodgingEntityReservation แสดงการจองที่พักสำหรับการเดินทาง และช่วยให้ผู้ใช้ติดตามการจองโรงแรมหรือที่พักให้เช่าที่กําลังจะเกิดขึ้นหรืออยู่ระหว่างดำเนินการได้

      รูปที่ 8 UI ที่แสดง LodgingReservationEntity รายการเดียวภายในคลัสเตอร์การจอง

    • TransportationReservationEntity: TransportationReservationEntity แสดงการจองสำหรับการเดินทางด้วยรูปแบบใดก็ได้ และช่วยให้ผู้ใช้ติดตามการจองสำหรับเที่ยวบิน เรือเฟอร์รี่ รถไฟ รถประจำทาง บริการเรียกรถ หรือเรือสำราญที่กําลังจะเกิดขึ้นหรือเกิดขึ้น

      รูปที่ 9 UI ที่แสดง TransportationReservationEntity รายการเดียวภายในคลัสเตอร์การจอง

    • VehicleRentalReservationEntity: VehicleRentalReservationEntity แสดงการจองรถเช่าและช่วยให้ผู้ใช้ติดตามการจองรถเช่าที่กําลังจะเกิดขึ้นหรืออยู่ระหว่างดำเนินการ

      รูปที่ 10 UI ที่แสดง VehicleRentalReservationEntity รายการเดียวภายในคลัสเตอร์การจอง

  • กลุ่มแนะนําจะแสดงรายการต่างๆ จากพาร์ทเนอร์นักพัฒนาแอปหลายรายในการรวมกลุ่ม UI เดียว โดยจะมีคลัสเตอร์แนะนำกลุ่มเดียวที่แสดงอยู่ใกล้กับด้านบนของ UI ด้วยตำแหน่งที่มีลำดับความสำคัญเหนือคลัสเตอร์คำแนะนำทั้งหมด พาร์ทเนอร์นักพัฒนาแอปแต่ละรายจะออกอากาศได้สูงสุด 10 รายการในคลัสเตอร์แนะนํา

    • GenericFeaturedEntity: GenericFeaturedEntity แตกต่างจากรายการคำแนะนำตรงที่ควรใช้รายการแนะนำสำหรับเนื้อหายอดนิยมรายการเดียวจากนักพัฒนาแอป และควรแสดงเนื้อหาที่สำคัญที่สุดรายการเดียวที่จะน่าสนใจและเกี่ยวข้องกับผู้ใช้

      รูปที่ 11: UI ที่แสดง FeaturedCluster พร้อมรายการ GenericFeaturedEntity

  • กลุ่ม Continue Search ช่วยให้ผู้ใช้กลับมาค้นหาข้อมูลการเดินทางต่อได้ด้วยการแสดงรายการข้อความค้นหาที่ผู้ใช้ค้นหาล่าสุดในแอปการเดินทางทั้งหมด ระบบจะปักหมุดคลัสเตอร์ไว้ในตำแหน่งที่ 2 หลังการจองและก่อนคลัสเตอร์แนะนำและแนะนำ พาร์ทเนอร์นักพัฒนาแอปแต่ละรายจะอนุญาตให้ออกอากาศได้สูงสุด 3 รายการในกลุ่ม "ค้นหาต่อไป"

    • PointOfInterestEntity: PointOfInterestEntity แสดงสถานที่น่าสนใจ เช่น ปั๊มน้ำมัน สถานที่จัดงาน สวนสนุก พิพิธภัณฑ์ สถานที่ท่องเที่ยว เส้นทางเดินป่า ฯลฯ โดยจะไฮไลต์เนื้อหาที่ผู้ใช้เคยค้นหา

งานก่อนเริ่มเวิร์กช็อป

ระดับ 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)
คลัสเตอร์การจอง ไม่เกิน 1 อย่างน้อย 1 รายการ ไม่เกิน 10 รายการ (RestaurantReservationEntity, EventReservationEntity, LodgingReservationEntity, TransportationReservationEntity หรือ VehicleRentalReservationEntity)
คลัสเตอร์แนะนำ ไม่เกิน 1 อย่างน้อย 1 รายการ ไม่เกิน 10 (GenericFeaturedEntity)
ค้นหาคลัสเตอร์ต่อไป ไม่เกิน 1 อย่างน้อย 1 รายการ ไม่เกิน 3 (PointOfInterestEntity)

ขั้นตอนที่ 1: ระบุข้อมูลเอนทิตี

SDK ได้กําหนดเอนทิตีต่างๆ เพื่อแสดงรายการแต่ละประเภท เรารองรับเอนทิตีต่อไปนี้สำหรับหมวดหมู่การท่องเที่ยวและกิจกรรม

  1. GenericFeaturedEntity
  2. ArticleEntity
  3. EventEntity
  4. LodgingEntity
  5. StoreEntity
  6. PointOfInterestEntity
  7. RestaurantReservationEntity
  8. EventReservationEntity
  9. LodgingReservationEntity
  10. TransportationReservationEntity
  11. VehicleRentalReservationEntity

แผนภูมิด้านล่างแสดงแอตทริบิวต์และข้อกําหนดที่ใช้ได้สําหรับแต่ละประเภท

GenericFeaturedEntity

แอตทริบิวต์ ข้อกำหนด คำอธิบาย รูปแบบ
URI การดำเนินการ ต้องระบุ

Deep Link ไปยังเอนทิตีในแอปของผู้ให้บริการ

หมายเหตุ: คุณใช้ Deep Link เพื่อการระบุแหล่งที่มาได้ โปรดดูคำถามที่พบบ่อยนี้

URI
ภาพโปสเตอร์ ต้องระบุ

เราจะแสดงรูปภาพเพียง 1 รูปเมื่อมีการระบุรูปภาพหลายรูป สัดส่วนภาพที่แนะนำคือ 16:9

หมายเหตุ: หากมีป้าย ให้เว้นพื้นที่ปลอดภัย 24 จุดต่อนิ้วทั้งด้านบนและด้านล่างของรูปภาพ

 ดูคำแนะนำได้ที่ข้อกำหนดเกี่ยวกับรูปภาพ
ชื่อ ไม่บังคับ ชื่อของเอนทิตี

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: 50 อักขระ
คำอธิบาย ไม่บังคับ

ข้อความย่อหน้าเดียวเพื่ออธิบายเอนทิตี

หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: 180 อักขระ
รายการคำบรรยาย ไม่บังคับ

คำบรรยายได้สูงสุด 3 รายการ โดยคำบรรยายแต่ละรายการจะเป็นข้อความบรรทัดเดียว

หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น

ข้อความอิสระ

ขนาดข้อความที่แนะนำสำหรับคำบรรยายแต่ละรายการ: สูงสุด 50 อักขระ
ป้าย ไม่บังคับ

ป้ายแต่ละใบจะเป็นข้อความอิสระ (ไม่เกิน 15 อักขระ) หรือรูปภาพขนาดเล็ก

การจัดการ UX พิเศษบนรูปภาพ/วิดีโอ เช่น การวางซ้อนป้ายบนรูปภาพ

  • "การอัปเดตแบบเรียลไทม์"
  • ระยะเวลาในการอ่านบทความ
ป้าย - ข้อความ ไม่บังคับ

ชื่อป้าย

หมายเหตุ: ป้ายต้องมีข้อความหรือรูปภาพ

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 15 อักขระ
ป้าย - รูปภาพ ไม่บังคับ

รูปภาพขนาดเล็ก

การจัดการ UX พิเศษ เช่น การวางซ้อนป้ายบนภาพ/วิดีโอขนาดย่อ

หมายเหตุ: ป้ายต้องมีข้อความหรือรูปภาพ

ดูคำแนะนำได้ที่ข้อกำหนดเกี่ยวกับรูปภาพ
หมวดหมู่เนื้อหา ไม่บังคับ อธิบายหมวดหมู่ของเนื้อหาในเอนทิตี

รายการ Enum

ดูคำแนะนำได้ที่ส่วนหมวดหมู่เนื้อหา

ArticleEntity

แอตทริบิวต์ ข้อกำหนด คำอธิบาย รูปแบบ
URI การดำเนินการ ต้องระบุ

Deep Link ไปยังเอนทิตีในแอปของผู้ให้บริการ

หมายเหตุ: คุณใช้ Deep Link เพื่อการระบุแหล่งที่มาได้ โปรดดูคำถามที่พบบ่อยนี้

URI
ชื่อ ต้องระบุ ชื่อของเอนทิตี

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: สูงสุด 50 อักขระ
ภาพโปสเตอร์ ไม่บังคับ

เราจะแสดงรูปภาพเพียง 1 รูปเมื่อมีการระบุรูปภาพหลายรูป สัดส่วนภาพที่แนะนำคือ 16:9

หมายเหตุ: ขอแนะนําอย่างยิ่งให้ใส่รูปภาพ หากมีป้าย ให้เว้นพื้นที่ปลอดภัย 24 dps ทั้งด้านบนและด้านล่างของรูปภาพ

 ดูคำแนะนำได้ที่ข้อกำหนดเกี่ยวกับรูปภาพ
แหล่งที่มา - ชื่อ ไม่บังคับ ชื่อผู้เขียน องค์กร หรือผู้รายงาน

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 25 อักขระ
แหล่งที่มา - รูปภาพ ไม่บังคับ รูปภาพของแหล่งที่มา เช่น ผู้แต่ง องค์กร ผู้สื่อข่าว ดูคำแนะนำได้ที่ข้อกำหนดเกี่ยวกับรูปภาพ
คำอธิบาย ไม่บังคับ

ข้อความย่อหน้าเดียวเพื่ออธิบายเอนทิตี

หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: 180 อักขระ
รายการคำบรรยาย ไม่บังคับ

คำบรรยายได้สูงสุด 3 รายการ โดยคำบรรยายแต่ละรายการจะเป็นข้อความบรรทัดเดียว

หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น

ข้อความอิสระ

ขนาดข้อความที่แนะนำสำหรับคำบรรยายแต่ละรายการ: สูงสุด 50 อักขระ
ป้าย ไม่บังคับ

ป้ายแต่ละใบจะเป็นข้อความอิสระ (ไม่เกิน 15 อักขระ) หรือรูปภาพขนาดเล็ก

การจัดการ UX พิเศษบนรูปภาพ/วิดีโอ เช่น วางป้ายซ้อนบนรูปภาพ

  • "การอัปเดตแบบเรียลไทม์"
  • ระยะเวลาในการอ่านบทความ
ป้าย - ข้อความ ไม่บังคับ

ชื่อป้าย

หมายเหตุ: ป้ายต้องมีข้อความหรือรูปภาพ

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 15 อักขระ
ป้าย - รูปภาพ ไม่บังคับ

รูปภาพขนาดเล็ก

การจัดการ UX พิเศษ เช่น การวางซ้อนป้ายบนภาพ/วิดีโอขนาดย่อ

หมายเหตุ: ป้ายต้องมีข้อความหรือรูปภาพ

ดูคำแนะนำได้ที่ข้อกำหนดเกี่ยวกับรูปภาพ
เวลาเผยแพร่เนื้อหา ไม่บังคับ ซึ่งเป็นการประทับเวลาตามยุคสมัยเป็นมิลลิวินาทีเมื่อเนื้อหาได้รับการเผยแพร่ / อัปเดตในแอป การประทับเวลา Epoch เป็นมิลลิวินาที
เวลาในการมีส่วนร่วมครั้งล่าสุด ต้องระบุแบบมีเงื่อนไข

การประทับเวลาตามยุคสมัยเป็นมิลลิวินาทีเมื่อผู้ใช้โต้ตอบกับเอนทิตีนี้ครั้งล่าสุด

หมายเหตุ: ต้องกรอกฟิลด์นี้หากเอนทิตีนี้เป็นส่วนหนึ่งของคลัสเตอร์การจอง

 การประทับเวลา Epoch เป็นมิลลิวินาที
เปอร์เซ็นต์ความคืบหน้า ต้องระบุแบบมีเงื่อนไข

เปอร์เซ็นต์ของเนื้อหาทั้งหมดที่ผู้ใช้บริโภคจนถึงปัจจุบัน

หมายเหตุ: ต้องกรอกฟิลด์นี้หากเอนทิตีนี้เป็นส่วนหนึ่งของคลัสเตอร์การจอง

 ค่า int ระหว่าง 0 ถึง 100
หมวดหมู่เนื้อหา ไม่บังคับ อธิบายหมวดหมู่ของเนื้อหาในเอนทิตี

รายการ Enum

ดูคำแนะนำได้ที่ส่วนหมวดหมู่เนื้อหา

EventEntity

แอตทริบิวต์ ข้อกำหนด คำอธิบาย รูปแบบ
URI การดำเนินการ ต้องระบุ

Deep Link ไปยังเอนทิตีในแอปของผู้ให้บริการ

หมายเหตุ: คุณใช้ Deep Link เพื่อการระบุแหล่งที่มาได้ โปรดดูคำถามที่พบบ่อยนี้

URI
ชื่อ ต้องระบุ ชื่อของเอนทิตี

สตริง

ขนาดข้อความที่แนะนำ: สูงสุด 50 อักขระ
เวลาเริ่มต้นที่แปลแล้ว - การประทับเวลา ต้องระบุ

การประทับเวลาตามยุคสมัยเมื่อคาดว่ากิจกรรมจะเริ่ม

 Joda-Time Instant
เวลาเริ่มต้นที่แปลแล้ว - เขตเวลา ต้องระบุ

เขตเวลาที่คาดว่ากิจกรรมจะเริ่ม

 Joda-Time DateTimeZone
โหมดเหตุการณ์ ต้องระบุ

ช่องสำหรับระบุว่ากิจกรรมจะเป็นแบบเสมือนจริง เข้าร่วมด้วยตนเอง หรือทั้ง 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 เป็นมิลลิวินาที
คำอธิบาย ไม่บังคับ

ข้อความย่อหน้าเดียวเพื่ออธิบายเอนทิตี

หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: 180 อักขระ
รายการคำบรรยาย ไม่บังคับ

คำบรรยายได้สูงสุด 3 รายการ โดยคำบรรยายแต่ละรายการจะเป็นข้อความบรรทัดเดียว

หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น

ข้อความอิสระ

ขนาดข้อความที่แนะนำสำหรับคำบรรยายแต่ละรายการ: สูงสุด 50 อักขระ
ป้าย ไม่บังคับ

ป้ายแต่ละใบจะเป็นข้อความอิสระ (ไม่เกิน 15 อักขระ) หรือรูปภาพขนาดเล็ก
ป้าย - ข้อความ ไม่บังคับ

ชื่อป้าย

หมายเหตุ: ป้ายต้องมีข้อความหรือรูปภาพ

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 15 อักขระ
ป้าย - รูปภาพ ไม่บังคับ

รูปภาพขนาดเล็ก

การจัดการ UX พิเศษ เช่น การวางซ้อนป้ายบนภาพ/วิดีโอขนาดย่อ

หมายเหตุ: ป้ายต้องมีข้อความหรือรูปภาพ

ดูคำแนะนำได้ที่ข้อกำหนดเกี่ยวกับรูปภาพ
ราคา - CurrentPrice ต้องระบุแบบมีเงื่อนไข

ราคาปัจจุบันของตั๋ว/บัตรเข้าชมกิจกรรม

ต้องระบุหากระบุราคาที่ขีดฆ่า

ข้อความอิสระ
ราคา - StrikethroughPrice ไม่บังคับ ราคาเดิมของตั๋ว/บัตรเข้างาน ข้อความอิสระ
ข้อความไฮไลต์ราคา ไม่บังคับ ข้อความไฮไลต์ราคาเพื่อแสดงโปรโมชัน กิจกรรม ส่วนลดสำหรับสมาชิก (หากมี)

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 45 อักขระ (ข้อความที่ยาวเกินไปอาจแสดงจุดไข่ปลา)
หมวดหมู่เนื้อหา ไม่บังคับ อธิบายหมวดหมู่ของเนื้อหาในเอนทิตี

รายการ Enum ที่มีสิทธิ์

  • TYPE_MOVIES_AND_TV_SHOWS (เช่น ภาพยนตร์)
  • TYPE_DIGITAL_GAMES (เช่น eSports)
  • TYPE_MUSIC (เช่น คอนเสิร์ต)
  • TYPE_TRAVEL_AND_LOCAL (เช่น ทัวร์ เทศกาล)
  • TYPE_HEALTH_AND_FITENESS (เช่น ชั้นเรียนโยคะ)
  • TYPE_EDUCATION (เช่น ชั้นเรียน)
  • TYPE_SPORTS (เช่น การแข่งขันฟุตบอล)
  • TYPE_DATING (เช่น การพบปะ)

ดูคำแนะนำได้ที่ส่วนหมวดหมู่เนื้อหา

LodgingEntity

แอตทริบิวต์ ข้อกำหนด คำอธิบาย รูปแบบ
URI การดำเนินการ ต้องระบุ

Deep Link ไปยังเอนทิตีในแอปของผู้ให้บริการ

หมายเหตุ: คุณใช้ Deep Link เพื่อการระบุแหล่งที่มาได้ โปรดดูคำถามที่พบบ่อยนี้

URI
ชื่อ ต้องระบุ ชื่อของเอนทิตี

สตริง

ขนาดข้อความที่แนะนำ: สูงสุด 50 อักขระ
ภาพโปสเตอร์ ต้องระบุ

เราจะแสดงรูปภาพเพียง 1 รูปเมื่อมีการระบุรูปภาพหลายรูป สัดส่วนภาพที่แนะนําคือ 16:9

หมายเหตุ: หากมีป้าย ให้เว้นพื้นที่ปลอดภัย 24 จุดต่อนิ้วทั้งด้านบนและด้านล่างของรูปภาพ

ดูคำแนะนำได้ที่ข้อกำหนดเกี่ยวกับรูปภาพ
สถานที่ตั้ง - ประเทศ ต้องระบุ ประเทศที่ที่พักตั้งอยู่

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ตั้ง - เมือง ต้องระบุ เมืองที่ที่พักตั้งอยู่

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ตั้ง - ที่อยู่สำหรับแสดง ต้องระบุ ที่อยู่ของที่พักที่จะแสดงต่อผู้ใช้

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ตั้ง - ที่อยู่ ไม่บังคับ ที่อยู่ (หากมี) ของที่พัก

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ตั้ง - รัฐ ไม่บังคับ รัฐหรือจังหวัด (หากมี) ที่ที่พักตั้งอยู่

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ตั้ง - รหัสไปรษณีย์ ไม่บังคับ รหัสไปรษณีย์ (หากมี) ของที่พัก

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ตั้ง - ย่าน ไม่บังคับ ย่านที่พัก (หากมี)

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
ป้าย ไม่บังคับ

ป้ายแต่ละใบจะเป็นข้อความอิสระ (ไม่เกิน 15 อักขระ) หรือรูปภาพขนาดเล็ก
ป้าย - ข้อความ ไม่บังคับ

ชื่อป้าย

หมายเหตุ: ป้ายต้องมีข้อความหรือรูปภาพ

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 15 อักขระ
ป้าย - รูปภาพ ไม่บังคับ

รูปภาพขนาดเล็ก

การจัดการ UX พิเศษ เช่น การวางซ้อนป้ายบนภาพ/วิดีโอขนาดย่อ

หมายเหตุ: ป้ายต้องมีข้อความหรือรูปภาพ

ดูคำแนะนำได้ที่ข้อกำหนดเกี่ยวกับรูปภาพ
คำอธิบาย ไม่บังคับ

ข้อความย่อหน้าเดียวเพื่ออธิบายเอนทิตี

หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: 180 อักขระ
รายการคำบรรยาย ไม่บังคับ

คำบรรยายได้สูงสุด 3 รายการ โดยคำบรรยายแต่ละรายการจะเป็นข้อความบรรทัดเดียว

หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น

ข้อความอิสระ

ขนาดข้อความที่แนะนำสำหรับคำบรรยายแต่ละรายการ: สูงสุด 50 อักขระ
AvailabilityTimeWindow - Localized Start Time - Timestamp ไม่บังคับ การประทับเวลาตามยุคสมัยเมื่อคาดว่าที่พักจะเปิด/พร้อมให้บริการ Joda-Time Instant
AvailabilityTimeWindow - Localized Start Time - Timezone ไม่บังคับ เขตเวลาที่คาดว่าที่พักจะเปิด/พร้อมให้บริการ Joda-Time DateTimeZone
AvailabilityTimeWindow - Localized End Time - Timestamp ไม่บังคับ การประทับเวลาตามยุคสมัยที่คาดว่าที่พักจะเปิด/พร้อมให้บริการ Joda-Time Instant
AvailabilityTimeWindow - Localized End Time - Timezone ไม่บังคับ เขตเวลาที่คาดว่าที่พักจะเปิด/พร้อมให้บริการ Joda-Time DateTimeZone
การจัดประเภท - ค่าสูงสุด ไม่บังคับ

ค่าสูงสุดของรูปแบบการให้คะแนน

ต้องระบุหากระบุค่าปัจจุบันของคะแนนด้วย

 ตัวเลข >= 0.0
การจัดประเภท - ค่าปัจจุบัน ไม่บังคับ

ค่าปัจจุบันของสเกลการให้คะแนน

ต้องระบุหากระบุค่าสูงสุดของการจัดประเภทด้วย

 ตัวเลข >= 0.0
คะแนน - จำนวน ไม่บังคับ

จํานวนการให้คะแนนที่พัก

หมายเหตุ: ระบุช่องนี้หากแอปต้องการควบคุมวิธีแสดงข้อมูลนี้ต่อผู้ใช้ ระบุสตริงที่กระชับซึ่งแสดงต่อผู้ใช้ได้ เช่น หากจํานวนคือ 1,000,000 ให้พิจารณาใช้ตัวย่อ เช่น 1 ล้าน เพื่อไม่ให้ถูกตัดในขนาดการแสดงผลที่เล็กลง

 สตริง
การจัดประเภท - ค่าจำนวน ไม่บังคับ

จํานวนการให้คะแนนที่พัก

หมายเหตุ: ระบุช่องนี้หากไม่ต้องการจัดการตรรกะการแสดงตัวย่อด้วยตนเอง หากมีทั้งจำนวนและค่าจำนวน เราจะใช้จำนวนเพื่อแสดงต่อผู้ใช้

 ยาว
ราคา - CurrentPrice ต้องระบุแบบมีเงื่อนไข

ราคาปัจจุบันของที่พัก

ต้องระบุหากระบุราคาที่มีการขีดทับ

ข้อความอิสระ
ราคา - StrikethroughPrice ไม่บังคับ ราคาเดิมของที่พัก ซึ่งมีการขีดทับใน UI ข้อความอิสระ
ข้อความไฮไลต์ราคา ไม่บังคับ ข้อความไฮไลต์ราคาเพื่อแสดงโปรโมชัน กิจกรรม ส่วนลดสำหรับสมาชิก (หากมี)

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 45 อักขระ (ข้อความที่ยาวเกินไปอาจแสดงจุดไข่ปลา)

StoreEntity

ออบเจ็กต์ StoreEntity แสดงถึงร้านค้าแต่ละแห่งที่พาร์ทเนอร์นักพัฒนาแอปต้องการเผยแพร่ เช่น ร้านอาหารยอดนิยมหรือร้านอาหารที่เกี่ยวข้องกับประสบการณ์การเดินทาง

แอตทริบิวต์ ข้อกำหนด คำอธิบาย รูปแบบ
ภาพโปสเตอร์ ต้องระบุ ต้องระบุรูปภาพอย่างน้อย 1 รูป ดูคำแนะนำได้ที่ข้อกำหนดเกี่ยวกับรูปภาพ
URI การดำเนินการ ต้องระบุ

Deep Link ไปยังเอนทิตีในแอปของผู้ให้บริการ

หมายเหตุ: คุณใช้ Deep Link เพื่อการระบุแหล่งที่มาได้ โปรดดูคำถามที่พบบ่อยนี้

URI
ชื่อ ไม่บังคับ ชื่อร้านค้า

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 45 อักขระ (ข้อความที่ยาวเกินไปอาจแสดงจุดไข่ปลา)
ตำแหน่ง ไม่บังคับ สถานที่ตั้งของร้านค้า

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 45 อักขระ (ข้อความที่ยาวเกินไปอาจแสดงจุดไข่ปลา)
ข้อความเสริม ไม่บังคับ ข้อความไฮไลต์เพื่อแสดงโปรโมชัน กิจกรรม หรือข้อมูลอัปเดตสำหรับร้านค้า หากมี

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 45 อักขระ (ข้อความที่ยาวเกินไปอาจแสดงจุดไข่ปลา)
ข้อความไฮไลต์แบบละเอียด ไม่บังคับ ข้อความไฮไลต์

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 45 อักขระ (ข้อความที่ยาวเกินไปอาจแสดงจุดไข่ปลา)
คำอธิบาย ไม่บังคับ คำอธิบายร้านค้า

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 90 อักขระ (ข้อความที่ยาวเกินไปอาจแสดงจุดไข่ปลา)
หมวดหมู่ ไม่บังคับ

หมวดหมู่ของร้านค้า ในบริบทของสถานที่รับประทานอาหาร อาจเป็นอาหาร เช่น "ฝรั่งเศส" "อเมริกันสมัยใหม่" "ราเมน" "อาหารรสเลิศ"

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 45 อักขระ (ข้อความที่ยาวเกินไปอาจแสดงจุดไข่ปลา)
การจัดประเภท - ค่าสูงสุด ไม่บังคับ

ค่าสูงสุดของรูปแบบการให้คะแนน

ต้องระบุหากระบุค่าปัจจุบันของคะแนนด้วย

 ตัวเลข >= 0.0
การจัดประเภท - ค่าปัจจุบัน ไม่บังคับ

ค่าปัจจุบันของสเกลการให้คะแนน

ต้องระบุหากระบุค่าสูงสุดของการจัดประเภทด้วย

 ตัวเลข >= 0.0
คะแนน - จำนวน ไม่บังคับ

จํานวนการให้คะแนนที่พัก

หมายเหตุ: ระบุช่องนี้หากแอปต้องการควบคุมวิธีแสดงข้อมูลนี้ต่อผู้ใช้ ระบุสตริงที่กระชับซึ่งแสดงต่อผู้ใช้ได้ เช่น หากจํานวนคือ 1,000,000 ให้พิจารณาใช้ตัวย่อ เช่น 1 ล้าน เพื่อไม่ให้ถูกตัดในขนาดการแสดงผลที่เล็กลง

 สตริง
การจัดประเภท - ค่าจำนวน ไม่บังคับ

จํานวนการให้คะแนนที่พัก

หมายเหตุ: ระบุช่องนี้หากไม่ต้องการจัดการตรรกะการแสดงตัวย่อด้วยตนเอง หากมีทั้งจำนวนและค่าจำนวน เราจะใช้จำนวนเพื่อแสดงต่อผู้ใช้

 ยาว

PointOfInterestEntity

แอตทริบิวต์ ข้อกำหนด คำอธิบาย รูปแบบ
URI การดำเนินการ ต้องระบุ

Deep Link ไปยังเอนทิตีในแอปของผู้ให้บริการ

หมายเหตุ: คุณใช้ Deep Link เพื่อการระบุแหล่งที่มาได้ โปรดดูคำถามที่พบบ่อยนี้

URI
ชื่อ ต้องระบุ ชื่อของเอนทิตี

สตริง

ขนาดข้อความที่แนะนำ: สูงสุด 50 อักขระ
ภาพโปสเตอร์ ต้องระบุ

เราจะแสดงรูปภาพเพียง 1 รูปเมื่อมีการระบุรูปภาพหลายรูป สัดส่วนภาพที่แนะนำคือ 16:9

หมายเหตุ: ขอแนะนําอย่างยิ่งให้ใช้รูปภาพ หากมีป้าย ให้เว้นพื้นที่ปลอดภัย 24 dp ทั้งด้านบนและด้านล่างของรูปภาพ

 ดูคำแนะนำได้ที่ข้อกำหนดเกี่ยวกับรูปภาพ
สถานที่ตั้ง - ประเทศ ต้องระบุ ประเทศที่จุดที่น่าสนใจเกิดขึ้น

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ตั้ง - เมือง ต้องระบุ เมืองที่จุดที่น่าสนใจเกิดขึ้น

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ตั้ง - ที่อยู่สำหรับแสดง ต้องระบุ ที่อยู่ของจุดที่น่าสนใจที่จะแสดงต่อผู้ใช้

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ตั้ง - ที่อยู่ ไม่บังคับ ที่อยู่ (หากมี) ของจุดที่น่าสนใจ

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ตั้ง - รัฐ ไม่บังคับ รัฐหรือจังหวัด (หากมี) ที่จุดที่น่าสนใจตั้งอยู่

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ตั้ง - รหัสไปรษณีย์ ไม่บังคับ รหัสไปรษณีย์ (หากมี) ของจุดที่น่าสนใจ

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ตั้ง - ย่าน ไม่บังคับ ย่าน (หากมี) ของจุดที่น่าสนใจ

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
AvailabilityTimeWindow - Localized Start Time - Timestamp ไม่บังคับ การประทับเวลาตามยุคสมัยเมื่อคาดว่าจุดที่น่าสนใจจะเปิด/พร้อมใช้งาน Joda-Time Instant
AvailabilityTimeWindow - Localized Start Time - Timezone ไม่บังคับ เขตเวลาซึ่งคาดว่าจุดที่น่าสนใจจะเปิด/พร้อมให้บริการ Joda-Time DateTimeZone
AvailabilityTimeWindow - Localized End Time - Timestamp ไม่บังคับ การประทับเวลาตามยุคสมัยที่คาดว่าจุดที่น่าสนใจจะเปิด/พร้อมให้บริการ Joda-Time Instant
AvailabilityTimeWindow - Localized End Time - Timezone ไม่บังคับ เขตเวลาซึ่งคาดว่าจุดที่น่าสนใจจะเปิด/พร้อมให้บริการ Joda-Time DateTimeZone
ป้าย ไม่บังคับ

ป้ายแต่ละใบจะเป็นข้อความอิสระ (ไม่เกิน 15 อักขระ) หรือรูปภาพขนาดเล็ก
ป้าย - ข้อความ ไม่บังคับ

ชื่อป้าย

หมายเหตุ: ป้ายต้องมีข้อความหรือรูปภาพ

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 15 อักขระ
ป้าย - รูปภาพ ไม่บังคับ

รูปภาพขนาดเล็ก

การจัดการ UX พิเศษ เช่น การวางซ้อนป้ายบนภาพ/วิดีโอขนาดย่อ

หมายเหตุ: ป้ายต้องมีข้อความหรือรูปภาพ

ดูคำแนะนำได้ที่ข้อกำหนดเกี่ยวกับรูปภาพ
คำอธิบาย ไม่บังคับ

ข้อความย่อหน้าเดียวเพื่ออธิบายเอนทิตี

หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: 180 อักขระ
รายการคำบรรยาย ไม่บังคับ

คำบรรยายได้สูงสุด 3 รายการ โดยคำบรรยายแต่ละรายการจะเป็นข้อความบรรทัดเดียว

หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น

ข้อความอิสระ

ขนาดข้อความที่แนะนำสำหรับคำบรรยายแต่ละรายการ: สูงสุด 50 อักขระ
การจัดประเภท - ค่าสูงสุด ไม่บังคับ

ค่าสูงสุดของรูปแบบการให้คะแนน

ต้องระบุหากระบุค่าปัจจุบันของคะแนนด้วย

 ตัวเลข >= 0.0
การจัดประเภท - ค่าปัจจุบัน ไม่บังคับ

ค่าปัจจุบันของสเกลการให้คะแนน

ต้องระบุหากระบุค่าสูงสุดของการจัดประเภทด้วย

 ตัวเลข >= 0.0
คะแนน - จำนวน ไม่บังคับ

จำนวนการให้คะแนนสำหรับจุดที่น่าสนใจ

หมายเหตุ: ระบุช่องนี้หากแอปต้องการควบคุมวิธีแสดงข้อมูลนี้ต่อผู้ใช้ ระบุสตริงที่กระชับซึ่งแสดงต่อผู้ใช้ได้ เช่น หากจํานวนคือ 1,000,000 ให้พิจารณาใช้ตัวย่อ เช่น 1 ล้าน เพื่อไม่ให้ถูกตัดในขนาดการแสดงผลที่เล็กลง

 สตริง
การจัดประเภท - ค่าจำนวน ไม่บังคับ

จำนวนการให้คะแนนสำหรับจุดที่น่าสนใจ

หมายเหตุ: ระบุช่องนี้หากไม่ต้องการจัดการตรรกะการแสดงตัวย่อด้วยตนเอง หากมีทั้งจำนวนและค่าจำนวน เราจะใช้จำนวนเพื่อแสดงต่อผู้ใช้

 ยาว
ราคา - CurrentPrice ต้องระบุแบบมีเงื่อนไข

ราคาปัจจุบันของตั๋ว/บัตรเข้าชมจุดสนใจ

ต้องระบุหากระบุราคาที่ขีดฆ่า

ข้อความอิสระ
ราคา - StrikethroughPrice ไม่บังคับ ราคาเดิมของตั๋ว/บัตรเข้าชมจุดสนใจ ข้อความอิสระ
ข้อความไฮไลต์ราคา ไม่บังคับ ข้อความไฮไลต์ราคาเพื่อแสดงโปรโมชัน กิจกรรม ส่วนลดสำหรับสมาชิก (หากมี)

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 45 อักขระ (ข้อความที่ยาวเกินไปอาจแสดงจุดไข่ปลา)

หมวดหมู่เนื้อหา ไม่บังคับ อธิบายหมวดหมู่ของเนื้อหาในเอนทิตี

รายการ Enum ที่มีสิทธิ์

  • TYPE_TRAVEL_AND_LOCAL
  • TYPE_MOVIES_AND_TV_SHOWS (เช่น โรงภาพยนตร์)
  • TYPE_MEDICAL (เช่น โรงพยาบาล)
  • TYPE_EDUCATION (เช่น โรงเรียน)
  • TYPE_SPORTS (เช่น สนามกีฬา)

ดูคำแนะนำได้ที่ส่วนหมวดหมู่เนื้อหา

RestaurantReservationEntity

แอตทริบิวต์ ข้อกำหนด คำอธิบาย รูปแบบ
URI การดำเนินการ ต้องระบุ

Deep Link ไปยังเอนทิตีในแอปของผู้ให้บริการ

หมายเหตุ: คุณใช้ Deep Link เพื่อการระบุแหล่งที่มาได้ โปรดดูคำถามที่พบบ่อยนี้

URI
ชื่อ ต้องระบุ ชื่อของเอนทิตี

สตริง

ขนาดข้อความที่แนะนำ: สูงสุด 50 อักขระ
เวลาเริ่มต้นการจองที่แปลแล้ว - การประทับเวลา ต้องระบุ การประทับเวลาตามยุคสมัยเมื่อคาดว่าการจองจะเริ่ม Joda-Time Instant
เวลาเริ่มต้นการจองที่แปลแล้ว - เขตเวลา ต้องระบุ เขตเวลาที่คาดว่าการจองจะเริ่ม Joda-Time DateTimeZone
สถานที่ตั้ง - ประเทศ ต้องระบุ ประเทศที่ร้านอาหารตั้งอยู่

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ตั้ง - เมือง ต้องระบุ เมืองที่ร้านอาหารตั้งอยู่

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ตั้ง - ที่อยู่สำหรับแสดง ต้องระบุ ที่อยู่ของร้านอาหารที่จะแสดงต่อผู้ใช้

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ตั้ง - ที่อยู่ ไม่บังคับ ที่อยู่ (หากมี) ของร้านอาหาร

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ตั้ง - รัฐ ไม่บังคับ รัฐหรือจังหวัด (หากมี) ที่ร้านอาหารตั้งอยู่

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ตั้ง - รหัสไปรษณีย์ ไม่บังคับ รหัสไปรษณีย์ (หากมี) ของร้านอาหาร

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ตั้ง - ย่าน ไม่บังคับ ย่าน (หากมี) ของร้านอาหาร

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
ภาพโปสเตอร์ ไม่บังคับ เราจะแสดงรูปภาพเพียง 1 รูปเมื่อมีการระบุรูปภาพหลายรูป สัดส่วนภาพที่แนะนําคือ 16:9 ดูคำแนะนำได้ที่ข้อกำหนดเกี่ยวกับรูปภาพ
คำอธิบาย ไม่บังคับ

ข้อความย่อหน้าเดียวเพื่ออธิบายเอนทิตี

หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: 180 อักขระ
รายการคำบรรยาย ไม่บังคับ

คำบรรยายได้สูงสุด 3 รายการ โดยคำบรรยายแต่ละรายการจะเป็นข้อความบรรทัดเดียว

หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น

ข้อความอิสระ

ขนาดข้อความที่แนะนำสำหรับคำบรรยายแต่ละรายการ: สูงสุด 50 อักขระ
ขนาดตาราง ไม่บังคับ จำนวนคนในกลุ่มการจอง จํานวนเต็ม > 0

EventReservationEntity

แอตทริบิวต์ ข้อกำหนด คำอธิบาย รูปแบบ
URI การดำเนินการ ต้องระบุ

Deep Link ไปยังเอนทิตีในแอปของผู้ให้บริการ

หมายเหตุ: คุณใช้ Deep Link เพื่อการระบุแหล่งที่มาได้ โปรดดูคำถามที่พบบ่อยนี้

URI
ชื่อ ต้องระบุ ชื่อของเอนทิตี

สตริง

ขนาดข้อความที่แนะนำ: สูงสุด 50 อักขระ
เวลาเริ่มต้นที่แปลแล้ว - การประทับเวลา ต้องระบุ

การประทับเวลาตามยุคสมัยเมื่อคาดว่ากิจกรรมจะเริ่ม

 Joda-Time Instant
เวลาเริ่มต้นที่แปลแล้ว - เขตเวลา ต้องระบุ

เขตเวลาที่คาดว่ากิจกรรมจะเริ่ม

 Joda-Time DateTimeZone
โหมดเหตุการณ์ ต้องระบุ

ช่องสำหรับระบุว่ากิจกรรมจะเป็นแบบเสมือนจริง เข้าร่วมด้วยตนเอง หรือทั้ง 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 ทั้งด้านบนและด้านล่างของรูปภาพ

 ดูคำแนะนำได้ที่ข้อกำหนดเกี่ยวกับรูปภาพ
เวลาสิ้นสุดที่แปลแล้ว - การประทับเวลา ไม่บังคับ

การประทับเวลาตามยุคเมื่อคาดว่ากิจกรรมจะสิ้นสุด

 Joda-Time Instant
เวลาสิ้นสุดที่แปลแล้ว - เขตเวลา ไม่บังคับ

เขตเวลาที่คาดว่ากิจกรรมจะสิ้นสุด

 Joda-Time DateTimeZone
ผู้ให้บริการ - ชื่อ ไม่บังคับ

ชื่อผู้ให้บริการ

หมายเหตุ: ต้องมีข้อความหรือรูปภาพสำหรับผู้ให้บริการ

ข้อความอิสระ เช่น ชื่อผู้จัด/ทัวร์
ผู้ให้บริการ - รูปภาพ ไม่บังคับ

โลโก้/รูปภาพของผู้ให้บริการ

หมายเหตุ: ต้องมีข้อความหรือรูปภาพสำหรับผู้ให้บริการ

ดูคำแนะนำได้ที่ข้อกำหนดเกี่ยวกับรูปภาพ
คำอธิบาย ไม่บังคับ

ข้อความย่อหน้าเดียวเพื่ออธิบายเอนทิตี

หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: 180 อักขระ
รายการคำบรรยาย ไม่บังคับ

คำบรรยายได้สูงสุด 3 รายการ โดยคำบรรยายแต่ละรายการจะเป็นข้อความบรรทัดเดียว

หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น

ข้อความอิสระ

ขนาดข้อความที่แนะนำสำหรับคำบรรยายแต่ละรายการ: สูงสุด 50 อักขระ
ป้าย ไม่บังคับ

ป้ายแต่ละใบจะเป็นข้อความอิสระ (ไม่เกิน 15 อักขระ) หรือรูปภาพขนาดเล็ก
ป้าย - ข้อความ ไม่บังคับ

ชื่อป้าย

หมายเหตุ: ป้ายต้องมีข้อความหรือรูปภาพ

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 15 อักขระ
ป้าย - รูปภาพ ไม่บังคับ

รูปภาพขนาดเล็ก

การจัดการ UX พิเศษ เช่น การวางซ้อนป้ายบนภาพ/วิดีโอขนาดย่อ

หมายเหตุ: ป้ายต้องมีข้อความหรือรูปภาพ

ดูคำแนะนำได้ที่ข้อกำหนดเกี่ยวกับรูปภาพ
รหัสการจอง ไม่บังคับ รหัสการจองสำหรับกิจกรรม ข้อความอิสระ
ราคา - CurrentPrice ต้องระบุแบบมีเงื่อนไข

ราคาปัจจุบันของตั๋ว/บัตรเข้าชมกิจกรรม

ต้องระบุหากระบุราคาที่ขีดฆ่า

ข้อความอิสระ
ราคา - StrikethroughPrice ไม่บังคับ ราคาเดิมของตั๋ว/บัตรเข้างาน ข้อความอิสระ
ข้อความไฮไลต์ราคา ไม่บังคับ ข้อความไฮไลต์ราคาเพื่อแสดงโปรโมชัน กิจกรรม ส่วนลดสำหรับสมาชิก (หากมี)

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 45 อักขระ (ข้อความที่ยาวเกินไปอาจแสดงจุดไข่ปลา)
การจัดประเภท - ค่าสูงสุด ไม่บังคับ

ค่าสูงสุดของรูปแบบการให้คะแนน

ต้องระบุหากระบุค่าปัจจุบันของคะแนนด้วย

 ตัวเลข >= 0.0
การจัดประเภท - ค่าปัจจุบัน ไม่บังคับ

ค่าปัจจุบันของสเกลการให้คะแนน

ต้องระบุหากระบุค่าสูงสุดของการจัดประเภทด้วย

 ตัวเลข >= 0.0
คะแนน - จำนวน ไม่บังคับ

จํานวนการให้คะแนนสําหรับกิจกรรม

หมายเหตุ: ระบุช่องนี้หากแอปต้องการควบคุมวิธีแสดงข้อมูลนี้ต่อผู้ใช้ ระบุสตริงที่กระชับซึ่งแสดงต่อผู้ใช้ได้ เช่น หากจํานวนคือ 1,000,000 ให้พิจารณาใช้ตัวย่อ เช่น 1 ล้าน เพื่อไม่ให้ถูกตัดในขนาดการแสดงผลที่เล็กลง

 สตริง
การจัดประเภท - ค่าจำนวน ไม่บังคับ

จํานวนการให้คะแนนสําหรับกิจกรรม

หมายเหตุ: ระบุช่องนี้หากไม่ต้องการจัดการตรรกะการแสดงตัวย่อด้วยตนเอง หากมีทั้งจำนวนและค่าจำนวน เราจะใช้จำนวนเพื่อแสดงต่อผู้ใช้

 ยาว
หมวดหมู่เนื้อหา ไม่บังคับ อธิบายหมวดหมู่ของเนื้อหาในเอนทิตี

รายการ Enum ที่มีสิทธิ์

  • TYPE_MOVIES_AND_TV_SHOWS (เช่น ภาพยนตร์)
  • TYPE_DIGITAL_GAMES (เช่น eSports)
  • TYPE_MUSIC (เช่น คอนเสิร์ต)
  • TYPE_TRAVEL_AND_LOCAL (เช่น ทัวร์ เทศกาล)
  • TYPE_HEALTH_AND_FITENESS (เช่น ชั้นเรียนโยคะ)
  • TYPE_EDUCATION (เช่น ชั้นเรียน)
  • TYPE_SPORTS (เช่น การแข่งขันฟุตบอล)
  • TYPE_DATING (เช่น การพบปะ)

ดูคำแนะนำได้ที่ส่วนหมวดหมู่เนื้อหา

LodgingReservationEntity

แอตทริบิวต์ ข้อกำหนด คำอธิบาย รูปแบบ
URI การดำเนินการ ต้องระบุ

Deep Link ไปยังเอนทิตีในแอปของผู้ให้บริการ

หมายเหตุ: คุณใช้ Deep Link เพื่อการระบุแหล่งที่มาได้ โปรดดูคำถามที่พบบ่อยนี้

URI
ชื่อ ต้องระบุ ชื่อของเอนทิตี

ข้อความอิสระ เช่น "การเข้าพักของคุณตั้งแต่วันที่ 12 ธ.ค."

ขนาดข้อความที่แนะนำ: สูงสุด 50 อักขระ
เวลาเช็คอินที่แปลแล้ว - การประทับเวลา ต้องระบุ การประทับเวลาตามยุคสมัยที่แสดงเวลาเช็คอินสำหรับการจอง Joda-Time Instant
เวลาเช็คอินที่แปลแล้ว - เขตเวลา ต้องระบุ เขตเวลาที่ระบุเวลาเช็คอินสำหรับการจอง Joda-Time Instant
เวลาเช็คเอาต์ที่แปลแล้ว - การประทับเวลา ต้องระบุ การประทับเวลาตามยุคสมัยที่แสดงเวลาเช็คเอาต์สำหรับการจอง Joda-Time Instant
เวลาเช็คเอาต์ที่แปลแล้ว - เขตเวลา ต้องระบุ เขตเวลาที่ระบุเวลาเช็คเอาต์สำหรับการจอง Joda-Time DateTimeZone
สถานที่ตั้ง - ประเทศ ต้องระบุ ประเทศที่ที่พักตั้งอยู่

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ตั้ง - เมือง ต้องระบุ เมืองที่ที่พักตั้งอยู่

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ตั้ง - ที่อยู่สำหรับแสดง ต้องระบุ ที่อยู่ของที่พักที่จะแสดงต่อผู้ใช้

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ตั้ง - ที่อยู่ ไม่บังคับ ที่อยู่ (หากมี) ของที่พัก

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ตั้ง - รัฐ ไม่บังคับ รัฐหรือจังหวัด (หากมี) ที่ที่พักตั้งอยู่

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ตั้ง - รหัสไปรษณีย์ ไม่บังคับ รหัสไปรษณีย์ (หากมี) ของที่พัก

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ตั้ง - ย่าน ไม่บังคับ ย่านที่พัก (หากมี)

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
ภาพโปสเตอร์ ไม่บังคับ

เราจะแสดงรูปภาพเพียง 1 รูปเมื่อมีการระบุรูปภาพหลายรูป สัดส่วนภาพที่แนะนําคือ 16:9

หมายเหตุ: หากมีป้าย ให้เว้นพื้นที่ปลอดภัย 24 dp ทั้งด้านบนและด้านล่างของรูปภาพ

ดูคำแนะนำได้ที่ข้อกำหนดเกี่ยวกับรูปภาพ
คำอธิบาย ไม่บังคับ

ข้อความย่อหน้าเดียวเพื่ออธิบายเอนทิตี

หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: 180 อักขระ
รายการคำบรรยาย ไม่บังคับ

คำบรรยายได้สูงสุด 3 รายการ โดยคำบรรยายแต่ละรายการจะเป็นข้อความบรรทัดเดียว

หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น

ข้อความอิสระ

ขนาดข้อความที่แนะนำสำหรับคำบรรยายแต่ละรายการ: สูงสุด 50 อักขระ
รหัสการจอง ไม่บังคับ รหัสการจองสำหรับที่พัก ข้อความอิสระ
การจัดประเภท - ค่าสูงสุด ไม่บังคับ

ค่าสูงสุดของรูปแบบการให้คะแนน

ต้องระบุหากระบุค่าปัจจุบันของคะแนนด้วย

 ตัวเลข >= 0.0
การจัดประเภท - ค่าปัจจุบัน ไม่บังคับ

ค่าปัจจุบันของสเกลการให้คะแนน

ต้องระบุหากระบุค่าสูงสุดของการจัดประเภทด้วย

 ตัวเลข >= 0.0
คะแนน - จำนวน ไม่บังคับ

จํานวนการให้คะแนนที่พัก

หมายเหตุ: ระบุช่องนี้หากแอปต้องการควบคุมวิธีแสดงข้อมูลนี้ต่อผู้ใช้ ระบุสตริงที่กระชับซึ่งแสดงต่อผู้ใช้ได้ เช่น หากจํานวนคือ 1,000,000 ให้พิจารณาใช้ตัวย่อ เช่น 1 ล้าน เพื่อไม่ให้ถูกตัดในขนาดการแสดงผลที่เล็กลง

 สตริง
การจัดประเภท - ค่าจำนวน ไม่บังคับ

จํานวนการให้คะแนนที่พัก

หมายเหตุ: ระบุช่องนี้หากไม่ต้องการจัดการตรรกะการแสดงตัวย่อด้วยตนเอง หากมีทั้งจำนวนและค่าจำนวน เราจะใช้จำนวนเพื่อแสดงต่อผู้ใช้

 ยาว
ราคา - CurrentPrice ต้องระบุแบบมีเงื่อนไข

ราคาปัจจุบันของที่พัก

ต้องระบุหากระบุราคาที่มีการขีดทับ

ข้อความอิสระ
ราคา - StrikethroughPrice ไม่บังคับ ราคาเดิมของที่พัก ซึ่งมีการขีดทับใน UI ข้อความอิสระ
ข้อความไฮไลต์ราคา ไม่บังคับ ข้อความไฮไลต์ราคาเพื่อแสดงโปรโมชัน กิจกรรม ส่วนลดสำหรับสมาชิก (หากมี)

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 45 อักขระ (ข้อความที่ยาวเกินไปอาจแสดงจุดไข่ปลา)

TransportationReservationEntity

แอตทริบิวต์ ข้อกำหนด คำอธิบาย รูปแบบ
URI การดำเนินการ ต้องระบุ

Deep Link ไปยังเอนทิตีในแอปของผู้ให้บริการ

หมายเหตุ: คุณใช้ Deep Link เพื่อการระบุแหล่งที่มาได้ โปรดดูคำถามที่พบบ่อยนี้

URI
ชื่อ ต้องระบุ ชื่อของเอนทิตี

ข้อความอิสระ เช่น "SFO to SAN"

ขนาดข้อความที่แนะนำ: สูงสุด 50 อักขระ
ประเภทการขนส่ง ต้องระบุ รูปแบบ/ประเภทการเดินทางสำหรับการจอง Enum: FLIGHT, TRAIN, BUS หรือ FERRY
เวลาออกเดินทางที่แปลแล้ว - การประทับเวลา ต้องระบุ การประทับเวลาตามยุคสมัยที่แสดงเวลาออกเดินทาง Joda-Time Instant
เวลาออกเดินทางที่แปลแล้ว - เขตเวลา ต้องระบุ เขตเวลาของเวลาออกเดินทาง Joda-Time DateTimeZone
เวลาถึงที่แปลแล้ว - การประทับเวลา ต้องระบุ การประทับเวลาตามยุคที่แสดงถึงเวลาถึง Joda-Time Instant
เวลาถึงที่แปลแล้ว - เขตเวลา ต้องระบุ เขตเวลาของเวลาถึง Joda-Time DateTimeZone
สถานที่ออกเดินทาง - ประเทศ ไม่บังคับ ประเทศต้นทาง

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ออกเดินทาง - เมือง ไม่บังคับ เมืองที่ออกเดินทาง

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ออกเดินทาง - ที่อยู่สำหรับแสดง ไม่บังคับ สถานที่ออกเดินทางที่จะแสดงต่อผู้ใช้

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ออกเดินทาง - ที่อยู่ ไม่บังคับ ที่อยู่ (หากมี) ของจุดเริ่มต้น

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ออกเดินทาง - รัฐ ไม่บังคับ รัฐหรือจังหวัด (หากมี) ของจุดออกเดินทาง

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ออกเดินทาง - รหัสไปรษณีย์ ไม่บังคับ รหัสไปรษณีย์ (หากมี) ของจุดเริ่มต้น

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ออกเดินทาง - ย่านใกล้เคียง ไม่บังคับ ย่าน (หากมี) ของจุดเริ่มต้น

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่มาถึง - ประเทศ ไม่บังคับ ประเทศที่มาถึง

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่มาถึง - เมือง ไม่บังคับ เมืองที่มาถึง

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่มาถึง - ที่อยู่สำหรับแสดง ไม่บังคับ สถานที่ถึงที่จะแสดงต่อผู้ใช้

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่มาถึง - ที่อยู่ ไม่บังคับ ที่อยู่ (หากมี) ของสถานที่ที่จะนำส่ง

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่มาถึง - รัฐ ไม่บังคับ รัฐหรือจังหวัด (หากมี) ของสถานที่ถึง

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่มาถึง - รหัสไปรษณีย์ ไม่บังคับ รหัสไปรษณีย์ (หากมี) ของสถานที่ถึง

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่มาถึง - ย่านใกล้เคียง ไม่บังคับ ย่าน (หากมี) ของสถานที่ถึง

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
ผู้ให้บริการ - ชื่อ ไม่บังคับ

ชื่อผู้ให้บริการ

หมายเหตุ: ต้องมีข้อความหรือรูปภาพสำหรับผู้ให้บริการ

ข้อความอิสระ เช่น ชื่อสายการบิน
ผู้ให้บริการ - รูปภาพ ไม่บังคับ

โลโก้/รูปภาพของผู้ให้บริการ

หมายเหตุ: ต้องมีข้อความหรือรูปภาพสำหรับผู้ให้บริการ

ดูคำแนะนำได้ที่ข้อกำหนดเกี่ยวกับรูปภาพ
ภาพโปสเตอร์ ไม่บังคับ

เราจะแสดงรูปภาพเพียง 1 รูปเมื่อมีการระบุรูปภาพหลายรูป สัดส่วนภาพที่แนะนําคือ 16:9

ดูคำแนะนำได้ที่ข้อกำหนดเกี่ยวกับรูปภาพ
คำอธิบาย ไม่บังคับ

ข้อความย่อหน้าเดียวเพื่ออธิบายเอนทิตี

หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: 180 อักขระ
รายการคำบรรยาย ไม่บังคับ

คำบรรยายได้สูงสุด 3 รายการ โดยคำบรรยายแต่ละรายการจะเป็นข้อความบรรทัดเดียว

หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น

ข้อความอิสระ

ขนาดข้อความที่แนะนำสำหรับคำบรรยายแต่ละรายการ: สูงสุด 50 อักขระ
รหัสการจอง ไม่บังคับ รหัสการจองสำหรับบริการขนส่ง ข้อความอิสระ
ราคา - CurrentPrice ต้องระบุแบบมีเงื่อนไข

ราคาปัจจุบันของการจอง

ต้องระบุหากระบุราคาที่มีการขีดทับ

ข้อความอิสระ
ราคา - StrikethroughPrice ไม่บังคับ ราคาเดิมของการจอง ซึ่งจะมีการขีดทับใน UI ข้อความอิสระ
ข้อความไฮไลต์ราคา ไม่บังคับ ข้อความไฮไลต์ราคาเพื่อแสดงโปรโมชัน กิจกรรม ส่วนลดสำหรับสมาชิก (หากมี)

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 45 อักขระ (ข้อความที่ยาวเกินไปอาจแสดงจุดไข่ปลา)
หมายเลขการขนส่ง ต้องระบุ หมายเลขเที่ยวบิน หมายเลขรถประจำทาง หมายเลขรถไฟ หรือหมายเลขเรือเฟอร์รี่/เรือสำราญ ข้อความอิสระ
เวลาขึ้นเครื่องที่แปลแล้ว - การประทับเวลา ต้องระบุ การประทับเวลาตามยุคสมัยที่แสดงเวลาขึ้นเครื่องสำหรับการจอง (หากมี) Joda-Time Instant
เวลาขึ้นเครื่องที่แปลแล้ว - เขตเวลา ต้องระบุ เขตเวลาของเวลาขึ้นเครื่องสำหรับการจอง (หากมี) Joda-Time DateTimeZone

VehicleRentalReservationEntity

แอตทริบิวต์ ข้อกำหนด คำอธิบาย รูปแบบ
URI การดำเนินการ ต้องระบุ

Deep Link ไปยังเอนทิตีในแอปของผู้ให้บริการ

หมายเหตุ: คุณใช้ Deep Link เพื่อการระบุแหล่งที่มาได้ โปรดดูคำถามที่พบบ่อยนี้

URI
ชื่อ ต้องระบุ ชื่อของเอนทิตี

ข้อความอิสระ เช่น "Avis Union Square SF"

ขนาดข้อความที่แนะนำ: สูงสุด 50 อักขระ
เวลารับรถที่แปลแล้ว - การประทับเวลา ต้องระบุ การประทับเวลาตามยุคสมัยที่แสดงเวลารับรถสำหรับการจอง Joda-Time Instant
เวลารับสินค้าแบบแปลแล้ว - เขตเวลา ต้องระบุ เขตเวลาของเวลารับสินค้าสำหรับการจอง Joda-Time DateTimeZone
เวลาส่งคืนที่แปลแล้ว - การประทับเวลา ไม่บังคับ การประทับเวลาตามยุคสมัยที่แสดงเวลาเช็คเอาต์สำหรับการจอง Joda-Time Instant
เวลาส่งคืนที่แปลแล้ว - เขตเวลา ไม่บังคับ เขตเวลาของเวลาเช็คเอาต์สำหรับการจอง Joda-Time DateTimeZone
ที่อยู่ในการรับ - ประเทศ ไม่บังคับ ประเทศของสถานที่รับสินค้า

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
ที่อยู่ในการรับ - เมือง ไม่บังคับ เมืองของสถานที่รับสินค้า

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
ที่อยู่ในการรับ - ที่อยู่สำหรับแสดง ไม่บังคับ สถานที่รับสินค้าที่จะแสดงต่อผู้ใช้

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
ที่อยู่ในการรับ - ที่อยู่ ไม่บังคับ ที่อยู่ (หากมี) ของจุดรับสินค้า

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
ที่อยู่ในการรับ - รัฐ ไม่บังคับ รัฐหรือจังหวัด (หากมี) ของจุดรับสินค้า

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
ที่อยู่ในการรับ - รหัสไปรษณีย์ ไม่บังคับ รหัสไปรษณีย์ (หากมี) ของจุดรับสินค้า

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
ที่อยู่ในการรับ - ย่าน ไม่บังคับ ย่าน (หากมี) ของจุดรับสินค้า

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
ที่อยู่สำหรับคืนสินค้า - ประเทศ ไม่บังคับ ประเทศของสถานที่ส่งคืน

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
ที่อยู่สำหรับคืนสินค้า - เมือง ไม่บังคับ เมืองของสถานที่คืนสินค้า

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
ที่อยู่สำหรับคืนสินค้า - ที่อยู่สำหรับแสดง ไม่บังคับ ตำแหน่งที่แสดงผลต่อผู้ใช้

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
ที่อยู่สำหรับคืนสินค้า - ที่อยู่ ไม่บังคับ ที่อยู่ (หากมี) ของสถานที่คืนสินค้า

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
ที่อยู่สำหรับคืนสินค้า - รัฐ ไม่บังคับ รัฐหรือจังหวัด (หากมี) ของสถานที่ส่งคืน

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
ที่อยู่สำหรับคืนสินค้า - รหัสไปรษณีย์ ไม่บังคับ รหัสไปรษณีย์ (หากมี) ของสถานที่ส่งคืน

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
ที่อยู่สำหรับคืนสินค้า - ย่าน ไม่บังคับ ย่าน (หากมี) ของสถานที่คืนสินค้า

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
ผู้ให้บริการ - ชื่อ ไม่บังคับ

ชื่อผู้ให้บริการ

หมายเหตุ: ต้องมีข้อความหรือรูปภาพสำหรับผู้ให้บริการ

ข้อความอิสระ เช่น "Avis Car Rental"
ผู้ให้บริการ - รูปภาพ ไม่บังคับ

โลโก้/รูปภาพของผู้ให้บริการ

หมายเหตุ: ต้องมีข้อความหรือรูปภาพสำหรับผู้ให้บริการ

ดูคำแนะนำได้ที่ข้อกำหนดเกี่ยวกับรูปภาพ
ภาพโปสเตอร์ ไม่บังคับ

เราจะแสดงรูปภาพเพียง 1 รูปเมื่อมีการระบุรูปภาพหลายรูป สัดส่วนภาพที่แนะนําคือ 16:9

ดูคำแนะนำได้ที่ข้อกำหนดเกี่ยวกับรูปภาพ
คำอธิบาย ไม่บังคับ

ข้อความย่อหน้าเดียวเพื่ออธิบายเอนทิตี

หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: 180 อักขระ
รายการคำบรรยาย ไม่บังคับ

คำบรรยายได้สูงสุด 3 รายการ โดยคำบรรยายแต่ละรายการจะเป็นข้อความบรรทัดเดียว

หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น

ข้อความอิสระ

ขนาดข้อความที่แนะนำสำหรับคำบรรยายแต่ละรายการ: สูงสุด 50 อักขระ
รหัสยืนยัน ไม่บังคับ รหัสยืนยันสำหรับการจองรถเช่า ข้อความอิสระ
ราคา - CurrentPrice ต้องระบุแบบมีเงื่อนไข

ราคาปัจจุบันของการจอง

ต้องระบุหากระบุราคาที่มีการขีดทับ

ข้อความอิสระ
ราคา - StrikethroughPrice ไม่บังคับ ราคาเดิมของการจอง ซึ่งจะมีการขีดทับใน UI ข้อความอิสระ
ข้อความไฮไลต์ราคา ไม่บังคับ ข้อความไฮไลต์ราคาเพื่อแสดงโปรโมชัน กิจกรรม ส่วนลดสำหรับสมาชิก (หากมี)

ข้อความอิสระ

ขนาดข้อความที่แนะนำ: ไม่เกิน 45 อักขระ (ข้อความที่ยาวเกินไปอาจแสดงจุดไข่ปลา)

ข้อกำหนดเกี่ยวกับรูปภาพ

ข้อกำหนดที่จำเป็นสำหรับชิ้นงานรูปภาพแสดงอยู่ในตารางนี้

สัดส่วนภาพ พิกเซลขั้นต่ำ พิกเซลที่แนะนํา

สี่เหลี่ยมจัตุรัส (1x1)

แนะนำ

 300x300 1200x1200
แนวนอน (1.91x1) 600x314 1200x628
แนวตั้ง (4x5) 480x600 960x1200

รูปภาพต้องโฮสต์ใน CDN สาธารณะเพื่อให้ Google เข้าถึงได้

รูปแบบไฟล์

PNG, JPG, GIF แบบภาพนิ่ง, WebP

ขนาดไฟล์สูงสุด

5120 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 เข้าถึงได้

หลักเกณฑ์ในการใช้หมวดหมู่เนื้อหา

  1. เอนทิตีบางรายการ เช่น ArticleEntity และ GenericFeaturedEntity มีสิทธิ์ใช้หมวดหมู่เนื้อหาใดก็ได้ สำหรับเอนทิตีอื่นๆ เช่น EventEntity, EventReservationEntity, PointOfInterestEntity เฉพาะหมวดหมู่ย่อยของหมวดหมู่เหล่านี้เท่านั้นที่มีสิทธิ์ ตรวจสอบรายการหมวดหมู่ที่มีสิทธิ์สำหรับประเภทเอนทิตีก่อนที่จะป้อนข้อมูลรายการ

  2. ใช้เอนทิตีประเภทที่เฉพาะเจาะจงสำหรับหมวดหมู่เนื้อหาบางหมวดหมู่แทนการใช้เอนทิตีทั่วไปร่วมกับ ContentCategory

  3. ช่อง ContentCategory เป็นช่องที่ไม่บังคับและควรเว้นว่างไว้หากเนื้อหาไม่ได้อยู่ในหมวดหมู่ที่กล่าวถึงก่อนหน้านี้

  4. ในกรณีที่ระบุหมวดหมู่เนื้อหาหลายหมวดหมู่ ให้ระบุหมวดหมู่ตามลำดับความเกี่ยวข้องกับเนื้อหา โดยให้หมวดหมู่เนื้อหาที่มีความเกี่ยวข้องมากที่สุดอยู่อันดับแรกในรายการ

ขั้นตอนที่ 2: ระบุข้อมูลคลัสเตอร์

เราขอแนะนำให้เรียกใช้งานเผยแพร่เนื้อหาในเบื้องหลัง (เช่น โดยใช้ WorkManager) และกำหนดเวลาให้ทำงานเป็นประจำหรือตามเหตุการณ์ (เช่น ทุกครั้งที่ผู้ใช้เปิดแอปหรือเมื่อผู้ใช้เพิ่งเพิ่มรายการลงในรถเข็น)

AppEngageTravelClient มีหน้าที่รับผิดชอบในการเผยแพร่คลัสเตอร์

API ต่อไปนี้ใช้เพื่อเผยแพร่คลัสเตอร์ในไคลเอ็นต์

  • isServiceAvailable
  • publishRecommendationClusters
  • publishFeaturedCluster
  • publishReservationCluster
  • publishContinueSearchCluster
  • publishUserAccountManagementRequest
  • updatePublishStatus
  • deleteRecommendationsClusters
  • deleteFeaturedCluster
  • deleteReservationCluster
  • deleteContinueSearchCluster
  • 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 ที่มีอยู่ออกจากพาร์ทเนอร์นักพัฒนาแอป
  • ระบบจะแยกวิเคราะห์และจัดเก็บข้อมูลจากคำขอไว้ในคลัสเตอร์แนะนําที่อัปเดตแล้ว

ในกรณีที่เกิดข้อผิดพลาด ระบบจะปฏิเสธคำขอทั้งหมดและคงสถานะที่มีอยู่ไว้

publishReservationCluster

API นี้ใช้เพื่อเผยแพร่ออบเจ็กต์ ReservationCluster

Kotlin

client.publishReservationCluster(
    PublishReservationClusterRequest.Builder()
      .setReservationCluster(
        ReservationCluster.Builder()
          .addLodgingReservationEntity(lodgingReservationEntity)
          .addVehicleRentalReservationEntity(vehicleRentalReservationEntity)
          .addTransportationReservationEntity(transportationReservationEntity)
          .addEventReservationEntity(eventReservationEntity)
          .addRestaurantReservationEntity(restaurantReservationEntity)
          .build())
      .build())

Java

client.publishReservationCluster(
            new PublishReservationClusterRequest.Builder()
                .setReservationCluster(
                    new ReservationCluster.Builder()
                        .addLodgingReservationEntity(lodgingReservationEntity)
                        .addVehicleRentalReservationEntity(vehicleRentalReservationEntity)
                        .addTransportationReservationEntity(transportationReservationEntity)
                        .addEventReservationEntity(eventReservationEntity)
                        .addRestaurantReservationEntity(restaurantReservationEntity)
                        .build())
                .build());

เมื่อบริการได้รับคําขอ ระบบจะดําเนินการต่อไปนี้ภายในธุรกรรมเดียว

  • ระบบจะนำข้อมูล ReservationCluster ที่มีอยู่ออกจากพาร์ทเนอร์นักพัฒนาแอป
  • ระบบจะแยกวิเคราะห์และจัดเก็บข้อมูลจากคำขอไว้ในคลัสเตอร์การจองที่อัปเดต

ในกรณีที่เกิดข้อผิดพลาด ระบบจะปฏิเสธคำขอทั้งหมดและคงสถานะที่มีอยู่ไว้

publishContinueSearchCluster

API นี้ใช้เพื่อเผยแพร่รายการออบเจ็กต์ ContinueSearchCluster

Kotlin

client.publishContinueSearchCluster(
    PublishContinueSearchClusterRequest.Builder()
      .setContinueSearchCluster(
        ContinueSearchCluster.Builder()
          .addPointOfInterestEntity(entity1)
          .addPointOfInterestEntity(entity2)
          .build())
      .build())

Java

client.publishContinueSearchCluster(
            new PublishContinueSearchClusterRequest.Builder()
                .setContinueSearchCluster(
                    new ContinueSearchCluster.Builder()
                        .addPointOfInterestEntity(entity1)
                        .addPointOfInterestEntity(entity2)
                        .build())
                .build());

เมื่อบริการได้รับคําขอ ระบบจะดําเนินการต่อไปนี้ภายในธุรกรรมเดียว

  • ระบบจะนำข้อมูล ContinueSearchCluster ที่มีอยู่ออกจากพาร์ทเนอร์นักพัฒนาแอป
  • ระบบจะแยกวิเคราะห์และจัดเก็บข้อมูลจากคําขอไว้ในคลัสเตอร์การค้นหาต่อที่อัปเดตแล้ว

ในกรณีที่เกิดข้อผิดพลาด ระบบจะปฏิเสธคำขอทั้งหมดและคงสถานะที่มีอยู่ไว้

publishUserAccountManagementRequest

API นี้ใช้เพื่อเผยแพร่การ์ดลงชื่อเข้าใช้ การดำเนินการลงชื่อเข้าใช้จะนำผู้ใช้ไปยังหน้าลงชื่อเข้าใช้ของแอปเพื่อให้แอปเผยแพร่เนื้อหาได้ (หรือแสดงเนื้อหาที่ปรับเปลี่ยนในแบบของคุณมากขึ้น)

ข้อมูลเมตาต่อไปนี้เป็นส่วนหนึ่งของการ์ดลงชื่อเข้าใช้

แอตทริบิวต์ ข้อกำหนด คำอธิบาย
URI การดำเนินการ ต้องระบุ Deep Link ไปยังการดำเนินการ (เช่น ไปยังหน้าลงชื่อเข้าใช้แอป)
รูปภาพ ไม่บังคับ - หากไม่ระบุ จะต้องระบุชื่อ

รูปภาพที่แสดงในการ์ด

รูปภาพสัดส่วนภาพ 16x9 ที่มีความละเอียด 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();

เมื่อบริการได้รับคําขอ ระบบจะนำข้อมูลที่มีอยู่ออกจากคลัสเตอร์แนะนํา ในกรณีที่เกิดข้อผิดพลาด ระบบจะปฏิเสธคำขอทั้งหมดและคงสถานะที่มีอยู่ไว้

deleteReservationCluster

API นี้ใช้เพื่อลบเนื้อหาของคลัสเตอร์การจอง

Kotlin

client.deleteReservationCluster()

Java

client.deleteReservationCluster();

เมื่อบริการได้รับคําขอ ระบบจะนำข้อมูลที่มีอยู่ออกจากคลัสเตอร์การจอง ในกรณีที่เกิดข้อผิดพลาด ระบบจะปฏิเสธคำขอทั้งหมดและคงสถานะที่มีอยู่ไว้

deleteUserManagementCluster

API นี้ใช้เพื่อลบเนื้อหาของคลัสเตอร์ UserAccountManagement

Kotlin

client.deleteUserManagementCluster()

Java

client.deleteUserManagementCluster();

เมื่อบริการได้รับคําขอ ระบบจะนำข้อมูลที่มีอยู่ออกจากคลัสเตอร์การจัดการบัญชีผู้ใช้ ในกรณีที่เกิดข้อผิดพลาด ระบบจะปฏิเสธคำขอทั้งหมดและคงสถานะที่มีอยู่ไว้

deleteContinueSearchCluster

API นี้ใช้เพื่อลบเนื้อหาของคลัสเตอร์การค้นหาต่อ

Kotlin

client.deleteContinueSearchCluster()

Java

client.deleteContinueSearchCluster();

เมื่อบริการได้รับคําขอ ระบบจะนำข้อมูลที่มีอยู่ออกจากกลุ่มการค้นหาต่อเนื่อง ในกรณีที่เกิดข้อผิดพลาด ระบบจะปฏิเสธคำขอทั้งหมดและคงสถานะที่มีอยู่ไว้

deleteClusters

API นี้ใช้เพื่อลบเนื้อหาของคลัสเตอร์ประเภทหนึ่งๆ

Kotlin

client.deleteClusters(
    DeleteClustersRequest.Builder()
      .addClusterType(ClusterType.TYPE_RESERVATION)
      .addClusterType(ClusterType.TYPE_FEATURED)
      .addClusterType(ClusterType.TYPE_RECOMMENDATION)
      .addClusterType(ClusterType.TYPE_CONTINUE_SEARCH)
      .build())

Java

client.deleteClusters(
            new DeleteClustersRequest.Builder()
                .addClusterType(ClusterType.TYPE_RESERVATION)
                .addClusterType(ClusterType.TYPE_FEATURED)
                .addClusterType(ClusterType.TYPE_RECOMMENDATION)
                .addClusterType(ClusterType.TYPE_CONTINUE_SEARCH)
                .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
}

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

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
}

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

}
  • ประกาศการติดตั้งใช้งานแบบคงที่ด้วยแท็ก <receiver> ในไฟล์ AndroidManifest.xml ซึ่งจะช่วยให้แอปพลิเคชันได้รับ Intent แบบออกอากาศเมื่อไม่ได้ทำงานอยู่ และช่วยให้แอปพลิเคชันเผยแพร่เนื้อหาได้
<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>
   </receiver>
</application>

Intent ต่อไปนี้จะส่งโดยบริการ

  • com.google.android.engage.action.PUBLISH_RECOMMENDATION เราขอแนะนำให้เริ่มการโทร publishRecommendationClusters เมื่อได้รับ Intent นี้
  • com.google.android.engage.action.PUBLISH_FEATURED เราขอแนะนำให้เริ่มpublishFeaturedClusterการโทรเมื่อได้รับ Intent นี้

เวิร์กโฟลว์การผสานรวม

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

คำถามที่พบบ่อย

ดูคำถามที่พบบ่อยเกี่ยวกับ Engage SDK

รายชื่อติดต่อ

โปรดติดต่อ engage-developers@google.com หากมีคำถามระหว่างกระบวนการผสานรวม

ขั้นตอนถัดไป

หลังจากการผสานรวมนี้เสร็จสมบูรณ์แล้ว ขั้นตอนถัดไปมีดังนี้

  • ส่งอีเมลไปที่ engage-developers@google.com และแนบ APK ที่ผสานรวมแล้วซึ่งพร้อมให้ Google ทดสอบ
  • Google จะดำเนินการยืนยันและตรวจสอบภายในเพื่อให้แน่ใจว่าการผสานรวมทำงานได้ตามที่คาดไว้ หากจำเป็นต้องทำการเปลี่ยนแปลง Google จะติดต่อคุณพร้อมรายละเอียดที่จำเป็น
  • เมื่อการทดสอบเสร็จสมบูรณ์และไม่จำเป็นต้องมีการเปลี่ยนแปลงใดๆ Google จะติดต่อคุณเพื่อแจ้งให้ทราบว่าคุณสามารถเริ่มเผยแพร่ APK ที่อัปเดตและผสานรวมแล้วใน Play Store
  • หลังจากที่ Google ยืนยันว่า APK ที่อัปเดตแล้วของคุณได้รับการเผยแพร่ไปยัง Play Store แล้ว ระบบอาจเผยแพร่คลัสเตอร์คำแนะนำ แนะนํา การจอง และค้นหาต่อให้ผู้ใช้เห็น