יומן שינויים

כדי לקבל הודעות רשמיות על Google Analytics API, צריך להירשם לקבוצת ההתראות של Google Analytics API.

2024-10-20 נוספה סוג המסנן EmptyFilter של המאפיין

באמצעות מסנן המאפיין EmptyFilter אפשר ליצור תנאי סינון להשוואה לערך ריק.

2024-10-15 נוספה התכונה 'רמת הדגימה' לשיטה reportTasks

אפשר להשתמש בשדה samplingLevel של השיטה properties.runReportTask כדי לקבוע את רמת הדגימה של הדוח.

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

2024-09-18 נוספה התכונה 'תמונה במסגרת של מכסות נכסים'

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

2024-06-28 נוספה מכסה של 'שגיאות לקוח לכל פרויקט לכל נכס'

עכשיו יש הגבלה של 10,000 שגיאות שרת API לכל פרויקט, לכל נכס, בחלון זמן של 15 דקות. הנתונים האלה כוללים את כל הבקשות שהתקבלה אליהן תגובה עם קוד שאינו 500 או 200. דוגמאות לשגיאות שנכללות במכסה הזו: שימוש בשילובים לא תואמים של מאפיינים ומדדים, כל שגיאות האימות.

אם חורגים מהמגבלה הזו, קריאות API נוספות לנכס הזה ייחסמו באופן זמני בפרויקט המשויך ב-Google Cloud עד לסיום חלון הזמן של 15 הדקות.

2024-05-14 נוספה התכונה 'השוואות'

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

שיטות הדיווח המרכזיות של Data API v1beta עודכנו כדי לתמוך בשדה comparisons, שמציין את ההגדרה של ההשוואות המבוקשות כשהוא נכלל.

בבקשה, אפשר לציין השוואה בסיסית על ידי ציון הביטוי dimensionFilter בבקשה, או להשתמש בהשוואה שמורה על ידי ציון שם המשאב של ההשוואה בשדה comparison.

השיטה getMetadata עודכנה כך שתציג את כל ההשוואות השמורות שזמינות לנכס בשדה התגובה comparisons.

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

בשלב זה, אפשר ליצור השוואות שמורות רק באמצעות ממשק המשתמש של Google Analytics.

08 במאי 2024 נוספו משימות דוחות, תכונה דיווח אסינכרוני, ל-Data API v1alpha.

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

שיטות הטיפול במשימות של דוחות הבאות נוספו ל-Data API v1alpha:

2024-05-06 מאפיינים חדשים לאירועים מרכזיים

עכשיו אפשר להשתמש במאפיינים ובמדדים של אירועים מרכזיים.

משנים את בקשות הדוחות שמשתמשות במאפיין isConversionEvent כך שישתמשו במאפיין isKeyEvent במקום זאת.

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

מדד שהוצא משימוש מדד אירוע מרכזי
advertiserAdCostPerConversion advertiserAdCostPerKeyEvent
conversions keyEvents
firstTimePurchaserConversionRate firstTimePurchaserRate
purchaserConversionRate purchaserRate
sessionConversionRate sessionKeyEventRate
userConversionRate userKeyEventRate

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

התגובה של השיטה properties/getMetadata משקפת את ההוספה של מאפיינים ומדדים של אירועים מרכזיים באובייקטים DimensionMetadata ו-MetricMetadata באופן הבא:

  • השדות apiName,‏ uiName ו-description מכילים את שם ה-API של אירוע המפתח, שם ממשק המשתמש ותיאור שלו.
  • בשדה החוזר deprecatedApiNames יש רשומה עם השם הישן של Conversion API.

25 במרץ 2024 נוספו קבוצת ערוצים ראשית, מקור תנועה ידני ומאפיינים ספציפיים לשילוב.

קבוצת ערוצים ראשית, מקור תנועה ידני ומאפיינים ספציפיים לשילוב של CM360,‏ DV360 ו-SA360 שנוספו לסכימה של Data API.

מאפייני קהל:

  • audienceId מזהה הקהל. המזהה המספרי של קהל.

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

  • firstUserPrimaryChannelGroup קבוצת ערוצים ראשית – נקודת הצירוף של המשתמש

  • primaryChannelGroup קבוצת ערוצים ראשית

  • sessionPrimaryChannelGroup קבוצת ערוצים ראשית – סשן

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

  • manualCampaignId מזהה הקמפיין שתויג ידנית

  • manualCampaignName שם הקמפיין הידני

  • manualCreativeFormat פורמט של קריאייטיב ידני

  • manualMarketingTactic שיטת שיווק ידנית

  • manualMedium אמצעי הגעה ידני לאתר

  • manualSource מקור ידני

  • manualSourceMedium מקור / אמצעי הגעה לאתר שתויג ידנית

  • manualSourcePlatform פלטפורמת המקור שתויגה ידנית

  • firstUserManualCampaignId מזהה הקמפיין הידני שמשויך לנקודת הצירוף של המשתמש

  • firstUserManualCampaignName שם הקמפיין הידני שמשויך לנקודת הצירוף של המשתמש

  • firstUserManualCreativeFormat פורמט של קריאייטיב ידני שמשויך לנקודת הצירוף של המשתמש

  • firstUserManualMarketingTactic שיטת שיווק ידנית שמשויכת לנקודת הצירוף של המשתמש

  • firstUserManualMedium אמצעי ההגעה הידני לאתר שמשויך לנקודת הצירוף של המשתמש

  • firstUserManualSource המקור הידני המשויך לנקודת הצירוף של המשתמש

  • firstUserManualSourceMedium מקור ידני / אמצעי ידני להגעה לאתר – נקודת הצירוף של המשתמש

  • firstUserManualSourcePlatform פלטפורמת מקור ידנית – נקודת הצירוף של המשתמש

  • sessionManualCampaignId מזהה הקמפיין הידני שמשויך לסשן

  • sessionManualCampaignName שם הקמפיין הידני שמשויך לסשן

  • sessionManualCreativeFormat פורמט של קריאייטיב ידני שמשויך לסשן

  • sessionManualMarketingTactic שיטת שיווק ידנית שמשויכת לסשן

  • sessionManualMedium אמצעי הגעה לאתר שמשויך לסשן שנוסף ידנית

  • sessionManualSource מקור ידני שמשויך לסשן

  • sessionManualSourceMedium קמפיין שתויג ידנית: מקור / אמצעי הגעה לאתר שמשויך לסשן

  • sessionManualSourcePlatform פלטפורמת מקור ידנית – סשן

