ลิงก์ Assistant

คุณสร้าง URL ที่ลิงก์ไปยัง Intent ที่เฉพาะเจาะจงของการดำเนินการได้โดยตรง ระบบจะนำผู้ใช้ที่คลิกลิงก์ Assistant (ก่อนหน้านี้เรียกว่าลิงก์การดำเนินการ) ในเว็บหรือเบราว์เซอร์ในอุปกรณ์เคลื่อนที่ไปยัง Assistant ในอุปกรณ์ของผู้ใช้ ซึ่งจะโต้ตอบกับการดำเนินการของคุณโดยตรง

ลิงก์ Assistant แตกต่างจากเว็บลิงก์ไดเรกทอรี ซึ่งจะส่งผู้ใช้ไปยังหน้าการดำเนินการของคุณในไดเรกทอรี Assistant

ลิงก์ Assistant อาจมีประโยชน์ในสถานการณ์ต่อไปนี้

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

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

หากต้องการสร้าง URL สำหรับการดำเนินการ ให้ทำตามขั้นตอนต่อไปนี้

  1. ในคอนโซล Actions ให้ไปที่ติดตั้งใช้งาน > ลิงก์ Assistant
  2. สําหรับ Intent ให้เลือก Intent ที่ต้องการสร้างลิงก์ให้
  3. เปิดใช้ตัวเลือกคุณต้องการเปิดใช้การลิงก์กับ intent_name หรือไม่
  4. (ไม่บังคับ) ในส่วนพารามิเตอร์แคมเปญ ให้ป้อนข้อมูลที่คุณต้องการบันทึกเพิ่มเติมไว้ในลิงก์เป็นพารามิเตอร์ของ URL
  5. (ไม่บังคับ) ป้อนชื่อลิงก์ ใช้ชื่อนี้เพื่ออธิบายสิ่งที่การดำเนินการทำ ตัวอย่างเช่น หากการดำเนินการของคุณนำผู้ใช้ไปตามขั้นตอนการทำธุรกรรมเพื่อซื้อตั๋วคอนเสิร์ต ชื่อลิงก์ของคุณอาจเป็น "ซื้อตั๋วคอนเสิร์ต"

หลังจากป้อนข้อมูลแล้ว คุณจะดูและคัดลอก URL ที่สร้างขึ้นหรือข้อมูลโค้ดที่สร้างขึ้นสำหรับลิงก์ Assistant ได้ ใช้ลิงก์ Assistant ได้ทุกที่ที่คุณต้องการ นำผู้ใช้ไปสู่การดำเนินการที่เจาะจงนี้

คุณสามารถทดสอบลิงก์ Assistant สำหรับ Intent (หลักหรือที่กำหนดเอง โดยมีหรือไม่มีพารามิเตอร์) ผ่านเครื่องจำลองหรือในอุปกรณ์ได้

หากต้องการทดสอบลิงก์ Assistant ในอุปกรณ์ ให้ทำตามขั้นตอนต่อไปนี้

  1. สร้างลิงก์ Assistant ในคอนโซล Actions
  2. ส่งลิงก์ Assistant เป็น URL ให้ตัวคุณเองในอีเมล ข้อความแชท หรือรูปแบบอื่นๆ
  3. ในอุปกรณ์ที่พร้อมใช้งาน Assistant ให้ลงชื่อเข้าใช้ Assistant ด้วยบัญชีเดียวกับที่คุณใช้สร้างโปรเจ็กต์ Actions
  4. ในอุปกรณ์เดียวกัน ให้คลิกลิงก์ 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 มีดังนี้

https://assistant.google.com/services/invoke[/$action_id][?intent=$intent&param.$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

หากลิงก์ 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&param.name=%22ExampleGame%22

สำหรับ Intent ของผู้ใช้ Google Assistant จะแยกเฉพาะพารามิเตอร์ที่การดำเนินการของคุณกำหนด โดยเป็นส่วนหนึ่งของ Intent และทิ้งพารามิเตอร์อื่นๆ

