פיתוח פעולות באפליקציה

התכונה 'פעולות באפליקציה' מאפשרת למשתמשים להפעיל פונקציונליות באפליקציה ל-Android באמצעות בקשה Google Assistant או באמצעות מקשי הקיצור ל-Android שהוצעו על ידי Assistant. אלה השלבים העיקריים להרחבת האפליקציה ל-Android באמצעות פעולות באפליקציה:

1. מזהים את הפונקציונליות באפליקציה שרוצים להפעיל ואת הכוונה המובנית (BII) התואמת.
2. יש לספק את פרטי הביצוע של ה-BII.
3. שולחים ל-Assistant את קיצורי הדרך של פעולת האפליקציה.
4. הצגת תצוגה מקדימה של פעולות האפליקציה במכשיר לבדיקה.
5. יוצרים גרסת בדיקה של האפליקציה.
6. שליחת בקשה לבדיקה ולפריסה של 'פעולות באפליקציה'.

אפשר גם להגדיר קיצורי דרך דינמיים ולספק אותם ל-Assistant כדי שהיא תוכל להציע אותם למשתמשים. יצירת פעולה באפליקציה באמצעות אפליקציה לדוגמה: בהתאם להנחיות של App Actions Codelab.

זהירות: עקב הגבלות רגולטוריות, אפליקציות שמשתתפות בתוכנית התוכנית לתוכנית 'לכל המשפחה' (DFF) אסור ליצור פעולות באפליקציה. אם תשלחו פעולה באפליקציה לבדיקה של אפליקציה שכלולה בתוכנית DFF, לא ניתנת לאישור.

הדרישות

לפני שמתחילים לפתח את האפליקציה 'פעולות באפליקציה', צריך לוודא שאתם והאפליקציה עומדים בדרישות הדרישות הבאות:

• נדרש חשבון Google עם גישה אל Google Play Console.
• צריך לפרסם את האפליקציה בחנות Google Play, כי 'פעולות באפליקציה' הן זמינה רק לאפליקציות שמתפרסמות שם. בנוסף, צריך לוודא שהאפליקציה לא מיועד לשימוש בפרופיל עבודה, כי אין תמיכה בפעולות באפליקציה באמצעות Google Play לארגונים.
• יש צורך במכשיר פיזי או וירטואלי כדי לבדוק את הפעולות באפליקציה.
• נדרשת הגרסה האחרונה של Android Studio.
• עליך להשתמש באותו חשבון Google כדי להיכנס ל-Android Studio, אפליקציית Google במכשיר הבדיקה ו-Google Play Console.
• צריך להגדיר את Assistant במכשיר הבדיקה ולבדוק אותה על ידי ביצוע מגע & לוחצים לחיצה ארוכה על לחצן דף הבית.

התאמה לאובייקטים מובנים של Intent בעזרת תכונות האפליקציה

זיהוי הפונקציונליות באפליקציה ל-Android שהמשתמשים עשויים לרצות לעבור אליהם באמצעות בקשה קולית ולבדוק את חומר עזר מובנה של Intent כדי למצוא יעדי BII מתאימים במיוחד למקרה כזה. מודלים של שאילתות משתמשים מייצגים את המשימות שהמשתמשים רוצים לבצע, לכן כדאי לחפש מודלים של שאילתות משתמשים שתואמים לפונקציונליות המרכזית ולתהליכי השימוש באפליקציה.

יש BIIs נפוצים שאפשר להשתמש בהם כמעט בכל אפליקציה ל-Android. לדוגמה, אפשר להרחיב את החיפוש באפליקציה ל-Assistant באמצעות ה-BII‏ actions.intent.GET_THING, או לאפשר למשתמשים להפעיל תכונות ספציפיות באפליקציה באמצעות הקול שלהם על ידי הטמעת ה-BII‏ actions.intent.OPEN_APP_FEATURE.

חשוב: כחלק מדרישות הפריסה של 'פעולות באפליקציה', אפליקציות כוללים פונקציית חיפוש, חייבים ליישם את הפונקציה actions.intent.GET_THING BII כדי שמשתמשים יוכלו לחפש תוכן באפליקציה שלך באמצעות פקודות קוליות נפוצות כמו "Ok Google, search for running shoes on אפליקציה לדוגמה."