המאפיינים של השילוב עם Campaign Manager 360‏ (CM360):

  • cm360AccountId מספר החשבון ב-CM360

  • cm360AccountName שם החשבון ב-CM360

  • cm360AdvertiserId מזהה המפרסם ב-CM360

  • cm360AdvertiserName שם המפרסם ב-CM360

  • cm360CampaignId מזהה הקמפיין ב-CM360

  • cm360CampaignName שם הקמפיין ב-CM360

  • cm360CreativeFormat הפורמט של הקריאייטיב ב-CM360

  • cm360CreativeId מזהה הקריאייטיב ב-CM360

  • cm360CreativeName שם הקריאייטיב ב-CM360

  • cm360CreativeType סוג הקריאייטיב ב-CM360

  • cm360CreativeTypeId מזהה סוג הקריאייטיב ב-CM360

  • cm360CreativeVersion גרסת הקריאייטיב ב-CM360

  • cm360Medium אמצעי ההגעה לאתר ב-CM360

  • cm360PlacementCostStructure מבנה העלויות של מיקומי המודעות ב-CM360

  • cm360PlacementId מזהה מיקום המודעה ב-CM360

  • cm360PlacementName שם מיקום המודעה ב-CM360

  • cm360RenderingId מזהה הרינדור ב-CM360

  • cm360SiteId מזהה האתר ב-CM360

  • cm360SiteName שם האתר ב-CM360

  • cm360Source המקור ב-CM360

  • cm360SourceMedium המקור / אמצעי ההגעה לאתר ב-CM360

  • firstUserCm360AccountId מספר החשבון ב-CM360 – נקודת הצירוף של המשתמש

  • firstUserCm360AccountName שם החשבון ב-CM360 – נקודת הצירוף של המשתמש

  • firstUserCm360AdvertiserId מזהה המפרסם ב-CM360 המשויך לנקודת הצירוף של המשתמש

  • firstUserCm360AdvertiserName שם המפרסם ב-CM360 – נקודת הצירוף של המשתמש

  • firstUserCm360CampaignId מזהה הקמפיין ב-CM360 שמשויך לנקודת הצירוף של המשתמש

  • firstUserCm360CampaignName שם הקמפיין ב-CM360 המשויך לנקודת הצירוף של המשתמש

  • firstUserCm360CreativeFormat הפורמט של הקריאייטיב ב-CM360 המשויך לנקודת הצירוף של המשתמש

  • firstUserCm360CreativeId מזהה הקריאייטיב ב-CM360 – נקודת הצירוף של המשתמש

  • firstUserCm360CreativeName שם הקריאייטיב ב-CM360 המשויך לנקודת הצירוף של המשתמש

  • firstUserCm360CreativeType סוג הקריאייטיב ב-CM360 המשויך לנקודת הצירוף של המשתמש

  • firstUserCm360CreativeTypeId מזהה סוג הקריאייטיב ב-CM360 – נקודת הצירוף של המשתמש

  • firstUserCm360CreativeVersion גרסת הקריאייטיב ב-CM360 – נקודת הצירוף של המשתמש

  • firstUserCm360Medium אמצעי ההגעה לאתר ב-CM360 – נקודת הצירוף של המשתמש

  • firstUserCm360PlacementCostStructure מבנה העלויות של מיקומי המודעות ב-CM360 – נקודת הצירוף של המשתמש

  • firstUserCm360PlacementId מזהה מיקום המודעה ב-CM360 – נקודת הצירוף של המשתמש

  • firstUserCm360PlacementName שם מיקום המודעה ב-CM360 – נקודת הצירוף של המשתמש

  • firstUserCm360RenderingId מזהה הרינדור ב-CM360 – נקודת הצירוף של המשתמש

  • firstUserCm360SiteId מזהה האתר ב-CM360 – נקודת הצירוף של המשתמש

  • firstUserCm360SiteName שם האתר ב-CM360 – נקודת הצירוף של המשתמש

  • firstUserCm360Source המקור ב-CM360 – נקודת הצירוף של המשתמש

  • firstUserCm360SourceMedium המקור / אמצעי ההגעה לאתר ב-CM360 – נקודת הצירוף של המשתמש

  • sessionCm360AccountId מספר החשבון ב-CM360 – סשן

  • sessionCm360AccountName שם החשבון ב-CM360 – סשן

  • sessionCm360AdvertiserId מזהה המפרסם ב-CM360 – סשן

  • sessionCm360AdvertiserName שם המפרסם ב-CM360 – סשן

  • sessionCm360CampaignId מזהה הקמפיין ב-CM360 – סשן

  • sessionCm360CampaignName שם הקמפיין ב-CM360 – סשן

  • sessionCm360CreativeFormat הפורמט של הקריאייטיב ב-CM360 – סשן

  • sessionCm360CreativeId מזהה הקריאייטיב ב-CM360 – סשן

  • sessionCm360CreativeName שם הקריאייטיב ב-CM360 – סשן

  • sessionCm360CreativeType סוג הקריאייטיב ב-CM360 – סשן

  • sessionCm360CreativeTypeId מזהה סוג הקריאייטיב ב-CM360 – סשן

  • sessionCm360CreativeVersion גרסת הקריאייטיב ב-CM360 – סשן

  • sessionCm360Medium אמצעי ההגעה לאתר ב-CM360 – סשן

  • sessionCm360PlacementCostStructure מבנה העלויות של מיקומי המודעות ב-CM360 – סשן

  • sessionCm360PlacementId מזהה מיקום המודעה ב-CM360 – סשן

  • sessionCm360PlacementName שם מיקום המודעה ב-CM360 – סשן

  • sessionCm360RenderingId מזהה הרינדור ב-CM360 – סשן

  • sessionCm360SiteId מזהה האתר ב-CM360 – סשן

  • sessionCm360SiteName שם האתר ב-CM360 – סשן

  • sessionCm360Source המקור ב-CM360 – סשן

  • sessionCm360SourceMedium המקור / אמצעי ההגעה לאתר ב-CM360 – סשן

