התכונה 'פעולות שיחה' הוצאה משימוש ב-13 ביוני 2023. כאן תוכלו לקרוא מידע נוסף על ההוצאה משימוש של 'פעולות שיחה'.

דף זה תורגם על ידי Cloud Translation API.

קישורים ל-Assistant

אפשר ליצור כתובת URL שמקשרת ישירות ל-Intent ספציפי של הפעולה. משתמשים שלוחצים על קישור ל-Assistant (שנקרא בעבר קישורי פעולות) מופנים ל-Assistant במכשיר שלהם, ושם תהיה להם אינטראקציה ישירה עם הפעולה.

קישורים ל-Assistant שונים מקישורים לדפי אינטרנט של ספרייה, ששולחים את המשתמשים לדף של הפעולה בספריית Assistant.

הנה כמה מצבים שבהם קישורים ל-Assistant יכולים להיות שימושיים:

קישור משתמשים להנחיות קוליות מאתר הדרכה.
קישור משתמשים לחוויית תמיכת לקוחות מדף עזרה.
קישור משתמשים לכוונת עדכון כדי שיוכלו להביע הסכמה לעדכונים העתידיים שלכם.

יצירת קישור ל-Assistant

ניתן ליצור קישורים ל-Assistant מתוך הפרויקט שלך במסוף Actions. הקישורים ל-Assistant זמינים בכל ערוצי הפריסה (אלפא, בטא וייצור). לדוגמה, אם הקישור ל-Assistant מופעל בגרסת האלפא של הפעולה, הקישור יהיה זמין לבודקי אלפא.

כדי ליצור כתובת אתר עבור פעולה, בצע את השלבים הבאים:

במסוף הפעולות, עוברים אל פריסה > קישורים ל-Assistant.
בשדה Intent, בוחרים את Intent שעבורו רוצים ליצור קישור.
מפעילים את האפשרות רוצה להפעיל את הקישור עבור Intent_name?
(אופציונלי) בקטע Campaign parameters (פרמטרים של קמפיין), מזינים מידע שרוצים לתעד בקישור בנוסף כפרמטרים של כתובת אתר.
(אופציונלי) מזינים שם קישור. השתמשו בכותרת הזו כדי לתאר מה הפעולה עושה. לדוגמה, אם הפעולה מעבירה את המשתמש לתהליך עסקה כדי לקנות כרטיסים להופעה, שם הקישור יכול להיות 'רכישת כרטיסים להופעות'.

אחרי שתזינו את הפרטים, תוכלו לראות ולהעתיק את כתובת ה-URL שנוצרה או את קטע הקוד שנוצר עבור הקישור ל-Assistant. אפשר להשתמש בקישור ל-Assistant בכל מקום שבו רוצים להפנות משתמשים לפעולה הספציפית הזו.

קישורים ל-Assistant לבדיקה

אפשר לבדוק קישורים ל-Assistant לכל Intent (ראשי או בהתאמה אישית, עם או בלי פרמטרים) באמצעות הסימולטור או במכשיר.

כדי לבדוק את הקישור ל-Assistant במכשיר, פועלים לפי השלבים הבאים:

יוצרים את הקישור ל-Assistant במסוף Actions.
שולחים את הקישור ל-Assistant ככתובת URL באימייל, בהודעת צ'אט או בפורמט אחר.
במכשיר עם Assistant מובנית, נכנסים ל-Assistant עם אותו חשבון שבו השתמשתם כדי ליצור את פרויקט הפעולות.
באותו מכשיר, לוחצים על הקישור ל-Assistant ששלחתם לעצמכם.

אחרי שמאשרים שהקישור ל-Assistant פועל כצפוי, צריך לפרוס מחדש את הפעולה כדי שהקישור יהיה זמין למשתמשים.

פרמטרים של קישור ל-Assistant

קישורים ל-Assistant יכולים לכלול Intent ופרמטרים בכתובת ה-URL. בקטע Campaign parameters (פרמטרים של קמפיין) מוסיפים פרמטרים של קמפיינים.

כשקישור ל-Assistant לא מכיל פרמטרים נוספים, Google Assistant מקשרת ל-Intent MAIN (actions.intent.MAIN) של הפעולה באופן הבא:

אם לא הפעלת באופן מפורש את ה-Intent MAIN בקישור של Assistant, Assistant תתאים ל-Intent הראשי ללא פרמטרים, בדומה להתנהגות של Talk to 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&param.$param=$value][&$utm_param=$utm_value]

הפרמטרים של כתובת האתר שאפשר להגדיר מתוארים בטבלה הבאה:

פרמטר של כתובת URL	התיאור
`$action_id`	המזהה המספרי של הפעולה.
`$intent`	השם המלא של ה-Intent המובנה או של המשתמש.
`$param`	השם המלא של פרמטר ה-Intent שצוין בחבילת הפעולות.
`$value`	ערך מקודד של כתובת URL מהסוג שהוצהר עבור `$param` בחבילת הפעולות.
`$utm_param`	רשימה של סוג פרמטרים אחד או יותר של מנטר התנועה של Urchin. הערכים החוקיים כוללים: `utm_source`, `utm_medium`, `utm_campaign`, `utm_term` ו-`utm_content`.
`$utm_value`	ערך המחרוזת של הפרמטר 'מנטר התנועה של Urchin'.

כתובות URL של קישורים ל-Assistant עם כוונות מובנות

אם הקישור ל-Assistant מכיל אובייקט אובייקט מובנה (הכוונה מתחילה ב-actions.intent.), Google Assistant מנסה לחלץ את כל הפרמטרים המובנים של ה-Intent מכתובת ה-URL ומעבירה אותם לפעולה שלכם. המערכת מסירה פרמטרים ש-Assistant לא מבינה כפרמטרים מובנים של Intent.

לגבי פעולות שיחה, Assistant שולחת את הפרמטרים האלה למילוי הבקשה כחלק מההודעה AppRequest.

בדוגמה הבאה אפשר לראות איך לציין כתובת URL של קישור ל-Assistant, שכוללת Intent מובנה עם פרמטר Intent אחד:

https://assistant.google.com/services/invoke/uid/0000008ddd7eabec?intent=actions.intent.PLAY_GAME&param.name=%22ExampleGame%22

כתובות URL של קישורים ל-Assistant עם כוונות המשתמש

ל-Intents של משתמשים, 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',
}

כתובות URL של קישורים ל-Assistant עם פרמטרים של מנטר התנועה של Urchin

פרמטרים של מנטר התנועה של Urchin הם מחרוזות ש-Google Assistant שולחת לפעולה כשמשתמשים לוחצים על קישור ל-Assistant. בהמשך תוכלו להשתמש במידע שכלול במחרוזות האלה כדי לנתח נתונים.

הפרמטרים של מנטר התנועה של Urchin ש-Assistant שולחת אל הפעולה כוללים את הפרטים הבאים:

utm_source
utm_medium
utm_campaign
utm_term
utm_content

הדוגמה הבאה מראה איך לציין כתובת URL של קישור ל-Assistant שכוללת פרמטרים של מנטר התנועה של Urchin:

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 עוזרים לכם להגביר את הגילוי של הפעולה דרך האתר, באמצעות Assistant.js. המשתמשים יכולים לנסות את הפעולה, ולקשר את חשבון Google שלהם לשירות שלכם באמצעות קישור חשבונות.

כשמשתמש מבקר באתר שלכם, הוא רואה את הלחצן 'ניסיון עם Google Assistant', שמפעיל את תהליך הקישור של Rich Assistant.

הפעלת קישור החשבון לפעולה מאפשרת למשתמשים לגשת לפעולה בכל אחד מהמכשירים עם Assistant מובנית. בנוסף, משתמשים יכולים לקשר את החשבון שלהם לשירות שלך לחשבון Google שלהם, וכך ליהנות מחוויה ברמה גבוהה יותר של התאמה אישית.

כשמשתמשים בקישורים של Assistant עם קישור חשבונות, משתמשים בכתובת ה-URL של ההרשאה שלך, שמוגדרת בפרויקט במסוף Actions. מידע נוסף זמין במסמכי התיעוד בנושא קישור חשבונות.

דרישות מוקדמות

כדי להשתמש בקישורים של Rich Assistant, צריך את הדברים הבאים:

פרויקט פעולות.
הקישור ל-Assistant הופעל עבור הפעולה.
(אופציונלי) קישור חשבונות הופעל עבור הפעולה.

פיתוח מקומי

כדי לכלול קישור עשיר ל-Assistant באתר, יש לבצע את השלבים הבאים:

כוללים בדף את ספריית JavaScript הבאה ומחליפים את <PROJECT_ID> במזהה פרויקט הפעולות:
```
<script async
src="https://actions.google.com/api/assist.js?projectId={PROJECT_ID}&dev=true">
</script>
```
מוסיפים את תג ה-HTML הבא במקום כלשהו בדף. הפעולה הזו תטען את הלחצן המוטבע 'ניסיון עם Google Assistant':
```
<google-assistant-link-group>
  
  <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 לא מחובר לחשבון, הקישור הראשון ל-Assistant מפעיל את Assistant או מפנה אותו אוטומטית לדף של ספריית Assistant לביצוע הפעולה.

הפעלה יזומה

אם רוצים שתהליך הקישור ל-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>

Deployment (פריסה)

קישורים של Rich Assistant פועלים רק בדומיינים שבבעלותכם ושאומתו באמצעות Google. בפיתוח מקומי אפשר לעקוף את הדרישה הזו על ידי גישה לפרויקט הפעולות, התחברות לחשבון 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 של המשתמש. לדוגמה, שליחת אימייל, ביצוע עסקה, שינוי הסטטוס של מכשיר חשמל לבית חכם, יצירת מינוי או עדכון תוכן.