הערה: קבוצת המסמכים הזו מיועדת למהדורות Standard,‏ Plus ו-Frontline של Gemini Enterprise. לעיון במסמכי התיעוד של מהדורת Business, אפשר להיכנס אל מרכז העזרה של Gemini Enterprise – מהדורת Business.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

נכנסים לדף Gemini Enterprise במסוף Google Cloud .

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

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

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

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

קבוצת מדדים	שם המדד	הגדרת המדד	הערות
הטמעה	סה"כ משתמשים	מספר המשתמשים הפעילים הייחודיים ב-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 יצר תשובה לשאלה של משתמש.	תשובות שנוצרו על ידי נציג לא נכללות בספירה הזו.
	מספר הפעולות	סך האינטראקציות, כמו העלאת קבצים, יצירת תיקיות או שימוש בפעולות של מחברים ב-Gemini Enterprise.	כולל פעולות כמו יצירת תבנית אימייל.
	שיעור הקליקים (CTR) לכל חיפוש	המספר הכולל של קליקים בחיפוש / מספר החיפושים	קליקים בחיפוש כוללים קליקים על תוצאות חיפוש ועל הפניות פנימיות.
	צפייה בדף לפי קטגוריה	המספר הכולל של הצפיות בכל דף קטגוריה
	מספר הלייקים והדיסלייקים למשוב	מספר הלייקים והדיסלייקים שנשלחו על ידי המשתמשים	רשומה של תגובות המשוב (לייק או דיסלייק) שנשלחו על ידי המשתמשים באפליקציה.
	פירוט הסיבות לסימון דיסלייק למשוב	אחוז הסיבות לסימון סרטון כ'לא אהבתי'	אם משתמש לא אהב תשובה שנוצרה, הוא יכול לבחור כמה סיבות כדי להסביר למה הוא לא אהב אותה. האחוז מציין את התדירות שבה נבחר כל אחד מהסיבות.
	שיעור החיפושים המוצלחים	מספר החיפושים המוצלחים / מספר החיפושים
	שיעור התשובות המוצלחות	מספר התשובות הנכונות / מספר התשובות
סוכנים	משתמשים פעילים בחודש של סוכנים	המספר הכולל של משתמשים פעילים שהשתמשו בסוכן בכל חודש.	משתמש נספר כפעיל עבור סוכן בכל פעם שהוא מבצע שיחה עם Assistant לסוכן הזה במצב סוכן, מחקר או יצירת רעיונות. הפעילות הזו כוללת פעילות של יוצר הסוכן במהלך תצוגות מקדימות או בדיקות ב-Agent Designer, כי הפעולות האלה יוצרות קריאות רגילות ל-Assistant עם מזהה הסוכן, בדומה לאינטראקציה של משתמש קצה. רק אינטראקציות עם טיוטות שלא נשמרו ושלא הוקצה להן מזהה סוכן לא נכללות בספירה הזו.
	שיחות צ'אט עם נציגים בחודש	המספר הכולל של סשנים בצ'אט שהמשתמשים יזמו באינטראקציה עם סוכן ספציפי בחודש.	סשן צ'אט מוגדר כאינטראקציה של משתמש עם נציג באותו שרשור צ'אט ביום אחד. אם המשתמש ימשיך את השיחה באותו שרשור צ'אט ביום שלאחר מכן, זה ייחשב כסשן חדש. סשנים של תצוגה מקדימה ובדיקה שהופעלו מכלי לתכנון סוכנים נספרים, כי הם עוברים באותו נתיב של Assistant API כמו סשנים של משתמשי קצה ומקבלים מזהה סשן.
	סוכנים שהיו בשימוש בחודש	המספר הכולל של סוכנים שהיה להם לפחות משתמש פעיל אחד בחודש.	המדד הזה מבוסס על אותה הגדרה של משתמש פעיל כמו משתמשים פעילים בחודש של סוכנים. לפעמים המספר הזה יכול להיות גבוה יותר מהמספר הכולל של סשנים של צ'אט בחודש בחודש מסוים, אם הרבה נציגים מקבלים שיחות קצרות עם Assistant שלא יוצרות מזהה סשן שנשמר (לדוגמה, שיחות שהופסקו או בוטלו, או שיחות חד-פעמיות שלא פותחות סשן של צ'אט).
	סך כל שיחות הצ'אט החודשיות	המספר הכולל של סשנים בצ'אט שהמשתמשים יזמו במהלך אינטראקציה עם הסוכנים בכל חודש.	סשן צ'אט מוגדר כאינטראקציה של משתמש עם סוכן באותו שרשור צ'אט ביום אחד. אם המשתמש ימשיך את השיחה באותו שרשור צ'אט ביום שלאחר מכן, זה ייחשב כסשן חדש. סשנים של תצוגה מקדימה ובדיקה שהופעלו מכלי לתכנון סוכנים נספרים, כי הם עוברים באותו נתיב של Assistant API כמו סשנים של משתמשי קצה ומקבלים מזהה סשן.
	סוכנים שנוצרו בחודש	המספר הכולל של סוכנים שנוצרו בחודש הקלנדרי האחרון.
	משתמשים פעילים ביום ב-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 מחושבים ברמת הפרויקט ולא ברמת המנוע.
	קובצי Notebook יומיים של 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 פרויקט:

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

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

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

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

בדף Create dataset:

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

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

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

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

יוצרים טבלה ריקה ב-BigQuery למערך הנתונים שיצרתם.
1. בחלונית Explorer מרחיבים את הפרויקט ואז בוחרים את מערך הנתונים שיצרתם.
2. בקטע פרטי מערך הנתונים, לוחצים על יצירת טבלה.
3. בחלונית Create table (יצירת טבלה), מציינים שם לטבלה בשדה Table (טבלה). כדי לייצא את המדדים באמצעות ה-API, צריך את שם הטבלה.
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" } }

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

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

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

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

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

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

ייצוא המדדים

REST

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

REST

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

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