מאפייני השילוב של Google Display & Video 360‏ (DV360):

  • dv360AdvertiserId מזהה המפרסם ב-DV360

  • dv360AdvertiserName שם המפרסם ב-DV360

  • dv360CampaignId מזהה הקמפיין ב-DV360

  • dv360CampaignName שם הקמפיין ב-DV360

  • dv360CreativeFormat פורמט של קריאייטיב ב-DV360

  • dv360CreativeId מזהה קריאייטיב ב-DV360

  • dv360CreativeName שם הקריאייטיב ב-DV360

  • dv360ExchangeId מזהה Exchange ב-DV360

  • dv360ExchangeName שם Exchange ב-DV360

  • dv360InsertionOrderId מזהה הזמנת קמפיין ב-DV360

  • dv360InsertionOrderName שם הזמנת הקמפיין ב-DV360

  • dv360LineItemId מזהה פריט ב-DV360

  • dv360LineItemName שם הפריט ב-DV360

  • dv360Medium אמצעי הגעה לאתר ב-DV360

  • dv360PartnerId מזהה שותף ב-DV360

  • dv360PartnerName שם השותף ב-DV360

  • dv360Source מקור ב-DV360

  • dv360SourceMedium מקור / אמצעי הגעה לאתר ב-DV360

  • firstUserDv360AdvertiserId מזהה המפרסם ב-DV360 שמשויך לנקודת הצירוף של המשתמש

  • firstUserDv360AdvertiserName שם המפרסם ב-DV360 שמשויך לנקודת הצירוף של המשתמש

  • firstUserDv360CampaignId מזהה הקמפיין ב-DV360 שמשויך לנקודת הצירוף של המשתמש

  • firstUserDv360CampaignName שם הקמפיין ב-DV360 שמשויך לנקודת הצירוף של המשתמש

  • firstUserDv360CreativeFormat פורמט הקריאייטיב ב-DV360 שמשויך לנקודת הצירוף של המשתמש

  • firstUserDv360CreativeId מזהה הקריאייטיב ב-DV360 שמשויך לנקודת הצירוף של המשתמש

  • firstUserDv360CreativeName שם הקריאייטיב ב-DV360 שמשויך לנקודת הצירוף של המשתמש

  • firstUserDv360ExchangeId מזהה בורסת הפרסום ב-DV360 שמשויך לנקודת הצירוף של המשתמש

  • firstUserDv360ExchangeName שם בורסת הפרסום ב-DV360 שמשויך לנקודת הצירוף של המשתמש

  • firstUserDv360InsertionOrderId מזהה הזמנת הקמפיין ב-DV360 שמשויך לנקודת הצירוף של המשתמש

  • firstUserDv360InsertionOrderName שם הזמנת הקמפיין ב-DV360 שמשויך לנקודת הצירוף של המשתמש

  • firstUserDv360LineItemId מזהה הפריט ב-DV360 שמשויך לנקודת הצירוף של המשתמש

  • firstUserDv360LinteItemName שם הפריט ב-DV360 שמשויך לנקודת הצירוף של המשתמש

  • firstUserDv360Medium אמצעי ההגעה לאתר ב-DV360 שמשויך לנקודת הצירוף של המשתמש

  • firstUserDv360PartnerId מזהה השותף ב-DV360 שמשויך לנקודת הצירוף של המשתמש

  • firstUserDv360PartnerName שם השותף ב-DV360 שמשויך לנקודת הצירוף של המשתמש

  • firstUserDv360Source המקור ב-DV360 שמשויך לנקודת הצירוף של המשתמש

  • firstUserDv360SourceMedium המקור / אמצעי ההגעה לאתר ב-DV360 שמשויך לנקודת הצירוף של המשתמש

  • sessionDv360AdvertiserId מזהה המפרסם ב-DV360 המשויך לסשן

  • sessionDv360AdvertiserName שם המפרסם ב-DV360 שמשויך לסשן

  • sessionDv360CampaignId מזהה הקמפיין ב-DV360 – סשן

  • sessionDv360CampaignName שם הקמפיין ב-DV360 – סשן

  • sessionDv360CreativeFormat פורמט של קריאייטיב ב-DV360 – סשן

  • sessionDv360CreativeId מזהה הקריאייטיב ב-DV360 – סשן

  • sessionDv360CreativeName שם קריאייטיב ב-DV360 שמשויך לסשן

  • sessionDv360ExchangeId מזהה Exchange ב-DV360 שמשויך לסשן

  • sessionDv360ExchangeName שם Exchange ב-DV360 שמשויך לסשן

  • sessionDv360InsertionOrderId מזהה הזמנת קמפיין ב-DV360 שמשויך לסשן

  • sessionDv360InsertionOrderName שם הזמנת הקמפיין ב-DV360 שמשויך לסשן

  • sessionDv360LineItemId מזהה פריט ב-DV360 שמשויך לסשן

  • sessionDv360LineItemName שם פריט ב-DV360 שמשויך לסשן

  • sessionDv360Medium אמצעי הגעה לאתר ב-DV360 שמשויך לסשן

  • sessionDv360PartnerId מזהה שותף ב-DV360 שמשויך לסשן

  • sessionDv360PartnerName שם השותף ב-DV360 שמשויך לסשן

  • sessionDv360Source המקור ב-DV360 שמשויך לסשן

  • sessionDv360SourceMedium מקור / אמצעי הגעה לאתר ב-DV360 – סשן

מאפייני השילוב של Google Search Ads 360‏ (SA360):

  • firstUserSa360AdGroupId מזהה קבוצת המודעות ב-SA360 שמשויך לנקודת הצירוף של המשתמש

  • firstUserSa360AdGroupName שם קבוצת המודעות ב-SA360 שמשויך לנקודת הצירוף של המשתמש

  • firstUserSa360CampaignId מזהה הקמפיין ב-SA360 שמשויך לנקודת הצירוף של המשתמש

  • firstUserSa360CampaignName הקמפיין ב-SA360 שמשויך לנקודת הצירוף של המשתמש

  • firstUserSa360CreativeFormat פורמט הקריאייטיב של המשתמש הראשון ב-SA360

  • firstUserSa360EngineAccountId מזהה חשבון מנוע החיפוש ב-SA360 שמשויך לנקודת הצירוף של המשתמש

  • firstUserSa360EngineAccountName שם חשבון מנוע החיפוש ב-SA360 שמשויך לנקודת הצירוף של המשתמש

  • firstUserSa360EngineAccountType סוג חשבון מנוע החיפוש ב-SA360 בנקודת הצירוף של המשתמש

  • firstUserSa360KeywordText טקסט מילת המפתח של המשתמש הראשון ב-SA360

  • firstUserSa360ManagerAccountId מספר חשבון הניהול ב-SA360 שמשויך לנקודת הצירוף של המשתמש

  • firstUserSa360ManagerAccountName שם חשבון הניהול ב-SA360 שמשויך לנקודת הצירוף של המשתמש

  • firstUserSa360Medium אמצעי ההגעה לאתר ב-SA360 שמשויך לנקודת הצירוף של המשתמש

  • firstUserSa360Query השאילתה של המשתמש הראשון ב-SA360

  • firstUserSa360Source המקור ב-SA360 שמשויך לנקודת הצירוף של המשתמש

  • firstUserSa360SourceMedium המקור / אמצעי ההגעה לאתר ב-SA360 שמשויך לנקודת הצירוף של המשתמש

  • sa360AdGroupId מזהה קבוצת מודעות ב-SA360

  • sa360CampaignId מזהה הקמפיין ב-SA360

  • sa360AdGroupName שם קבוצת המודעות ב-SA360

  • sa360CampaignName קמפיין ב-SA360

  • sa360CreativeFormat פורמט הקריאייטיב ב-SA360

  • sa360EngineAccountId מספר חשבון מנוע חיפוש ב-SA360

  • sa360EngineAccountName שם חשבון מנוע החיפוש ב-SA360

  • sa360EngineAccountType סוג חשבון מנוע חיפוש ב-SA360

  • sa360KeywordText טקסט מילת מפתח ב-SA360

  • sa360ManagerAccountId מספר חשבון הניהול ב-SA360

  • sa360ManagerAccountName השם של חשבון הניהול ב-SA360

  • sa360Medium אמצעי הגעה לאתר ב-SA360

  • sa360Query שאילתה ב-SA360

  • sa360Source מקור ב-SA360

  • sa360SourceMedium מקור / אמצעי הגעה לאתר ב-SA360

  • sessionSa360AdGroupId מזהה קבוצת המודעות ב-SA360 שמשויך לסשן

  • sessionSa360CampaignId מזהה הקמפיין ב-SA360 המשויך לסשן

  • sessionSa360ManagerAccountId מספר חשבון הניהול ב-SA360 שמשויך לסשן

  • sessionSa360ManagerAccountName שם חשבון הניהול ב-SA360 שמשויך לסשן

  • sessionSa360SourceMedium המקור / אמצעי ההגעה לאתר ב-SA360 שמשויך לסשן

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

