ייצוא מדדים של Analytics ל-BigQuery

בדף הזה מוסבר איך לייצא מדדי ניתוח נתונים של AI Commerce Search אל BigQuery. ייצוא של מדדים מ-Analytics מאפשר לכם לשמור את המדדים ולכתוב שאילתות SQL כדי לבצע ניתוח משלכם.

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

לייצוא נתוני מדדים ל-BigQuery יש את המגבלות הבאות:

  • הנתונים שמיוצאים לטבלאות BigQuery בפרויקט AI Commerce Search הם תצוגות מורשות, ולא תצוגות חומריות.

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

  • אי אפשר לייצא מדדים של אירועים ברמת המשתמש שהתרחשו לפני יותר מ-180 ימים, או מדדים שנוצרו לפני יותר מ-180 ימים. אי אפשר לאחזר מדדים שנוצרו לפני חלון 180 הימים.

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

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

מידע נוסף על ייבוא

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

צריך ליצור מערך נתונים ב-BigQuery כדי לאחסן בו את נתוני המדדים של Analytics.

צריך ליצור את מערכי הנתונים באותו פרויקט שבו הטמעתם את AI Commerce Search.

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

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

    במסמכי התיעוד של BigQuery.

  2. יוצרים מערך נתונים ב-BigQuery במיקום ארה"ב (מספר אזורים בארצות הברית) במספר אזורים. לדוגמה, נותנים את השם retail_data. אם תיצרו את מערך הנתונים באזור אחר, ייצוא הנתונים ל-BigQuery ייכשל. אין תמיכה ב-CMEK למערך הנתונים, והפעלת ההצפנה גורמת לייצוא להיכשל.

    מידע על יצירת מערך נתונים זמין במאמר יצירת מערכי נתונים במאמרי העזרה של BigQuery.

    קבוצת הנתונים הזו תשמש לאחסון הטבלאות של הנתונים שתייצאו. בקטעים הבאים מוסבר איך לייצא.

ייצוא מדדי הניתוח לטבלה ב-BigQuery

אפשר להשתמש בשיטה exportAnalyticsMetrics כדי לייצא את קטלוג המוצרים הקמעונאי לטבלה ב-BigQuery.

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

  • ‫PROJECT_ID: המזהה של פרויקט AI Commerce Search API שבו יצרתם את מערך הנתונים ב-BigQuery.
  • ‫DATASET_ID: השם של מערך הנתונים שיצרתם במאמר יצירת מערך נתונים ב-BigQuery. לדוגמה, אפשר להשתמש ב-retail_data או ב-retail_metrics_data.
  • ‫TABLE_ID_PREFIX: קידומת למזהה הטבלה. הקידומת לא יכולה להיות מחרוזת ריקה. הסיומת retail_analytics_metrics מתווספת כדי להשלים את שם הטבלה. לדוגמה, אם הקידומת היא test, שם הטבלה הוא test_retail_analytics_metrics.

תוכן בקשת JSON: 

{
  "catalog": "projects/PROJECT_ID/locations/global/catalogs/default_catalog",
  "outputConfig":
  {
    "bigqueryDestination":
    {
      "datasetId": "DATASET_ID",
        "tableIdPrefix": "TABLE_ID_PREFIX",
        "tableType": "view"
    }
  }
}

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

אתם אמורים לקבל תגובת JSON שדומה לזו:

{
  "name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/operations/12310973052792775280",
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.retail.v2.ExportAnalyticsMetricsResponse",
    "outputResult": {
      "bigqueryResult": [
        {
          "datasetId": "DATASET_ID",
          "tableId": "TABLE_ID_PREFIX_retail_analytics_metrics"
        }
      ]
    }
  }
}

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

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

מאפייני מדדים

מדדי ספירה הם הספירות הגולמיות שמצטברות ישירות מאירועים רלוונטיים של משתמשים עם אותם מאפיינים. כדי לפרש את המדדים, צריך לדעת על אילו מאפיינים הם מבוססים. לצורך מדדי הניתוח, אירועי חיפוש ועיון נקראים אירועי צפייה, ואירועים מסוג detail_page_view, add_to_cart ו-purchase נקראים אירועי המרה. בטבלה הבאה מוגדרים מאפייני המדדים.

מאפיין המדד תיאור
תאריך

התאריך של האירועים הרלוונטיים שיצרו את המדדים.

במדדי חשיפות, זהו התאריך של אירועי החשיפות.

במדדים של סשנים ומבקרים, זהו התאריך של אירוע החשיפה הראשון של הסשן או המבקר.
external_experiment_ids

מזהי הניסוי של האירועים הרלוונטיים שיצרו את המדדים.

במדדי חשיפה, זהו מזהה הניסוי של אירוע החשיפה.

