יומן שינויים

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

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

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

מאפייני קהל:

  • מזהה קהל אחד (audienceId). המזהה המספרי של קהל.

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

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

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

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

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

  • מזהה קמפיין ידני אחד (manualCampaignId)

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

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

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

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

  • מקור ידני של manualSource

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

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

  • מזהה קמפיין ידני אחד (firstUserManualCampaignId) המשויך לאינטראקציה הראשונה של המשתמש

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

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

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

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

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

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

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

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

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

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

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

  • אמצעי ידני להגעה לאתר – סשן אחד (sessionManualMedium)

  • מקור ידני אחד (sessionManualSource) המשויך לסשן

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • מזהה האתר ב-CM360 – סשן אחד (sessionCm360SiteId)

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

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

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

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

  • מזהה מפרסם ב-DV360 אחד (dv360AdvertiserId)

  • שם מפרסם ב-DV360 אחד (dv360AdvertiserName)

  • מזהה קמפיין אחד (dv360CampaignId) ב-DV360

  • שם קמפיין אחד (dv360CampaignName) ב-DV360

  • פורמט של קריאייטיב אחד (dv360CreativeFormat) ב-DV360

  • מזהה קריאייטיב ב-DV360 אחד (dv360CreativeId)

  • שם קריאייטיב אחד (dv360CreativeName) ב-DV360

  • מזהה Exchange ב-DV360 של dv360ExchangeId

  • שם Exchange ב-DV360 של dv360ExchangeName

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

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

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

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

  • אמצעי הגעה לאתר ב-DV360 אחד (dv360Medium)

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

  • שם שותף ב-DV360 אחד (dv360PartnerName)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • מזהה קמפיין ב-DV360 (sessionDv360CampaignId) המשויך לסשן

  • שם קמפיין ב-DV360 (sessionDv360CampaignName) המשויך לסשן

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

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

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

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

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

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

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

  • מזהה פריט אחד (sessionDv360LineItemId) ב-DV360 המשויך לסשן

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

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

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

  • 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

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

  • שם של חשבון ניהול אחד (sa360ManagerAccountName) ב-SA360

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

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

  • מקור אחד (sa360Source) ב-SA360

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

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

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

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

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

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

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

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

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

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

30 בינואר 2024 תמיכה בהתראות על תגובות לפעולה מאתר אחר (webhook) עבור 'רשימות קהלים' וב'רשימות קהלים חוזרות' ב-Data API של גרסה 1 של הגרסה האלפא.

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

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

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

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

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

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

13.12.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.11.2023 נוספה פונקציונליות של ייצוא חוזר של רשימות קהלים אל גרסת האלפא של Data API בגרסה 1

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

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

08.11.2023 נוסף ייצוא של רשימות הקהלים לפונקציונליות של Sheets ל-Data API v1 בגרסת אלפא

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

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

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

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

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

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

deviceId isAdsPersonalizationAllowed
ABC true
DAC false
ABC false
עדכון AAA true

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

deviceId isAdsPersonalizationAllowed
עדכון AAA true
ABC false
ABC true
DAC false

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

נכסים רגילים

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

נכסי Analytics 360

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

18.10.2022 נוספו מדדי מודעות.

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

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

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

הודעה על שינויי תאימות סכימה 2022-09-13.

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

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

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 נוספו מדדים של שיעור המרה.

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

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

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

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

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

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

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

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

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

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

מונח ותוכן שנוצרו ידנית

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

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

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

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

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

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

ניתוח תאונות

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

קמפיין Google Ads

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • videoTitle כותרת הסרטון.

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

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

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

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

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

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

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

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

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

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

07.09.2021 checkCompatibility נוספה ל-API.

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

21.07.2021 שינויים בדיווח בזמן אמת.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

19.02.2021: שינויים בחלוקה לדפים.

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

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

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

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

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

מידות: adFormat, adSourceName, adUnitName, itemBrand, itemCategory, itemCategory2, itemCategory3, itemCategory4, itemCategory5 itemId, itemListId, itemListName, itemName, itemPromotionCreativeName, itemPromotionId, itemPromotionName, orderCoupon, transactionId.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

08.10.2020 getMetadata נוספה ל-API.

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

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

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