יומן שינויים

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

15.12.2023 דוחות גישה לנתונים זמינים עכשיו בכל הנכסים ב-Google Analytics.

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

למידע נוסף, עיינו בתיעוד הסכימה.

15.12.2023 המאפיין accessDateHour נוסף לסכימה של דוח הגישה לנתונים.

המאפיין accessDateHour שנוסף לסכימה של דוח הגישה לנתונים. הדוח מכיל את התאריך והשעה שבהם המשתמש ב-Google Analytics ניגש לנתוני הדיווח ב-Google Analytics.

2023-10-05 בנכסים עם מודלים של שיוך מסוג קליק ראשון, לינארי, דעיכה לאורך זמן ומבוסס-מיקום, מוגדרים כברירת מחדל ל-DDA חוצה-ערוצים.

החל מאמצע אוקטובר 2023, המודלים של השיוך (Attribution) קליק ראשון, לינארי, דעיכה לאורך זמן ומבוסס-מיקום לא יהיו זמינים לשימוש עם השיטה UpdateAttributionSettings בכל הנכסים.

אם הנכס מוגדר כרגע לשימוש באחד מהמודלים האלה, הוא ישתנה לשיוך מבוסס-נתונים (DDA) חוצה-ערוצים. עדיין יוצגו לכם האפשרויות להשתמש במקום זאת במודל 'קליק אחרון בכל הערוצים' או 'קליק אחרון עם העדפה ל-Google Ads'.

01-09-2023 נוספו שיטות להגדרת סכימה של ערכי המרות ב-SKAdNetwork.

GetSKAdNetworkConversionValueSchema, CreateSKAdNetworkConversionValueSchema, DeleteSKAdNetworkConversionValueSchema, UpdateSKAdNetworkConversionValueSchema, ListSKAdNetworkConversionValueSchemas נוספו ל-Admin API v1alpha.

הפונקציונליות הזו מאפשרת לנהל את הגדרת הסכימה של ערכי ההמרות ב-SKAdNetwork עבור מקור נתונים ב-iOS.

01-09-2023 נוספה שיטת UpdateConversionEvent.

השיטה UpdateConversionEvent נוספה ל-Admin API v1beta.

השם של השדה BigQueryLink.enterprise_export_enabled 2023-09-01 השתנה ל-fresh_daily_export_enabled.

השדה enterprise_export_enabled של המשאב BigQueryLink שונה ל-fresh_daily_export_enabled.

14.07.2023 שינויי תוכנה שעלולים לגרום לכשלים בשיטות properties.updateAttributionSettings, properties.getAttributionSettings.

החל מ-24 ביולי 2023, יבוצעו שינויי תוכנה שעלולים לגרום לכשלים ב-Admin API v1 בגרסת אלפא. השינויים ישפיעו על הפונקציונליות של השיטות properties.getAttributionSettings ו-properties.updateAttributionSettings.

שמות החברים בקבוצה ReportingAttributionModel ישתנו באופן הבא:

שם ישן השם החדש
CROSS_CHANNEL_DATA_DRIVEN PAID_AND_ORGANIC_CHANNELS_DATA_DRIVEN
CROSS_CHANNEL_LAST_CLICK PAID_AND_ORGANIC_CHANNELS_LAST_CLICK
CROSS_CHANNEL_FIRST_CLICK PAID_AND_ORGANIC_CHANNELS_FIRST_CLICK
CROSS_CHANNEL_LINEAR PAID_AND_ORGANIC_CHANNELS_LINEAR
CROSS_CHANNEL_POSITION_BASED PAID_AND_ORGANIC_CHANNELS_POSITION_BASED
CROSS_CHANNEL_TIME_DECAY PAID_AND_ORGANIC_CHANNELS_TIME_DECAY
ADS_PREFERRED_LAST_CLICK GOOGLE_PAID_CHANNELS_LAST_CLICK