יש גם מזהי BII שמאפשרים תרחישים לדוגמה אנכיים או ספציפיים לקטגוריה. עבור לדוגמה, אפליקציה לאימון כושר עשויה להשתמש בactions.intent.START_EXERCISE BII.

הערה: במקרים שבהם אין BII לפונקציונליות של האפליקציה, תוכלו להשתמש קהל בהתאמה אישית עם כוונת רכישה שנועד להרחיב את האפליקציה באמצעות 'פעולות באפליקציה'.

כדי להבטיח חוויית משתמש מעולה ולמנוע עיכובים אפשריים באישור, חשוב לוודא שכל BII שאתם מטמיעים רלוונטי לפונקציונליות שלכם באפליקציה.

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

מסירת פרטי השלמה לכוונות מובנות

רוב הפיתוח של פעולה באפליקציה הוא הצהרה על יכולת shortcuts.xml קובץ המשאבים של האפליקציה ל-Android שבה לציין את ה-BII שנבחר ואת אופן מילוי ההזמנות המתאים. BII יוצר מודל שאילתה של המשתמש, וכוונת מילוי ההזמנה מאפשרת ל-Assistant מידע על אופן ביצוע המשימה.

בקובץ shortcuts.xml, ממשקי ה-BII מיוצגים בתור <capability> וכל מילוי הזמנות מיוצג כרכיב <intent>:

<shortcuts>
    <capability android:name="actions.intent.START_EXERCISE">
        <intent
            android:action="android.intent.action.VIEW"
            android:targetPackage="com.example.app"
            android:targetClass="com.example.app.browse">
            <parameter
                android:name="exercise.name"
                android:key="exercise_name">
            </parameter>
        </intent>
    </capability>

הערה: ספריית Jetpack androidx.core:core:1.6.0 (ואילך) נדרשת ב-Android כדי להימנע משגיאות הידור במהלך הגדרת יכולות של 'פעולות באפליקציה' shortcuts.xml. מידע נוסף מופיע במאמר תחילת העבודה עם Android Jetpack.

ברוב ה-BIIs, אפשר לחלץ פרמטרים של כוונת הרכישה משאילתת המשתמש על סמך ישויות של schema.org. לאחר מכן האפליקציה משתמשת ב-BII האלה כדי להפנות משתמשים ליכולת שנבחרה. לדוגמה, לפני קוד ממפה את הפרמטר BII exercise.name ל-Android exercise_name intent.

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

<shortcuts>
    <capability android:name="actions.intent.START_EXERCISE">
        <intent android:action="android.intent.action.VIEW">
            <url-template android:value="myexerciseapp://start{?exercise_name}" />
            <parameter android:name="exercise.name"
                android:key="exercise_name"
                android:mimeType="text/*">
            </parameter>
        </intent>
    </capability>
</shortcuts>

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

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

יישום הכוונה המובנית של GET_THING

אם האפליקציה כוללת פונקציית חיפוש, צריך להטמיע את הפונקציה actions.intent.GET_THING BII לפונקציה הזו. לאחר מכן, Assistant תוכל להעביר את המשתמשים לפונקציית החיפוש של האפליקציה כדי לקבל תוצאות בתוך האפליקציה כשהם ייצרו שאילתות כמו "Ok Google, חיפוש 'דבר לדוגמה' באפליקציית 'דוגמה'".

בקובץ shortcuts.xml, מטמיעים את המאפיין <capability> עבור ה-BII של actions.intent.GET_THING להטמיע כל BII אחר. אפשר להשתמש בכמה מילוי הזמנות למטרות GET_THING כל עוד מספקים לפחות מילוי הזמנה אחד שעובר את המשתמש שאילתה לפונקציית החיפוש של האפליקציה.

דוגמה להוספת ה-BII של actions.intent.GET_THING shortcuts.xml:

  <capability android:name="actions.intent.GET_THING">
    <intent
      android:targetPackage="com.example.myapp"
      android:targetClass="com.example.myapp.MySearchActivity">
      <parameter android:name="thing.name" android:key="query" />
    </intent>
  </capability>

בחיפוש שלך, Activity, עליך לחלץ את שאילתת החיפוש מהנתונים הנוספים של intent ומעבירים אותו לפונקציית החיפוש של האפליקציה. בקוד הקודם, שאילתת חיפוש, מועברת כמפתח query, ממופה אל "thing.name" BII. לאחר מכן, בצעו חיפוש עם השאילתה ותציגו את התוצאות בממשק המשתמש.