התכונה 'ייצוא קהלים' תומכת טוב יותר בייצוא קהלים של משתמשים לא פעילים. משתמשים נכללים בקהלים האלה ללא אירוע שעונה על הקריטריונים. לדוגמה, משתמש יכול להיכלל בקהל אם הוא לא נכנס לאתר שלכם במשך שבעה ימים. דוגמאות לקהלים של משתמשים לא פעילים: 'קונים לא פעילים – 7 ימים', 'משתמשים לא פעילים – 7 ימים' ו'משתמשים שלא קיבלו התראות – 7 ימים'. מידע נוסף על הקהלים המוצעים זמין במאמר קהלים מוצעים.

2024-02-28 ייצוא קהלים מחזיר את מזהה המשתמש שצוין בתיוג.

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

30 בינואר 2024 תמיכה בהתראות Webhook לרשימות קהלים ולרשימות קהלים קבועות בגרסה אלפא של Data API v1.

אפשר לציין את השדות AudienceList.webhookNotification ו-RecurringAudienceList.webhookNotification כשיוצרים רשימת חברים בקהל (באמצעות properties.audienceLists.create) או רשימת חברים בקהל קבועה (באמצעות properties.recurringAudienceLists.create).

הפונקציה הזו מאפשרת לקבל התראות Webhook באופן אסינכררוני כשרשימת קהל הופכת לזמינה.

2024-01-18 שיפור התאימות למאפיינים שכוללים את מחרוזת השאילתה או את רכיב הדקה.

מאפיינים שכוללים את מחרוזת השאילתה תואמים עכשיו לרוב השדות. מאפיינים כמו pagePathPlusQueryString,‏ unifiedPageScreen,‏ pageLocation ו-fullPageUrl תואמים עכשיו לשדות נוספים רבים, כולל sessionSource,‏ browser,‏ city ו-landingPage.

מאפיינים שכוללים את רכיב הדקות תואמים עכשיו לרוב השדות. מאפיינים כמו minute, ‏ nthMinute ו-dateHourMinute תואמים עכשיו לקבוצה דומה של שדות נוספים.

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

2023-12-13 פרמטרים מותאמים אישית ברמת הפריט

עכשיו אפשר לכלול מאפיינים מותאמים אישית ברמת הפריט בשאילתות של Analytics Data API באמצעות התחביר הבא:

שם API גנרי תיאור
customItem:parameter_name מאפיין מותאם אישית ברמת הפריט עבור parameter_name

מידע נוסף זמין במאמר מאפיינים ומדדים של API.

05 בדצמבר 2023 רשימות קהלים זמינות בגרסת הבטא של Data API v1 בתור ייצוא קהלים

השם של התכונה 'רשימות קהלים' השתנה ל-ייצוא קהלים והיא נוספה לגרסת הבטא של Data API v1.

הוספנו את השיטות הבאות לגרסת הבטא של Data API v1:

2023-11-28 הוספנו את samplingMetadatas לתשובה לדיווח

הוספת samplingMetadatas אל ResponseMetaData. הקולקציה הזו תכיל SampleMetadata לכל טווח תאריכים בבקשה שלגביו בוצעה דגימה של התוצאות. מערכת Google Analytics תחיל דגימה רק אם היא צופה שהמגבלות על עוצמה (cardinality) יגרמו לירידה באיכות הנתונים.

2023-11-28 נוספה פונקציונליות של ייצוא קבוע של רשימות קהלים לגרסת האלפא של Data API v1

הוספנו את השיטות properties.recurringAudienceLists.create,‏ properties.recurringAudienceLists.create ו-properties.recurringAudienceLists.list לגרסה האלפא של Data API v1.

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

08 בנובמבר 2023 נוספה ל-Data API v1 alpha הפונקציונליות של ייצוא רשימות קהלים ל-Sheets

הוספנו את השיטה properties.audienceLists.exportSheet לגרסת האלפא של Data API v1, שמאפשרת לייצא רשימת קהלים ל-Google Sheets.

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

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

2023-09-12 כללי הסדר שמוגדרים כברירת מחדל ב-AudienceList

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

לפני השינוי הזה, יכול להיות שקיבלת את הדוח הבא:

deviceId isAdsPersonalizationAllowed
ABC TRUE
DAC FALSE
ABC FALSE
AAA TRUE

אחרי השינוי הזה, תקבלו את הדוח הבא:

deviceId isAdsPersonalizationAllowed
AAA TRUE
ABC FALSE
ABC TRUE
DAC FALSE

2023-08-15 נוספה המאפיין isLimitedAdTracking לסכימת הייצוא של רשימות קהלים

  • isLimitedAdTracking ההגדרה 'הגבלת מעקב מודעות' שנקבעה במכשיר. ערכים אפשריים: true,‏ false ו-(not set).

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

15 באוגוסט 2023 נוספו המאפיין currencyCode והמדד itemDiscountAmount

  • currencyCode קוד המטבע המקומי (לפי תקן ISO 4217) של אירוע המסחר האלקטרוני. לדוגמה, 'USD' או 'GBP'.

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

מידע נוסף זמין במאמר סכימת הדיווח של Data API.

