คุณสร้าง URL ที่ลิงก์ไปยัง Intent ที่เฉพาะเจาะจงของการดำเนินการได้โดยตรง ระบบจะนำผู้ใช้ที่คลิกลิงก์ Assistant (ก่อนหน้านี้เรียกว่าลิงก์การดำเนินการ) ในเว็บหรือเบราว์เซอร์ในอุปกรณ์เคลื่อนที่ไปยัง Assistant ในอุปกรณ์ของผู้ใช้ ซึ่งจะโต้ตอบกับการดำเนินการของคุณโดยตรง
ลิงก์ Assistant แตกต่างจากเว็บลิงก์ไดเรกทอรี ซึ่งจะส่งผู้ใช้ไปยังหน้าการดำเนินการของคุณในไดเรกทอรี Assistant
ลิงก์ Assistant อาจมีประโยชน์ในสถานการณ์ต่อไปนี้
- การลิงก์ผู้ใช้เข้ากับคำแนะนำด้วยเสียงจากเว็บไซต์แสดงวิธีการ
- การลิงก์ผู้ใช้กับประสบการณ์การสนับสนุนลูกค้าจากหน้าความช่วยเหลือ
- การลิงก์ผู้ใช้กับความตั้งใจในการอัปเดตเพื่อให้พวกเขาเลือกรับการอัปเดตในอนาคตได้
สร้างลิงก์ Assistant
คุณสร้างลิงก์ Assistant จากภายในโปรเจ็กต์ได้ในคอนโซล Actions ลิงก์ Assistant พร้อมใช้งานผ่านช่องทางการติดตั้งใช้งานทั้งหมด (อัลฟ่า เบต้า และเวอร์ชันที่ใช้งานจริง) เช่น หากมีการเปิดใช้ลิงก์ Assistant ในรุ่นอัลฟ่าของการดำเนินการ ผู้ทดสอบเวอร์ชันอัลฟ่าจะใช้ลิงก์ได้
หากต้องการสร้าง URL สำหรับการดำเนินการ ให้ทำตามขั้นตอนต่อไปนี้
- ในคอนโซล Actions ให้ไปที่ติดตั้งใช้งาน > ลิงก์ Assistant
- สําหรับ Intent ให้เลือก Intent ที่ต้องการสร้างลิงก์ให้
- เปิดใช้ตัวเลือกคุณต้องการเปิดใช้การลิงก์กับ intent_name หรือไม่
- (ไม่บังคับ) ในส่วนพารามิเตอร์แคมเปญ ให้ป้อนข้อมูลที่คุณต้องการบันทึกเพิ่มเติมไว้ในลิงก์เป็นพารามิเตอร์ของ URL
- (ไม่บังคับ) ป้อนชื่อลิงก์ ใช้ชื่อนี้เพื่ออธิบายสิ่งที่การดำเนินการทำ ตัวอย่างเช่น หากการดำเนินการของคุณนำผู้ใช้ไปตามขั้นตอนการทำธุรกรรมเพื่อซื้อตั๋วคอนเสิร์ต ชื่อลิงก์ของคุณอาจเป็น "ซื้อตั๋วคอนเสิร์ต"
หลังจากป้อนข้อมูลแล้ว คุณจะดูและคัดลอก URL ที่สร้างขึ้นหรือข้อมูลโค้ดที่สร้างขึ้นสำหรับลิงก์ Assistant ได้ ใช้ลิงก์ Assistant ได้ทุกที่ที่คุณต้องการ นำผู้ใช้ไปสู่การดำเนินการที่เจาะจงนี้
ทดสอบลิงก์ Assistant
คุณสามารถทดสอบลิงก์ Assistant สำหรับ Intent (หลักหรือที่กำหนดเอง โดยมีหรือไม่มีพารามิเตอร์) ผ่านเครื่องจำลองหรือในอุปกรณ์ได้
หากต้องการทดสอบลิงก์ Assistant ในอุปกรณ์ ให้ทำตามขั้นตอนต่อไปนี้
- สร้างลิงก์ Assistant ในคอนโซล Actions
- ส่งลิงก์ Assistant เป็น URL ให้ตัวคุณเองในอีเมล ข้อความแชท หรือรูปแบบอื่นๆ
- ในอุปกรณ์ที่พร้อมใช้งาน Assistant ให้ลงชื่อเข้าใช้ Assistant ด้วยบัญชีเดียวกับที่คุณใช้สร้างโปรเจ็กต์ Actions
- ในอุปกรณ์เดียวกัน ให้คลิกลิงก์ Assistant ที่คุณส่งให้ตัวเอง
เมื่อยืนยันว่าลิงก์ Assistant ทำงานได้ตามที่คาดไว้แล้ว คุณจะต้องทำให้การดำเนินการใช้งานได้อีกครั้งเพื่อให้ผู้ใช้เข้าถึงลิงก์ได้
พารามิเตอร์ลิงก์ Assistant
ลิงก์ Assistant อาจมี Intent และพารามิเตอร์ใน URL หรือไม่ก็ได้ ใช้ส่วนพารามิเตอร์แคมเปญเพื่อเพิ่มพารามิเตอร์แคมเปญ
เมื่อลิงก์ Assistant ไม่มีพารามิเตอร์เพิ่มเติม Google Assistant จะลิงก์กับ Intent MAIN
(actions.intent.MAIN
) ของการดำเนินการที่มีลักษณะการทำงานต่อไปนี้
- หากคุณไม่ได้เปิดใช้ Intent
MAIN
อย่างชัดเจนในลิงก์ Assistant Assistant จะจับคู่ Intent หลักโดยไม่มีพารามิเตอร์ใดๆ ซึ่งคล้ายกับลักษณะการทำงานของ "พูดกับ app_name" - หากคุณเปิดใช้ Intent
MAIN
อย่างชัดแจ้ง Assistant จะส่งพารามิเตอร์ไปยังการดำเนินการของคุณ
ต่อไปนี้คือตัวอย่าง URL ลิงก์ Assistant ที่ใช้ Intent MAIN
ที่ไม่มีพารามิเตอร์เพิ่มเติม
https://assistant.google.com/services/invoke/uid/000000d139bbc4d4
ข้อกําหนดของ 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 Assistant จะพยายามดึงพารามิเตอร์ Intent ในตัวใน URL และส่งต่อไปยังการดำเนินการของคุณ พารามิเตอร์ใดๆ ที่ Assistant ไม่เข้าใจเมื่อมีการนำพารามิเตอร์ Intent ในตัวออก
สำหรับการดำเนินการแบบการสนทนา Assistant จะส่งพารามิเตอร์เหล่านี้ไปยัง Fulfillment ของคุณในฐานะส่วนหนึ่งของข้อความ AppRequest
ตัวอย่างต่อไปนี้แสดงวิธีที่คุณระบุ URL ลิงก์ Assistant ที่มี Intent ในตัวที่มีพารามิเตอร์ Intent รายการเดียว
https://assistant.google.com/services/invoke/uid/0000008ddd7eabec?intent=actions.intent.PLAY_GAME¶m.name=%22ExampleGame%22
URL ลิงก์ Assistant กับความตั้งใจของผู้ใช้
สำหรับ Intent ของผู้ใช้ Google Assistant จะแยกเฉพาะพารามิเตอร์ที่การดำเนินการของคุณกำหนด โดยเป็นส่วนหนึ่งของ Intent และทิ้งพารามิเตอร์อื่นๆ
ตัวอย่างต่อไปนี้แสดงวิธีระบุ URL ลิงก์ Assistant ที่มีความตั้งใจของผู้ใช้
https://assistant.google.com/services/invoke/uid/0000001f575305a0?intent=NEWS_UPDATE_DEEP_LINK¶m.topic=sports
สำหรับ URL ตัวอย่างด้านบน ใน AppRequest
Assistant จะเพิ่มออบเจ็กต์ JSON ดังนี้
argument {
name: 'topic',
raw_text: 'sports',
text_value: 'sports',
}
URL ของลิงก์ Assistant ที่มีพารามิเตอร์ UTM
พารามิเตอร์ UTM เป็นสตริงที่ Google Assistant ส่งไปยังการดำเนินการของคุณเมื่อผู้ใช้คลิกลิงก์ Assistant คุณสามารถใช้ข้อมูลที่อยู่ในสตริงเหล่านี้ สำหรับการวิเคราะห์ในภายหลังได้
พารามิเตอร์ UTM ที่ Assistant ส่งไปยังการดำเนินการของคุณจะมีข้อมูลต่อไปนี้
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
สำหรับ URL ตัวอย่างด้านบน Assistant จะเพิ่มอาร์กิวเมนต์ต่อไปนี้ในข้อความ AppRequest
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',
}
ลิงก์ Rich Assistant
ลิงก์ Assistant แบบสมบูรณ์ให้คุณเพิ่มการค้นพบการดำเนินการของคุณผ่านทางเว็บไซต์โดยใช้ help.js ผู้ใช้สามารถลองใช้การดำเนินการของคุณ รวมทั้งลิงก์บัญชี Google กับบริการของคุณโดยใช้การลิงก์บัญชี
เมื่อผู้ใช้เข้าชมเว็บไซต์ ก็จะเห็นปุ่ม "ลองใช้ Google Assistant" ซึ่งจะเรียกให้แสดงขั้นตอนลิงก์ Rich Assistant
การเปิดใช้การลิงก์บัญชีสำหรับการดําเนินการช่วยให้ผู้ใช้เข้าถึงการดําเนินการของคุณได้ในอุปกรณ์ที่พร้อมใช้งาน Assistant เครื่องใดก็ได้ นอกจากนี้ ผู้ใช้ยังลิงก์บัญชีกับบริการของคุณกับบัญชี Google ได้ด้วย ซึ่งจะมอบประสบการณ์การใช้งานที่ปรับเปลี่ยนให้เหมาะกับลูกค้ามากขึ้น
เมื่อใช้กับการลิงก์บัญชี ลิงก์ Rich Assistant จะใช้ URL การให้สิทธิ์ซึ่งตั้งค่าไว้ในโปรเจ็กต์ในคอนโซลการดำเนินการ สำหรับข้อมูลเพิ่มเติม โปรดดูเอกสารการลิงก์บัญชี
ข้อกำหนดเบื้องต้น
หากต้องการใช้ลิงก์ Rich Assistant คุณต้องมีสิ่งต่อไปนี้
- Actions Project
- เปิดใช้ลิงก์ Assistant แล้วสำหรับการดำเนินการของคุณ
- (ไม่บังคับ) เปิดใช้การลิงก์บัญชีสำหรับการดำเนินการของคุณ
การพัฒนาในท้องถิ่น
หากต้องการใส่ลิงก์ Assistant แบบสมบูรณ์ในเว็บไซต์ ให้ทําตามขั้นตอนต่อไปนี้
ใส่ไลบรารี JavaScript ต่อไปนี้ในหน้าเว็บของคุณ โดยแทนที่
<PROJECT_ID>
ด้วยรหัสโปรเจ็กต์ Actions:<script async src="https://actions.google.com/api/assist.js?projectId={PROJECT_ID}&dev=true"> </script>
เพิ่มแท็ก HTML ต่อไปนี้ไว้ที่ใดก็ได้ในหน้าเว็บ การดำเนินการนี้จะโหลดปุ่ม "ลองใช้กับ Google Assistant" ในบรรทัด
<google-assistant-link-group> <!-- One or more <google-assistant-link> tags --> <google-assistant-link href="{ASSISTANT_LINK_1}"> </google-assistant-link> <google-assistant-link href="{ASSISTANT_LINK_2}"> </google-assistant-link> </google-assistant-link-group>
การทริกเกอร์เชิงรุก
หากต้องการให้เริ่มขั้นตอนลิงก์ Assistant แบบสมบูรณ์โดยอัตโนมัติเมื่อผู้ใช้เข้าชมหน้าเว็บของคุณเป็นครั้งแรก ให้ใช้แท็ก <google-assistant-proactive-link>
เมื่อคุณใช้แท็กนี้ ลิงก์จะเปิดใช้งานโดยไม่มีผู้ใช้เข้าชมครั้งแรก โดยที่ผู้ใช้จะไม่เลือกปุ่มในบรรทัด
เพิ่ม
id
ในแท็กกลุ่มลิงก์ของ Assistant ดังนี้<google-assistant-link-group id="my-group"> <!-- One or more <google-assistant-link> tags --> <google-assistant-link href="{ASSISTANT_LINK_1}"> </google-assistant-link> <google-assistant-link href="{ASSISTANT_LINK_2}"> </google-assistant-link> </google-assistant-link-group>
วางแท็ก
<google-assistant-proactive-action-link>
ในหน้าเว็บและตั้งค่าแอตทริบิวต์groupId
เป็นid
:<google-assistant-link-group id="my-group"> <!-- One or more <google-assistant-link> tags --> <google-assistant-link href="{ASSISTANT_LINK_1}"> </google-assistant-link> <google-assistant-link href="{ASSISTANT_LINK_2}"> </google-assistant-link> </google-assistant-link-group> <google-assistant-proactive-link groupId="my-group"> </google-assistant-proactive-link>
การทำให้ใช้งานได้
ลิงก์ Assistant แบบสมบูรณ์ใช้งานได้กับโดเมนที่คุณเป็นเจ้าของและได้ยืนยันกับ Google แล้วเท่านั้น เมื่อพัฒนาในเครื่อง ข้อกำหนดนี้จะถูกหลีกเลี่ยงโดยสิทธิ์ในการเข้าถึงโปรเจ็กต์ Actions, มีการลงชื่อเข้าใช้บัญชี Google และการตั้งค่าพารามิเตอร์การค้นหา dev=true
ในแท็กสคริปต์
<script async
src="https://actions.google.com/api/assist.js?projectId={PROJECT_ID}&dev=true">
</script>
วิธีการทำให้การดําเนินการใช้งานได้ที่มีลิงก์ Assistant สมบูรณ์มีดังนี้
- จดทะเบียนสาธารณสมบัติในคอนโซลการดำเนินการในส่วนทำให้ใช้งานได้ > การยืนยันแบรนด์ > เชื่อมต่อเว็บไซต์
นำพารามิเตอร์การค้นหา
dev=true
ออกจากสคริปต์<script async src="https://actions.google.com/api/assist.js?projectId={PROJECT_ID}"> </script>
ข้อจำกัดและแนวทางปฏิบัติแนะนำ
ระบบจะใช้ข้อจำกัดและแนวทางปฏิบัติแนะนำต่อไปนี้เพื่อให้สามารถเผยแพร่และอ้างอิง URL ของลิงก์ Assistant นอกไดเรกทอรีหรือบริการอื่นๆ ของ Google ได้
- ดำเนินการต่อเพื่อสนับสนุนลิงก์ Assistant ทั้งหมดของคุณ หากคุณเผยแพร่ลิงก์ Assistant ที่ต่อมาเสียหาย โปรเจ็กต์การดำเนินการของคุณอาจถูกแจ้งว่าไม่มีประสิทธิภาพและถูกลบออก
การเผยแพร่ลิงก์หมายความว่าคุณรองรับการทริกเกอร์จากแหล่งที่มาที่ไม่น่าเชื่อถือ สำหรับการดำเนินการที่ลิงก์ไว้ คุณต้องยืนยันกับผู้ใช้อย่างชัดแจ้งก่อนที่จะดำเนินการใดๆ ก็ตาม ตัวอย่างเช่น การดำเนินการที่ปิดอุปกรณ์สมาร์ทโฮมจะแสดงข้อความแจ้งผู้ใช้ว่า "แน่ใจไหมว่าต้องการปิด
$applianceName
"ในบริบทนี้ การกระทำในชีวิตจริงคือการกระทำใดๆ ก็ตามที่ส่งผลต่อบริการ ข้อมูล อุปกรณ์ เครือข่าย คอมพิวเตอร์ หรือ API ของผู้ใช้ ตัวอย่างเช่น การส่งอีเมล ทำธุรกรรม เปลี่ยนสถานะอุปกรณ์สมาร์ทโฮม การสร้างการสมัครใช้บริการ หรืออัปเดตเนื้อหา