שמות החברים בקבוצה AdsWebConversionDataExportScope ישתנו באופן הבא:

שם ישן השם החדש
CROSS_CHANNEL PAID_AND_ORGANIC_CHANNELS
ADS_PREFERRED GOOGLE_PAID_CHANNELS

10.07.2023 נוסף השדה ads_web_conversion_data_export_scope לסוג AttributionSettings

הוספנו את השדה ads_web_conversion_data_export_scope לסוג AttributionSettings, שאפשר לשנות אותו באמצעות השיטה UpdateAttributionSettings.

5 ביוני 2023 הוצאה משימוש של מודלים של שיוך מסוג 'קליק ראשון', 'לינארי', 'דעיכה לאורך זמן' ו'מבוסס-מיקום'.

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

תוכלו לקרוא מידע נוסף בהודעה על המוצר Google Analytics.

GetAdSenseLink, CreateAdSenseLink, DeleteAdSenseLink, ListAdSenseLinks נוספו ל-Admin API v1alpha.

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

31.5.2023 נוספה שיטה לחיפוש נכס GA4 מקושר.

השיטה FetchConnectedGa4Property שנוספה ל-Admin API v1alpha

הפונקציונליות הזו מאפשרת לקבל מידע על נכס GA4 שמקושר לנכס Universal Analytics בתהליך ההעברה מ-GA4.

31.5.2023 נוספה שיטה לניהול כללים ליצירת אירועים.

השיטות CreateEventCreateRule, UpdateEventCreateRule, DeleteEventCreateRule, ListEventCreateRules, GetEventCreateRule שנוספו ל-Admin API v1alpha.

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

31.5.2023 נוספו שיטות לניהול קבוצות ערוצים בהתאמה אישית.

נוספו שיטות GetChannelGroup, ListChannelGroups, CreateChannelGroup, UpdateChannelGroup, DeleteChannelGroup ל-Admin API v1alpha.

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

אחרי שיוצרים קבוצות ערוצים בהתאמה אישית, אפשר להשתמש בהן באמצעות Google Analytics Data API v1.

31.03.2023 נוספו שיטות לניהול של הגדרות מדידה משופרות.

השיטות properties.dataStreams.updateEnhancedMeasurementSettings, properties.dataStreams.getEnhancedMeasurementSettings שנוספו ל-Admin API v1alpha.

הפונקציונליות הזו מאפשרת לנהל את הגדרות המדידה המשופרות של מקור נתוני אתר בנכס GA4.

31.03.2023 נוספו שיטות לניהול תגי אתר מחוברים.

השיטות properties.createConnectedSiteTag, properties.deleteConnectedSiteTag, properties.listConnectedSiteTags שנוספו ל-Admin API v1alpha.

הפונקציונליות הזו מאפשרת לנהל תגי אתרים מחוברים, והיא שימושית לצורך העברת תנועה מנכס Universal Analytics אל נכס Google Analytics 4.

31.03.2023 נוספו שיטות runAccessReport ברמת החשבון או ברמת הנכס לגרסת הבטא של Admin API.

השיטות properties.runAccessReport ו-accounts.runAccessReport שנוספו לגרסת v1beta של Admin API. השיטות מחזירות דוח מותאם אישית של רשומות גישה לנתונים.

24.02.2023 נוספו שיטות לניהול של קבוצות נתונים מורחבות.

המשאב ExpandedDataSet נוסף לגרסת v1alpha של ה-API, יחד עם הפעולות המתאימות properties.expandedDataSets.create, properties.expandedDataSets.delete, properties.expandedDataSets.patch, properties.expandedDataSets.list, properties.expandedDataSets.get. ניתן להשתמש בפונקציונליות הזו לניהול קבוצות נתונים מורחבות ב-Google Analytics 360.

המשאב AccessBinding נוסף לגרסת v1alpha של ה-API, יחד עם הפעולות הבאות:

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