2023-08-10 נוספה המאפיין isAdsPersonalizationAllowed לסכימת הייצוא של רשימות קהלים

  • isAdsPersonalizationAllowed האם מותר להציג מודעות בהתאמה אישית. אם המשתמש עומד בדרישות להתאמה אישית של מודעות, הפונקציה isAdsPersonalizationAllowed מחזירה את הערך true. אם המשתמש לא עומד בדרישות להתאמה אישית של מודעות, הפרמטר isAdsPersonalizationAllowed מחזיר את הערך false.

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

2023-07-10 רשימות קהלים

נוספה תמיכה ברשימות קהלים לגרסת האלפא של Data API v1. רשימות קהלים כוללות תמונת מצב של המשתמשים בקהל בזמן יצירת רשימת החברים בקהל.

השיטות הבאות נוספו ל-Data API v1 alpha:

2023-05-19 קבוצות ערוצים בהתאמה אישית

נוספה תמיכה בקבוצות ערוצים בהתאמה אישית ל-Data API.

2023-05-11 שינויים במכסות האסימונים.

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

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

אחרי השינוי הזה, החיוב על חלק מהבקשות יישאר ללא שינוי, אבל תהיה עלייה ניכרת בחיובים על שאילתות מורכבות יותר. לדוגמה, בקשות לנתונים של יותר מ-6 חודשים יכולות לחייב ב-1,000 טוקנים של מכסות או יותר.

נכסים רגילים

שם המכסה המגבלה הישנה מגבלה חדשה
טוקנים ליבה לכל נכס ביום 25,000 200,000
Core Tokens Per Property Per Hour 5,000 40,000
Core Tokens לכל פרויקט, לכל נכס, לשעה 1,750 14,000
טוקנים בזמן אמת לכל נכס ביום 25,000 200,000
טוקנים בזמן אמת לכל נכס לשעה 5,000 40,000
טוקנים בזמן אמת לכל פרויקט לכל נכס בכל שעה 1,750 14,000
טוקנים במשפך לכל נכס ביום 25,000 200,000
מספר הטוקנים במשפך לכל נכס לשעה 5,000 40,000
מספר הטוקנים במשפך לכל פרויקט לכל נכס לכל שעה 1,750 14,000

נכסי Analytics 360

שם המכסה המגבלה הישנה מגבלה חדשה
טוקנים ליבה לכל נכס ביום 250,000 2,000,000
Core Tokens Per Property Per Hour 50,000 400,000
Core Tokens לכל פרויקט, לכל נכס, לשעה 17,500 140,000
טוקנים בזמן אמת לכל נכס ביום 250,000 2,000,000
טוקנים בזמן אמת לכל נכס לשעה 50,000 400,000
טוקנים בזמן אמת לכל פרויקט לכל נכס בכל שעה 17,500 140,000
טוקנים במשפך לכל נכס ביום 250,000 2,000,000
מספר הטוקנים במשפך לכל נכס לשעה 50,000 400,000
מספר הטוקנים במשפך לכל פרויקט לכל נכס לכל שעה 17,500 140,000

2023-03-02 נוספו מאפייני תאריך.

  • dayOfWeekName שם היום בשבוע. היום בשבוע באנגלית. למאפיין הזה יש ערכים של Sunday,‏ Monday וכו'.

  • isoWeek שבוע בפורמט ISO בשנה. מספר השבוע לפי תקן ISO, שבו כל שבוע מתחיל ביום שני. פרטים נוספים זמינים בכתובת https://en.wikipedia.org/wiki/ISO_week_date. דוגמאות לערכים: 01,‏ 02 ו-53.

  • isoYear שנה בפורמט ISO. השנה בפורמט ISO של האירוע. פרטים נוספים זמינים בכתובת https://en.wikipedia.org/wiki/ISO_week_date. ערכים לדוגמה: 2022 ו-2023.

  • isoYearIsoWeek שבוע ISO בשנה ISO. הערכים המשולבים של isoWeek ו-isoYear. ערכים לדוגמה: 201652 ו-201701.

  • yearMonth שנה וחודש. הערכים המשולבים של year ו-month. ערכים לדוגמה: 202212 או 202301.

  • yearWeek שנה ושבוע. הערכים המשולבים של year ו-week. ערכים לדוגמה: 202253 או 202301.

2023-02-27 נוספו מאפייני מסחר אלקטרוני.

  • itemListPosition המיקום של רשימת הפריטים. המיקום של פריט ברשימה (למשל, מוצר שאתם מוכרים). המאפיין הזה מאוכלס בתגים באמצעות הפרמטר 'index' במערך הפריטים.

  • itemLocationID מזהה מיקום הפריט. המיקום הפיזי שמשויך לפריט (למשל, המיקום הפיזי של החנות). מומלץ להשתמש במזהה המקום ב-Google שתואם לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית. השדה הזה מאוכלס בתהליך התיוג באמצעות הפרמטר location_id במערך הפריטים.

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

2023-02-21 נוספו המאפיינים 'דף נחיתה + מחרוזת שאילתה' ו'דף נחיתה + מחרוזת שאילתה + נתיב הדף'.

  • landingPagePlusQueryString דף נחיתה + מחרוזת שאילתה. נתיב הדף + מחרוזת השאילתה שמשויכים לצפייה הראשונה בדף במהלך סשן.

השדה הזה מחליף את המאפיין landingPage שהוצא משימוש, והוא יתעדכן כך שלא יחזיר מחרוזת שאילתה ב-14 במאי 2023.

2023-01-28 נוספו המדדים 'צפיות לכל משתמש' ו'משתמשים שגללו'.

  • screenPageViewsPerUser צפיות לכל משתמש. מספר המסכים באפליקציה או הדפים באתר שהמשתמשים צפו בהם לכל משתמש פעיל. מספר הצפיות החוזרות באותו הדף או אותו המסך נספרות. (screen_view + page_view events) / active users.

  • scrolledUsers משתמשים שביצעו גלילה. מספר המשתמשים הייחודיים שגללו לפחות 90% מהדף.

2023-01-23 נוספו המאפיינים 'יבשת' ו'מזהה יבשת'.

  • continent יבשת. היבשת שממנה בוצעה פעילות המשתמש. לדוגמה, Americas או Asia.

  • continentId מזהה יבשת. המזהה הגיאוגרפי של היבשת שממנה בוצעה פעילות המשתמש, שמבוסס על כתובת ה-IP שלו.

2023-01-23 נוספה המאפיין 'מזהה מסנן של נתוני בדיקה'.

  • testDataFilterId מזהה מסנן של נתוני בדיקה. המזהה המספרי של מסנן נתונים במצב בדיקה. המטרה של מסנני נתונים היא לכלול נתוני אירועים בדוחות או להחריג אותם מהם על סמך ערכי פרמטר-אירוע. מידע נוסף זמין במאמר https://support.google.com/analytics/answer/10108813.

