צפייה בנתוני Analytics וייצוא שלהם

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

הערה: המדדים מתעדכנים בערך כל 6 שעות, ולכן יכול להיות שיחלפו כמה שעות עד שתוכלו להשתמש בדף Analytics אחרי יצירת האפליקציה.

לפני שמתחילים

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

אם אין לכם מאגר נתונים, אתם צריכים לקשר מקור נתונים של Google או מקור נתונים של צד שלישי לאפליקציה.

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

אירועי משתמשים לניתוח

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

כדי לקבל את המדדים באפליקציות של Gemini Enterprise, צריך את אירועי המשתמש הבאים:

• חיפוש אירועים. נדרש לשיעור הקליקים.
• אירועים של צפייה בפריטים. נדרש לשיעור הקליקים.

המידע הבא משמש גם לניתוחים מסוימים:

• חשיפות. אתם יכולים לספק חשיפות (צפיות בפריטים או קליקים) שאפשר לשייך ל-Google על ידי הכללת הפריט המשויך ב-UserEvent.Documents כשמייבאים אירועים של משתמשים. הפרטים האלה נחוצים לשיוך ולחישוב מדדים לכל חיפוש.
• טוקנים של שיוך (Attribution). טוקנים של שיוך הם מזהים ייחודיים שנוצרים על ידי Google ומוחזרים עם כל בקשת חיפוש. חשוב להקפיד לכלול את אסימון השיוך הזה כ-UserEvent.attributionToken בכל אירועי משתמש שנובעים מחיפוש. המידע הזה נדרש כדי לזהות אם החיפוש מופעל על ידי ה-API. רק אירועים של משתמשים עם טוקן שיוך שנוצר על ידי Google משמשים לחישוב מדדים.
• יומני חיפוש. יומני החיפוש מבוססים על בקשות חיפוש. כדי לאפשר ל-Google לזהות סשנים של משתמשים, כדי שתוכל לספק ניתוח נתונים לפי סשן ותוצאות חיפוש באיכות גבוהה יותר, מומלץ מאוד להגדיר את השדה האופציונלי SearchRequest.UserPseudoId.

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

צפייה בניתוח הנתונים של Gemini Enterprise

הערה: אפשרות הצגת ניתוח נתוני החיפוש של אפליקציות באזורים מרובים בארה"ב ובאיחוד האירופי זמינה בגרסת Public Preview. ניתוח נתוני החיפוש הוא GA לאפליקציות גלובליות.

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

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

1. במסוף Google Cloud , עוברים לדף Gemini Enterprise.

   ‫Gemini Enterprise

2. לוחצים על שם האפליקציה שרוצים לראות את נתוחי השימוש שלה.

3. לוחצים על Analytics.

4. לוחצים על כרטיסייה כדי לראות את קבוצת המדדים:

   • שימוש: מדדים לגבי סטטוס השימוש של המשתמשים.

   • שימוש ואיכות: מדדים לגבי משוב משתמשים ושימוש באפליקציה.

   • סוכן: מדדים לסוכנים באפליקציית האינטרנט של Gemini Enterprise, כולל סוכנים שנוצרו על ידי Google,‏ NotebookLM Enterprise וסוכנים שהארגון שלכם יצר ורשם ב-Gemini Enterprise.

   • ערך: מדדים לגבי החיסכון בעלויות שהושג על ידי משתמשים ששולחים שאילתות לנתונים באמצעות האפליקציה.

   

   הצגת נתוני הניתוח של האימוץ

5. כדי לסנן את המדדים, מציינים את המסננים שזמינים בכרטיסיית המדדים ואז לוחצים על הלחצן רענון כדי להחיל אותם.

הגדרות של המדדים

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