במדדים של סשנים ומבקרים, זהו שרשור של מזהי הניסוי החיצוניים הייחודיים של כל אירועי החשיפה שמופיעים בסשן או בביקור. לדוגמה, אם יש שני אירועי חיפוש בסשן או אצל מבקר, באירוע החיפוש הראשון הערכים של external_experiment_ids הם test_arm_1,test_arm_2, ובאירוע החיפוש השני הערכים של external_experiment_ids הם test_arm_1,test_arm_3, אז הערכים של external_experiment_ids של הסשן או המבקר הם test_arm_1,test_arm_2,test_arm_3.
device_type

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

במדדי חשיפות, זהו סוג המכשיר של אירוע החשיפה.

במדדים של סשנים ומבקרים, הערך הזה ריק אם לסשן או למבקר יש יותר מסוג מכשיר אחד, או 1 אם יש רק סוג מכשיר אחד לכל הסשן או המבקר.
serving_config

הגדרת הצגת האירועים הרלוונטיים שיצרו את המדדים.

במדדי חשיפות, זהו קובץ ההגדרות של אירוע החשיפה.

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

המקור של האירועים הרלוונטיים שיצרו את המדדים.

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

לגבי מדדים של סשנים ומבקרים, הערך הוא Mixed אם הסשן או המבקר קיבלו אירועי חשיפה שסופקו על ידי Google וגם על ידי הפתרון שלכם. הערך הוא Google אם אירועי החשיפה מוצגים רק על ידי Google, או Non-Google אם אירועי החשיפה מוצגים רק על ידי הפתרון שלכם במהלך הסשן או הביקור.
ישות

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

במדדי חשיפות, זהו הישות של אירוע החשיפה.

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

מדדי חשיפות

מדדי החשיפות מחושבים בהתאם לדרישות המוקדמות. אפשר לשייך אירועי המרה (אירועים מסוג detail_page_view, add_to_cart ו-purchase) לאירוע חשיפה רק אם הם עומדים בקריטריונים הבאים.

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

  • מזהה המוצר של אירוע ההמרה חייב להופיע בתוצאות של אירוע החשיפה.

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

    נתיב המרות חלון מועד ההמרה
    חשיפה -> צפייה בדף הפרטים ‫60 שניות
    חשיפה -> הוספה לעגלת הקניות 24 שעות
    חשיפה -> רכישה 48 שעות

מדדי חשיפות ברשת החיפוש

שם המדד תיאור
search_event מספר אירועי החיפוש
detail_page_view_from_search מספר האירועים של צפייה בדף פרטים מחיפוש
add_to_cart_unit_from_search מספר היחידות של אירועי הוספה לעגלת קניות מחיפוש
purchase_unit_from_search מספר יחידות הרכישה מחיפוש
revenue_from_search הכנסות מחיפוש
search_event_without_result חיפוש של ספירת אירועים שלא מניב תוצאות
search_request_personalization_enabled מספר בקשות החיפוש שהוגשו עם הפעלה של התאמה אישית
search_request_personalization_result_served מספר בקשות החיפוש שמוצגות עם תוצאות בהתאמה אישית

עיון במדדי החשיפות

שם המדד תיאור
browse_event עיון במספר האירועים
detail_page_view_from_browse מספר האירועים מסוג צפייה בדף פרטים מתוך גלישה
add_to_cart_unit_from_browse מספר היחידות של אירועי הוספה לעגלת קניות מדפדוף
purchase_unit_from_browse מספר יחידות שנרכשו מתוך דפדוף
revenue_from_browse הכנסות מדפדוף
browse_event_without_result עיון בספירת אירועים שלא מניב תוצאות
browse_request_personalization_enabled מספר בקשות הגלישה שהוגשו כשההתאמה האישית מופעלת
browse_request_personalization_result_served מספר בקשות הגלישה שמוצגות עם תוצאות בהתאמה אישית

מדדים של סשנים

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

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

שם המדד תיאור
סשן מספר הסשנים

מדדים של פעילות בחיפוש Google

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

שם המדד תיאור
search_session מספר הסשנים שכוללים חיפוש
search_event_in_search_session חיפוש מספר האירועים בסשנים של חיפוש
browse_event_in_search_session עיון במספר האירועים בסשנים של חיפושים
detail_page_view_in_search_session ספירת הצפיות בדף הפרטים במהלך סשנים של חיפוש
add_to_cart_in_search_session מספר האירועים של הוספה לעגלת קניות בסשנים של חיפוש
add_to_cart_unit_in_search_session המספר של אירועי הוספה לעגלת קניות בסשנים של חיפוש
purchase_order_in_search_session מספר הזמנות הרכש במהלך סשנים של חיפוש
purchase_unit_in_search_session מספר יחידות הרכישה בסשנים של חיפוש
revenue_in_search_session הכנסות במהלך פעילות בחיפוש Google
bounce_count_in_search_session מספר הסשנים של המבקר שעוזב את האתר אחרי צפייה בדף אחד בלבד במהלך סשנים של חיפוש