18 באוקטובר 2022 נוספו מדדי Google Ads.

  • advertiserAdClicks קליקים על מודעות. מספר הפעמים הכולל שמשתמשים לחצו על מודעה כדי להגיע לנכס.
  • advertiserAdCost עלות המודעות. הסכום הכולל ששילמת תמורת המודעות.
  • advertiserAdCostPerClick עלות לקליק ב-Google Ads. העלות לקליק ב-Google Ads היא העלות של המודעה חלקי הקליקים על המודעה, ולרוב היא מקוצרת ל-CPC.
  • advertiserAdCostPerConversion עלות להמרה. העלות להמרה היא העלות של המודעות חלקי ההמרות.
  • advertiserAdImpressions חשיפות של מודעות. מספר החשיפות הכולל.
  • returnOnAdSpend החזר על הוצאות פרסום. ההחזר על הוצאות הפרסום (ROAS) הוא ההכנסה הכוללת חלקי עלות המודעות של המפרסם.

17 באוקטובר 2022 נוספו מדדים ברמת הפריט.

  • itemsAddedToCart פריטים נוספו לעגלת הקניות. מספר היחידות שנוספו לעגלת הקניות של פריט יחיד.
  • itemsCheckedOut פריטים שעברו לשלב התשלום. מספר היחידות שעברו לשלב התשלום של פריט יחיד.
  • itemsClickedInList פריטים שלחצו עליהם ברשימה. מספר היחידות שמשתמשים לחצו עליהן ברשימה של פריט יחיד.
  • itemsClickedInPromotion פריטים שלחצו עליהם בקידום מכירות. מספר היחידות של פריט יחיד שמשתמשים לחצו עליהן בקידום מכירות.
  • itemsViewed פריטים שנצפו. מספר היחידות שצפו בהן בפריט יחיד.
  • itemsViewedInList פריטים שנצפו ברשימה. מספר היחידות שצפו בהן ברשימה של פריט יחיד.
  • itemsViewedInPromotion פריטים שנצפו בקידום מכירות. מספר היחידות שצפו בהן בקידום מכירות של פריט יחיד.

13 בספטמבר 2022 הודעה על שינויים בתאימות של Schema.

ב-1 בדצמבר 2022 ייכנסו לתוקף השינויים הבאים שמשביתים את התאימות לאחור:

  1. מאפיינים ברמת הפריט כמו itemName הופכים ללא תואמים למדדים ברמת האירוע כמו eventCount. מאפיינים ברמת הפריט עדיין יהיו תואמים למדדים ברמת הפריט, כמו itemRevenue, למדדים שמבוססים על משתמשים, כמו activeUsers, ולמדדים שמבוססים על סשנים, כמו sessions.

  2. מאפייני שיוך (Attribution) כמו source הופכים ללא תואמים למדדים מסוימים ברמת האירוע, כמו eventCount. מאפייני השיוך עדיין יהיו תואמים למדדים שניתנים לשיוך, כמו conversions, למדדים שמבוססים על משתמשים, כמו activeUsers, ולמדדים שמבוססים על סשנים, כמו sessions.

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

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

01 בספטמבר 2022 שינויים במכסות.

  • המכסות של Requests per day , Requests Per Minute, Requests Per Minute Per User יוסר מ-Data API.

  • הוספנו את המכסה Tokens Per Project Per Property Per Hour ל-API.

  • כל בקשה צורכת מכסה גם ב-Tokens Per Property Per Hour וגם ב-Tokens Per Project Per Property Per Hour.

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

03 באוגוסט 2022 נוספו מאפייני SA360 ברמת הסשן.

  • sessionSa360AdGroupName שם קבוצת המודעות ב-SA360 שמשויך לסשן. שם קבוצת המודעות מ-Search Ads 360 שהובילה לסשן הזה.

  • sessionSa360CampaignName הקמפיין ב-SA360 שהוביל לסשן. שם הקמפיין מ-Search Ads 360 שהוביל לסשן הזה.

  • sessionSa360CreativeFormat פורמט הקריאייטיב של הסשן ב-SA360. סוג הקריאייטיב ב-Search Ads 360 שהוביל לסשן הזה. לדוגמה, 'מודעה רספונסיבית לרשת החיפוש' או 'מודעת טקסט מורחבת'.

  • sessionSa360EngineAccountId מספר חשבון מנוע החיפוש של הסשן ב-SA360. המזהה של חשבון מנוע החיפוש ב-SA360 שהוביל לסשן הזה.

  • sessionSa360EngineAccountName שם חשבון מנוע החיפוש של הסשן ב-SA360. השם של חשבון מנוע החיפוש ב-SA360 שהוביל לסשן הזה.

  • sessionSa360EngineAccountType סוג חשבון מנוע החיפוש של הסשן ב-SA360. הסוג של חשבון מנוע החיפוש ב-Search Ads 360 שהוביל לסשן הזה. לדוגמה, 'google ads',‏ 'bing' או 'baidu'.

  • sessionSa360Keyword טקסט מילת המפתח של הסשן ב-SA360. מילת המפתח במנוע החיפוש מ-Search Ads 360 שהובילה לסשן הזה.

  • sessionSa360Medium אמצעי ההגעה לאתר של הסשן ב-SA360. מילת המפתח במנוע החיפוש מ-Search Ads 360 שהובילה לסשן הזה. לדוגמה, 'cpc'.

  • sessionSa360Query השאילתה של הסשן ב-SA360. שאילתת החיפוש מ-Search Ads 360 שהובילה לסשן הזה.

  • sessionSa360Source המקור של הסשן ב-SA360. מקור התנועה מ-Search Ads 360 שהובילה לסשן הזה. לדוגמה, 'example.com' או 'google'.

  • המאפיינים sessionCampaignId ו-sessionCampaignName תומכים עכשיו בקמפיינים ב-Search Ads 360.

11 ביולי 2022 נוספו מדדי שיעור המרות.

שיעור המרה

  • sessionConversionRate אחוז הסשנים שבהם הופעל אירוע המרה כלשהו.

  • userConversionRate אחוז המשתמשים שהפעילו אירוע המרה כלשהו.

מדדי שיעורי המרה להמרה אחת

  • sessionConversionRate:event_name אחוז הסשנים שהופעל בהם אירוע המרה ספציפי.

  • userConversionRate:event_name אחוז המשתמשים שהפעילו אירוע המרה ספציפי.