קבוצת מדדים	שם המדד	הגדרת המדד	הערות
הטמעה	סה"כ משתמשים	מספר המשתמשים הפעילים הייחודיים ב-Gemini Enterprise בטווח התאריכים שנבחר.	משתמש נחשב פעיל אם הוא נכנס לחשבון ומפעיל קריאות ל-API, למשל כשהוא מגיע לדף הבית. מכיוון שהספירה היא של משתמשים ייחודיים, משתמש שמבצע קריאות לשיטות של Assistant, תשובה וחיפוש API נספר רק פעם אחת בסך הכול.
	משתמשים שמתקשרים לעוזר	מספר המשתמשים שהתקשרו לשיטות AssistantService או השתמשו ב-Assistant כדי ליצור תשובות.
	משתמשים שמקבלים מענה לשיחות	מספר המשתמשים שהתקשרו לשיטות ConversationalSearchService ו-GenerativeSearchAnswerService כדי ליצור תשובות.
	משתמשים שמבצעים חיפוש	מספר המשתמשים שהתקשרו לשיטות SearchService כדי לקבל תוצאות חיפוש.
	משתמשים שקוראים לשיטות אחרות של API	מספר המשתמשים שקראו ל-API methods שאינם streamAssist,‏ streamAnswer ו-engines.servingConfigs.search. לדוגמה, משתמשים שקוראים לשיטות של API לאימות.
	משתמשים פעילים ביום (DAU)	מספר המשתמשים הפעילים ביום	משתמש נחשב פעיל אם הוא נכנס לחשבון ומפעיל קריאות ל-API, למשל כשהוא מגיע לדף הבית.
	משתמשים פעילים לשבוע	מספר המשתמשים הפעילים בשבוע. השבוע מתחיל ביום שני ומסתיים ביום ראשון.
	משתמשים פעילים לחודש	מספר המשתמשים הפעילים בחודש
	שיעור השימור לאחר 7 ימים	מספר המשתמשים החוזרים בתקופה הנוכחית של 7 ימים חלקי מספר המשתמשים הפעילים בתקופה הקודמת של 7 ימים	משתמש נחשב כמשתמש חוזר אם הוא פעיל בתקופה הנוכחית של 7 ימים וגם בתקופה הקודמת של 7 ימים.
	שיעור הצמיחה ב-7 הימים האחרונים	ההפרש באחוזים בין מספר המשתמשים הפעילים בתקופה הנוכחית של שבעה ימים לבין מספר המשתמשים הפעילים בתקופה הקודמת של שבעה ימים
	שיעור הנטישה ב-7 הימים האחרונים	מספר המשתמשים שביטלו את המינוי בתקופה הנוכחית של 7 ימים חלקי מספר המשתמשים הפעילים בתקופה הקודמת של 7 ימים	משתמש נחשב כמי שעזב אם הוא היה פעיל בתקופה הקודמת של 7 ימים, אבל לא פעיל בתקופה הנוכחית של 7 ימים.
	שיעור השימור לאחר 28 ימים	מספר המשתמשים החוזרים בתקופה הנוכחית של 28 ימים חלקי מספר המשתמשים הפעילים בתקופה הקודמת של 28 ימים
	שיעור הצמיחה ב-28 הימים האחרונים	ההפרש באחוזים בין מספר המשתמשים הפעילים בתקופה הנוכחית של 28 ימים לבין מספר המשתמשים הפעילים בתקופה הקודמת של 28 ימים
	שיעור הנטישה ב-28 הימים האחרונים	מספר המשתמשים שביטלו את המינוי בתקופה הנוכחית של 28 יום חלקי מספר המשתמשים הפעילים בתקופה הקודמת של 28 יום
	מושבים שנרכשו	מספר הרישיונות (המושבים) שהארגון רכש	כולל את כל המושבים שנרכשו מאז ההרשמה ל-Gemini Enterprise.
	מושבים שנטענו	מספר רישיונות המשתמשים שהוקצו לאנשים בארגון והתקבלו על ידם	המספר כולל את כל המושבים שנתבעו מאז ההרשמה ל-Gemini Enterprise.
