จัดตำแหน่งเติมข้อความอัตโนมัติจะใช้โทเค็นเซสชันในการจัดกลุ่มคำค้นหาและขั้นตอนการเลือกของการค้นหาแบบเติมข้อความอัตโนมัติของผู้ใช้เป็นเซสชันที่แยกกันเพื่อใช้ในการเรียกเก็บเงิน เซสชันจะเริ่มต้นเมื่อผู้ใช้เริ่มพิมพ์ข้อความค้นหา และสรุปเมื่อผู้ใช้เลือกสถานที่และเรียกรายละเอียดสถานที่ แต่ละเซสชันสามารถมีข้อความค้นหาที่เติมข้อความอัตโนมัติหลายรายการ ตามด้วยการเลือกสถานที่เพียง 1 แห่ง คีย์ API ที่ใช้สำหรับแต่ละคำขอภายในเซสชันต้องเป็นของโปรเจ็กต์ Google Cloud Console เดียวกัน เมื่อเซสชันสิ้นสุดลง โทเค็นจะใช้งานไม่ได้อีกต่อไป แอปต้องสร้างโทเค็นใหม่สำหรับแต่ละเซสชัน หากไม่ระบุพารามิเตอร์ sessiontoken หรือหากคุณใช้โทเค็นเซสชันซ้ำ ระบบจะเรียกเก็บเงินจากเซสชันเสมือนว่าไม่ได้ระบุโทเค็นเซสชันไว้ (เรียกเก็บเงินคำขอแต่ละรายการแยกกัน)
เราขอแนะนำหลักเกณฑ์ต่อไปนี้
- ใช้โทเค็นเซสชันสำหรับเซสชันการเติมข้อความอัตโนมัติทั้งหมด
- สร้างโทเค็นใหม่สำหรับแต่ละเซสชัน
- ตรวจสอบว่าคีย์ API ที่ใช้สำหรับการเติมข้อความอัตโนมัติและสถานที่ทั้งหมดภายในเซสชันเป็นของโปรเจ็กต์ Google Cloud Console เดียวกัน
- อย่าลืมส่งโทเค็นเซสชันที่ไม่ซ้ำกันให้เซสชันใหม่แต่ละเซสชัน การใช้โทเค็นเดียวกันสำหรับมากกว่า 1 เซสชันจะส่งผลให้มีการเรียกเก็บเงินแต่ละคำขอแยกกัน
คุณเลือกที่จะละเว้นโทเค็นเซสชันที่เติมข้อความอัตโนมัติจากคำขอได้ หากละเว้นโทเค็นเซสชัน ระบบจะเรียกเก็บเงินคำขอแต่ละรายการแยกกัน ซึ่งจะทริกเกอร์ การเติมข้อความอัตโนมัติ - ตามคำขอ SKU หากคุณใช้โทเค็นเซสชันซ้ำ ระบบจะถือว่าเซสชันไม่ถูกต้องและจะเรียกเก็บเงินคำขอเสมือนว่าไม่ได้ให้โทเค็นเซสชัน
ตัวอย่าง
เมื่อผู้ใช้พิมพ์ข้อความค้นหา คำขอที่เติมข้อความอัตโนมัติจะถูกเรียกว่าทุกๆ การกดแป้นพิมพ์ (ไม่ใช่ต่ออักขระ) และแสดงรายการผลลัพธ์ที่เป็นไปได้ เมื่อผู้ใช้เลือกจากรายการผลการค้นหา ระบบจะนับการเลือกเป็นคำขอ และคำขอทั้งหมดที่เกิดขึ้นระหว่างการค้นหาจะถูกรวมกลุ่มและนับเป็นคำขอเดียว หากผู้ใช้เลือกสถานที่ ระบบจะแสดงคำค้นหาโดยไม่มีค่าใช้จ่าย และจะเรียกเก็บเงินเฉพาะคำขอข้อมูลสถานที่เท่านั้น หากผู้ใช้ไม่เลือกภายใน 2-3 นาทีนับจากเริ่มต้นเซสชัน ระบบจะเรียกเก็บเงินเฉพาะคำค้นหา
มาดูโฟลว์ของเหตุการณ์นี้จากมุมมองของแอปกัน
- ผู้ใช้เริ่มพิมพ์ข้อความค้นหาเพื่อค้นหา "ปารีส ประเทศฝรั่งเศส"
- เมื่อตรวจพบอินพุตของผู้ใช้ แอปจะสร้างโทเค็นเซสชันใหม่ "โทเค็น A"
- เมื่อผู้ใช้พิมพ์ API จะส่งคำขอเติมข้อความอัตโนมัติทุกๆ 2-3 อักขระ โดยแสดงรายการผลลัพธ์ใหม่ที่เป็นไปได้สำหรับแต่ละอักขระดังนี้
"P"
"Par"
"ปารีส"
"ปารีส, Fr"
- สิ่งที่จะเกิดขึ้นเมื่อผู้ใช้เลือกมีดังนี้
- ระบบจะจัดกลุ่มคำขอทั้งหมดที่เกิดจากการค้นหาดังกล่าวและเพิ่มลงในเซสชันที่แสดงด้วย "โทเค็น A" เป็นคำขอเดียว
- การเลือกของผู้ใช้จะนับเป็นคำขอรายละเอียดสถานที่และเพิ่มลงในเซสชันที่แสดงด้วย "โทเค็น A"
- เซสชันสิ้นสุดลงและแอปทิ้ง "โทเค็น A"
ดูข้อมูลเพิ่มเติมเกี่ยวกับการเรียกเก็บเงินสำหรับคําขอที่เติมข้อความอัตโนมัติได้ที่การใช้งานและการเรียกเก็บเงิน
สร้างโทเค็นเซสชัน
หากต้องการสร้างโทเค็นเซสชัน โปรดเรียกใช้ AutocompleteSessionToken.newInstance()