05 במאי 2022 הוספנו פונקציונליות של דיווח על משפכים לערוץ אלפא.

  • השיטה runFunnelReport נוספה לגרסה v1alpha של ה-API, והיא מאפשרת לקבל דוח משפך מותאם אישית של נתוני האירועים ב-Google Analytics.

  • נכון לעכשיו השיטה מבוססת על יציבות אלפא במטרה לקבל משוב על תחביר ויכולות לפני המעבר לבטא. נשמח שתמלאו את המשוב על דוח המשפך של Google Analytics Data API כדי להביע את דעתכם על ה-API הזה.

2022-02-16 נוספו מאפיינים חדשים.

הוספה ידנית של מונחים ותוכן

  • firstUserManualAdContent תוכן מודעה שנוסף ידנית המשויך לנקודת הצירוף של המשתמש. תוכן המודעה שדרכו המשתמש צורף לראשונה. מאוכלס על ידי הפרמטר utm_content.

  • firstUserManualTerm מונח שנוסף ידנית המשויך לנקודת הצירוף של המשתמש. המונח שדרכו המשתמש צורף לראשונה. מאוכלס על ידי הפרמטר utm_term.

  • manualAdContent תוכן מודעה שנוסף ידנית. תוכן המודעה שמשויך לאירוע ההמרה. מאוכלס על ידי הפרמטר utm_content.

  • manualTerm מונח שנוסף ידנית. המונח שמשויך לאירוע ההמרה. מאוכלס על ידי הפרמטר utm_term.

  • sessionManualAdContent תוכן מודעה שנוסף ידנית המשויך לסשן. תוכן המודעה שהוביל לסשן. מאוכלס על ידי הפרמטר utm_content.

  • sessionManualTerm מונח שנוסף ידנית המשויך לסשן. המונח שהניב סשן. מאוכלס על ידי הפרמטר utm_term.

ניתוח קריסות

  • crashAffectedUsers משתמשים שהושפעו מקריסות. מספר המשתמשים שדיווחו על קריסה בשורה הזו בדוח.

  • crashFreeUsersRate שיעור המשתמשים ללא קריסות.

אפליקציה/אתר

  • averageSessionDuration משך הזמן הממוצע (בשניות) של סשנים של משתמשים.

  • newVsReturning משתמשים חדשים או חוזרים.

  • screenPageViewsPerSession צפיות לכל סשן.

  • landingPage דף נחיתה. נתיב הדף + מחרוזת השאילתה שמשויכים לצפייה הראשונה בדף במהלך סשן.

  • platformDeviceCategory הפלטפורמה וסוג המכשיר שבהם האתר או האפליקציה לנייד פעלו.

אפליקציה לנייד

  • averagePurchaseRevenuePerUser הכנסה ממוצעת מרכישה לכל משתמש.

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

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

  • dauPerMau משתמשים פעילים ביום / משתמשים פעילים בחודש. האחוז הממוצע של משתמשים פעילים ב-30 הימים שהם גם משתמשים פעילים במשך יום אחד.

  • dauPerWau משתמשים פעילים ביום / משתמשים פעילים בשבוע. האחוז הממוצע של משתמשים פעילים במהלך 7 ימים שהם גם משתמשים פעילים במשך יום אחד.

  • wauPerMau משתמשים פעילים בשבוע / משתמשים פעילים בחודש. האחוז הממוצע של משתמשים פעילים ב-30 הימים האחרונים שהם גם משתמשים פעילים ב-7 הימים האחרונים.

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

  • transactionsPerPurchaser עסקאות לכל רוכש.

קמפיין Google Ads

  • firstUserGoogleAdsCampaignType סוג הקמפיין ב-Google Ads שדרכו המשתמש צורף לראשונה.

  • googleAdsCampaignType סוג הקמפיין ב-Google Ads שמשוייך לאירוע ההמרה.

  • sessionGoogleAdsCampaignType סוג הקמפיין ב-Google Ads שהוביל לסשן הזה.

07 בספטמבר 2021 נוספו מאפייני תאריך/שעה חדשים.

  • dateHourMinute הערכים המשולבים של התאריך, השעה והדקה בפורמט YYYYMMDDHHMM.

  • minute הדקה הדו-ספרתית של השעה שבה האירוע נרשם ביומן.

  • nthMinute מספר הדקות שחלפו מאז תחילת טווח התאריכים.

07 בספטמבר 2021 נוספו מאפיינים חדשים שמאוכלסים על ידי פרמטרים של אירועים.

  • achievementId מזהה ההישג במשחק עבור אירוע מסוים.

  • character דמות השחקן במשחק עבור אירוע מסוים.

  • fileExtension הסיומת של הקובץ שהורדתם.

  • fileName נתיב הדף של הקובץ שהורד.

  • groupId מזהה קבוצת השחקנים במשחק עבור אירוע מסוים.

  • linkClasses מאפיין ה-HTML class של קישור לאתר אחר.

  • linkDomain דומיין היעד של הקישור היוצא.

  • linkId מאפיין ה-HTML ‏id של קישור לאתר אחר או של קובץ שמורידים.

  • linkText טקסט הקישור להורדת הקובץ.

  • linkUrl כתובת ה-URL המלאה של קישור לאתר אחר או של קובץ שמורידים.

  • method השיטה שבה אירוע הופעל.

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

  • pageLocation הפרוטוקול, שם המארח, נתיב הדף ומחרוזת השאילתה של דפי האינטרנט שבהם ביקר המשתמש.

  • pageReferrer כתובת ה-URL המלאה של האתר המפנה, כולל שם המארח והנתיב.

  • percentScrolled האחוז מתוך הדף שהמשתמש גלל בו (לדוגמה, '90').

  • searchTerm המונח שהמשתמש חיפש.

  • videoProvider מקור הסרטון (לדוגמה, 'youtube').

  • videoTitle השם של הסרטון.

  • videoUrl כתובת ה-URL של הסרטון.

  • visible הפונקציה מחזירה את הערך 'true' אם התוכן גלוי.

  • unifiedPagePathScreen נתיב הדף (באתר) או סיווג המסך (באפליקציה) שבו האירוע נרשם ביומן.

07 בספטמבר 2021 שינויים בסכימה של ה-API.

שינויים במאפיינים קיימים:

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

הודעה על שינויים קרובים:

  • firstUserTrafficOrigin מקור התנועה שדרכו המשתמש צורף לראשונה. אין להסתמך על כך שהשדה הזה יחזיר את הערך 'ידני' לגבי תנועה שמשתמשת ב-UTMs. השדה הזה יתעדכן כך שיחזיר את הערך '(not set)' במסגרת השקת תכונה שצפויה בקרוב.

  • sessionTrafficOrigin מקור התנועה בקמפיין של הסשן. אין להסתמך על כך שהשדה הזה יחזיר את הערך 'ידני' לגבי תנועה שמשתמשת ב-UTMs. השדה הזה יתעדכן כך שיחזיר את הערך '(not set)' במסגרת השקת תכונה שצפויה בקרוב.

  • trafficOrigin מקור התנועה בקמפיין של אירוע ההמרה. אין להסתמך על כך שהשדה הזה יחזיר את הערך 'ידני' לגבי תנועה שמשתמשת ב-UTMs. השדה הזה יתעדכן כך שיחזיר את הערך '(not set)' במסגרת השקת תכונה שצפויה בקרוב.

