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

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

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

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

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

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

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

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

בקטע הזה מתוארים אירועי המשתמשים ש-Gemini Enterprise משתמש בהם כדי ליצור את המדדים שקשורים לחיפוש, כמו ספירת החיפושים ושיעור הקליקים (CTR). אם אתם משתמשים בממשק המשתמש כדי לחפש ולקבל תשובות באמצעות העוזר של 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. נכנסים לדף Gemini Enterprise במסוף Google Cloud .

   ‫Gemini Enterprise

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

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

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

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

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

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

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

   • ברמת המשתמש: המדדים כוללים את מזהי המשתמשים (כתובת אימייל או מזהה ייחודי) של משתמשים בארגון, ואת האינטראקציות שלהם עם סוכני AI שנוצרו על ידי Google ועם סוכני AI שהארגון יצר ורשם ב-Gemini Enterprise.

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

   

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

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

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

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

קבוצת מדדים	שם המדד	הגדרת המדד	הערות
הטמעה	סה"כ משתמשים	מספר המשתמשים הפעילים הייחודיים ב-Gemini Enterprise בטווח התאריכים שנבחר.	משתמש נחשב פעיל אם הוא נכנס לחשבון ומפעיל קריאות ל-API, למשל כשהוא מגיע לדף הבית. מכיוון שהספירה היא ייחודית, משתמש שמפעיל את השיטות של ממשקי ה-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 יצר תשובה לשאלה של משתמש.	תשובות שנוצרו על ידי נציג לא נכללות בספירה הזו.
	מספר הפעולות	אינטראקציות כוללות, כמו העלאת קבצים, יצירת תיקיות או שימוש בפעולות של מחברים ב-Gemini Enterprise.	כולל פעולות כמו יצירת תבנית אימייל.
	שיעור הקליקים (CTR) לכל חיפוש	המספר הכולל של קליקים בחיפוש / מספר החיפושים	קליקים בחיפוש כוללים קליקים על תוצאות חיפוש ועל הפניות פנימיות.
	צפייה בדף לפי קטגוריה	המספר הכולל של הצפיות בכל דף קטגוריה
	מספר הלייקים והדיסלייקים למשוב	מספר הלייקים והדיסלייקים שנשלחו על ידי משתמשים	רשומה של תגובות המשוב (לייק או דיסלייק) שנשלחו על ידי המשתמשים באפליקציה.
	פירוט של הסיבות לדיסלייק על משוב	אחוז הסיבות לסימון סרטון כ'לא אהבתי'	אם משתמש לא אהב תשובה שנוצרה, הוא יכול לבחור כמה סיבות כדי להסביר למה הוא לא אהב אותה. האחוז מציין את התדירות שבה נבחר כל אחד מהסיבות.
	שיעור הצלחה של חיפושים	מספר החיפושים המוצלחים / מספר החיפושים
	שיעור התשובות שהושלמו	מספר התשובות הנכונות / מספר התשובות