שימוש ואיכות	מספר החיפושים	המספר הכולל של חיפושים
	מספר התשובות	המספר הכולל של שאילתות ש-Gemini Enterprise יצר עבורן תשובה	תשובות שנוצרו על ידי נציג לא נכללות בספירה הזו.
	מספר הפעולות	המספר הכולל של שאילתות ש-Gemini Enterprise ענה עליהן	כולל פעולות כמו יצירת תבנית אימייל.
	שיעור הקליקים (CTR) לכל חיפוש	המספר הכולל של קליקים בחיפוש / מספר החיפושים	קליקים בחיפוש כוללים קליקים על תוצאות חיפוש ועל הפניות פנימיות.
	צפייה בדף לפי קטגוריה	המספר הכולל של הצפיות בכל דף קטגוריה
	מספר הלייקים והדיסלייקים למשוב	מספר הלייקים והדיסלייקים שנשלחו על ידי משתמשים	רשומה של תגובות המשוב (לייק או דיסלייק) שנשלחו על ידי המשתמשים באפליקציה.
	פירוט של הסיבות לסימון דיסלייק למשוב	אחוז הסיבות לסימון סרטון כ'לא אהבתי'	אם משתמש לא אהב תשובה שנוצרה, הוא יכול לבחור כמה סיבות כדי להסביר למה הוא לא אהב אותה. האחוז מציין את התדירות שבה כל סיבה נבחרה.
	שיעור החיפושים המוצלחים	מספר החיפושים המוצלחים / מספר החיפושים
	שיעור התשובות שהושלמו	מספר התשובות הנכונות / מספר התשובות
נציגים	משתמשים פעילים בחודש של סוכנים	המספר הכולל של משתמשים פעילים שהשתמשו בסוכן בכל חודש.
	שיחות צ'אט עם נציג בחודש	המספר הכולל של סשנים בצ'אט שהמשתמשים יזמו עם נציג ספציפי בחודש.	שיחת צ'אט מוגדרת כאינטראקציה של משתמש עם נציג באותו שרשור צ'אט ביום אחד. אם המשתמש ימשיך את השיחה באותו שרשור צ'אט ביום שלאחר מכן, היא תיחשב כסשן חדש.
	סוכנים שהיו בשימוש בחודש	המספר הכולל של סוכנים שהיה להם לפחות משתמש פעיל אחד בחודש.
	סך כל סשני הצ'אט החודשיים	המספר הכולל של סשנים בצ'אט שהמשתמשים יזמו במהלך אינטראקציה עם הסוכנים בכל חודש.	שיחת צ'אט מוגדרת כאינטראקציה של משתמש עם נציג באותו שרשור צ'אט ביום אחד. אם המשתמש ימשיך את השיחה באותו שרשור צ'אט ביום שלאחר מכן, היא תיחשב כסשן חדש.
	סוכנים שנוצרו מדי חודש	המספר הכולל של סוכנים שנוצרו בחודש הקלנדרי האחרון.
	משתמשים פעילים ביום (DAU) ב-NotebookLM Enterprise	מספר המשתמשים הפעילים ב-NotebookLM Enterprise בכל יום.	המדדים של NotebookLM Enterprise מחושבים ברמת הפרויקט ולא ברמת המנוע.
	מספר התיקיות היומיות שנוצרו ב-NotebookLM Enterprise	מספר תיקיות ה-Notebook של NotebookLM Enterprise שנוצרו בכל יום.	המדדים של NotebookLM Enterprise מחושבים ברמת הפרויקט ולא ברמת המנוע.
	מספר תיקיות ה-Notebook שכל משתמש יצר ב-NotebookLM Enterprise בכל יום	מספר תיקיות NotebookLM Enterprise שכל משתמש יצר בכל יום.	המדדים של NotebookLM Enterprise מחושבים ברמת הפרויקט ולא ברמת המנוע.
	מספר תיקיות Notebook יומיות ששותפו ב-NotebookLM Enterprise	מספר קובצי NotebookLM Enterprise ששותפו בכל יום.	המדדים של NotebookLM Enterprise מחושבים ברמת הפרויקט ולא ברמת המנוע.
	סקירות קוליות יומיות שנוצרו ב-NotebookLM Enterprise	מספר הסקירות הקוליות שנוצרו ב-NotebookLM Enterprise בכל יום.	המדדים של NotebookLM Enterprise מחושבים ברמת הפרויקט ולא ברמת המנוע.
	משתמשים פעילים בחודש ב-NotebookLM Enterprise	מספר המשתמשים הפעילים ב-NotebookLM Enterprise בחודש.	המדדים של NotebookLM Enterprise מחושבים ברמת הפרויקט ולא ברמת המנוע.
	מספר תיקיות ה-Notebook שנוצרו ב-NotebookLM Enterprise בחודש	מספר תיקיות Notebook של NotebookLM Enterprise שנוצרו בחודש.	המדדים של NotebookLM Enterprise מחושבים ברמת הפרויקט ולא ברמת המנוע.
	‫NotebookLM Enterprise: מחברת חודשית שנוצרה לכל משתמש	המספר הממוצע של מחברות NotebookLM Enterprise שנוצרו לכל משתמש בחודש.	המדדים של NotebookLM Enterprise מחושבים ברמת הפרויקט ולא ברמת המנוע.
	מספר תיקיות Notebook ששותפו מדי חודש ב-NotebookLM Enterprise	מספר תיקיות ה-Notebook של NotebookLM Enterprise ששותפו בחודש.	המדדים של NotebookLM Enterprise מחושבים ברמת הפרויקט ולא ברמת המנוע.
	סקירות קוליות חודשיות שנוצרו ב-NotebookLM Enterprise	מספר הסקירות הקוליות שנוצרו ב-NotebookLM Enterprise בכל חודש.	המדדים של NotebookLM Enterprise מחושבים ברמת הפרויקט ולא ברמת המנוע.
