יומן שינויים

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

‫14 בספטמבר 2026 נוספה תמיכה בשאילתות שיחה בגרסה 1 אלפא

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

  • גוף הבקשה מקבל שאילתה, מזהה סשן אופציונלי להמשך שיחה קודמת ופרמטר returnPropertyQuota אופציונלי.
  • התשובה מחזירה נתוני תשובה מובְנים של הצ'אט באובייקטים מסוג ResponseBlock, את מזהה הסשן ופרטים על מכסת האסימונים של הנכס באמצעות PropertyChatQuota, אם התבקש.
  • היקף ההרשאות של OAuth‏ https://www.googleapis.com/auth/analytics.chatbot.read מספק גישת קריאה ל-method‏ properties.chat.

14 בספטמבר 2026 הוספנו סיבות לחיתוך נתונים לתגובות בדוחות

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

‫23.4.2026 נוספה תמיכה בדיווח על המרות בגרסת אלפא 1

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

  • הוספנו את השדה ConversionSpec ל-RunReportRequest, שמאפשר לסנן המרות באמצעות conversionActions (מזהי פעולות המרה) ולבחור AttributionModel (DATA_DRIVEN או LAST_CLICK).
  • הוספנו את השדה Section ל-ResponseMetaData כדי לזהות אם הנתונים בדוח מגיעים מדיווח רגיל (SECTION_REPORT) או מדיווח על המרות (SECTION_ADVERTISING).

עדכנו את השיטה getMetadata בגרסת אלפא של Data API v1 כדי לספק מידע לדיווח על המרות:

  • הוספנו את השדה conversions לתגובה, שמחזירה רשימה של אובייקטים מסוג ConversionMetadata שממפים מזהים של פעולות המרה לשמות המוצגים.
  • הוספנו את השדה sections ל-DimensionMetadata ול-MetricMetadata כדי לזהות אם שדה ספציפי תואם לדיווח רגיל, לדיווח על המרות או לשניהם.

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

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

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

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

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

‫18-09-2024 הוספנו את התכונה "תמונת מצב של מכסות הנכס"

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

‫28 ביוני 2024 נוספה המכסה "שגיאות לקוח לכל פרויקט לכל נכס"

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

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

14 במאי 2024 הוספנו את התכונה "השוואות"

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

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

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

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

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

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

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

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

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

‫06-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 במרץ 2024 נוספו מאפיינים ספציפיים לשילוב, למקור תנועה ידני ולקבוצת ערוצים ראשית.

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

מאפייני קהל:

  • 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

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

  • ‫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

  • מקור ב-DV360 (dv360Source)

  • 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

  • קמפיין ב-SA360 של sa360CampaignName

  • ‫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-03-2024 תמיכה בקהלים של משתמשים לא פעילים בייצוא קהלים.

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

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

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

2024-01-30 תמיכה בהתראות Webhook לרשימות קהלים ולרשימות קהלים חוזרות ב-Data API v1 alpha.

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

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

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

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

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

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

‫13 בדצמבר 2023 פרמטרים מותאמים אישית ברמת הפריט

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

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

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

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

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

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

28.11.2023 הוספנו את samplingMetadatas לתגובת הדוח

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

28 בנובמבר 2023 נוספה פונקציונליות של ייצוא חוזר של רשימת קהלים לגרסת אלפא 1 של Data API

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

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

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

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

12 בספטמבר 2023 כללי ברירת המחדל למיון של AudienceList

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

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

deviceId isAdsPersonalizationAllowed
ABC true
DAC false
ABC false
AAA true

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

deviceId isAdsPersonalizationAllowed
AAA true
ABC false
ABC true
DAC false

15.8.2023 הוספנו את המאפיין isLimitedAdTracking לסכימת הייצוא של רשימת החברים בקהל

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

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

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

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

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

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

‫10.8.2023 הוספנו את המאפיין isAdsPersonalizationAllowed לסכימת הייצוא של רשימת החברים בקהל

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

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

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

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

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

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

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

‫11 במאי 2023 שינויים במכסת הטוקנים.

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

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

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

נכסים רגילים

שם המכסה המגבלה הישנה מגבלה חדשה
אסימוני ליבה לכל נכס ביום 25,000 200,000
אסימוני ליבה לכל נכס לשעה 5,000 40,000
מספר הטוקנים של Core לכל פרויקט, לכל נכס, לשעה 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
מספר הטוקנים של Core לכל פרויקט, לכל נכס, לשעה 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 וכו'.

  • ‫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.

27 בפברואר 2023 נוספו מאפיינים של מסחר אלקטרוני.

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

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

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

‫21 בפברואר 2023 נוסף המאפיין "דף נחיתה + מחרוזת שאילתה".

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

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

28.1.2023 נוספו המדדים "צפיות לכל משתמש" ו"משתמשים שגללו".

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

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

‫23.1.2023 נוספו המאפיינים "יבשת" ו"מזהה יבשת".

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

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

23 בינואר 2023 נוסף המאפיין "מזהה מסנן של נתוני בדיקה".

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

2022-10-18 נוספו מדדי מודעות.

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

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

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

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

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

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

  2. מאפייני שיוך (Attribution) כמו 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.

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

‫03-08-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 אחוז המשתמשים שהפעילו אירוע המרה ספציפי.

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

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

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

‫16.2.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) / משתמשים פעילים בחודש (MAU). האחוז הממוצע של משתמשים פעילים ב-30 הימים שהם גם משתמשים פעילים במשך יום אחד.

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

  • ‫wauPerMau משתמשים פעילים בשבוע (WAU) / משתמשים פעילים בחודש (MAU). האחוז הממוצע של משתמשים פעילים ב-30 הימים שהם גם משתמשים פעילים במהלך 7 ימים.

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

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

קמפיין Google Ads

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

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

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

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

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

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

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

7.9.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 נתיב הדף (אתר) או סיווג המסך (אפליקציה) שבהם האירוע תועד.

שינויים בסכימת ה-API בתאריך 07-09-2021.

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

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

הודעה על שינויים צפויים:

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

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

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

07-09-2021 הוספנו את ה-method‏ checkCompatibility ל-API.

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

21 ביולי 2021 שינויים בדוחות "פעילות בזמן אמת".

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

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

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

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

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

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

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

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

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

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

‫9.4.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 שורות, צריך להשתמש בעימוד.

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

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

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

8 בפברואר 2021 dayOfWeek, שינויים במאפיינים של week.

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

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

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

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

28.1.2021 נוספו מאפיינים חדשים של תאריך/שעה.

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

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

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

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

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

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

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

‫19.10.2020 עדכון של פריטי המידע שנוצרו בתהליך הפיתוח (Artifact) של ספריית הלקוח.

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

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

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

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

08-10-2020 מאפיינים ומדדים מותאמים אישית זמינים בדוחות.

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