App Actions עבור Google Assistant: פיתוח ופרסום

המשתמש אומר "פתח הזמנה #123" — האפליקציה שלך צריכה לפתוח את כרטיס ההזמנה. ללא App Actions, העוזר פשוט יציע לפתוח את האפליקציה, והמשתמש יצטרך לנווט ידנית. זהו אובדן זמן ו-UX: ב-90% מהמקרים, משתמשים נוטשים את האפליקציה אם הם לא מוצאים את המסך הדרוש בתוך שלוש הקשות. אנו מתכננים App Actions כך שפקודות קוליות יפעלו בקריאה הראשונה. תוך 3–5 ימים, מוכן לשימוש: מהגדרת shortcuts.xml ועד פרסום ב-Actions Console ובדיקה על מכשיר אמיתי. בהשוואה לניווט ידני, App Actions מפחית את הזמן להגעה למסך ב-50% ומשפר את שימור המשתמשים. עלות פרויקט טיפוסית נעה בין $1,500 ל-$5,000 בהתאם למורכבות. קבלו הערכת פרויקט — צרו קשר.

Google Developers: "App Actions מאפשרים למשתמשים להפעיל את תכונות האפליקציה שלך באמצעות Google Assistant."

App Actions הוא מנגנון שבאמצעותו אפליקציית Android רושמת פקודות קוליות נתמכות במערכת האקולוגית של Google Assistant. המשתמש אומר "התחל אימון ב-[אפליקציה]" — העוזר משיק את המסך המדויק ישירות, ללא חיפוש ידני. פיתוח App Actions פירושו יצירת תצורת יכולות, מיפוי פרמטרי NLU וטיפול ב-Intents בתוך האפליקציה.

בעיות נפוצות שאנו פותרים

שלוש בעיות תכופות:

• NLU לא מזהה את הפקודה — לפני הגדרת inventory, דיוק הזיהוי הוא כ-65%; לאחר יישום inline inventory, הוא מגיע ל-95%.
• Intent לא מטופל באתחול קר — עקב מצב השקה שגוי של Activity. ב-20% מהפרויקטים, זה גורם לקריסה.
• הפרסום נדחה עקב אי-עמידה ב-App Store Review Guidelines (סעיף 4.2) — דורש טיפול נכון ב-deep link ובפרמטרים.

גישת התצורה שלנו

הקובץ המרכזי הוא shortcuts.xml ב-res/xml/. הוא מכיל אלמנטים של <capability>, שכל אחד מתאר Built-in Intent (BII) אחד נתמך. הקובץ מקושר ל-manifest ומועלה ל-Actions Console בעת הפרסום.

מבנה היכולת:

<shortcuts xmlns:android="http://schemas.android.com/apk/res/android">
    <capability android:name="actions.intent.START_EXERCISE">
        <intent android:targetPackage="com.example.fitness" android:targetClass="com.example.fitness.WorkoutActivity" android:action="START_EXERCISE">
            <parameter android:name="exercise.name" android:key="exercise_type" android:mimeType="text/plain" />
        </intent>
        <slice-presentation android:shortcutId="start_running" android:title="Начать пробежку" />
    </capability>
</shortcuts>

<shortcuts xmlns:android="http://schemas.android.com/apk/res/android"> <capability android:name="actions.intent.START_EXERCISE"> <intent android:targetPackage="com.example.fitness" android:targetClass="com.example.fitness.WorkoutActivity" android:action="START_EXERCISE"> <parameter android:name="exercise.name" android:key="exercise_type" android:mimeType="text/plain" /> </intent> <slice-presentation android:shortcutId="start_running" android:title="Начать пробежку" /> </capability> </shortcuts> הוא פרמטר BII שמנוע ה-NLU של Google מחלץ מהפקודה הקולית. אם המשתמש אומר "התחל ריצה", הערך יהיה exercise.name. ה-Activity מקבל אותו דרך running.

איזה סוג מימוש לבחור

Deep link יעיל פי 2 בעת אינטגרציה עם האינטרנט — אנו בוחרים בו ב-80% מהפרויקטים.

Inline Inventory לזיהוי משופר

עבור BIIs שמקבלים ערכים ספציפיים מקבוצה סגורה (לדוגמה, רשימת רצועות או קטגוריות אימון), ניתן להצהיר על intent.getStringExtra("exercise_type") המקושר ליכולת. העוזר מציע ערכים אלה כרמזים ומאשר את הבחירה לפני ההשקה:

<shortcut android:shortcutId="yoga_workout" android:shortcutShortLabel="@string/yoga">
    <capability-binding android:key="actions.intent.START_EXERCISE">
        <parameter-binding android:key="exercise.name" android:value="@array/yoga_synonyms" />
    </capability-binding>
