יומן שינויים

לקבלת הודעות רשמיות של Google Analytics API, מומלץ להירשם ל-Google Analytics API Notify Group.

28.06.2024 נוספה המכסה 'שגיאות לקוח לכל פרויקט בכל נכס'

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

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

14.05.2024 נוספה תכונת השוואות

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

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

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

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

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

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

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

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

נוספו ל-Data API גרסה 1alpha את השיטות הבאות לטיפול במשימות הדיווח:

6.05.2024 מאפיינים חדשים של אירועים מרכזיים

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

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

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

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

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

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

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

25.03.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):

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • שם האתר ב-CM360: cm360SiteName

  • המקור אחד (cm360Source) ב-CM360

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

  • 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 – סשן

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

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

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

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

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

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

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

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

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

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

  • 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

  • מזהה בורסת פרסום ב-DV360 dv360ExchangeId

  • שם בורסת הפרסום ב-DV360 dv360ExchangeName

  • מזהה אחד (dv360InsertionOrderId) של הזמנת קמפיין ב-DV360

  • שם הזמנת קמפיין ב-DV360 אחד (dv360InsertionOrderName)

  • מזהה פריט אחד (dv360LineItemId) ב-DV360

  • שם פריט אחד (dv360LineItemName) ב-DV360

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

  • מזהה שותף ב-DV360 אחד (dv360PartnerId)

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

  • מקור אחד (dv360Source) ב-DV360

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • 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 שמשויך לנקודת הצירוף של המשתמש

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

  • 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

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

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

  • שאילתה אחת (sa360Query) ב-SA360

  • המקור של sa360Source ב-SA360

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

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

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

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

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

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

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

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

28.02.2024 הכלי לייצוא קהלים מחזיר את מזהה המשתמש שצוין בתיוג.

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

30.01.2024 תמיכה בהתראות על תגובה לפעולה מאתר אחר (webhook) עבור רשימות קהלים, רשימות קהלים חוזרות ב-Data API v1 alpha.

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

הפונקציונליות הזו מאפשרת לקבל באופן אסינכרוני התראות על תגובה לפעולה מאתר אחר (webhook) כשרשימת חברים בקהל הופכת לזמינה.

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

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

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

מידע מקיף על תאימות זמין ב-Dimensions & Metrics Explorer ב-GA4.

13.12.2023 פרמטרים מותאמים אישית ברמת הפריט

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

שם API כללי תיאור
customItem:parameter_name מאפיין מותא�� אישית ברמת הפריט לפרמטר parameter_name

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

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

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

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

28.11.2023 samplingMetadatas נוסף לדיווח על התשובה

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

28.11.2023 נוספה פונקציונליות חוזרת של ייצוא רשימות קהלים לאלפא של Data API v1

נוספו ה-methods properties.recurringAudienceLists.create, properties.recurringAudienceLists.create ו-properties.recurringAudienceLists.list ל-Data API v1 alpha.

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

8.11.2023 נוסף ייצוא של רשימות קהלים לפונקציונליות של Sheets לאלפא של Data API v1.

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

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

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

12.09.2023 כללי סדר ברירת המחדל לרשימת קהלים

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

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

deviceId isAdsPersonalizationAllowed
ABC true
DAC false
ABC false
AAA true

לאחר השינוי הזה, יישלח אליכם הדוח הבא:

deviceId isAdsPersonalizationAllowed
AAA true
ABC false
ABC true
DAC false

15.08.2023 נוסף מאפיין isLimitedAdTracking לסכימת הייצוא של רשימת הקהלים

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

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

15.08.2023 נוסף מאפיין currencyCode, מדד itemDiscountAmount

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

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

למידע נוסף על סכימת הדיווח של Data API.

10.08.2023 נוסף מאפיין isAdsPersonalizationAllowed לסכימת הייצוא של רשימת הקהלים

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

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

רשימות קהלים 2023.07.2023

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

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

19.05.2023 קבוצות ערוצים בהתאמה אישית

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

11.05.2023 שינויים במכסת האסימונים.

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

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

