יומן שינויים

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

‫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, כולל סוג החיתוך, הודעה תיאורית והתאריכים שמושפעים.

‫2026-04-23 נוספה תמיכה בדיווח על המרות בגרסה 1 אלפא

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

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

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

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

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

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

‫15 באוקטובר 2024 נוספה התכונה 'רמת הדגימה' לשיטה 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 דקות.

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

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

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

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

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

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

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

‫2024-05-08 הוספנו ל-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 יש רשומה עם שם ה-API של ההמרה שהוצא משימוש.

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

הוספנו לסכימה של 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

  • 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 שמשויכים לסשן

‫2024-03-06 תמיכה בקהלים של משתמשים לא פעילים בייצוא קהלים.

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

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

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

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

אפשר לציין את השדות 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.

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

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

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

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

‫2023-12-05 רשימות קהלים זמינות ב-Data API v1 beta כייצוא קהלים

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

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

2023-11-28 נוסף samplingMetadatas לתשובת הדוח

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

‫2023-11-28 נוספה פונקציונליות של ייצוא חוזר של רשימת חברים בקהל ל-Data API v1 alpha

נוספו שיטות properties.recurringAudienceLists.create, properties.recurringAudienceLists.create, properties.recurringAudienceLists.list ל-Data API v1 alpha.

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

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

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

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

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

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

deviceId isAdsPersonalizationAllowed
ABC true
DAC false
ABC false
AAA true

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

deviceId isAdsPersonalizationAllowed
AAA true
ABC false
ABC true
DAC false

‫15 באוגוסט 2023 נוסף המאפיין isLimitedAdTracking לסכימת הייצוא של רשימת החברים בקהל

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

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

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

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

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

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

‫10 באוגוסט 2023 נוסף המאפיין isAdsPersonalizationAllowed לסכימת הייצוא של רשימת החברים בקהל

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

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

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

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

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

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

נוספה תמיכה ב-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 Per Project Per Property Per Hour 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 Per Project Per Property Per Hour 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 ברמת האירוע או הפריט. אם הפרמטר מצוין ברמת האירוע וברמת הפריט, נעשה שימוש בפרמטר ברמת הפריט.

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

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

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

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

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

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

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

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

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

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

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

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

  • advertiserAdClicks קליקים על מודעות. מספר הפעמים הכולל שמשתמשים לחצו על מודעה כדי להגיע לנכס.
  • advertiserAdCost עלות המודעות. הסכום הכולל ששילמתם על המודעות
  • advertiserAdCostPerClick עלות לקליק ב-Google Ads. העלות לקליק על מודעה היא עלות המודעה חלקי מספר הקליקים על המודעה, ולעתים קרובות היא מסומנת בקיצור 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 יהיו תואמים רק לקבוצה מוגבלת של מאפיינים ומדדים.

‫2022-09-01 שינויים במכסה.

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

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

‫2022-08-03 נוספו מאפיינים ב-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 בפברואר 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 משתמשים פעילים ביום / משתמשים פעילים בחודש. האחוז היומי הממוצע של משתמשים פעילים ב-30 הימים שהם גם משתמשים פעילים במשך יום אחד.

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

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

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

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

קמפיין Google Ads

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

‫2021-09-07 נוספה שיטת checkCompatibility ל-API.

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

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

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

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

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

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

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

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

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

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

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

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

‫2021-04-09 גרסת הבטא של 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 בפברואר 2021 שינויים במספור העמודים.

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

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

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

‫8 בפברואר 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.

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

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

‫2021-02-08 שינויים במאפיינים dayOfWeek, week.

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

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

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

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

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

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

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

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

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

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

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

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

‫19 באוקטובר 2020: עודכנו ארטיפקטים של ספריות לקוח.

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

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

‫2020-10-08 נוסף ל-API קוד method ‏getMetadata.

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

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

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