אופציונלי: ניתן להעביר ל-Assistant מקשי קיצור לפעולה באפליקציה

אחרי שתגדירו יכולת עבור הפעולה שלכם, משתמשים יוכלו להפעיל כדי לעשות את זה, אומרים משהו כמו "Ok Google, order a פיצה on Example App". Assistant יכולה להציע למשתמשים קיצורי דרך ל-Android לפעולות שלך וכך לאפשר להם לגלות את הפעולות שלכם ולשחזר אותן לבצע אותן שוב. עוזר/ת אישי/ת יכול להציע קיצורי דרך דינמיים וגם סטטיים.

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

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

תצוגה מקדימה של 'פעולות באפליקציה'

במהלך הפיתוח והבדיקה, משתמשים הפלאגין של Google Assistant ל-Android Studio כדי לבדוק אם 'פעולות באפליקציה' מתאימות לאפליקציה שלכם. הפלאגין יוצר תצוגה מקדימה של 'פעולות באפליקציה' ב-Assistant בחשבון Google. בעזרת כלי הבדיקה אפשר לבדוק במכשיר בדיקה פיזי או באמולטור של נתונים, באמצעות אספקת קלט של BII הפרמטרים שאתם מצפים לקבל מהמשתמשים.

הערה: אפשר גם להוסיף עוד בודקים לשילוב של פעולות באפליקציה, גם אם הם לא משתפים את אותו חשבון Play Console. שפת תרגום למידע נוסף: הוספת בודקים.

בזמן הצפייה בתצוגה מקדימה של הפעולות באפליקציה, אפשר להפעיל שאילתות באמצעות הקול במכשיר. פונקציונליות זו זמינה רק לשאילתות המפורטות מסמך עזר של BII לפעולות באפליקציה. שימוש בקול לצורך הדגמה בלבד, ולא לצורך בדיקה רגילה.

הערה: כלי הבדיקה של פעולות באפליקציה תומך בבדיקת מודעות BIi רק בלוקאל en-US, אלא אם במקור המידע המובנה לגבי הכוונה תוארו שאילתות לדוגמה ללוקאלים אחרים.

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

יצירת גרסה לבדיקה

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

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

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

שליחת בקשה לבדיקה ולפריסה של 'פעולות באפליקציה'

פעולות באפליקציה לא זמינות למשתמשים באפליקציות שפרסמת או בבדיקה פתוחה לציבור עד שהם ייבדקו ויאושרו. בדיקת הפעולות באפליקציה לא משפיעה על סטטוס הבדיקה והפריסה של האפליקציות ל-Android ב-Google Play. גם אם האפליקציה שהגשת אושרה ותפורסם בחנות Play, יכול להיות ש-Google בודקת את shortcuts.xml. פעולות באפליקציה לא עובדות עבור משתמשי קצה עד שהבדיקה הזו תאושר.

כאשר פורסים את האפליקציה, הפעולות באפליקציה נשארות מופעלות. אבל, לפעמים הגרסאות שנפרסו מחדש כפופות לבדיקה של Google. אם הגרסה החדשה לא פועל כראוי או מכיל הפרות מדיניות, Google שומרת לעצמה את הזכות משביתים את 'פעולות באפליקציה' עבור האפליקציה.

כדי לשלוח את הפעולות באפליקציה לבדיקה:

1. יש לאשר את התנאים וההגבלות של 'פעולות באפליקציה' ב-Google Play Console (הגדרות מתקדמות > פעולות באפליקציה):

   

2. מעלים את האפליקציה, שמכילה את shortcuts.xml, אל Google Play Console כרגיל לפרסום.

3. אחרי שתעלו את האפליקציה ל-Play Console, Google תיצור איתכם קשר ב כתובת אימייל בחשבון Play Console עם מידע נוסף על הסטטוס של האפליקציה בדיקת פעולות. אפשר גם ליצור קשר עם התמיכה למפתחים של Assistant לשאלות לגבי סטטוס הבדיקה של הפעולות באפליקציה. בטופס יצירת הקשר, מציינים את מזהה חבילת האפליקציה ובוחרים באפשרות בדיקת פעולות באפליקציה בתיבה איך נוכל לעזור לך?.