הפונקציונליות User Links תוסר מ-Admin API v1 alpha ב-1.6.23

24.02.2023 הוצאה משימוש של שיטות הבדיקה של הרשאות המשתמשים.

השיטות הבאות הוצאו משימוש ויוסרו מ-Admin API v1 אלפא ב-1.6.23:

24.02.2023 נוספו שיטות לניהול קהלים.

המשאב Audience נוסף לגרסת v1alpha של ה-API, יחד עם הפעולות המתאימות properties.audience.create, properties.audience.archive, properties.audience.patch, properties.audience.list, properties.audience.get.

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

15.02.2023 נוספו שיטות לביטול הסכמה לתהליך ההגדרה האוטומטי של GA4.

properties.setAutomatedGa4ConfigurationOptOut, פעולות properties.fetchAutomatedGa4ConfigurationOptOut נוספו לגרסת v1alpha של ה-API.

הפונקציונליות הזו מאפשרת לנהל את סטטוס ביטול ההסכמה לתהליך ההגדרה האוטומטי של GA4 בנכס UA.

המשאב BigQueryLink נוסף לגרסת v1alpha של ה-API, יחד עם הפעולות properties.bigQueryLinks.get ו-properties.bigQueryLinks.list התואמות.

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

המשאב SearchAds360Link נוסף לגרסת v1alpha של ה-API, יחד עם הפעולות המתאימות properties.searchAds360Links.create, properties.searchAds360Links.delete, properties.searchAds360Links.patch, properties.searchAds360Links.list, properties.searchAds360Links.get.

הפונקציונליות הזו מאפשרת לנהל את הקישורים בין נכס GA4 לישות ב-Search Ads 360.

15.2.2023 שינויי תוכנה שעלולים לגרום לכשלים.

15.02.2023 שינויים שונים.

11.08.2022 runAccessReport נוספה אל Admin API v1alpha.

השיטה properties.runAccessReport שנוספה לגרסת v1alpha של Admin API. הוא מחזיר דוח מותאם אישית של רשומות גישה לנתונים. הדוח מספק תיעוד של כל פעם שמשתמש קורא נתוני דיווח של Google Analytics. דוחות הגישה לנתונים זמינים לאדמינים של נכסי Google Analytics 360.

11.07.2022: גרסת בטא של Admin API הושקה.

הושקה גרסת v1beta של Google Analytics Admin API.

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

12.10.2021 שיטות EnhancedMeasurementSettings הוסרו מה-API.

  • properties.webDataStreams.getEnhancedMeasurementSettings, שיטות properties.webDataStreams.updateEnhancedMeasurementSettings יוסרו מה-API, אבל בקרוב אפשר יהיה לשנות את ההגדרות של המדידה המשופרת דרך API.
  • השדה directRoles במשאב UserLink לא תומך יותר בתפקיד predefinedRoles/manage-users. במקום זאת, צריך להשתמש בתפקיד predefinedRoles/admin החדש, ששווה לשילוב של התפקידים הישנים predefinedRoles/edit ו-predefinedRoles/manage-users. השינוי הזה משפיע על ההתנהגות של השיטות accounts.userLinks, properties.userLinks, והוא תואם לשינויים שחלו בניהול של הרשאות גישה והגבלת גישה לנתונים ב-Google Analytics.

05.06.2021 נוספו תכונות.