ערך (גרסת Public Preview)
	חיפוש מוצלח	מספר החיפושים המוצלחים.	מספר החיפושים המוצלחים נקבע לפי התנהגות המשתמש אחרי החיפוש. חיפוש נחשב מוצלח אם מתרחש אחד מהדברים הבאים: אם לוחצים על תוצאת חיפוש לפני שמתחילים חיפוש חדש. אם התשובה מחיפוש כוללת תוצאת חיפוש של אנשים, ולא מופיע אחריה חיפוש נוסף תוך שתי דקות. הסיבה לכך היא שתוצאות חיפוש של אנשים מוצגות בדף תוצאות החיפוש, ובדרך כלל לא צריך ללחוץ עליהן.
	תשובה מוצלחת	מספר התשובות הנכונות	ההצלחה של תשובה נקבעת לפי התנהגות המשתמש אחרי שהיא נוצרת. ההצלחה נמדדת לפי המשוב שמתקבל או לפי הזמן שעובר עד שנשאלת שאילתת המשך. אם המשתמש מסמן לייק לתשובה, השאילתה נחשבת למוצלחת. אם אין משוב והמשתמש לא שולח אילתא נוספת תוך 30 שניות, המערכת מניחה שהאילתא הצליחה.
	שעות העבודה של העובד שנשמרו לתאריכים שנבחרו	(מספר החיפושים המוצלחים + מספר התשובות המוצלחות) כפול הדקות שנחסכו לכל תשובה מוצלחת
	הערך שנשמר לתאריכים שנבחרו	השעות שנחסכו בטווח התאריכים שנבחר ✕ השכר השעתי הממוצע של העובד	כדי לראות את המדד הזה, בכרטיסייה ערך, מציינים תעריף שעתי בשדה תעריף שעתי של עובד.
	השעות השנתיות החזויות של העובדים שנחסכו	(מספר החיפושים המוצלחים + מספר התשובות המוצלחות) כפול הדקות שנחסכו לכל חיפוש מוצלח	המספר השנתי המשוער של חיפושים מוצלחים נגזר ממספר החיפושים המוצלחים בטווח התאריכים שנבחר. על סמך מחקר פנימי שביצענו ב-Google, כל שאילתה חוסכת שלוש דקות.
	ערך שנתי משוער שנחסך	החיסכון השנתי הצפוי בשעות עבודה של העובדים × השכר השעתי הממוצע של העובדים	כדי לראות את המדד הזה, בכרטיסייה ערך, מציינים תעריף שעתי בשדה תעריף שעתי של עובד.

ייצוא המדדים

כדי לייצא את המדדים לטבלה ב-BigQuery בGoogle Cloud פרויקט שלכם:

1. מוודאים שיש לכם את ההרשאות והתפקידים הנדרשים.

   • כדי לקרוא ל-API, צריך להיות לכם תפקיד Discovery Engine Viewer .
   • הרשאות שנדרשות ליצירת מערך נתונים ב-BigQuery
   • ההרשאות שנדרשות ליצירת טבלה.