הערה: אם האפליקציה שלך מוגבלת על סמך פרטי הכניסה, צריך לספק בדיקת ההתחברות באמצעות שליחת האפליקציה. כדי לספק את פרטי הכניסה לבדיקה, צריך לבחור את האפליקציה ב: ב-Play Console, עוברים אל מדיניות > תוכן האפליקציה, ולפעול בהתאם מפורטות הוראות בנושא גישה לאפליקציות.

אופציונלי: בדיקת קישורי העומק של הפעילות

כדי להשתמש בקישור עומק להפעלת Activity באמצעות פעולה באפליקציה, Activity צריך להיות מוגדרים עם כתובות URL של קישורי עומק ומסנן Intent תואם. את קובץ המניפסט של האפליקציה ל-Android.

הערה: קישור העומק יכול להתבסס על כתובות URL של קישורים לאפליקציה, כתובות URL שמבוססות על כוונת רכישה או סכמות בהתאמה אישית, כמו myapp://do.thing/param=value.

כדי לבדוק שהפעילויות שלך נגישות וניתן להפעיל אותן באמצעות כדי לבצע פעולות באפליקציה באמצעות קישורי עומק, מריצים את הפקודה הבאה של adb:

$ adb shell am start -a android.intent.action.VIEW -d "AppLinksURL"

לדוגמה:

$ adb shell am start -a android.intent.action.VIEW -d "https://www.example.com/deeplink"

אם הפעילות לא מופעלת כראוי באמצעות הפקודה adb, אז כדאי לבדוק את הדברים הבאים:

• בקובץ המניפסט של האפליקציה, הפעילות מכילה android:exported=true, לכן היא יכולה תושק באמצעות Intent מ-Google Assistant.
• אם אתם משתמשים בכתובות URL של קישורים לאפליקציות, עליכם לפעול לפי כל השלבים שמפורטים הטיפול בקישורים לאפליקציות ל-Android.

המדיניות בנושא קמפיינים לעידוד הפעולות באפליקציה

פעולות באפליקציה צריכות לעמוד בדרישות של מדיניות ספציפית כדי להבטיח שהמשתמשים שמפעילים אותן יקבלו את החוויה הרצויה. יש לעיין בכללי המדיניות האלה לפני לשלוח את האפליקציות שלכם כדי לספק את חוויית המשתמש הטובה ביותר ולהימנע מ-Play עיכובים או דחיות של בדיקות בחנות.

• הפניית משתמשים לתוכן המיועד על ידי המשתמשים

  פרמטרים מובנים של Intent (BII) ו/או פרמטרים מובנים של פעולה באפליקציה חייבים להפנות את המשתמשים רק אל הפעולה הרלוונטית ושהמשתמש מכוון לעשות. זה יכול לכלול תוכן מתוך האפליקציה, תוכן של האתר, או מידע שמוצג בפרוסות או בווידג'טים כל עוד זו הייתה הכוונה של המשתמש.

  לדוגמה, הטמעות של ה-BII של START_EXERCISE להתחיל פעילות גופנית מסוג מסוים, כמו ריצה או שחייה. היחיד חריג למדיניות הזו הוא כאשר ה-BII של OPEN_APP_FEATURE מפנה משתמשים למסך הבית של האפליקציה.

• הטמעת מדדי BI רלוונטיים של פעולות באפליקציה

  ה-BIIs שמופעלים צריכים להיות קשורים ישירות לתוכן ולפונקציונליות של האפליקציה.

  לדוגמה, אם האפליקציה מסווגת בקטגוריה 'חנות Play תקשורת', לא מטמיעים את ה-BII של START_EXERCISE, מומלץ לאפליקציות בקטגוריה Heath ו-Fitness.

• הטמעה של קהלים רלוונטיים בהתאמה אישית עם כוונת רכישה

  שאילתות מוגדרות לכוונות מודעה בהתאמה אישית קשורות לתוכן של האפליקציה ול החדשה. דוגמה להפרה אפשרית של המדיניות יוצרת את ה-Intent custom.action.intent.GET_RECIPE עם דפוס שאילתה משויך "Show me burrito recipes" לאפליקציה הקטגוריה 'תחבורה בחנות Play'.

---