07 בספטמבר 2021 נוספה ל-API השיטה checkCompatibility.

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

2021-07-21 שינויים בדיווח בזמן אמת.

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

2021-07-21 מאפיינים חדשים של קיבוץ ערוצים.

הוספנו מאפיינים חדשים של קיבוץ ערוצים לסכימה של דיווח ב-Data API:

  • firstUserDefaultChannelGrouping קיבוץ ערוצים שמוגדר כברירת מחדל – נקודת הצירוף של המשתמש.

  • defaultChannelGrouping קיבוץ ערוצים שמוגדר כברירת מחדל.

שינויים בסכימה של ה-API ב-10 ביוני 2021.

  • המאפיין minutesAgo נוסף לסכימה של Data API בזמן אמת, וניתן להשתמש בו בשאילתות לשיטה runRealtimeReport. המאפיין הזה מכיל את מספר הדקות שחלפו מאז שהאירוע נאסף. 00 היא הדקה הנוכחית, ו-01 היא הדקה הקודמת.

  • המאפיין googleAdsCreativeId נוסף לסכימה של Data API. המאפיין הזה מכיל את המזהה של הקריאייטיב ב-Google Ads שמשויך לאירוע ההמרה.

  • המאפיין sessionGoogleAdsCreativeId נוסף לסכימה של Data API. המאפיין הזה מכיל את המזהה של הקריאייטיב ב-Google Ads שהוביל לסשן באתר או באפליקציה.

  • השם של המאפיין firstUserCreativeId השתנה ל-firstUserGoogleAdsCreativeId בהסכימה של Data API. המאפיין הזה מכיל את המזהה של נכס הקריאייטיב ב-Google Ads שדרכו המשתמש צורף לראשונה.

09 באפריל 2021 גרסת הבטא של Google Analytics Data API v1 שוחררה.

  • נקודת הקצה ל-API עודכנה ל-https://analyticsdata.googleapis.com/v1beta.

  • השיטות runReport, ‏ runPivotReport, ‏ batchRunReports ו-batchRunPivotReports מקבלות עכשיו את המזהה של נכס Google Analytics 4 בפרמטר property של נתיב כתובת ה-URL, במקום בשדה entity של גוף הבקשה:

    POST https://analyticsdata.googleapis.com/v1beta/GA4_PROPERTY_ID:batchRunReports

  • ספריות הלקוח של ה-API עודכנו כך שישתמשו בנקודת הקצה החדשה של ה-API.

2021-02-19 שינויים בחלוקה לדפים.

  • גודל התגובה של הדוח שמוגדר כברירת מחדל הוגדל מ-10 ל-10,000 שורות של נתוני אירועים.

  • הערך "limit" : -1 ששימש לציון ניסיון לאחזר את כל השורות כבר לא נתמך ב-RunReportRequest.

  • הערך המקסימלי של השדה limit מוגדר כ-100000. משתמשים בחלוקה לדפים כדי לאחזר דוחות שמכילים יותר מ-100,000 שורות.

2021-02-08 מאפיינים ומדדים חדשים למסחר אלקטרוני.

נוספו מאפיינים ומדדים חדשים של מסחר אלקטרוני לסכימה של ה-API:

מאפיינים: adFormat, adSourceName, adUnitName, itemBrand, itemCategory, itemCategory2, itemCategory3, itemCategory4, itemCategory5 itemId, itemListId, itemListName, itemName, itemPromotionCreativeName, itemPromotionId, itemPromotionName, orderCoupon, transactionId.

מדדים: adUnitExposure, addToCarts, cartToViewRate, checkouts, ecommercePurchases, firstTimePurchasers, itemListClickThroughRate, itemListClicks, itemListViews, itemPromotionClickThroughRate, itemPromotionClicks, itemPromotionViews, itemPurchaseQuantity, itemRevenue, itemViews, publisherAdClicks, publisherAdImpressions, totalPurchasers.

08 בפברואר 2021 נוספו מאפייני קמפיין חדשים.

נוספו מימדי קמפיינים חדשים לסכימת ה-API: campaignId, campaignName, googleAdsAccountName, googleAdsAdGroupId, googleAdsAdGroupName, googleAdsAdNetworkType, source, trafficOrigin

08 בפברואר 2021 שינויים במאפיינים dayOfWeek ו-week.

  • הערך של המאפיין dayOfWeek מתחיל עכשיו ב-0 במקום ב-1.

  • הערך של המאפיין week מתחיל עכשיו ב-01 ומחזיר מספר בן שתי ספרות מ-01 עד 53. כל שבוע מתחיל ביום ראשון. ה-1 בינואר חל תמיד בשבוע מספר 01.

28 בינואר 2021 נוספו וריאנטים של צבירת נתונים למדדים מותאמים אישית.

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

2021-01-28 נוספו מאפייני תאריך ושעה חדשים.

המאפיינים החדשים הבאים נוספו לסכימה של ה-API: hour, nthHour, nthYear, dateHour.

2021-01-28 מספר הטוקנים של המכסה שחויב על כל שאילתה ב-Data API הופחת.

ב-Data API הופחתה כמות טוקני המכסה שחויבתם עליהם לכל שאילתה. המגבלות על מכסות של אסימונים למכסות נכס לשעה וליום לא השתנו.

2020-11-09 השיטה getUniversalMetadata נמחקה.

השיטה getUniversalMetadata נמחקה. יש להשתמש ב-getMetadata. הטווח המקסימלי של שנה אחת למועדים לכל בקשת API הוסר.

2020-11-02 נוספה שיטה לדיווח בזמן אמת.

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

19 באוקטובר 2020 עודכנו פריטי המידע שנוצרו בתהליך פיתוח (artifacts) של ספריית הלקוח.

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

13 באוקטובר 2020 השם של נכסי 'אפליקציה + אתר' השתנה ל-Google Analytics 4‏ (GA4).

2020-10-08 נוספה ל-API השיטה getMetadata.

השיטה getMetadata מחזירה מאפיינים ומדדים מותאמים אישית שזמינים למזהה הנכס ב-GA4 שצוין, וגם מטא-נתונים אוניברסליים.

08 באוקטובר 2020 מאפיינים ומדדים מותאמים אישית זמינים בדוחות.

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