סוכנים	משתמשים פעילים בחודש של סוכנים	המספר הכולל של משתמשים פעילים שהשתמשו בסוכן בכל חודש.	משתמש נספר כפעיל עבור סוכן בכל פעם שהוא מבצע שיחה עם Assistant לסוכן הזה במצב סוכן, מחקר או יצירת רעיונות. הפעילות הזו כוללת פעילות של יוצר הסוכן במהלך תצוגות מקדימות או בדיקות בכלי לתכנון סוכנים, כי הפעולות האלה יוצרות קריאות רגילות ל-Assistant עם מזהה הסוכן, בדומה לאינטראקציה של משתמש קצה. רק אינטראקציות עם טיוטות שלא נשמרו ושלא הוקצה להן מזהה סוכן לא נכללות בספירה הזו.
	שיחות צ'אט חודשיות עם נציגים	המספר הכולל של סשנים בצ'אט שהמשתמשים יזמו באינטראקציה עם סוכן ספציפי בחודש.	סשן צ'אט מוגדר כאינטראקציה של משתמש עם סוכן באותו שרשור צ'אט ביום מסוים. אם המשתמש ימשיך את השיחה באותו שרשור צ'אט ביום שלאחר מכן, זה ייחשב כסשן חדש. סשנים של תצוגה מקדימה ובדיקה שהופעלו מכלי לתכנון סוכנים נספרים, כי הם עוברים באותו נתיב של Assistant API כמו סשנים של משתמשי קצה ומקבלים מזהה סשן.
	סוכנים שהיו בשימוש בחודש	המספר הכולל של סוכנים שהיה להם לפחות משתמש פעיל אחד בחודש.	המדד הזה מבוסס על אותה הגדרה של משתמש פעיל כמו משתמשים פעילים בחודש של סוכנים. לפעמים המספר הזה יכול להיות גבוה יותר מהמספר הכולל של סשנים של צ'אט בחודש בחודש מסוים, אם הרבה נציגים מקבלים שיחות קצרות עם Assistant שלא יוצרות מזהה סשן שנשמר (לדוגמה, שיחות שהופסקו או בוטלו, או שיחות חד-פעמיות שלא פותחות סשן של צ'אט).
	סך כל שיחות הצ'אט החודשיות	המספר הכולל של סשנים בצ'אט שהמשתמשים יזמו במהלך אינטראקציה עם הסוכנים בכל חודש.	סשן צ'אט מוגדר כאינטראקציה של משתמש עם סוכן באותו שרשור צ'אט ביום מסוים. אם המשתמש ימשיך את השיחה באותו שרשור צ'אט ביום שלאחר מכן, זה ייחשב כסשן חדש. סשנים של תצוגה מקדימה ובדיקה שהופעלו מכלי לתכנון סוכנים נספרים, כי הם עוברים באותו נתיב של Assistant API כמו סשנים של משתמשי קצה ומקבלים מזהה סשן.
	סוכנים שנוצרו בחודש	המספר הכולל של סוכנים שנוצרו בחודש הקלנדרי האחרון.
	משתמשים פעילים ביום ב-Gemini Notebook Enterprise	מספר המשתמשים הפעילים ב-Gemini Notebook Enterprise בכל יום.	המדדים של Gemini Notebook Enterprise מחושבים ברמת הפרויקט ולא ברמת המנוע. הערה: המדדים של Gemini Notebook Enterprise כוללים יצירת מחברות, שיתוף מחברות, יצירת סקירה קולית ומספרים כוללים של משתמשים פעילים. מדדים של ארטיפקטים אחרים שנוצרו – כמו מפות חשיבה, סקירות בווידאו, מצגות, אינפוגרפיקות ודוחות מותאמים אישית – עדיין לא מוצגים בלוח הבקרה הזה.
	‫Gemini Notebook Enterprise daily notebooks created	מספר הנוטבוקים שנוצרו ב-Gemini Notebook Enterprise בכל יום.	המדדים של Gemini Notebook Enterprise מחושבים ברמת הפרויקט ולא ברמת המנוע.
	מספר הנוטבוקים היומיים שנוצרו למשתמש ב-Gemini Notebook Enterprise	מספר מחברות Gemini Notebook Enterprise שנוצרו על ידי כל משתמש בכל יום.	המדדים של Gemini Notebook Enterprise מחושבים ברמת הפרויקט ולא ברמת המנוע.
	נוטבוקים יומיים משותפים של Gemini Notebook Enterprise	מספר הנוטבוקים ב-Gemini Notebook Enterprise ששותפו בכל יום.	המדדים של Gemini Notebook Enterprise מחושבים ברמת הפרויקט ולא ברמת המנוע.
	סקירות קוליות יומיות שנוצרו ב-Gemini Notebook Enterprise	מספר הסקירות הקוליות שנוצרו ב-Gemini Notebook Enterprise בכל יום.	המדדים של Gemini Notebook Enterprise מחושבים ברמת הפרויקט ולא ברמת המנוע.
	משתמשים פעילים בחודש ב-Gemini Notebook Enterprise	מספר המשתמשים הפעילים ב-Gemini Notebook Enterprise בחודש.	המדדים של Gemini Notebook Enterprise מחושבים ברמת הפרויקט ולא ברמת המנוע.
	מספר הנוטבוקים שנוצרו מדי חודש ב-Gemini Notebook Enterprise	מספר הנוטבוקים שנוצרו ב-Gemini Notebook Enterprise בכל חודש.	המדדים של Gemini Notebook Enterprise מחושבים ברמת הפרויקט ולא ברמת המנוע.
	‫Gemini Notebook Enterprise – נוטבוקים חודשיים שנוצרו לכל משתמש	המספר הממוצע של מחברות Gemini Notebook Enterprise שנוצרו לכל משתמש בחודש.	המדדים של Gemini Notebook Enterprise מחושבים ברמת הפרויקט ולא ברמת המנוע.
	נוטבוקים חודשיים משותפים ב-Gemini Notebook Enterprise	מספר הנוטבוקים ב-Gemini Notebook Enterprise ששותפו בחודש.	המדדים של Gemini Notebook Enterprise מחושבים ברמת הפרויקט ולא ברמת המנוע.
	סקירות קוליות חודשיות שנוצרו ב-Gemini Notebook Enterprise	מספר הסקירות הקוליות שנוצרו באמצעות Gemini Notebook Enterprise בכל חודש.	המדדים של Gemini Notebook Enterprise מחושבים ברמת הפרויקט ולא ברמת המנוע.