ตัวอย่างต่อไปนี้แสดงวิธีระบุ URL ลิงก์ Assistant ที่มีความตั้งใจของผู้ใช้

https://assistant.google.com/services/invoke/uid/0000001f575305a0?intent=NEWS_UPDATE_DEEP_LINK&param.topic=sports

สำหรับ URL ตัวอย่างด้านบน ใน AppRequest Assistant จะเพิ่มออบเจ็กต์ JSON ดังนี้

argument {
  name: 'topic',
  raw_text: 'sports',
  text_value: 'sports',
}

พารามิเตอร์ 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',
}

ลิงก์ Assistant แบบสมบูรณ์ให้คุณเพิ่มการค้นพบการดำเนินการของคุณผ่านทางเว็บไซต์โดยใช้ help.js ผู้ใช้สามารถลองใช้การดำเนินการของคุณ รวมทั้งลิงก์บัญชี Google กับบริการของคุณโดยใช้การลิงก์บัญชี

เมื่อผู้ใช้เข้าชมเว็บไซต์ ก็จะเห็นปุ่ม "ลองใช้ Google Assistant" ซึ่งจะเรียกให้แสดงขั้นตอนลิงก์ Rich Assistant

การเปิดใช้การลิงก์บัญชีสำหรับการดําเนินการช่วยให้ผู้ใช้เข้าถึงการดําเนินการของคุณได้ในอุปกรณ์ที่พร้อมใช้งาน Assistant เครื่องใดก็ได้ นอกจากนี้ ผู้ใช้ยังลิงก์บัญชีกับบริการของคุณกับบัญชี Google ได้ด้วย ซึ่งจะมอบประสบการณ์การใช้งานที่ปรับเปลี่ยนให้เหมาะกับลูกค้ามากขึ้น

เมื่อใช้กับการลิงก์บัญชี ลิงก์ Rich Assistant จะใช้ URL การให้สิทธิ์ซึ่งตั้งค่าไว้ในโปรเจ็กต์ในคอนโซลการดำเนินการ สำหรับข้อมูลเพิ่มเติม โปรดดูเอกสารการลิงก์บัญชี

ข้อกำหนดเบื้องต้น

หากต้องการใช้ลิงก์ Rich Assistant คุณต้องมีสิ่งต่อไปนี้

การพัฒนาในท้องถิ่น

หากต้องการใส่ลิงก์ Assistant แบบสมบูรณ์ในเว็บไซต์ ให้ทําตามขั้นตอนต่อไปนี้

  1. ใส่ไลบรารี JavaScript ต่อไปนี้ในหน้าเว็บของคุณ โดยแทนที่ <PROJECT_ID> ด้วยรหัสโปรเจ็กต์ Actions:

    <script async
src="https://actions.google.com/api/assist.js?projectId={PROJECT_ID}&dev=true">
</script>

  2. เพิ่มแท็ก 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> เมื่อคุณใช้แท็กนี้ ลิงก์จะเปิดใช้งานโดยไม่มีผู้ใช้เข้าชมครั้งแรก โดยที่ผู้ใช้จะไม่เลือกปุ่มในบรรทัด

  1. เพิ่ม 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>

  2. วางแท็ก <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 สมบูรณ์มีดังนี้

  1. จดทะเบียนสาธารณสมบัติในคอนโซลการดำเนินการในส่วนทำให้ใช้งานได้ > การยืนยันแบรนด์ > เชื่อมต่อเว็บไซต์

  2. นำพารามิเตอร์การค้นหา dev=true ออกจากสคริปต์

    <script async
src="https://actions.google.com/api/assist.js?projectId={PROJECT_ID}">
</script>

ข้อจำกัดและแนวทางปฏิบัติแนะนำ

ระบบจะใช้ข้อจำกัดและแนวทางปฏิบัติแนะนำต่อไปนี้เพื่อให้สามารถเผยแพร่และอ้างอิง URL ของลิงก์ Assistant นอกไดเรกทอรีหรือบริการอื่นๆ ของ Google ได้

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

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

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