คุณสามารถสร้าง URL ที่จะเชื่อมโยงกับการดำเนินการที่เฉพาะเจาะจงได้โดยตรงตามการกระทำ ระบบจะนำผู้ใช้ที่คลิกลิงก์ Assistant (ก่อนหน้านี้เรียกว่าลิงก์การดำเนินการ) ในเว็บหรือเบราว์เซอร์ในอุปกรณ์เคลื่อนที่ไปยัง Assistant ในอุปกรณ์ของผู้ใช้ ซึ่งจะโต้ตอบกับการดำเนินการที่เกี่ยวข้องของคุณโดยตรง
ตัวอย่างลิงก์ Assistant ที่มีประโยชน์มีดังนี้
- การลิงก์ผู้ใช้เข้ากับคำแนะนำด้วยเสียงจากเว็บไซต์แสดงวิธีการ
- การเชื่อมโยงผู้ใช้กับประสบการณ์การสนับสนุนลูกค้าจากหน้า "รับความช่วยเหลือ"
- การลิงก์ผู้ใช้กับความตั้งใจในการอัปเดตเพื่อให้พวกเขาเลือกรับการอัปเดตในอนาคตได้
หากต้องการสร้าง URL สำหรับการดำเนินการ ให้ทำดังนี้
- ในคอนโซล Actions ให้ไปที่พัฒนา > การดําเนินการ
- คลิกการดำเนินการที่คุณต้องการสร้างลิงก์
- ในส่วนลิงก์ ให้เปิดใช้งานคุณต้องการเปิดใช้ URL สำหรับการดำเนินการนี้หรือไม่
- ป้อนชื่อลิงก์ ชื่อนี้ควรมีคำกริยาที่อธิบายรายละเอียดของการดำเนินการ เช่น หากการดำเนินการของคุณนำผู้ใช้ไปยังขั้นตอนการทำธุรกรรมเพื่อซื้อตั๋วคอนเสิร์ต ชื่อลิงก์ที่มีประโยชน์คือ "ซื้อตั๋วคอนเสิร์ต"
- คลิกบันทึก
คุณสามารถคัดลอก URL ที่ให้ไว้และอ้างอิง URL นั้นได้ทุกที่ที่ต้องการนำผู้ใช้มาที่การดำเนินการที่เฉพาะเจาะจงนี้
พารามิเตอร์ลิงก์ Assistant
ลิงก์ Assistant อาจมี Intent และพารามิเตอร์ใน URL หรือไม่ก็ได้ Google จะจัดการพารามิเตอร์ตามประเภทของ Intent ที่ระบุไว้ใน URL
ข้อกําหนดของ URL ของลิงก์ Assistant
ไวยากรณ์ทั่วไปสำหรับ URL ของลิงก์ Assistant มีดังนี้
https://assistant.google.com/services/invoke[/$action_id][?intent=$intent¶m.$param=$value][&$utm_param=$utm_value]
พารามิเตอร์ URL ที่คุณสามารถตั้งค่ามีอธิบายในตารางต่อไปนี้
พารามิเตอร์ URL | คำอธิบาย |
---|---|
$action_id |
ตัวระบุที่เป็นตัวเลขของการดำเนินการ |
$intent |
ชื่อเต็มของความตั้งใจในตัวหรือความตั้งใจที่กำหนดเอง |
$param |
ชื่อเต็มของพารามิเตอร์ Intent ที่ระบุในแพ็กเกจการดำเนินการ |
$value |
ค่าที่เข้ารหัสของ URL ของประเภทที่ประกาศสำหรับ $param ในแพ็กเกจการดำเนินการ |
$utm_param |
รายการประเภทพารามิเตอร์ UTM อย่างน้อย 1 รายการ ค่าที่ใช้ได้ ได้แก่ utm_source , utm_medium , utm_campaign , utm_term และ utm_content |
$utm_value |
ค่าสตริงของพารามิเตอร์ UTM |
URL ลิงก์ Assistant ที่มี Intent ในตัว
หากลิงก์ Assistant มี Intent ในตัว (Intent ขึ้นต้นด้วย actions.intent.*
) Google จะพยายามดึงพารามิเตอร์ Intent ในตัวใน URL แล้วส่งไปยังการดำเนินการของคุณ พารามิเตอร์ที่ Google ไม่เข้าใจเนื่องจากพารามิเตอร์ Intent ในตัวจะถูกตัดออก
สำหรับการดำเนินการแบบการสนทนา Google จะส่งพารามิเตอร์เหล่านี้ไปยัง Fulfillment ของคุณซึ่งเป็นส่วนหนึ่งของข้อความ AppRequest
ตัวอย่างต่อไปนี้แสดงวิธีที่คุณระบุ URL ลิงก์ Assistant ที่มี Intent ในตัวที่มีพารามิเตอร์ Intent รายการเดียว
https://assistant.google.com/services/invoke/uid/0000008ddd7eabec?intent=actions.intent.GET_HOROSCOPE¶m.astrologySign=%22cancer%22
URL ของลิงก์ Assistant ที่มี Intent ที่กำหนดเอง
สำหรับ Intent ที่กำหนดเอง Google จะดึงข้อมูลเฉพาะพารามิเตอร์ที่การดำเนินการของคุณกำหนดเป็นส่วนหนึ่งของ Intent และทิ้งพารามิเตอร์อื่นๆ
ตัวอย่างต่อไปนี้แสดงวิธีระบุ URL ลิงก์ Assistant ที่มี Intent ที่กำหนดเอง
https://assistant.google.com/services/invoke/uid/0000001f575305a0?intent=NEWS_UPDATE_DEEP_LINK¶m.topic=sports
สำหรับ URL ตัวอย่างด้านบน ใน AppRequest
Google จะเพิ่มออบเจ็กต์ JSON ดังนี้
argument {
name: ‘topic’,
raw_text: ‘sports’,
text_value: ‘sports’,
}
URL ของลิงก์ Assistant ที่ไม่มีเจตนา
หากไม่ระบุ Intent ในลิงก์ Assistant ทาง Google จะลิงก์กับ Intent MAIN
(actions.intent.MAIN
) ของการดำเนินการของคุณโดยค่าเริ่มต้นโดยมีลักษณะการทำงานดังต่อไปนี้
- หากคุณไม่ได้เปิดใช้ Intent
MAIN
ในลิงก์ Assistant อย่างชัดแจ้ง Google จะเรียกใช้ Intent หลักโดยไม่มีพารามิเตอร์ใดๆ ซึ่งคล้ายกับลักษณะการทำงานสำหรับ "พูดกับ app_name" - หากคุณเปิดใช้ Intent
MAIN
อย่างชัดแจ้ง Google จะส่งพารามิเตอร์ไปยังการดำเนินการของคุณ
ตัวอย่างต่อไปนี้แสดงวิธีระบุ URL ลิงก์ Assistant โดยไม่มีเจตนา
https://assistant.google.com/services/invoke/uid/000000d139bbc4d4
URL ของลิงก์ Assistant กับพารามิเตอร์ UTM
พารามิเตอร์ UTM เป็นสตริงที่ Google ส่งไปยัง Action ของคุณเมื่อผู้ใช้คลิกลิงก์ Assistant ซึ่งคุณจะนำไปใช้สำหรับการวิเคราะห์ในภายหลังได้
พารามิเตอร์ UTM ที่ Google ส่งไปยังการดำเนินการของคุณจะมีข้อมูลต่อไปนี้
utm_source
utm_medium
utm_campaign
utm_term
utm_content
ตัวอย่างต่อไปนี้แสดงวิธีที่คุณจะระบุ URL ของลิงก์ Assistant ที่มีพารามิเตอร์ UTM
https://assistant.google.com/services/invoke/uid/000000d139bbc4d4?utm_source=Google&utm_medium=email&utm_campaign=holiday+sale
Google จะเพิ่มอาร์กิวเมนต์ต่อไปนี้ในข้อความ AppRequest
สำหรับตัวอย่าง URL ด้านบน
argument {
name: ‘utm_source’,
raw_text: ‘Google’,
text_value: ‘Google’,
}
argument {
name: ‘utm_medium’,
raw_text: ‘email’,
text_value: ‘email’,
}
argument {
name: ‘utm_campaign’,
raw_text: ‘holiday sale’,
text_value: ‘holiday sale’,
}
ทดสอบลิงก์ Assistant
คุณสามารถทดสอบลิงก์ Assistant สำหรับ Intent (หลักหรือที่กำหนดเอง โดยมีหรือไม่มีพารามิเตอร์) ได้ผ่านเครื่องจำลองหรืออุปกรณ์
วิธีทดสอบลิงก์ Assistant
- เปิดใช้ลิงก์ Assistant ในคอนโซล
- ลงชื่อเข้าใช้ Assistant ด้วยบัญชีเดียวกันกับที่ใช้สร้างโปรเจ็กต์ Actions on Google
- สร้างลิงก์ Assistant ในเวอร์ชันที่คลิกได้ (ในอีเมล แชท เอกสาร ฯลฯ)
- ในอุปกรณ์ที่พร้อมใช้งาน Assistant ให้คลิกลิงก์ที่สร้างขึ้นในขั้นตอนก่อนหน้า
เมื่อยืนยันว่าลิงก์ Assistant ทํางานตามที่คาดไว้แล้ว คุณจะต้องทําให้การดําเนินการใช้งานได้อีกครั้งเพื่อให้ผู้ใช้ใช้ลิงก์ได้
ข้อจำกัดและแนวทางปฏิบัติแนะนำ
เนื่องจากตอนนี้คุณสามารถเผยแพร่และอ้างอิง URL ของลิงก์ Assistant นอกไดเรกทอรีหรือบริการอื่นๆ ของ Google ได้แล้ว โปรดทราบว่ามีข้อจำกัดและแนวทางปฏิบัติแนะนำต่อไปนี้
- โปรดตรวจสอบว่าคุณยังรองรับลิงก์ Assistant ทั้งหมดต่อไป หากคุณเผยแพร่ลิงก์ Assistant ที่ต่อมาเสียหาย โปรเจ็กต์ Actions อาจได้รับแจ้งว่าไม่มีประสิทธิภาพและถูกลบออก
การเผยแพร่ลิงก์หมายความว่าคุณรองรับการทริกเกอร์จากแหล่งที่มาที่ไม่น่าเชื่อถือ สำหรับการดำเนินการที่ลิงก์ไว้ คุณต้องยืนยันกับผู้ใช้อย่างชัดแจ้งก่อนที่จะดำเนินการ "การดำเนินการในชีวิตจริง" ตัวอย่างเช่น การดำเนินการที่ปิดอุปกรณ์สมาร์ทโฮมควรแสดงข้อความแจ้งผู้ใช้ว่า "คุณแน่ใจไหมว่าต้องการปิด
$applianceName
"ในบริบทนี้ "การกระทำในชีวิตจริง" คือการกระทำใดๆ ที่ส่งผลต่อบริการ ข้อมูล อุปกรณ์ เครือข่าย คอมพิวเตอร์ หรือ API ของผู้ใช้ ตัวอย่างเช่น การส่งอีเมล การทำธุรกรรม การเปลี่ยนแปลงสถานะของเครื่องใช้ไฟฟ้าสมาร์ทโฮม การสร้างการสมัครใช้บริการ หรืออัปเดตเนื้อหา