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