2. יוצרים מערך נתונים ב-BigQuery:

   1. פותחים את הדף BigQuery במסוף Google Cloud .

      לדף BigQuery

   2. בחלונית Explorer, בוחרים את אותו פרויקט שבו נמצאת אפליקציית Gemini Enterprise כדי ליצור את מערך הנתונים.

   3. לוחצים על האפשרות ואז על יצירת מערך נתונים.

   4. בדף Create dataset:

      • בשדה Dataset ID, מזינים שם ייחודי למערך הנתונים. כדי לייצא את המדדים דרך ה-API, צריך את שם מערך הנתונים.

      • בטבלה הבאה מוצג מיפוי של המיקומים ב-BigQuery למיקומים באפליקציית Gemini Enterprise, לפי סוג המיקום:

        הערה: אחרי שיוצרים את מערך הנתונים אי אפשר לשנות את המיקום.

        מיקום במספר אזורים של אפליקציית Gemini Enterprise	מיקום במספר אזורים ב-BigQuery
        עולמי	ארה"ב (מספר אזורים בארצות הברית)
        ארה"ב (מספר אזורים בארצות הברית)	ארה"ב (מספר אזורים בארצות הברית)
        האיחוד האירופי (מספר אזורים באיחוד האירופי)	האיחוד האירופי (מספר אזורים באיחוד האירופי)

   5. לוחצים על יצירת מערך נתונים.

3. יוצרים טבלה ריקה ב-BigQuery למערך הנתונים שיצרתם.

   1. בחלונית Explorer מרחיבים את הפרויקט ואז בוחרים את מערך הנתונים שיצרתם.
   2. בקטע פרטי מערך הנתונים, לוחצים על יצירת טבלה.
   3. בחלונית Create table (יצירת טבלה), מציינים שם לטבלה בשדה Table (טבלה). כדי לייצא את המדדים באמצעות ה-API, צריך את שם הטבלה.
   4. לוחצים על יצירת טבלה.

4. קוראים לשיטה analytics:exportMetrics כדי לאחזר נתוני מדדים מ-30 הימים האחרונים, כולל היום הנוכחי.

   הערה: אפשר להתקשר אל שיטת analytics:exportMetrics עד 5 פעמים ביום עבור פרויקט Google Cloud , ועד 25 פעמים ביום עבור Google Cloud ארגון.

   REST

   curl -X POST \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   -d '{
      "analytics": "projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID",
      "outputConfig":
         {
            "bigqueryDestination":
            {
               "datasetId": "BIGQUERY_DATASET_ID",
               "tableId": "BIGQUERY_TABLE_ID"
            }
         }
      }' \
   "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/analytics:exportMetrics"
   

   מחליפים את מה שכתוב בשדות הבאים:

   • ‫ENDPOINT_LOCATION: האזור במספר אזורים של בקשת ה-API. מציינים אחד מהערכים הבאים:
     • ‫us בארה"ב במספר אזורים
     • ‫eu במספר אזורים באיחוד האירופי
     • global למיקום הגלובלי
     מידע נוסף זמין במאמר בנושא ציון מספר אזורים למאגר הנתונים.
   • ‫LOCATION: האזור המרובה של מאגר הנתונים: ‫global,‏ us או eu
   • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
   • ‫APP_ID: המזהה של האפליקציה שממנה רוצים לייצא מדדים.
   • ‫BIGQUERY_DATASET_ID: המזהה של מערך הנתונים ב-BigQuery שיצרתם.
     מזהה מערך הנתונים הוא בפורמט <PROJECT_ID>.<DATASET_ID>. צריך לספק רק את <DATASET_ID>.
   • ‫BIGQUERY_TABLE_ID: המזהה של הטבלה ב-BigQuery שיצרתם.
     בתצוגה Classic explorer, מזהה הטבלה הוא בפורמט <PROJECT_ID>.<DATASET_ID>.<TABLE_ID>. צריך לספק רק את <TABLE_ID>.

   הערה: אם רוצים לייצא שוב נתוני מדדים ולשמור את הנתונים שיוצאו קודם, צריך ליצור טבלה חדשה ב-BigQuery ולעדכן את BIGQUERY_TABLE_ID לפני שמפעילים את השיטה analytics:exportMetrics.

   התשובה כוללת את שם הפעולה ואת המזהה שלה. חשוב לשים לב למזהה הפעולה כדי להשתמש בו בשלב הבא.
   לדוגמה:

   {
      "name": "projects/my-project-123/locations/global/collections/default_collection/engines/my-app/operations/OPERATION_ID",
      "metadata": {
         "@type": "type.googleapis.com/google.cloud.discoveryengine.v1alpha.ExportMetricsMetadata"
      }
   }
   

   דוגמה לפקודה ולתוצאה

   curl -X POST \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: my-project-123" \
   -d '{
      "analytics": "projects/my-project-123/locations/global/collections/default_collection/engines/my-app",
      "outputConfig":
         {
            "bigqueryDestination":
            {
               "datasetId": "123456789012345678901",
               "tableId": "123456789012345678901"
            }
         }
      }' \
   "https://discoveryengine.googleapis.com/v1alpha/projects/my-project-123/locations/global/collections/default_collection/engines/my-app/analytics:exportMetrics"
   
   {
     "name": "projects/123456/locations/global/collections/default_collection/engines/my-app/operations/export-metrics-123456789012345678901",
     "metadata": {
       "@type": "type.googleapis.com/google.cloud.discoveryengine.v1alpha.ExportMetricsMetadata"
     }
   }
   