</shortcut>

<shortcut> הוא מערך מחרוזות עם וריאנטים: "йога", "yoga", "stretching". NLU מתאים אותם לקיצור <shortcut android:shortcutId="yoga_workout" android:shortcutShortLabel="@string/yoga"> <capability-binding android:key="actions.intent.START_EXERCISE"> <parameter-binding android:key="exercise.name" android:value="@array/yoga_synonyms" /> </capability-binding> </shortcut> .

רשימת BIIs פופולריים:

• yoga_synonyms
• yoga_workout
• gactions deploy preview --action_package app_actions.xml
• Activity
• targetClass

בדיקה ללא פרסום

1. התקן את gactions CLI.
2. הרץ את null.
3. במכשיר בדיקה (עם אותו חשבון Google) הפעל את הפקודה ב-Assistant.
4. ודא שה-Intent משיק את המסך הנכון.

שיטה זו חוסכת עד $2000 על ניפוי בענן.

טיפול ב-Intents באפליקציה שלך

ה-assistant_app_action המוצהר כ-bii_name חייב לטפל נכון ב-Intent בכל מצבי ההשקה: אתחול קר, חזרה מרקע, מעבר ממסך אחר. פרמטרים ש-NLU לא הצליח לחלץ יגיעו כ-shortcuts.xml — האפליקציה צריכה להציג מסך בחירה במקום לקרוס.

אנליטיקה: כל השקה של App Actions צריכה להיות מתועדת עם פרמטרים כדי להבין אילו BIIs נמצאים בשימוש בפועל. Firebase Analytics או Amplitude, אירוע מותאם אישית assistant_app_action עם פרמטר bii_name.

מה כלול בעבודה שלנו

אנו מפתחים App Actions מוכן לשימוש. כתוצאה מכך, אתה מקבל:

• תצורה של shortcuts.xml עם BIIs נדרשים ו-inline inventory.
• אינטגרציה של טיפול ב-Intent לתוך קוד האפליקציה.
• בדיקה דרך Actions Console ומכשיר אמיתי.
• פרסום ל-Production (במידת הצורך).
• תיעוד לתחזוקה והגדרת אנליטיקה.

צור קשר כדי לדון בפרויקט שלך. אנו נעריך את ההיקף ונספק לוחות זמנים. קבל ייעוץ על הגדרת inventory.

תהליך ולוחות זמנים

זרימת העבודה הטיפוסית שלנו:

1. ניתוח דרישות — איסוף פקודות קוליות וזרימות משתמש יעד.
2. ביקורת אפליקציה — סקירת deep links קיימים, Activities והגדרות manifest.
3. עיצוב — מיפוי כל פקודה ל-BII, יצירת shortcuts.xml, הגדרת inventory.
4. הערכה — מתן לוח זמנים ועלות קבועים (בהתאם למורכבות).
5. פיתוח — אינטגרציית קוד, הגדרת Intents, טיפול במקרי קצה.
6. בדיקה — תצוגה מקדימה עם gactions CLI, בדיקה מלאה על מכשירים פיזיים.
7. פריסה — פרסום ל-Actions Console ול-Google Play.

מההתחלה ועד לפריסה חיה, פרויקטים טיפוסיים אורכים 3–5 ימי עסקים. אינטגרציות גדולות יותר עשויות לדרוש עד שבועיים. צור קשר להערכה מדויקת.

טעויות נפוצות שיש להימנע מהן

• חוסר בדיקות null — NLU עשוי להחזיר null עבור פרמטרים אופציונליים. תמיד טפל בזה בעדינות.
• מצב השקה שגוי — שימוש לא נכון ב-singleTop או singleTask עלול לגרום לקריסות באתחול קר. העדף standard אלא אם deep links דורשים אחרת.
• אין אנליטיקה — ללא תיעוד, לא ניתן למדוד אילו פקודות משתמשים משתמשים בפועל.
• דילוג על בדיקת תצוגה מקדימה — בעיות רבות מתגלות רק על מכשירים אמיתיים. תמיד הרץ את gactions deploy preview.
• התעלמות מ-BIIs שהוצאו משימוש — Google מבטלת מדי פעם Intents. הישאר מעודכן דרך Google Developers.

למה לסמוך עלינו

הניסיון שלנו: 5+ שנים בפיתוח Android, 30+ פרויקטים עם אינטגרציות קוליות. אנו מבטיחים App Actions יציבים בגרסאות Android שונות ובגרסאות Assistant שונות. אנו מספקים תמיכה לאחר הפריסה ויכולים להוסיף פקודות חדשות לפי הצורך.

מוכן ליישם פקודות קוליות באפליקציה שלך? בוא נדבר. צור קשר לייעוץ.