עיון במדדי הסשנים

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

שם המדד תיאור
browse_session מספר הסשנים שכוללים גלישה
search_event_in_browse_session חיפוש מספר האירועים בסשנים של גלישה
browse_event_in_browse_session עיון במספר האירועים בסשנים של עיון
detail_page_view_in_browse_session ספירת הצפיות בדף הפרטים במהלך סשנים של גלישה
add_to_cart_in_browse_session המספר של אירועי הוספה לעגלת קניות בסשנים של גלישה
add_to_cart_unit_in_browse_session המספר של יחידות שנוספו לעגלת קניות בסשנים של גלישה
purchase_order_in_browse_session מספר הזמנות הרכש בסשני גלישה
purchase_unit_in_browse_session מספר יחידות הרכישה בסשנים של גלישה
revenue_in_browse_session הכנסות מסשנים של גלישה
bounce_count_in_browse_session מספר הסשנים של המבקר שעוזב את האתר אחרי שצפה רק בדף אחד במהלך סשנים של גלישה

מדדי מבקרים

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

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

שם המדד תיאור
מבקר מספר המבקרים

מדדים של מבקרים בחיפוש

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

שם המדד תיאור
search_visitor מספר המבקרים שביצעו חיפוש אחד לפחות
search_event_from_search_visitor מספר אירועים של חיפוש ממבקרים שהגיעו בעקבות חיפוש
browse_event_from_search_visitor עיון במספר האירועים ממבקרים שהגיעו בעקבות חיפוש
detail_page_view_from_search_visitor מספר הצפיות בדף הפרטים של מבקרים שהגיעו מחיפוש
add_to_cart_from_search_visitor מספר האירועים מסוג 'הוספה לעגלת קניות' ממבקרים שהגיעו בעקבות חיפוש
add_to_cart_unit_from_search_visitor מספר היחידות שהוספו לעגלת הקניות ממבקרים שהגיעו בעקבות חיפוש
purchase_order_from_search_visitor מספר הזמנות הרכש ממבקרים שהגיעו בעקבות חיפוש
purchase_unit_from_search_visitor מספר היחידות שנרכשו ממבקרים שהגיעו בעקבות חיפוש
revenue_from_search_visitor הכנסה ממבקרים שהגיעו בעקבות חיפוש

עיון במדדי מבקרים

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

שם המדד תיאור
browse_visitor מספר המבקרים שביצעו לפחות חיפוש אחד
search_event_from_browse_visitor מספר אירועים של חיפושים ממבקרים שגולשים באתר
browse_event_from_browse_visitor עיון במספר האירועים ממבקרים שצופים בתוכן
detail_page_view_from_browse_visitor מספר הצפיות בדף הפרטים של מבקרים שחיפשו מוצרים
add_to_cart_from_browse_visitor המספר של אירועי הוספה לעגלת קניות ממבקרים בדף
add_to_cart_unit_from_browse_visitor המספר של אירועי הוספה לעגלת קניות ממבקרים בדף המוצר
purchase_order_from_browse_visitor מספר הזמנות רכש ממבקרים בדפי מוצרים
purchase_unit_from_browse_visitor מספר יחידות הרכישה ממבקרים שגולשים באתר
revenue_from_browse_visitor הכנסה ממבקרים שהגיעו מדפדוף

דוגמה לשימוש

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

חישוב שיעור הקליקים (CTR)

חישוב שיעור הקליקים (CTR) ברשת החיפוש לפי תאריך, לפי סוג מכשיר ולפי יעד התנועה.

SELECT
  `date`,
  device_type,
  traffic_destination,
  SUM(detail_page_view_from_search) / SUM(search_event) as search_CTR
FROM copied_table
GROUP BY `date`, device_type, traffic_destination

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

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

SELECT
  `date`,
  external_experiment_ids,
  device_type,
  serving_config,
  traffic_destination,
  entity,
  detail_page_view_from_browse
FROM copied_table
WHERE
  traffic_destination = 'Google' AND 'test_arm' in UNNEST(external_experiment_ids)

הצגת הגדרות התצורה של הצגת המודעות שהכי נפוצות

מקבלים את הגדרות ההצגה שהיו בשימוש הכי נפוץ בין התאריכים '2023-10-01' ו-'2023-11-01' לתנועה ב-Google. לכל אירוע חיפוש צריך להיות משויך קובץ הגדרות להצגת מודעות.

SELECT
  serving_config,
  SUM(search_event) as total_search_count
FROM copied_table
WHERE `date` between '2023-10-01' and '2023-11-01' AND traffic_destination = 'Google'
GROUP BY serving_config
ORDER BY total_search_count