אחרי השינוי הזה, למרות שהחיוב על חלק מהבקשות לא יש��נה, תהיה עלייה משמעותית בחיובים בשאילתות מורכבות יותר. לדוגמה, בקשות לנתונים של יותר מ-6 חודשים יכולות לחייב 1,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
אסימוני משפך לכל נכס ליום 25,000 200,000
אסימוני משפך לכל נכס בשעה 5,000 40,000
אסימוני משפך לכל פרויקט לפי נכס לשעה 1,750 14,000

נכסי Analytics 360

שם המכסה מגבלה ישנה מגבלה חדשה
אסימוני ליבה לכל נכס ליום 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
אסימוני משפך לכל נכס ליום 250,000 2,000,000
אסימוני משפך לכל נכס בשעה 50,000 400,000
אסימוני משפך לכל פרויקט לפי נכס לשעה 17,500 140,000

02.03.2023 נוספו מאפיינים של תאריך.

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

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

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

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

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

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

27.02.2023 נוספו מאפיינים של מסחר אלקטרוני.

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

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

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

21.02.2023 נוסף המאפיין 'דף נחיתה + מחרוזת שאילתה'.

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

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

28 בינואר 2023 נוספו מדדים של 'צפיות לכל משתמש', במסגרת המדדים 'משתמשים שגללו'.

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

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

23.01.2023 נוספו המאפיינים 'יבשת' ו'מזהה יבשת'.

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

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

23.01.2023 נוסף המאפיין 'מזהה מסנן של נתוני בדיקה'.

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

18.10.2022 נוספו מדדי Google Ads.

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

17.10.2022 נוספו מדדים ברמת הפריט.

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

13.09.2022 הודעה על שינויים בתאימות לסכימה.

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

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

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

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

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

01.09.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.

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

3 באוגוסט 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 שהובילה לסשן הזה. לדוגמה, 'עלות לקליק'.

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

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

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

11.07.2022 נוספו מדדים של שיעור המרה.

שיעור המרה (CVR)

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

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

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

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

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

5.05.2022 נוספה לערוץ האלפא פונקציונליות של דיווח משפך.

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

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

16.02.2022 נוספו מאפיינים חדשים.

מונח ותוכן ידניים

  • 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 DAU / משתמשים פעילים בחודש. האחוז המצטבר של משתמשים פעילים במהלך 30 יום שהם גם משתמשים פעילים במשך יום אחד.

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

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

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

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

קמפיין Google Ads

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

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

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

7.09.2021 נוספו מאפיינים חדשים 'תאריך ושעה'.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • outbound מחזירה 'true' אם ��ק��שור ��ו��י�� לאתר שאינו חלק מהדומיין של הנכס.

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

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

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

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

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

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

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

  • visible מחזירה 'true' אם התוכן גלוי.

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

7.09.2021 שינויים בסכימת ה-API.

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

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

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

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

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

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

7.09.2021 המתודה checkCompatibility נוספה ל-API.

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

21.07.2021 שינויים בדוחות 'פעילות בזמן אמת'.

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

21.07.2021 מאפיינים חדשים של קיבוץ ערוצים.

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

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

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

10.06.2021 שינויים בסכימת ה-API.

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

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

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

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

09.04.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.

19.02.2021 שינויים בעימוד.

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

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

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

8.02.2021 מאפיינים ומדדים חדשים למסחר אלקטרוני.

מאפיינים ומדדים חדשים של מסחר אלקטרוני נוספו לסכימת ה-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.

8.02.2021 נוספו מאפיינים חדשים לקמפיין.

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

8.02.2021 dayOfWeek, שינויים במאפיינים של week.

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

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

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

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

28.01.2021 נוספו מאפיינים חדשים 'תאריך ושעה'.

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

28 בינואר 2021 ב-Data API צמצמת את מספר אסימוני המכסה שחויבו לפי שאילתה.

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

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

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

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

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

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

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

13.10.2020 השמות של נכסי אפליקציה + אתר השתנו ל-Google Analytics 4 (GA4).

8.10.2020 ה-method getMetadata נוספה ל-API.

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

8.10.2020 מאפיינים ומדדים מותאמים אישית זמינים בדוחות.

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