5. כדי לראות את הסטטוס של פעולת ייצוא המדדים, קוראים לשיטה engines.operations.get:

   REST

   curl -X GET \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/operations/OPERATION_ID"
   

   מחליפים את מה שכתוב בשדות הבאים:

   • ‫ENDPOINT_LOCATION: האזור במספר אזורים של בקשת ה-API. מציינים אחד מהערכים הבאים:
     • ‫us בארה"ב במספר אזורים
     • ‫eu במספר אזורים באיחוד האירופי
     • global למיקום הגלובלי
     מידע נוסף זמין במאמר בנושא ציון מספר אזורים למאגר הנתונים.
   • ‫LOCATION: האזור המרובה של מאגר הנתונים: ‫global,‏ us או eu
   • ‫APP_ID: המזהה של האפליקציה שרוצים לקבל את הפעולות הממושכות שלה.
   • ‫OPERATION_ID: המזהה של פעולת ייצוא המדדים שהוחזר בתשובה כשמריצים את הפקודה לייצוא המדדים.

   דוגמה לפקודה ולתוצאה

   פקודה לדוגמה:

   curl -X GET \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   "https://discoveryengine.googleapis.com/v1alpha/projects/my-project-123/locations/global
   /collections/default_collection/engines/my-app/operations/export-metrics-123456789012345678901"
   

   דוגמה לתגובה כשפעולה מסתיימת בהצלחה:

   {
     "name": "projects/123456/locations/global/collections/default_collection/engines/my-app/operations/export-metrics-123456789012345678901",
     "metadata": {
       "@type": "type.googleapis.com/google.cloud.discoveryengine.v1alpha.ExportMetricsMetadata",
       "createTime": "2025-09-17T20:04:30.449781Z",
       "updateTime": "2025-09-17T20:04:35.089617Z"
     },
     "done": true,
     "response": {
       "@type": "type.googleapis.com/google.cloud.discoveryengine.v1alpha.ExportMetricsResponse"
     }
   }
   

   דוגמה לתגובה כשפעולה נתקלת בשגיאות:

   {
     "name": "projects/123456/locations/global/collections/default_collection/engines/my-app/operations/export-metrics-123456789012345678901",
     "metadata": {
       "@type": "type.googleapis.com/google.cloud.discoveryengine.v1alpha.ExportMetricsMetadata",
       "createTime": "2025-09-17T20:04:30.449781Z",
       "updateTime": "2025-09-17T20:04:35.089617Z"
     },
     "done": true,
     "error": {
       "code": 3,
       "message": "BigQuery job failed with error: Not found: Dataset my-project-123:123456789012345678901 was not found in location US at [1:24]"
     }
   }