ערך (גרסת Public Preview)
	חיפוש מוצלח	מספר החיפושים שהצליחו.	מספר החיפושים המוצלחים נקבע לפי התנהגות המשתמש אחרי החיפוש. חיפוש נחשב מוצלח אם מתרחש אחד מהמקרים הבאים: אם לוחצים על תוצאת חיפוש לפני שמתחילים חיפוש חדש. אם התשובה מחיפוש כוללת תוצאה של חיפוש אנשים, ולא מופיע אחריה חיפוש נוסף תוך שתי דקות. הסיבה לכך היא שתוצאות חיפוש של אנשים מוצגות בדף תוצאות החיפוש, ובדרך כלל לא צריך ללחוץ עליהן.
	תשובה מוצלחת	מספר התשובות הנכונות	ההצלחה של תשובה נקבעת לפי התנהגות המשתמש אחרי שהיא נוצרת. ההצלחה נמדדת לפי המשוב שמתקבל או לפי הזמן שעובר עד שנשאלת שאילתת המשך. אם המשתמש מביע לייק לתשובה, השאילתה נחשבת למוצלחת. אם לא מתקבל משוב והמשתמש לא שולח שאילתה נוספת תוך 30 שניות, המערכת מניחה שהשאילתה הצליחה.
	שעות העבודה של העובד שנשמרו לתאריכים שנבחרו	(מספר החיפושים המוצלחים + מספר התשובות המוצלחות) כפול הדקות שנחסכו לכל תשובה מוצלחת
	הערך שנשמר לתאריכים שנבחרו	השעות שנחסכו בטווח התאריכים שנבחר ✕ השכר השעתי הממוצע של העובד	כדי לראות את המדד הזה, בכרטיסייה ערך, מציינים שכר שעתי בשדה שכר שעתי של העובד.
	השעות השנתיות של העובדים שנחסכו	(מספר החיפושים המוצלחים + מספר התשובות המוצלחות) כפול הדקות שנחסכו לכל חיפוש מוצלח	מספר החיפושים השנתי המשוער מחושב על סמך מספר החיפושים המוצלחים בטווח התאריכים שנבחר. על סמך מחקר פנימי שביצענו ב-Google, כל שאילתה חוסכת שלוש דקות.
	ערך שנתי צפוי שנחסך	השעות השנתיות המשוערות שנחסכו לעובדים ✕ השכר השעתי הממוצע של העובדים	כדי לראות את המדד הזה, בכרטיסייה ערך, מציינים שכר שעתי בשדה שכר שעתי של העובד.
רמת המשתמש
	הערה: כדי לראות את המדדים של רמת המשתמש, אתם צריכים להיות ברשימת ההיתרים. כדי להוסיף אתכם לרשימת ההיתרים, אתם צריכים לפנות לצוות ניהול החשבון או לצוות המכירות.
	מזהה משתמש	כתובת האימייל של כל משתמש בארגון. אם כתובת האימייל לא זמינה, המזהה הייחודי המקורי של המשתמש מוצג.
	סה"כ הודעות	המספר הכולל של הודעות שהמשתמש שלח לאפליקציית האינטרנט של Gemini Enterprise.	כולל את כל ההודעות שהמשתמש שלח, ולא רק שיחות עם סוכני Gemini Enterprise.
	הודעות לסוכנים שנוצרו על ידי Google	המספר הכולל של הודעות שמשתמש שלח לסוכנים שנוצרו על ידי Google בטווח התאריכים והשעות שנבחר.
	הודעות לנציגי התמיכה שלנו	המספר הכולל של ההודעות שמשתמש שלח לסוכנים שנוצרו על ידי הארגון ונרשמו ב-Gemini Enterprise בטווח התאריכים והשעות שנבחר.

ייצוא המדדים

כדי לייצא את המדדים לטבלה ב-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 שיצרתם.
     בתצוגה של הסייר הקלאסי, מזהה הטבלה הוא בפורמט <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]"
     }
   }