התכונות הבאות נוספו ל-API:

  • השיטה accounts.searchChangeHistoryEvents נוספה ל-API. השיטה הזו מחפשת את כל השינויים בחשבון או בחשבונות הצאצא שלו על סמך קבוצת המסננים שצוינה. סיבות נפוצות הן עדכונים שיבוצעו בממשק המשתמש של Google Analytics, שינויים מתמיכת הלקוחות או שינויים אוטומטיים במערכת של Google Analytics.
  • שיטות לניהול סודות ב-Measurement Protocol שנוספו במסגרת properties.webDataStreams.measurementProtocolSecrets:
    • create יצירת סוד של Measurement Protocol.
    • delete מחיקת הסוד של 'פרוטוקול מדידת היעד'.
    • get מחפשים סוד אחד של Measurement Protocol.
    • list החזרת הסודות של פרוטוקול המדידה ברמת הצאצא בנכס ההורה שצוין.
    • patch עדכון סוד של Measurement Protocol.
  • שיטות לניהול אירועי המרה שנוספו במסגרת properties.conversionEvents:
    • create יצירת אירוע המרה עם המאפיינים שצוינו.
    • delete מחיקת אירוע המרה בנכס.
    • get מאחזרים אירוע המרה יחיד.
    • list מחזירה רשימה של אירועי המרה בנכס ההורה שצוין.
  • שיטות לניהול מאפיינים מותאמים אישית שנוספו במסגרת properties.customDimensions:
    • archive המערכת מעבירה מאפיין מותאם אישית של נכס לארכיון.
    • create יצירת מאפיין מותאם אישית.
    • get מחפשים מאפיין מותאם אישית אחד.
    • list פירוט של המאפיינים המותאמים אישית בנכס.
    • patch עדכון מאפיין מותאם אישית בנכס.
  • שיטות ניהול של מדדים מותאמים אישית שנוספו בקטע properties.customMetrics:
    • archive המערכת מעבירה מדד מותאם אישית לנכס לארכיון.
    • create מכיל מדד מותאם אישית.
    • get מחפשים מדד מותאם אישית אחד.
    • list פירוט של מדדים מותאמים אישית בנכס.
    • patch מעדכן מדד מותאם אישית בנכס.
  • נוספו שיטות properties.getGoogleSignalsSettings, properties.updateGoogleSignalsSettings שמאפשרות לשלוט בהגדרה של Google Signals בנכס Google Analytics 4.
  • delete_time, expire_time שדות פלט רק שנוספו לסוג Property.

05.06.2021 שינויי תוכנה שעלולים לגרום לכשלים.

נוספו שינויי תוכנה שעלולים לגרום לכשלים:

  • properties.iosAppDataStreams.create, שיטות properties.androidAppDataStreams.create הוסרו מה-API. כדי ליצור מקורות נתונים של אפליקציות בנכס Google Analytics 4, צריך להשתמש ב-Firebase.
  • properties.delete מחזירה עכשיו את נתוני הנכס שנמחק כסוג Property במקום להחזיר תגובה ריקה.
  • עכשיו השדה time_zone מהסוג Property הוא שדה חובה.
  • השדה deleted הוסר מהסוג Property.
  • email_address השדה UserLink לא ניתן לשינוי.
  • השדה name מסוג UserLink הוא עכשיו פלט בלבד.

28.1.2021 שינויי תוכנה שעלולים לגרום לכשלים.

שינויי תוכנה שעלולים לגרום לכשלים: - השדה update_mask נדרש לכל פעולות העדכון.

  • השם של השדה country_code שונה ל-region_code ב-Account.

  • השם של השדה url_query_parameter שונה ל-uri_query_parameter ב-EnhancedMeasurementSettings.

  • הוסר שדה parent מהערך GoogleAdsLink.

20.10.2020 נוספה תמיכה בסיכומי חשבונות.

נוספה תמיכה בשיטת סיכומי החשבון.

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

15 באוגוסט 2020: שם ה-API לניהול של אפליקציות + אתרים השתנה ל-Admin API.

שינינו את השם של ה-Management App + Web API של Google Analytics ועכשיו הוא נקרא Google Analytics Admin API. כתוצאה מכך, נקודת הקצה של ה-API השתנתה ל-analyticsadmin.googleapis.com. צריך לעדכן בהתאם את הקוד הקיים שנכתב על הגרסה הקודמת של כתובת ה-URL של נקודת הקצה ב-API ואת ספריות הלקוח בהתאם.