Google Analytics - כל יומני השינויים של Reporting API

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

הרשמה ליומני שינויים קשורים

כל יומני השינויים של Google Analytics API
–
להרשמה rss

האפשרות הזו כוללת את כל ממשקי ה-API של איסוף, הגדרה ודיווח.

כל יומני השינויים של Reporting API
–
להרשמה rss

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

זוהי הגרסה הראשונית של User Activity API

  • User Activity API מאפשר לאחזר את כל הנתונים המשויכים ל-Client-ID או ל-User-ID יחיד במהלך טווח תאריכים נתון. היא נועדה בעיקר לספק תמיכה לבעלי נכסים שרוצים לספק גישה אוטומטית לנתוני המשתמש ישירות למשתמש הזה. פרטים נוספים זמינים במדריך User Activity API.

גרסה זו כוללת שינויים במכסות והמגבלות של Analytics Real Time API.

הקריאות ל-Analytics Time Reporting API משמשות ליצירת מגבלה של 10,000 קריאות לצפייה (פרופיל) ביום, בהשוואה לקריאות אחרות ל-API של Analytics. עכשיו, קריאות ל-Analytics Real Time Reporting API מחושבות בנפרד. פירוש הדבר הוא שניתן לבצע 10,000 קריאות ביום לכל תצוגה מפורטת (פרופיל) באמצעות Analytics Real Time Reporting API וגם לבצע עוד 10,000 קריאות ביום לכל תצוגה מפורטת (פרופיל) באמצעות ממשקי API אחרים של Analytics. מידע נוסף זמין בדף מגבלות ומכסות.

השינוי הזה מספק גישה פרטנית יותר וללא תקלות לניהול המכסות, כך שקריאות תכופות באמצעות Analytics Real Time Reporting API לא יחסמו בטעות את כל הקריאות האחרות ל-Analytics API למשך שארית היום עבור פרופיל מסוים.

הגרסה הזו מגדילה את מספר השורות המקסימלי שהוחזרו בתוצאות של Analytics Reporting API v4.

מספר השורות המקסימלי שהוחזר באובייקט Analytics Reporting API v4 ReportData גדל מ-10,000 ל-100,000.

בגרסה הזו נוספה תצוגה מקדימה של מערכת מכסה מבוססת משאבים עבור Google Analytics Reporting API v4, שמאפשרת להשתמש בספי דגימה גבוהים יותר ללקוחות Analytics 360 (Premium).

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

בגרסה הזו אנחנו מוציאים משימוש את המאפיינים והמדדים הבאים:

  • ga:correlationModelId
  • ga:queryProductId
  • ga:queryProductName
  • ga:queryProductVariation
  • ga:relatedProductId
  • ga:relatedProductName
  • ga:relatedProductVariation
  • ga:correlationScore
  • ga:queryProductQuantity
  • ga:relatedProductQuantity

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

שעה

  • המאפיין החדש ga:dateHourMinute שמשלב את ga:date, את ga:hour ואת ga:minute.

הסרת נתונים

מהגרסה הזו יוסרו המאפיינים והמדדים הבאים שהוצאו משימוש:

  • ga:socialactivities
  • ga:socialactivityaction
  • ga:socialactivitydisplayname
  • ga:socialactivityendorsingurl
  • ga:socialactivitynetworkaction
  • ga:socialactivitypost
  • ga:socialactivitytagssummary
  • ga:socialactivitytimestamp
  • ga:socialactivityuserhandle
  • ga:socialactivityuserphotourl
  • ga:socialactivityuserprofileurl
  • ga:socialinteractionspervisit

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

מדדי משתמשים

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

מדדי משתמשים שהושפעו מעדכון החישוב:

  • ga:users - מספר המשתמשים הכולל בתקופת הזמן המבוקשת.
  • ga:1dayusers – המספר הכולל של משתמשים פעילים במשך יום אחד בכל יום בתקופת הזמן המבוקשת.
  • ga:7dayusers – המספר הכולל של משתמשים פעילים במשך 7 ימים בכל יום בתקופת הזמן המבוקשת.
  • ga:14dayusers – המספר הכולל של משתמשים פעילים במשך 14 ימים בכל יום בתקופת הזמן המבוקשת.
  • ga:30dayusers – המספר הכולל של משתמשים פעילים במשך 30 יום בכל יום בתקופת הזמן המבוקשת.

אירועים ייחודיים

אנחנו מתקרבים לסיום תקופת הזמן של ההוצאה משימוש של ga:uniqueEvents. אחרי 26 במרץ 2017 ההגדרה של ga:uniqueEvents תעודכן והמדד הפרטי ga:uniqueEventsTemporary יוסר מה-API. מידע נוסף זמין במסמכי עזרה בנושא אירועים ייחודיים.

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

מאפייני משתמש

  • מאפיין - ga:userBucket - לכל משתמש נתון, המאפיין 'קטגוריית משתמש' (ערכים 1 עד 100) מציין את הקטגוריה שאליה המשתמש הוקצה. לפרטים, מומלץ לעיין במאמר בדיקת קמפיינים של רימרקטינג.

הודעות שגיאה

בעבר, כש-API היה מחזיר הודעת שגיאה שגויה, Unknown dimension(s): או Unknown metric(s): בעת בקשת נתונים עם תנאים שלא מתקיימים, ה-API מחזיר עכשיו את ההודעה: Restricted metric(s): ... can only be queried under certain conditions.

מאפיינים ומדדים ב-AdSense

בתצוגות מפורטות שאינן מקושרות ל-AdSense האפשרות לשלוח שאילתות לגבי מאפיינים ומדדים של AdSense. שליחת שאילתות לגבי המאפיינים והמדדים האלה באמצעות תצוגות מפורטות שלא מקושרות ל-AdSense תוביל לשגיאה.

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

מאפיינים ומדדים ב-AdSense

בגרסה הזו תוקנה בעיה שהתחילה ב-7/1/2017 שבה שליחת שאילתות לגבי מאפיינים ומדדים של AdSense תחזיר את השגיאה "מדד לא ידוע" עבור תצוגות מפורטות שאינן מקושרות ל-AdSense.

שינויים צפויים

החל מ-31 בינואר 2017 ואילך, לא תהיה יותר אפשרות לשלוח שאילתות לגבי מאפיינים ומדדים של AdSense בתצוגות מפורטות שלא מקושרות ל-AdSense. שליחת שאילתות לגבי המאפיינים והמדדים האלה באמצעות תצוגות מפורטות שלא מקושרות ל-AdSense תוביל לשגיאה.

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

מדדים מחושבים

בגרסה הזו נוספה תמיכה במדדים מחושבים.

  • מדד – ga:calcMetric_ – הערך של המדד המחושב המבוקש, כאשר מתייחס לשם שהוגדר על ידי המשתמש של המדד המחושב. שים לב שסוג הנתונים של ga:calcMetric_ יכול להיות FLOAT, INTEGER, CURRENCY, TIME או PERCENT. פרטים נוספים זמינים במאמר מידע על מדדים מחושבים.

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

מעקב אחר אירועים

ההגדרה של ga:uniqueEvents תשתנה כדי לשקף בצורה מדויקת יותר את מספר האירועים הייחודיים. כדי להשפיע על השינוי הזה, נוציא משימוש מבחינה טכנית את המדד הנוכחי ga:uniqueEvents בהתאם למדיניות שלנו בנושא הוצאה משימוש של נתונים. אם אתם רוצים לנסות את ההגדרה החדשה, תוכלו להפנות למדד הפרטי ga:uniqueEventsTemporary, שמחשב בצורה מדויקת יותר את מספר האירועים הייחודיים. אנחנו גם נוסיף מדד חדש ga:uniqueDimensionCombinations ששומר את ההגדרה הנוכחית של ga:uniqueEvents. לאחר התקופה המתאימה להוצאה משימוש (כ-6 חודשים), המדד הפרטי ga:uniqueEventsTemporary יוסר והמדד המקורי ga:uniqueEvents ייצג בצורה נכונה את מספר האירועים הייחודיים. מידע נוסף זמין במסמכי העזרה בנושא אירועים ייחודיים.

אירועים ייחודיים

  • מדד – ga:uniqueEvents – ההגדרה של ga:uniqueEvents תשתנה בקרוב כדי לשקף בצורה מדויקת יותר את מספר האירועים הייחודיים. כדי לשמור את ההגדרה הקיימת, צריך להשתמש בפונקציה ga:uniqueDimensionCombinations. מידע נוסף זמין במסמכי עזרה בנושא אירועים ייחודיים.
  • מדד - ga:uniqueDimensionCombinations - שילובי מאפיינים ייחודיים סופר את מספר השילובים הייחודיים של מאפיין-ערך לכל מאפיין בדוח. פעולה זו מאפשרת לבנות מאפיינים משולבים (בשרשור) לאחר עיבוד, וכך מתקבל דיווח גמיש יותר ללא צורך לעדכן את הטמעת המעקב או להשתמש במשבצות ממדים מותאמות אישית נוספות. מידע נוסף זמין במסמכי עזרה בנושא אירועים ייחודיים.

בדיקות מעבר – פרטיות

  • מדד - ga:uniqueEventsTemporary – מספר האירועים הייחודיים. זו תהיה ההגדרה החדשה של ga:uniqueEvents. אפשר להשתמש במדד הזה כדי להבין את ההגדרה החדשה לפני השינוי. לתשומת ליבכם: המדד הזה הוא פרטי, והוא לא יופיע בחומר העזר בנושא מאפיינים ומדדים.

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

DoubleClick Bid Manager

  • מאפיין - ga:dbmClickAdvertiser – שם המפרסם ב-DBM שמשויך לקליק ב-DBM שתואם לסשן ב-Google Analytics (רק ב-Analytics 360, נדרש שילוב עם DBM).
  • מאפיין - ga:dbmClickAdvertiserId – מזהה המפרסם ב-DBM של הקליק ב-DBM שתואם לסשן ב-Google Analytics (רק ב-Analytics 360, נדרש שילוב עם DBM).
  • מאפיין - ga:dbmClickCreativeId – מזהה הקריאייטיב ב-DBM של הקליק ב-DBM שתואם לסשן ב-Google Analytics (רק ב-Analytics 360, נדרש שילוב עם DBM).
  • מאפיין - ga:dbmClickExchange – שם הבורסה ב-DBM של הקליק ב-DBM שתואם לסשן ב-Google Analytics (רק ב-Analytics 360, נדרש שילוב עם DBM).
  • מאפיין - ga:dbmClickExchangeId – מזהה ההמרה ב-DBM של הקליק ב-DBM שתואם לסשן ב-Google Analytics (רק ב-Analytics 360, נדרש שילוב עם DBM).
  • מאפיין – ga:dbmClickInsertionOrder – השם של הזמנת הקמפיין ב-DBM של הקליק ב-DBM שתואם לסשן ב-Google Analytics (רק ב-Analytics 360, נדרש שילוב עם DBM).
  • מאפיין – ga:dbmClickInsertionOrderId – מזהה הזמנת קמפיין ב-DBM של הקליק ב-DBM שתואם לסשן ב-Google Analytics (רק ב-Analytics 360, נדרש שילוב עם DBM).
  • מאפיין - ga:dbmClickLineItem – שם פריט ב-DBM של הקליק ב-DBM שתואם לסשן ב-Google Analytics (רק ב-Analytics 360, נדרש שילוב עם DBM).
  • מאפיין - ga:dbmClickLineItemId – מזהה פריט ב-DBM של הקליק ב-DBM שתואם לסשן ב-Google Analytics (רק ב-Analytics 360, נדרש שילוב עם DBM).
  • מאפיין – ga:dbmClickSite – שם האתר ב-DBM שבו הוצג הקריאייטיב ב-DBM ולקליק עליו הקליק ב-DBM שתואם לסשן ב-Google Analytics (ב-Analytics 360 בלבד, נדרש שילוב עם DBM).
  • מאפיין - ga:dbmClickSiteId – מזהה אתר ב-DBM שבו הוצג הקריאייטיב ב-DBM ולקליק עליו הקליק ב-DBM שתואם לסשן ב-Google Analytics (ב-Analytics 360 בלבד, נדרש שילוב עם DBM).
  • מאפיין - ga:dbmLastEventAdvertiser – שם המפרסם ב-DBM שמשויך לאירוע האחרון ב-DBM (חשיפה או קליק בתוך חלון המבט לאחור של DBM) המשויך לסשן ב-Google Analytics (רק ב-Analytics 360, נדרש שילוב עם DBM).
  • מאפיין - ga:dbmLastEventAdvertiserId – מזהה המפרסם ב-DBM של האירוע האחרון ב-DBM (חשיפה או קליק בתוך חלון המבט לאחור של DBM) המשויך לסשן ב-Google Analytics (ב-Analytics 360 בלבד, נדרש שילוב עם DBM).
  • מאפיין - ga:dbmLastEventCreativeId – מזהה קריאייטיב ב-DBM של האירוע האחרון ב-DBM (חשיפה או קליק בתוך חלון המבט לאחור של DBM) המשויך לסשן ב-Google Analytics (ב-Analytics 360 בלבד, נדרש שילוב עם DBM).
  • מאפיין - ga:dbmLastEventExchange – שם הבורסה ב-DBM של האירוע האחרון ב-DBM (חשיפה או קליק בחלון המבט לאחור של DBM) שמשויך לסשן ב-Google Analytics (רק ב-Analytics 360, נדרש שילוב עם DBM).
  • מאפיין - ga:dbmLastEventExchangeId – מזהה Exchange ב-DBM של האירוע האחרון ב-DBM (חשיפה או קליק בתוך חלון המבט לאחור של DBM) המשויך לסשן של Google Analytics (ב-Analytics 360 בלבד, נדרש שילוב עם DBM).
  • מאפיין - ga:dbmLastEventInsertionOrder – שם הזמנת הקמפיין ב-DBM של האירוע האחרון ב-DBM (חשיפה או קליק בחלון המבט לאחור של DBM) שמשויך לסשן ב-Google Analytics (רק ב-Analytics 360, נדרש שילוב עם DBM).
  • מאפיין – ga:dbmLastEventInsertionOrderId – מזהה הזמנת קמפיין ב-DBM של האירוע האחרון ב-DBM (חשיפה או קליק בתוך חלון המבט לאחור של DBM) המשויך לסשן של Google Analytics (רק ב-Analytics 360, נדרש שילוב עם DBM).
  • מאפיין – ga:dbmLastEventLineItem – שם פריט ב-DBM של האירוע האחרון ב-DBM (חשיפה או קליק בתוך חלון המבט לאחור של DBM) המשויך לסשן של Google Analytics (רק ב-Analytics 360, נדרש שילוב עם DBM).
  • מאפיין – ga:dbmLastEventLineItemId – מזהה פריט ב-DBM של האירוע האחרון ב-DBM (חשיפה או קליק בתוך חלון המבט לאחור של DBM) המשויך לסשן של Google Analytics (רק ב-Analytics 360, נדרש שילוב עם DBM).
  • מאפיין - ga:dbmLastEventSite – שם האתר ב-DBM שבו הוצג הקריאייטיב ב-DBM ולקליק עליו האירוע האחרון ב-DBM (חשיפה או קליק בתוך חלון המבט לאחור ב-DBM) המשויך לסשן של Google Analytics (רק ב-Analytics 360, נדרש שילוב עם DBM).
  • מאפיין – ga:dbmLastEventSiteId – מזהה אתר ב-DBM שבו הוצג הקריאייטיב ב-DBM ולקליק עליו אירוע ה-DBM האחרון (חשיפה או קליק בתוך חלון המבט לאחור של DBM) המשויך לסשן של Google Analytics (רק ב-Analytics 360, נדרש שילוב עם DBM).
  • מדד – ga:dbmCPA – מחיר להמרה בפועל (eCPA) להכנסה ב-DBM (ב-Analytics 360 בלבד, נדרש שילוב עם DBM).
  • מדד - ga:dbmCPC – אופטימיזציית עלות לקליק להכנסה ב-DBM (ב-Analytics 360 בלבד, נדרש שילוב עם DBM).
  • מדד – ga:dbmCPM – עלות בפועל לאלף חשיפות להכנסה ב-DBM (רק ב-Analytics 360, צריך שילוב עם DBM).
  • מדד - ga:dbmCTR – שיעור קליקים ב-DBM (Analytics 360 בלבד, מחייב שילוב עם DBM).
  • מדד - ga:dbmClicks – סה"כ קליקים ב-DBM (Analytics 360 בלבד, מחייב שילוב עם DBM).
  • מדד – ga:dbmConversions – סה"כ המרות ב-DBM (ב-Analytics 360 בלבד, נדרש שילוב עם DBM).
  • מדד – ga:dbmCost – עלות ב-DBM (ב-Analytics 360 בלבד, נדרש שילוב עם DBM).
  • מדד – ga:dbmImpressions – סה"כ חשיפות ב-DBM (ב-Analytics 360 בלבד, נדרש שילוב עם DBM).
  • מדד – ga:dbmROAS – החזר על הוצאות פרסום ב-DBM (ב-Analytics 360 בלבד, צריך שילוב עם DBM).
  • מאפיין – ga:dsAdGroup – קבוצת מודעות ב-DS (רק ב-Analytics 360, נדרש שילוב עם DS).
  • מאפיין – ga:dsAdGroupId – מזהה קבוצת מודעות ב-DS (רק ב-Analytics 360, נדרש שילוב עם DS).
  • מאפיין – ga:dsAdvertiser – מפרסם ב-DS (ב-Analytics 360 בלבד, נדרש שילוב עם DS).
  • מאפיין – ga:dsAdvertiserId – מזהה מפרסם ב-DS (רק ב-Analytics 360, נדרש שילוב עם DS).
  • מאפיין - ga:dsAgency – סוכנות DS (כדי להשתמש ב-Analytics 360 בלבד, נדרש שילוב עם DS).
  • מאפיין – ga:dsAgencyId – מזהה סוכנות DS (רק ב-Analytics 360, נדרש שילוב עם DS).
  • מאפיין – ga:dsCampaign – קמפיין ב-DS (רק ב-Analytics 360, נדרש שילוב עם DS).
  • מאפיין – ga:dsCampaignId – מזהה קמפיין ב-DS (ב-Analytics 360 בלבד, נדרש שילוב עם DS).
  • מאפיין – ga:dsEngineAccount – חשבון מנוע חיפוש ב-DS (רק ב-Analytics 360, נדרש שילוב עם DS).
  • מאפיין – ga:dsEngineAccountId – מספר חשבון מנוע חיפוש ב-DS (ל-Analytics 360 בלבד, נדרש שילוב עם DS).
  • מאפיין – ga:dsKeyword – מילת מפתח ב-DS (ב-Analytics 360 בלבד, נדרש שילוב עם DS).
  • מאפיין – ga:dsKeywordId – מזהה מילת מפתח ב-DS (ב-Analytics 360 בלבד, נדרש שילוב עם DS).
  • ga:dsCPC – העלות לקליק של מפרסם ב-DS (רק ב-Analytics 360, נדרש שילוב עם DS).
  • ga:dsCTR – שיעור הקליקים ב-DS (רק ב-Analytics 360, נדרש שילוב עם DS).
  • ga:dsClicks – קליקים ב-DS (ב-Analytics 360 בלבד, נדרש שילוב עם DS).
  • ga:dsCost – עלות ב-DS (רק ב-Analytics 360, נדרש שילוב עם DS).
  • ga:dsImpressions – חשיפות ב-DS (Analytics 360 בלבד, מחייב שילוב עם DS).
  • ga:dsProfit – DS Profie (Analytics 360 בלבד, מחייב שילוב עם DS).
  • ga:dsReturnOnAdSpend – החזר על הוצאות פרסום ב-DS (רק ב-Analytics 360, נדרש שילוב עם DS).
  • ga:dsRevenuePerClick – הכנסה לקליק ב-DS (רק ב-Analytics 360, נדרש שילוב עם DS).

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

מזהה עסקה

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

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

רשת גיאוגרפית

  • מאפיין – ga:continentId – מזהה היבשת של המשתמשים, שנגזר מכתובות ה-IP או המזהים הגיאוגרפיים של המשתמשים.

הגבלות

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

  • כניסה לקבוצת המידע של שופינג
    • ga:checkoutOptions
    • ga:shoppingStage
  • קבוצת ניסויים של GWO
    • ga:experimentVariant
    • ga:experimentId
  • קבוצת אינטרס
    • ga:interestOtherCategory
  • קבוצת אינטרסים בשוק
    • ga:interestInMarketCategory
  • קבוצת מבצעים פנימיים:
    • ga:internalPromotionCreative
    • ga:internalPromotionId
    • ga:internalPromotionName
    • ga:internalPromotionPosition
  • קבוצת אינטרס למיתוג:
    • ga:interestAffinityCategory

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

דיווח על שגיאות

הגרסה הזו מתחילה לאכוף מגבלות על בקשות דיווח שנכשלו (5XX).

  • 10 בקשות שנכשלו לכל פרויקט לכל פרופיל לשעה.
  • 50 בקשות שנכשלו לכל פרויקט לכל פרופיל ביום.

מגבלות ציר

בגרסה הזו מתחילה האכיפה של מגבלות בבקשות צירים:

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

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

רשת גיאוגרפית

  • מאפיין - ga:metroId - הקוד בן שלוש הספרות של אזור השוק הייעודי (DMA) שממנו הגיעה התנועה. הקוד נגזר מכתובות ה-IP או המזהים הגיאוגרפיים של המשתמשים.

DoubleClick for Publishers

  • ערך - ga:dfpImpressions - חשיפה של מודעה של DFP מדווחת בכל פעם שמודעה בודדת מוצגת באתר. לדוגמה, אם דף שמכיל שתי יחידות מודעות מוצג פעם אחת, נציג שתי חשיפות (הקישור אל DFP מופעל והאפשרות 'הסתרת הכנסות מ-DoubleClick' לא מופעלת)."
  • מדד – ga:dfpCoverage – כיסוי הוא אחוז הבקשות להצגת מודעות שהחזירו לפחות מודעה אחת. בדרך כלל, הכיסוי יכול לעזור בזיהוי אתרים שבהם חשבון DFP אינו מסוגל לספק מודעות ממוקדות. (חשיפות של מודעות / סה"כ בקשות למודעות) * 100 (האפשרות 'קישור ל-Floodlight' מופעלת וההכנסה מ-DoubleClick לא מופעלת)."
  • ערך - ga:dfpMonetizedPageviews - ערך זה מודד את המספר הכולל של צפיות בדף בנכס שהוצגו עם מודעה מחשבון DFP המקושר. הערה: דף אחד יכול לכלול כמה יחידות מודעות (האפשרות 'קישור ל-Floodlight' מופעלת והאפשרות 'הסתרת הכנסות מ-DoubleClick' לא מופעלת)."
  • ערך - ga:dfpImpressionsPerSession - היחס בין חשיפות של מודעות ב-DoubleClick לבין ביקורים ב-Analytics (חשיפות של מודעה / ביקורים ב-Analytics) (האפשרות לקשר בין DFP מופעלת וההכנסות מ-DoubleClick לא מופעלות)."
  • מדד - ga:dfpViewableImpressionsPercent - אחוז החשיפות של מודעות שניתנות לצפייה. חשיפה נחשבת לחשיפה שניתנת לצפייה כאשר היא מופיעה בדפדפנים של משתמשים, ויש לה אפשרות לראות אותה (האפשרות של קישור DFP מופעלת והאפשרות 'הסתרת הכנסות מ-DoubleClick' לא מופעלת)."
  • ערך - ga:dfpClicks - מספר הפעמים שבוצעו קליקים על מודעות DFP באתר (האפשרות 'קישור ב-Floodlight מופעלת' ו'הסתרת הכנסות מ-DoubleClick' לא מופעלת)."
  • ערך - ga:dfpCTR - אחוז הצפיות בדף שהסתיימו בקליק על מודעת DFP (הקישור ל-Floodlight הופעל והסתרת ההכנסות מ-DoubleClick לא הופעלה)."
  • ערך - ga:dfpRevenue - ההכנסה מ-DoubleClick היא אומדן של סך כל ההכנסות ממודעות על סמך הופעות שהוצגו (הקישור ל-Floodlight מופעל וההכנסות מ-DoubleClick לא מופעלות)."
  • ערך - ga:dfpRevenuePer1000Sessions - סך כל ההכנסה המשוערת ממודעות DFP לכל 1,000 ביקורים ב-Analytics. חשוב לשים לב שהמדד הזה מבוסס על ביקורים באתר, ולא על חשיפות של מודעות (האפשרות 'קישור ל-Floodlight' מופעלת והאפשרות 'הסתרת הכנסות מ-DoubleClick' לא מופעלת)."
  • מדד - ga:dfpECPM - העלות האפקטיבית לאלף צפיות בדף. זוהי ההכנסה מ-DoubleClick לכל 1,000 צפיות בדף (האפשרות 'קישור ב-Floodlight' מופעלת והאפשרות 'הסתרת הכנסות מ-DoubleClick' לא מופעלת)."
  • ערך - ga:backfillImpressions - הופעות במילוי חוזר הוא סכום כל ההופעות של מודעות AdSense או מודעות פעילות שהוצגו כמילוי חוזר דרך DFP. חשיפה של מודעה מדווחת בכל פעם שמודעה בודדת מוצגת באתר. לדוגמה, אם דף שמכיל שתי יחידות מודעות מוצג פעם אחת, נציג שתי חשיפות (הקישור אל DFP מופעל והאפשרות 'הסתרת הכנסות מ-DoubleClick' לא מופעלת)."
  • מדד – ga:backfillCoverage – כיסוי במילוי חלופי הוא אחוז הבקשות להצגת מודעות למילוי חוסרים (backfill) שהחזירו לפחות מודעה אחת. באופן כללי, הכיסוי יכול לעזור לזהות אתרים שבהם החשבון של בעל האתר אינו יכול לספק מודעות ממוקדות. (מספר החשיפות של מודעות חלקי סה"כ הבקשות למודעות) כפול 100. אם גם AdSense וגם Ad Exchange מספקות מודעות מילוי חוסרים (backfill), המדד הזה הוא הממוצע המשוקלל של שני חשבונות המילוי החוזר (קישור ל-Floodlight מופעל ו'ההכנסה מ-DoubleClick' לא מופעלת)."
  • מדד - ga:backfillMonetizedPageviews - המדד הזה מחשב את המספר הכולל של צפיות בדף בנכס, שהוצגו עם מודעה אחת לפחות מהחשבונות המקושרים למילוי חוסרים(backfill). חשוב לשים לב שצפייה יחידה בדף שמייצר הכנסות יכולה לכלול מספר חשיפות של מודעות (האפשרות 'קישור ב-Merchant Center' מופעלת והאפשרות 'הסתרת הכנסה מ-DoubleClick' לא מופעלת)."
  • מדד - ga:backfillImpressionsPerSession - היחס בין חשיפות של מודעות למילוי חוסרים (backfill) לביקורים ב-Analytics (חשיפות של מודעות / ביקורים ב-Analytics). אם גם AdSense וגם Ad Exchange מספקות מודעות מילוי חוסרים (backfill), המדד הזה הוא הסכום של שני חשבונות המילוי החוזר (קישור ל-Floodlight מופעל ו'הסתרה של הכנסה מ-DoubleClick' לא מופעלת)."
  • מדד - ga:backfillViewableImpressionsPercent - אחוז החשיפות של מודעות למילוי חוסרים (backfill) שהיו ניתנות לצפייה. חשיפה נחשבת לחשיפה שניתנת לצפייה כאשר היא מופיעה בדפדפנים של המשתמשים ואפשר לראות אותה. אם גם AdSense וגם Ad Exchange מספקות מודעות למילוי חוסרים (backfill), המדד הזה הוא הממוצע המשוקלל של שני חשבונות המילוי החוזר (הקישור ל-Floodlight מופעל והאפשרות 'הסתרת הכנסות מ-DoubleClick' לא מופעלת)."
  • מדד - ga:backfillClicks - מספר הפעמים שלחצו על מודעות מילוי חוזר באתר. אם גם AdSense וגם Ad Exchange מספקות מודעות למילוי חוסרים (backfill), המדד הזה הוא הסכום של שני החשבונות למילוי חוסרים (הקישור בין DFP מופעל ו'ההכנסה מ-DoubleClick' לא מופעלת)."
  • מדד - ga:backfillCTR - אחוז החשיפות למילוי חוסרים (backfill) שהובילו לקליק על מודעה. אם גם AdSense וגם Ad Exchange מספקות מודעות למילוי חוסרים (backfill), המדד הזה הוא הממוצע המשוקלל של שני חשבונות המילוי החוזר (הקישור ל-Floodlight מופעל והאפשרות 'הסתרת הכנסות מ-DoubleClick' לא מופעלת)."
  • מדד - ga:backfillRevenue – סך כל ההכנסות המשוערות ממודעות למילוי חוסרים (backfill). אם גם AdSense וגם Ad Exchange מספקות מודעות למילוי חוסרים (backfill), המדד הזה הוא הסכום של שני החשבונות למילוי חוסרים (הקישור בין DFP מופעל ו'ההכנסה מ-DoubleClick' לא מופעלת)."
  • מדד - ga:backfillRevenuePer1000Sessions – סך כל ההכנסות המשוערות ממודעות למילוי חוסרים (backfill) לכל 1,000 ביקורים ב-Analytics. חשוב לשים לב שהמדד הזה מבוסס על ביקורים באתר ולא על חשיפות של מודעות. אם גם AdSense וגם Ad Exchange מספקות מודעות מילוי חוסרים (backfill), המדד הזה הוא הסכום של שני חשבונות המילוי החוזר (קישור ל-Floodlight מופעל ו'הסתרה של הכנסה מ-DoubleClick' לא מופעלת)."
  • מדד - ga:backfillECPM - העלות האפקטיבית לאלף צפיות בדף. זוהי ההכנסה ממילוי חלופי ב-DoubleClick לכל 1,000 צפיות בדף. אם גם AdSense וגם Ad Exchange מספקות מודעות מילוי חוסרים (backfill), המדד הזה הוא הסכום של שני חשבונות המילוי החוזר (קישור ל-Floodlight מופעל ו'הסתרה של הכנסה מ-DoubleClick' לא מופעלת)."

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

פלחים

בגרסה הזו תוקנה בעיה שגורמת לקבוצת משנה של בקשות עם הפלח (gaid::-1) של כל המשתמשים (gaid::-1) להיספר ב-Core Reporting API V3 ולפוצל לשני פלחים ב-Analytics Reporting API V4.

דגימות

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

זוהי גרסה לתיקון באגים שמתקנת בעיה כששולחים בקשות לקבוצה בעלת מאפיינים משותפים בגרסה 4 של Analytics Reporting API.

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

מעכשיו, בקשות לקבוצה בעלת מאפיינים משותפים יכולות לשלוח בקשה להצגת כל המאפיינים של קבוצה בעלת מאפיינים משותפים. בעבר, ה-API היה מחזיר שגיאה כשביקשו מאפיינים מסוג ga:acquisition....

ערך חיי המשתמש של בקשה לערך חיי המשתמש

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

בגרסה הזו נוסף מאפיין חדש: addedInApiVersion.

נוסף בגרסת API

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

הודעה על גרסה חדשה של ה-API – Analytics Reporting API V4. ה-API החדש הזה הוא השיטה הפרוגרמטית המתקדמת ביותר לגישה לנתוני דוחות ב-Google Analytics.

תכונות עיקריות

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

  • ביטויים של מדדים - ממשק ה-API מאפשר לבקש לא רק את המדדים המובנים, אלא גם את הביטויים המתמטיים. לדוגמה, ניתן לבטא השלמות של מטרות עסקיות לכל מספר סשנים בבקשה באופן ga:goal1completions/ga:sessions.
  • טווחי תאריכים מרובים – תמיכה בבקשה בשני טווחי תאריכים, כדי לאפשר לכם להשוות נתונים של שתי תקופות בבקשה אחת.
  • קבוצות בעלות מאפיינים משותפים וערך חיי המשתמש - ה-API כולל אוצר מילים עשיר, שבו ניתן לבקש דוחות על קבוצות בעלות מאפיינים משותפים ועל ערך חיי המשתמש.
  • מספר פלחים – עכשיו אפשר לבקש מספר פלחים בבקשה אחת.

תחילת העבודה

פרטים על תחילת העבודה עם ה-API זמינים בתיעוד למפתחים.

מדיניות בנושא מכסות

ל-Analytics Reporting API V4 יש מכסות ומגבלות משלו. מאחר שמדובר ב-API חדש, המגבלות והמכסות האלה עשויות להשתנות.

העברה

בנוסף למדריך העברה, אנחנו מציעים גם ספריית תאימות של Python ב-GitHub.

מאפיינים ומדדים

בגרסה הזו גם נוספה קבוצה של מאפיינים ומדדים ספציפית ל-Analytics Reporting API V4. הגדרות הרשימה המלאות זמינות בסייר המאפיינים והמדדים.

  • מאפיין – ga:cohort – שם הקבוצה בעלת המאפיינים המשותפים שמשתמש משתייך אליה, על סמך ההגדרה של הקבוצות בעלות המאפיינים המשותפים. בהתאם להגדרה של קבוצות בעלות מאפיינים משותפים, משתמש יכול להשתייך לכמה קבוצות בעלות מאפיינים משותפים, בדומה לאופן שבו משתמש יכול להשתייך למספר פלחים.

  • מאפיין - ga:cohortNthDay - קיזוז ימים מבוסס 0 ביחס לתאריך ההגדרה של הקבוצה בעלת המאפיינים המשותפים. לדוגמה, אם קבוצה בעלת מאפיינים משותפים הוגדרה עם תאריך הביקור הראשון כ-1 בספטמבר 2015, הערך של ga:cohortNthDay יהיה 3 עבור תאריך 2015-09-04.

  • ga:cohortNthMonth - קיזוז חודשים מבוסס 0 ביחס לתאריך ההגדרה של הקבוצה בעלת המאפיינים המשותפים.

  • מאפיין - ga:cohortNthWeek – קיזוז שבועות מבוסס 0 ביחס לתאריך ההגדרה של הקבוצה בעלת המאפיינים המשותפים.

  • מאפיין – ga:acquisitionTrafficChannel – ערוץ התנועה שדרכו המשתמש צורף. הוא מחולץ מהסשן הראשון של המשתמש. ערוץ התנועה מחושב על סמך כללי ברירת המחדל לקיבוץ ערוצים (ברמת התצוגה המפורטת, אם הם זמינים) במועד צירוף המשתמשים.

  • מאפיין – ga:acquisitionSource – המקור שדרכו המשתמש צורף. נגזר מהסשן הראשון של המשתמש.

  • מאפיין – ga:acquisitionMedium – אמצעי ההגעה לאתר שדרכו המשתמש צורף. נגזר מהסשן הראשון של המשתמש.

  • מאפיין - ga:acquisitionSourceMedium - הערך המשולב של ga:userPurchaseSource ו-ga:PurchaseMedium.

  • מאפיין – ga:acquisitionCampaign הקמפיין שדרכו המשתמש צורף. נגזר מהסשן הראשון של המשתמש.

  • מדד – ga:cohortActiveUsers – המדד הזה רלוונטי בהקשר של מאפייני הקיזוז המבוססים על 0 (ga:cohortNthDay, ga:cohortNthWeek או ga:cohortNthMonth). הוא מציין את מספר המשתמשים בקבוצה בעלת המאפיינים המשותפים שפעילים בחלון הזמן התואם ליום/שבוע/חודש של הקבוצה בעלת המאפיינים המשותפים. לדוגמה, עבור ga:cohortNthWeek = 1, מספר המשתמשים (בקבוצה בעלת מאפיינים משותפים) שהיו פעילים בשבוע השני. אם הבקשה לא כוללת את הערכים ga:cohortNthDay, ga:cohortNthWeek או ga:cohortNthMonth, למדד הזה יהיה אותו ערך כמו ga:cohortTotalUsers.

  • מדד - ga:cohortTotalUsers – מספר המשתמשים ששייכים לקבוצה בעלת המאפיינים המשותפים, שנקראים גם 'גודל הקבוצה בעלת המאפיינים המשותפים'.

  • מדד - ga:cohortAppviewsPerUser – צפיות באפליקציה לכל משתמש בקבוצה בעלת מאפיינים משותפים.

  • מדד - ga:cohortGoalCompletionsPerUser - יעדים שהושלמו לכל משתמש בקבוצה בעלת מאפיינים משותפים.

  • מדד - ga:cohortPageviewsPerUser - צפיות בדף לכל משתמש בקבוצה בעלת מאפיינים משותפים.

  • מדד - ga:cohortRetentionRate - שיעור שימור של קבוצה בעלת מאפיינים משותפים.

  • מדד - ga:cohortRevenuePerUser – הכנסה למשתמש בקבוצה בעלת מאפיינים משותפים.

  • מדד - ga:cohortVisitDurationPerUser - משך הסשן לכל משתמש בקבוצה בעלת מאפיינים משותפים.

  • מדד - ga:cohortSessionsPerUser - ביקורים לכל משתמש בקבוצה בעלת מאפיינים משותפים.

  • מדד – ga:cohortTotalUsersWithLifetimeCriteria – רלוונטי בהקשר של בקשה עם המאפיינים ga:acquisitionTrafficChannel, ga:acquisitionSource, ga:acquisitionMedium או ga:acquisitionCampaign. המדד הזה מייצג את מספר המשתמשים בקבוצות בעלות מאפיינים משותפים שצורפו דרך הערוץ, המקור, אמצעי ההגעה לאתר או הקמפיין הנוכחיים. לדוגמה, עבור ga:acquisitionTrafficChannel=Direct, הוא מייצג את מספר המשתמשים בקבוצה בעלת המאפיינים המשותפים שצורפו ישירות. אם אף אחד מהמאפיינים שצוינו לא קיים, הערך שלו שווה ל-ga:cohortTotalUsers.

  • מדד – ga:cohortAppviewsPerUserWithLifetimeCriteria – צפיות באפליקציה לכל משתמש במאפיין צירוף המשתמשים של קבוצה בעלת מאפיינים משותפים.

  • מדד - ga:cohortGoalCompletionsPerUserWithLifetimeCriteria - השלמת מטרות עסקיות לכל משתמש במאפיין צירוף המשתמשים בקבוצה בעלת מאפיינים משותפים.

  • מדד - ga:cohortPageviewsPerUserWithLifetimeCriteria - צפיות בדף למשתמש במאפיין צירוף המשתמשים של קבוצה בעלת מאפיינים משותפים.

  • מדד – ga:cohortRevenuePerUserWithLifetimeCriteria – הכנסה למשתמש במאפיין צירוף המשתמשים של קבוצה בעלת מאפיינים משותפים.

  • מדד - ga:cohortSessionsPerUserWithLifetimeCriteria – משך הסשן לכל משתמש במאפיין צירוף המשתמשים בקבוצה בעלת מאפיינים משותפים.

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

רשימת ההגדרות המלאה מופיעה בחומר העזר בנושא מאפיינים ומדדים.

פעילויות חברתיות

המאפיינים והמדדים האלה הוצאו משימוש ויוסרו אחרי 30 בספטמבר 2016. פרטים על הסרת נתונים זמינים במדיניות בנושא הוצאה משימוש של נתונים:

  • מאפיין - ga:socialActivityEndorsingUrl - עבור פעילות של מרכז נתונים חברתיים, זוהי כתובת האתר של הפעילות החברתית (למשל, כתובת האתר של הפוסט ב-Google+ , כתובת האתר של התגובה בבלוג וכו').
  • מאפיין - ga:socialActivityDisplayName - עבור פעילות של מרכז נתונים חברתיים, זהו הכותרת של הפעילות החברתית שפורסמה על ידי המשתמשים ברשת החברתית.
  • מאפיין - ga:socialActivityPost - עבור פעילות של מרכז נתונים חברתיים, זהו התוכן של הפעילות החברתית (למשל, התוכן של הודעה שפורסמה ב-Google+ ) שפורסם על ידי משתמשים ברשת חברתית.
  • מאפיין - ga:socialActivityTimestamp - עבור פעילות של מרכז נתונים חברתיים, זוהי השעה שבה הפעילות החברתית התרחשה ברשת החברתית.
  • מאפיין - ga:socialActivityUserHandle - עבור פעילות של מרכז נתונים חברתיים, זהו הכינוי של הרשת החברתית (למשל שם או מזהה) של משתמשים שיזמו את הפעילות החברתית.'
  • מאפיין - ga:socialActivityUserPhotoUrl - לפעילות של מרכז נתונים חברתיים, זוהי כתובת האתר של התמונה המשויכת לפרופילים של משתמשים ברשת חברתית.'
  • מאפיין - ga:socialActivityUserProfileUrl - לפעילות של מרכז נתונים חברתיים, זוהי כתובת האתר של הפרופילים של המשתמשים המשויכים ברשת החברתית.
  • מאפיין - ga:socialActivityTagsSummary - לפעילות של מרכז נתונים חברתיים, זוהי קבוצה מופרדת בפסיקים של תגים המשויכים לפעילות החברתית.'
  • מאפיין - ga:socialActivityAction - עבור פעילות של מרכז נתונים חברתיים, הערך הזה מייצג את סוג הפעולה החברתית שמשויכת לפעילות (למשל, הצבעה, תגובה, סימון 1+ וכו').
  • מאפיין - ga:socialActivityNetworkAction - עבור פעילות של מרכז נתונים חברתיים, זהו סוג הפעולה החברתית והרשת החברתית שבה בוצעה הפעילות.
  • מאפיין - ga:socialActivityContentUrl - לפעילות של מרכז נתונים חברתיים, זוהי כתובת ה-URL ששותפה על ידי המשתמשים ברשת החברתית.
  • מדד - ga:socialActivities - המספר הכולל של פעילויות שבהן כתובת URL של תוכן שותפה או הוזכרה ברשת שותפה של המרכז לנתוני רשתות חברתיות.

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

פלטפורמה או מכשיר

  • מאפיין - ga:browserSize - גודל אזור התצוגה של הדפדפנים של המשתמשים. גודל הדפדפן הוא מאפיין בהיקף של סשן. המאפיין הזה מתעד את המימדים הראשוניים של אזור התצוגה בפיקסלים, ומפורמט כרוחב X. לדוגמה, 1920x960.

בגרסה הזו נוסף פרמטר חדש ל-API.

הכללת שורות ריקות

  • בגרסה הזו מתווסף הפרמטר האופציונלי החדש include-empty-rows. כשמגדירים את הערך ל-false שורות בלי נתונים, המערכת תשמיט מהתשובה. ערך ברירת המחדל הוא true, זהו שינוי שאינו עלול לגרום לכשלים, ולכן אין צורך לעדכן את הקוד. לפרטים נוספים, אפשר לעיין במסמכי התיעוד של Core Reporting API.

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

משתמש

  • מדד - ga:1dayUsers – המספר הכולל של משתמשים פעילים במשך יום אחד בכל יום בתקופת הזמן המבוקשת. כדי להריץ שאילתות על המדד הזה, צריך לציין לפחות אחד מהערכים ga:nthDay, ga:date או ga:day בתור מאפיין. בתאריך הנתון, הערך שיוחזר יהיה המספר הכולל של המשתמשים הייחודיים בתקופה של יום אחד שמסתיימת בתאריך הנתון.
  • מדד - ga:7dayUsers – המספר הכולל של משתמשים פעילים במשך 7 ימים בכל יום בתקופת הזמן המבוקשת. כדי להריץ שאילתות על המדד הזה, צריך לציין לפחות אחד מהערכים ga:nthDay, ga:date או ga:day בתור מאפיין. בתאריך הנתון, הערך שיוחזר יהיה סך כל המשתמשים הייחודיים בתקופת 7 הימים שמסתיימת בתאריך הנתון.
  • מדד - ga:14dayUsers – המספר הכולל של משתמשים פעילים במשך 14 יום בכל יום בתקופת הזמן המבוקשת. כדי להריץ שאילתות על המדד הזה, צריך לציין לפחות אחד מהערכים ga:nthDay, ga:date או ga:day בתור מאפיין. בתאריך הנתון, הערך שיוחזר יהיה סך כל המשתמשים הייחודיים בתקופת 14 הימים שמסתיימת בתאריך הנתון.
  • מדד - ga:30dayUsers – המספר הכולל של משתמשים פעילים במשך 30 יום בכל יום בתקופת הזמן המבוקשת. כדי להריץ שאילתות על המדד הזה, צריך לציין לפחות אחד מהערכים ga:nthDay, ga:date או ga:day בתור מאפיין. בתאריך הנתון, הערך שיוחזר יהיה סך כל המשתמשים הייחודיים בתקופת 30 הימים שמסתיימת בתאריך הנתון.

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

DoubleClick Ad Exchange ‏(AdX)

  • מדד - ga:adxCTR - אחוז הצפיות בדף שהובילו לקליק על מודעת AdX.
  • מדד - ga:adxClicks - מספר הפעמים שלחצו על מודעות AdX באתר שלך.
  • מדד – ga:adxCoverage – כיסוי הוא אחוז הבקשות להצגת מודעות שהחזירו לפחות מודעה אחת. באופן כללי, נתוני הכיסוי יכולים לעזור לכם לזהות אתרים שבהם אין ל-AdX אפשרות להציג מודעות ממוקדות בחשבון AdX. (חשיפות של מודעות / סה"כ בקשות למודעות) * 100
  • מדד - ga:adxECPM - העלות האפקטיבית לאלף צפיות בדף. זוהי ההכנסה שלך מ-AdX לכל 1,000 צפיות בדף.
  • ערך - ga:adxImpressions - חשיפה של מודעת AdX מדווחת בכל פעם שמודעה בודדת מוצגת באתר שלך. לדוגמה, אם דף שיש בו שתי יחידות מודעות מוצג פעם אחת, נדווח על שתי חשיפות.
  • מדד - ga:adxImpressionsPerSession - היחס בין חשיפות של מודעות AdX לביקורים ב-Analytics (חשיפות של מודעה / ביקורים ב-Analytics).
  • מדד - ga:adxMonetizedPageviews - צפיות בדף שמייצרות הכנסות מודדות את המספר הכולל של צפיות בדף בנכס שלך, שהוצגו עם מודעה מחשבון AdX המקושר שלך. הערה: דף אחד יכול לכלול כמה יחידות מודעות.
  • מדד - ga:adxRevenue - סך כל ההכנסות המשוערות ממודעות AdX.
  • מדד - ga:adxRevenuePer1000Sessions - סך כל ההכנסה המשוערת ממודעות AdX לכל 1,000 ביקורים ב-Analytics. חשוב לשים לב שהמדד הזה מבוסס על ביקורים באתר ולא על חשיפות של מודעות.
  • מדד - ga:adxViewableImpressionsPercent - אחוז החשיפות של מודעות שהיו ניתנות לצפייה. חשיפה נחשבת לחשיפה שניתנת לצפייה כשהמודעה מופיעה בדפדפן של משתמש במקום שבו אפשר לראות אותה.

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

מאפיינים שהוצאו משימוש

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

  • מאפיין - ga:adSlotPosition – במקום זאת יש להשתמש במאפיין ga:adSlot.
  • מאפיין - ga:nextPagePath – במקום זאת יש להשתמש במאפיין ga:pagePath.
  • מאפיין - ga:nextContentGroupXX – במקום זאת יש להשתמש במאפיין ga:contentGroupXX.

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

AdWords

  • מאפיין - ga:adQueryWordCount - מספר המילים בשאילתת החיפוש.

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

פלטפורמה או מכשיר

  • מאפיין - ga:dataSource - מקור הנתונים של היט. היטים שנשלחו מ-ga.js ומ-analytics.js מדווחים כ'אתר'; היטים שנשלחו מערכות ה-SDK לנייד מדווחים כ-'app'. ניתן לשנות את הערכים האלה.
  • מאפיין – ga:searchAfterDestinationPage – הדף שאליו המשתמש ביקר אחרי שביצע חיפוש פנימי באתר.

זוהי גרסה לתיקון באגים:

  • בגרסה הזו תוקנה בעיה באכיפת מגבלות הסינון בשאילתת Real Time Reporting API. בקשות עם rt:activeUsers ומסנן של מאפיין ברמת האירוע יובילו לשגיאה עם סיבה badRequest ולהודעה עם הערך OR operator not supported for a hit level filter. לפרטים נוספים על אילוצי שאילתות, מומלץ לעיין במדריך למפתחים בנושא Real Time Reporting API.

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

ECommerce

  • מדד - ga:transactionsPerUser - מספר העסקאות הכולל חלקי מספר המשתמשים הכולל.
  • מדד – ga:revenuePerUser – סך כל ההכנסות ממכירות שסופקו בעסקה, לא כולל משלוח ומס, חלקי מספר המשתמשים הכולל.

משתמש

  • מדד - ga:sessionsPerUser - המספר הכולל של סשנים חלקי מספר המשתמשים הכולל.

רשת גיאוגרפית

  • מאפיין - ga:cityId - מזהי הערים של המשתמשים, הנגזרים מכתובות IP או מזהים גיאוגרפיים.
  • מאפיין - ga:countryIsoCode - קוד ISO של המדינה של המשתמשים, שנגזר מכתובות IP או מזהים גיאוגרפיים. הערכים ניתנים כקוד ISO-3166-1 alpha-2.
  • מאפיין – ga:regionId – מזהה האזור של המשתמשים, שנגזר מכתובות IP או מזהים גיאוגרפיים. בארה"ב, אזור הוא מדינה, למשל מדינת ניו יורק.
  • מאפיין - ga:regionIsoCode - קוד המשתמשים לפי אזור ISO, שנגזר מכתובות IP או מזהים גיאוגרפיים. הערכים ניתנים כקוד ISO-3166-2.
  • מאפיין - ga:subContinentCode - קוד תת-היבשת של המשתמשים, שנגזר מכתובות IP או מזהים גיאוגרפיים. לדוגמה, פולינזיה או צפון אירופה. הערכים מוצגים כקוד UN M.49.

DoubleClick Campaign Manager

  • מדד – ga:dcmROAS – החזר על הוצאות פרסום (ROAS) של DCM (פרימיום בלבד).

מדדים שהוצאו משימוש

המדדים האלה הוצאו משימוש. ניתן לעיין במדיניות בנושא הוצאת נתונים לקבלת פרטים על הסרת נתונים: + מדד - ga:dcmROI - במקום זאת יש להשתמש ב-ga:dcmROAS. + מדד - ga:dcmMargen – במקום זאת, יש להשתמש ב-ga:dcmROAS.

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

AdWords

  • מדד – ga:ROAS – החזר על הוצאות פרסום (ROAS) מייצג את ההכנסה הכוללת מהעסקה ואת ערך היעד חלקי עלות הפרסום הנגזרת.

מאפיינים ומדדים שהוצאו משימוש

המאפיינים והמדדים האלה הוצאו משימוש. ניתן לעיין במדיניות בנושא הוצאת נתונים לקבלת פרטים על הסרת נתונים: + מדד - ga:ROI - במקום זאת יש להשתמש ב-ga:ROAS. + מדד - ga:margin – במקום זאת, יש להשתמש ב-ga:ROAS.

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

AdSense

  • מדד – ga:adsenseCoverage – אחוז הבקשות להצגת מודעות שהחזירו לפחות מודעה אחת.
  • מדד – ga:adsenseViewableImpressionPercent – אחוז החשיפות שהיו ניתנות לצפייה.

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

נתיבי המרות

  • מאפיין - mcf:dcmAd - שם מודעת DCM של אירוע DCM (חשיפה או קליק) שתואם להמרה ב-Google Analytics.
  • מאפיין - mcf:dcmAdPath - הנתיב להמרה שבו אינטראקציות בנתיב מיוצגות על ידי מודעות DCM.
  • מאפיין - mcf:dcmAdType - שם סוג המודעה ב-DCM של האירוע (חשיפה או קליק) ב-DCM שתואם להמרה ב-Google Analytics.
  • מאפיין - mcf:dcmAdvertiser - שם המפרסם ב-DCM של אירוע DCM (חשיפה או קליק) שתואם להמרה ב-Google Analytics.
  • מאפיין – mcf:dcmAdvertiserPath – הנתיב להמרה שבו אינטראקציות בנתיב מיוצגות על ידי מפרסמי DCM.
  • מאפיין - mcf:dcmCampaign - שם הקמפיין ב-DCM של האירוע (חשיפה או קליק) ב-DCM שתואם להמרה ב-Google Analytics.
  • מאפיין - mcf:dcmCampaignPath - הנתיב להמרה שבו אינטראקציות בנתיב מיוצגות על ידי קמפיינים של DCM.
  • מאפיין - mcf:dcmCreative - שם הקריאייטיב ב-DCM של האירוע (חשיפה או קליק) ב-DCM שתואם להמרה ב-Google Analytics.
  • מאפיין – mcf:dcmCreativePath – הנתיב להמרה שבו אינטראקציות בנתיב מיוצגות על ידי פריטי קריאייטיב של DCM.
  • מאפיין - mcf:dcmCreativeVersion - גרסת הקריאייטיב של DCM לאירוע (חשיפה או קליק) ב-DCM שתואם להמרה ב-Google Analytics.
  • מאפיין – mcf:dcmCreativeVersionPath – הנתיב להמרה שבו אינטראקציות בנתיב מיוצגות על ידי גרסאות של קריאייטיב של DCM.
  • מאפיין - mcf:dcmNetwork – הרשת שבה נעשה שימוש.
  • מאפיין - mcf:dcmPlacement - שם מיקום האתר ב-DCM של האירוע (הופעה או קליק) ב-DCM שתואם להמרה ב-Google Analytics.
  • מאפיין - mcf:dcmPlacementPath - הנתיב להמרה שבו אינטראקציות בנתיב מיוצגות על ידי מיקומי DCM.
  • מאפיין - mcf:dcmSite - שם האתר ב-DCM שבו הוצג הקריאייטיב של DCM עבור האירוע (חשיפה או קליק) של DCM שתואם להמרה ב-Google Analytics.
  • מאפיין – mcf:dcmSitePath – הנתיב להמרה שבו אתרי DCM מיוצגים על ידי אינטראקציות בנתיב.
  • מדד - mcf:firstImpressionConversions - מספר ההמרות שעבורן חשיפה של קמפיין DCM הייתה אינטראקציה ההמרה הראשונה בחלון מבט לאחור של 30 יום. המאפיין הזה כולל עסקאות שהושלמו וגם עסקאות.
  • מדד - mcf:firstImpressionValue - ערך ההמרות שעבורן חשיפה של קמפיין DCM הייתה אינטראקציה ההמרה הראשונה בחלון מבט לאחור של 30 יום. המאפיין הזה כולל עסקאות שהושלמו וגם עסקאות.
  • מדד - mcf:impressionAssistedConversions - מספר ההמרות שעבורן הופיעה חשיפה של קמפיין DCM בנתיב ההמרות, אבל לא הייתה האינטראקציה הסופית של ההמרה. המאפיין הזה כולל עסקאות שהושלמו וגם עסקאות.
  • מדד - mcf:impressionAssistedValue - ערך ההמרות שעבורן תופיע חשיפה של קמפיין DCM בנתיב ההמרות, אבל לא הייתה האינטראקציה הסופית של ההמרה. המאפיין הזה כולל עסקאות שהושלמו וגם עסקאות.

הגרסה הזו כוללת הוספה של מדד סשנים חדש, מאפיין חדש של מקורות תנועה ומאפיינים ומדדים חדשים מ-DoubleClick Campaign Manager.

מאפיינים ומדדים

רשימת ההגדרות המלאה מופיעה בחומר העזר בנושא מאפיינים ומדדים.

סשן

  • מדד - ga:hits - מספר ההיטים הכולל שנשלחו אל Google Analytics. המדד הזה מסכם את כל סוגי ההיטים (למשל, צפייה בדף, אירוע, תזמון וכו')

מקורות תנועה

  • מאפיין - ga:campaignCode - כשמשתמשים במעקב ידני אחר קמפיין, הערך של פרמטר המעקב utm_id.

DoubleClick Campaign Manager

  • מאפיין - ga:dcmClickAd - שם מודעת DCM של קליק ב-DCM התואם לסשן ב-Google Analytics (פרימיום בלבד).
  • מאפיין - ga:dcmClickAdId - מזהה המודעה של DCM עבור הקליק ב-DCM התואם לסשן ב-Google Analytics (פרימיום בלבד).
  • מאפיין - ga:dcmClickAdType - שם סוג המודעה ב-DCM של הקליק ב-DCM התואם לסשן ב-Google Analytics (פרימיום בלבד).
  • מאפיין - ga:dcmClickAdTypeId - מזהה סוג מודעה ב-DCM של הקליק ב-DCM שתואם לסשן ב-Google Analytics (פרימיום בלבד).
  • מאפיין - ga:dcmClickAdvertiser - שם המפרסם ב-DCM של הקליק ב-DCM התואם לסשן ב-Google Analytics (פרימיום בלבד).
  • מאפיין - ga:dcmClickAdvertiserId - מזהה המפרסם ב-DCM של הקליק ב-DCM התואם לסשן ב-Google Analytics (פרימיום בלבד).
  • מאפיין - ga:dcmClickCampaign - שם הקמפיין ב-DCM של הקליק ב-DCM התואם לסשן ב-Google Analytics (פרימיום בלבד).
  • מאפיין - ga:dcmClickCampaignId - מזהה קמפיין DCM של הקליק ב-DCM התואם לסשן ב-Google Analytics (פרימיום בלבד).
  • מאפיין - ga:dcmClickCreative - שם הקריאייטיב ב-DCM של הקליק ב-DCM התואם לסשן ב-Google Analytics (פרימיום בלבד).
  • מאפיין - ga:dcmClickCreativeId - מזהה קריאייטיב ב-DCM של קליק DCM התואם לסשן ב-Google Analytics (פרימיום בלבד).
  • מאפיין - ga:dcmClickCreativeType - שם סוג הקריאייטיב ב-DCM של הקליק ב-DCM התואם לסשן ב-Google Analytics (פרימיום בלבד).
  • מאפיין - ga:dcmClickCreativeTypeId - מזהה סוג קריאייטיב ב-DCM של הקליק ב-DCM התואם לסשן ב-Google Analytics (פרימיום בלבד).
  • מאפיין - ga:dcmClickCreativeVersion - גרסת קריאייטיב של DCM לקליק של DCM התואם לסשן ב-Google Analytics (פרימיום בלבד).
  • מאפיין - ga:dcmClickRenderingId - מזהה הרינדור של DCM עבור הקליק ב-DCM התואם לסשן ב-Google Analytics (פרימיום בלבד).
  • מאפיין - ga:dcmClickSite - שם האתר שבו הקריאייטיב של DCM הוצג ונלחץ עליו עבור קליק של DCM שתואם לסשן ב-Google Analytics (גרסת פרימיום בלבד).
  • מאפיין - ga:dcmClickSiteId - מזהה אתר ב-DCM שבו הוצג הקריאייטיב של DCM ונלחצו עליו עבור קליק של DCM שתואם לסשן ב-Google Analytics (פרימיום בלבד).
  • מאפיין - ga:dcmClickSitePlacement - שם מיקום האתר ב-DCM של הקליק ב-DCM התואם לסשן ב-Google Analytics (פרימיום בלבד).
  • מאפיין - ga:dcmClickSitePlacementId - מזהה מיקום באתר של DCM עבור קליק של DCM התואם לסשן ב-Google Analytics (פרימיום בלבד).
  • מאפיין - ga:dcmClickSpotId - מזהה ההגדרה של DCM Floodlight של הקליק ב-DCM שתואם לסשן ב-Google Analytics (פרימיום בלבד).
  • מאפיין - ga:dcmFloodlightActivity – שם פעילות ב-DCM Floodlight שמשויך להמרה ב-Floodlight (פרימיום בלבד).
  • מאפיין - ga:dcmFloodlightActivityAndGroup – שם הפעילות ושם הקבוצה ב-DCM Floodlight המשויכים להמרה ב-Floodlight (פרימיום בלבד).
  • מאפיין - ga:dcmFloodlightActivityGroup – השם של קבוצת הפעילות ב-DCM Floodlight המשויכת להמרה ב-Floodlight (Premium בלבד).
  • מאפיין - ga:dcmFloodlightActivityGroupId – מזהה קבוצת פעילות ב-DCM Floodlight שמשויך להמרה ב-Floodlight (פרימיום בלבד).
  • מאפיין – ga:dcmFloodlightActivityId – מזהה פעילות ב-DCM Floodlight שמשויך להמרה ב-Floodlight (Premium בלבד).
  • מאפיין - ga:dcmFloodlightAdvertiserId – מזהה מפרסם ב-DCM Floodlight שמשויך להמרה ב-Floodlight (גרסת פרימיום בלבד).
  • מאפיין - ga:dcmFloodlightSpotId – מזהה ההגדרה של DCM Floodlight שמשויך להמרה ב-Floodlight (גרסת פרימיום בלבד).
  • מאפיין - ga:dcmLastEventAd - שם מודעת DCM של אירוע DCM האחרון (חשיפה או קליק בתוך חלון המבט לאחור של DCM) המשויך לסשן ב-Google Analytics (פרימיום בלבד).
  • מאפיין - ga:dcmLastEventAdId - מזהה מודעה של DCM של אירוע DCM האחרון (חשיפה או קליק במהלך חלון המבט לאחור של DCM) המשויך לסשן ב-Google Analytics (פרימיום בלבד).
  • מאפיין - ga:dcmLastEventAdType - שם סוג המודעה ב-DCM של אירוע DCM האחרון (חשיפה או קליק בתוך חלון המבט לאחור של DCM) המשויך לסשן ב-Google Analytics (פרימיום בלבד).
  • מאפיין - ga:dcmLastEventAdTypeId - מזהה סוג מודעת DCM של אירוע DCM האחרון (חשיפה או קליק בתוך חלון המבט לאחור של DCM) המשויך לסשן ב-Google Analytics (פרימיום בלבד).
  • מאפיין - ga:dcmLastEventAdvertiser - שם המפרסם ב-DCM של אירוע ה-DCM האחרון (חשיפה או קליק במהלך חלון המבט לאחור של DCM) המשויך לסשן ב-Google Analytics (פרימיום בלבד).
  • מאפיין - ga:dcmLastEventAdvertiserId - מזהה המפרסם ב-DCM של אירוע ה-DCM האחרון (חשיפה או קליק במהלך חלון המבט לאחור של DCM) המשויך לסשן ב-Google Analytics (פרימיום בלבד).
  • מאפיין – ga:dcmLastEventAttributionType – יש שני ערכים אפשריים (שיעור קליקים ואפשרות צפייה). אם אירוע DCM האחרון המשויך לסשן של Google Analytics היה קליק, הערך יהיה שיעור קליקים. אם אירוע DCM האחרון המשויך לסשן של Google Analytics היה חשיפה של מודעה, הערך יהיה שיעור צפייה (Premium בלבד).
  • מאפיין - ga:dcmLastEventCampaign - שם קמפיין DCM של אירוע DCM האחרון (חשיפה או קליק בתוך חלון המבט לאחור של DCM) המשויך לסשן ב-Google Analytics (פרימיום בלבד).
  • מאפיין - ga:dcmLastEventCampaignId - מזהה קמפיין DCM של אירוע DCM האחרון (חשיפה או קליק במהלך חלון המבט לאחור של DCM) המשויך לסשן ב-Google Analytics (פרימיום בלבד).
  • מאפיין - ga:dcmLastEventCreative - שם הקריאייטיב ב-DCM של אירוע ה-DCM האחרון (חשיפה או קליק במהלך חלון המבט לאחור של DCM) המשויך לסשן ב-Google Analytics (פרימיום בלבד).
  • מאפיין - ga:dcmLastEventCreativeId - מזהה קריאייטיב של DCM באירוע האחרון של DCM (חשיפה או קליק במהלך חלון המבט לאחור של DCM) המשויך לסשן ב-Google Analytics (פרימיום בלבד).
  • מאפיין - ga:dcmLastEventCreativeType - שם סוג הקריאייטיב ב-DCM של אירוע ה-DCM האחרון (חשיפה או קליק בתוך חלון המבט לאחור של DCM) המשויך לסשן ב-Google Analytics (פרימיום בלבד).
  • מאפיין - ga:dcmLastEventCreativeTypeId - מזהה סוג קריאייטיב ב-DCM של אירוע DCM האחרון (חשיפה או קליק במהלך חלון המבט לאחור של DCM) המשויך לסשן ב-Google Analytics (פרימיום בלבד).
  • מאפיין - ga:dcmLastEventCreativeVersion - גרסת הקריאייטיב של DCM לאירוע האחרון של DCM (חשיפה או קליק במהלך חלון המבט לאחור של DCM) המשויך לסשן ב-Google Analytics (פרימיום בלבד).
  • מאפיין - ga:dcmLastEventRenderingId - מזהה הרינדור של DCM באירוע האחרון של DCM (חשיפה או קליק במהלך חלון המבט לאחור של DCM) המשויך לסשן ב-Google Analytics (פרימיום בלבד).
  • מאפיין - ga:dcmLastEventSite - שם האתר שבו הקריאייטיב של DCM הוצג ולקליק עליו אירוע DCM האחרון (חשיפה או קליק במהלך חלון המבט לאחור של DCM) המשויך לסשן של Google Analytics (פרימיום בלבד).
  • מאפיין - ga:dcmLastEventSiteId - מזהה אתר ב-DCM שבו הוצג הקריאייטיב של DCM ונלחץ עליו עבור אירוע DCM האחרון (חשיפה או קליק במהלך חלון המבט לאחור של DCM) המשויך לסשן של Google Analytics (פרימיום בלבד).
  • מאפיין - ga:dcmLastEventSitePlacement - שם מיקום האתר ב-DCM של אירוע DCM האחרון (חשיפה או קליק בתוך חלון המבט לאחור של DCM) המשויך לסשן ב-Google Analytics (פרימיום בלבד).
  • מאפיין - ga:dcmLastEventSitePlacementId - מזהה מיקום המודעה באתר של DCM של אירוע DCM האחרון (חשיפה או קליק בתוך חלון המבט לאחור של DCM) המשויך לסשן ב-Google Analytics (פרימיום בלבד).
  • מאפיין - ga:dcmLastEventSpotId - מזהה ההגדרה של DCM Floodlight של אירוע DCM האחרון (חשיפה או קליק במהלך חלון המבט לאחור של DCM) המשויך לסשן ב-Google Analytics (פרימיום בלבד).
  • מדד - ga:dcmFloodlightQuantity – מספר ההמרות של DCM Floodlight (גרסת פרימיום בלבד).
  • מדד – dcmFloodlightRevenue – הכנסה מ-DCM Floodlight (פרימיום בלבד).

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

מאפיינים ומדדים

רשימת ההגדרות המלאה מופיעה בחומר העזר בנושא מאפיינים ומדדים.

קיבוץ תוכן

  • מאפיין - ga:landingContentGroupXX – קבוצת התוכן התואמת הראשונה בסשן של המשתמש.
  • מאפיין - ga:nextContentGroupXX – מתייחס לקבוצת תוכן שמשתמשים ביקרו בה אחרי קבוצת תוכן אחרת.
  • מאפיין - ga:contentGroupXX - קבוצת תוכן בנכס. קבוצת תוכן היא אוסף של תכנים ומספקים מבנה לוגי שאפשר לקבוע באמצעות קוד מעקב או התאמה לביטוי רגולרי של כותרת דף/כתובת URL, או כללים מוגדרים מראש.
  • מאפיין - ga:previousContentGroupXX - מתייחס לקבוצת תוכן שביקרו בה לפני ביקור בקבוצת תוכן אחרת.
  • ערך - ga:contentGroupUniqueViewsXX - מספר הדפים (הייחודיים) השונים בפעילות באתר עבור קבוצת התוכן שצוינה. כדי לקבוע את הייחודיות, המערכת מביאה בחשבון גם את pagePath וגם את pageTitle.

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

פלחים

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

מאפיינים ומדדים

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

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

  • מאפיין - ga:internalPromotionCreative - תוכן הקריאייטיב שמיועד לקידום מכירות.
  • מאפיין – ga:internalPromotionId – המזהה שבו משתמשים לקידום המכירות.
  • מאפיין – ga:internalPromotionName – שם המבצע.
  • מאפיין – ga:internalPromotionPosition – מיקום המבצע בדף האינטרנט או במסך האפליקציה.
  • מאפיין - ga:orderCouponCode - קוד לשובר ברמת ההזמנה.
  • מאפיין - ga:productBrand - שם המותג שתחתיו המוצר נמכר.
  • מאפיין - ga:productCategoryHierarchy - הקטגוריה ההיררכית שבה המוצר מסווג (מסחר אלקטרוני משופר).
  • מאפיין - ga:productCategoryLevelXX – רמה (1-5) בהיררכיה של קטגוריות מוצרים, מלמעלה למטה.
  • מאפיין - ga:productCouponCode - קוד השובר ברמת המוצר.
  • מאפיין - ga:productListName - השם של רשימת המוצרים שבה המוצר מופיע.
  • מאפיין - ga:productListPosition – מיקום המוצר ברשימת המוצרים.
  • מאפיין – ga:productVariant – הווריאציה הספציפית של המוצר, למשל, XS, S, M, L עבור מידה או אדום, כחול, ירוק, שחור עבור צבע.
  • מאפיין – ga:checkoutOptions – אפשרויות משתמש שצוינו בתהליך התשלום בקופה, למשל, FedEx , DHL , UPS לאפשרויות משלוח או Visa , MasterCard או AmEx עבור אפשרויות תשלום. יש להשתמש במאפיין זה במקביל לשלב הקנייה.
  • מאפיין – ga:shoppingStage – שלבים שונים של חוויית הקנייה שמשתמשים השלימו בסשן, למשל, PRODUCT_VIEW, ADD_TO_CART, CHECKOUT וכו'.
  • מדד – ga:internalPromotionCTR – השיעור שבו משתמשים לחצו כדי לצפות בקידום המכירות הפנימי (מספר הקליקים / מספר הפעמים שקידום המכירות הופיע).
  • מדד – ga:internalPromotionClicks – מספר הקליקים בקידום מכירות פנימי.
  • מדד – ga:internalPromotionViews – מספר הצפיות בקידום מכירות פנימי.
  • מדד – ga:localProductRefundAmount – סכום ההחזר הכספי על מוצר נתון במטבע המקומי.
  • מדד - ga:localRefundAmount - סכום ההחזר הכולל על העסקה במטבע המקומי.
  • מדד - ga:productAddsToCart - מספר הפעמים שהמוצר נוסף לעגלת הקניות.
  • מדד - ga:productCheckouts – מספר הפעמים שהמוצר נכלל בתהליך התשלום.
  • מדד – ga:productDetailViews – מספר הפעמים שמשתמשים צפו בדף פרטי המוצר.
  • מדד – ga:productListClicks – מספר הפעמים שמשתמשים לחצו על המוצר כשהוא הופיע ברשימת המוצרים.
  • מדד - ga:productListViews – מספר הפעמים שהמוצר הופיע ברשימת המוצרים.
  • מדד – ga:productListCTR – שיעור הלחיצות של משתמשים על המוצר ברשימת המוצרים.
  • מדד – ga:productRefunds – מספר הפעמים שניתן החזר כספי עבור המוצר.
  • מדד - ga:productRefundAmount – הסכום הכולל של ההחזר הכספי שמשויך למוצר.
  • מדד - ga:productRemovesFromCart – מספר הפעמים שהמוצר הוסר מעגלות קניות.
  • מדד - ga:productRevenuePerPurchase – הכנסה ממוצעת ממוצר לרכישה (בדרך כלל עם קוד שובר מוצר).
  • מדד – ga:buyToDetailRate – רכישות ייחודיות חלקי מספר הצפיות בדפים של פרטי המוצרים.
  • מדד - ga:cartToDetailRate – הוספות מוצרים חלקי מספר הצפיות בפרטי המוצר.
  • מדד – ga:quantityAddedToCart – מספר יחידות המוצר שנוספו לעגלת הקניות.
  • מדד – ga:quantityCheckedOut – מספר יחידות המוצר שנכללו בתהליך התשלום.
  • מדד – ga:quantityRefunded – מספר יחידות המוצר שבוצע עבורן החזר כספי.
  • מדד – ga:quantityRemovedFromCart – מספר יחידות המוצר שהוסרו מעגלת הקניות.
  • מדד – ga:refundAmount – סכום המטבע שהוחזר על עסקה.
  • מדד – ga:totalRefunds – מספר ההחזרים הכספיים שבוצעו.

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

מאפיינים ומדדים

רשימת ההגדרות המלאה מופיעה בחומר העזר בנושא מאפיינים ומדדים.

מערכת

  • מאפיין – ga:sourcePropertyDisplayName – השם המוצג של נכס המקור בנכסי-על. תקף רק לנכסי-על.
  • מאפיין – ga:sourcePropertyTrackingId – מזהה לצורכי מעקב של נכס מקור בנכסי-על. תקף רק לנכסי-על

קיבוץ ערוצים

  • מאפיין - ga:channelGrouping – קיבוץ הערוצים שמוגדר כברירת מחדל ומשותף בתצוגה המפורטת (פרופיל).
  • מאפיין - ga:correlationModelId - מזהה מודל ההתאמה למוצרים קשורים.
  • מאפיין - ga:queryProductId – מזהה המוצר שמופיע בשאילתה.
  • מאפיין - ga:queryProductName - שם המוצר שמופיע בשאילתה.
  • מאפיין - ga:queryProductVariation - וריאציה של המוצר שמופיע בשאילתה.
  • מאפיין - ga:relatedProductId – המזהה של המוצר הקשור.
  • מאפיין - ga:relatedProductName - שם המוצר הקשור.
  • מאפיין - ga:relatedProductVariation - וריאציה של המוצר הקשור.
  • מדד - ga:correlationScore – ציון ההתאמה למוצרים קשורים.
  • מדד - ga:queryProductQuantity – כמות המוצר שמופיע בשאילתה.
  • מדד - ga:relatedProductQuantity – כמות המוצר הקשור.

תיקון השם של עמודת הכותרת

  • היה באג בגרסה 2014-04-16; אם תשאלו לגבי מאפיין או מדד שהוצאו משימוש, ה-API יחזיר את כותרות העמודות עם המאפיין או המדד החלופי. עכשיו הוא מחזיר בצורה נכונה את אותו שם של מאפיין או מדד ששימש בבקשה.

הגרסה הזו כוללת שינוי במוסכמה לגבי מתן שמות למאפיין uiName.

שינוי שם משתמש

  • מאפיין uiName בעמודות עם תבניות משתמש עכשיו ב-XX כדי לייצג את האינדקס המספרי במקום 1. לדוגמה, Goal 1 Value נקרא עכשיו Goal XX Value.

זוהי הגרסה הראשונית של ממשק ה-API להטמעה:

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

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

הוצאה משימוש של appUiName

  • השיטה appUiName הוצאה משימוש. הוא כבר לא נדרש ב-Metadata API כי שמות ממשק המשתמש עבור תצוגות מפורטות של אינטרנט ואפליקציות (פרופילים) אוחדו. יש להסיר כל קוד שנעשה בו שימוש במאפיין appUiName ולהשתמש רק במאפיין uiName.

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

שינינו את השם של מאפיינים ומדדים

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

משתמש

  • מאפיין - rt:visitorType – במקום זאת יש להשתמש במאפיין rt:userType.
  • מדד – rt:activeVisitors – יש להשתמש במקום זאת ב-rt:activeUsers.

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

מאפיינים ומדדים חדשים

המאפיינים הבאים נוספו ל-Core Reporting API:

AdWords

  • מאפיין - ga:isTrueViewVideoAd - Yes או No - מציין אם המודעה היא מודעת וידאו מסוג TrueView של AdWords.

שעה

  • מאפיין - ga:nthHour - אינדקס לכל שעה בטווח התאריכים שצוין. האינדקס של השעה הראשונה של היום הראשון (כלומר, תאריך ההתחלה) בטווח התאריכים הוא 0, 1 עבור השעה הבאה וכן הלאה.

שינינו את השם של מאפיינים ומדדים

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

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

קהל

  • מאפיין - ga:visitorAgeBracket – במקום זאת יש להשתמש במאפיין ga:userAgeBracket.
  • מאפיין - ga:visitorGender – במקום זאת יש להשתמש במאפיין ga:userGender.

מסחר אלקטרוני

  • מדד – ga:transactionRevenuePerVisit – יש להשתמש במקום זאת ב-ga:transactionRevenuePerSession.
  • מדד – ga:transactionsPerVisit – יש להשתמש במקום זאת ב-ga:transactionsPerSession.

מעקב אחר אירועים

  • מדד – ga:eventsPerVisitWithEvent – יש להשתמש במקום זאת ב-ga:eventsPerSessionWithEvent.
  • מדד – ga:visitsWithEvent – יש להשתמש במקום זאת ב-ga:sessionsWithEvent.

המרות ליעד

  • מדד – ga:goalValuePerVisit – יש להשתמש במקום זאת ב-ga:goalValuePerSession.
  • מדד – ga:percentVisitsWithSearch – יש להשתמש במקום זאת ב-ga:percentSessionsWithSearch.
  • מדד – ga:searchVisits – יש להשתמש במקום זאת ב-ga:searchSessions.

מעקב אחר דפים

  • מדד – ga:pageviewsPerVisit – יש להשתמש במקום זאת ב-ga:pageviewsPerSession.

סשן

  • מאפיין - ga:visitLength – במקום זאת יש להשתמש במאפיין ga:sessionDurationBucket.
  • מדד – ga:avgTimeOnSite – יש להשתמש במקום זאת ב-ga:avgSessionDuration.
  • מדד – ga:timeOnSite – יש להשתמש במקום זאת ב-ga:sessionDuration.
  • מדד – ga:visitBounceRate – יש להשתמש במקום זאת ב-ga:bounceRate.
  • מדד – ga:visits – יש להשתמש במקום זאת ב-ga:sessions.

אינטראקציות חברתיות

  • מאפיין - ga:socialInteractionNetworkActionVisit – במקום זאת יש להשתמש במאפיין ga:socialInteractionNetworkActionSession.
  • מדד – ga:socialInteractionsPerVisit – יש להשתמש במקום זאת ב-ga:socialInteractionsPerSession.

משתמש

  • מאפיין - ga:daysSinceLastVisit – במקום זאת יש להשתמש במאפיין ga:daysSinceLastSession.
  • מאפיין - ga:visitCount – במקום זאת יש להשתמש במאפיין ga:sessionCount.
  • מאפיין - ga:visitorType – במקום זאת יש להשתמש במאפיין ga:userType.
  • מאפיין - ga:visitsToTransaction – במקום זאת יש להשתמש במאפיין ga:sessionsToTransaction.
  • מדד – ga:newVisits – יש להשתמש במקום זאת ב-ga:newUsers.
  • מדד – ga:percentNewVisits – יש להשתמש במקום זאת ב-ga:percentNewSessions.
  • מדד – ga:visitors – יש להשתמש במקום זאת ב-ga:users.

פלחים: ממשק ה-API הראשי לדיווח בגרסאות v2.4 ו-v3.0

תמיכה בפלחים חדשים ב-Core Reporting API.

  • הפרמטר segment תומך עכשיו בפלחי משתמשים ובפלחי רצף. בפלחים ברמת המשתמש וברמת הסשן שנוצרו בממשק האינטרנט אפשר לשלוח שאילתות באמצעות הפרמטר segment.
  • תחביר חדש לפלחים דינמיים זמין לשימוש עם הפרמטר segment. לפרטים נוספים אפשר לעיין במדריך למפתחי פלחים
  • הקידומת dynamic:: הוצאה משימוש. מומלץ migrate לתחביר החדש בהקדם האפשרי.

הקידומת ga: הוצאה משימוש

הקידומת ga: הוצאה משימוש לכל המאפיינים והמדדים בזמן אמת, והוחלפה בקידומת החדשה rt:. בקשות API שמשתמשות בקידומת ga: ימשיכו לפעול במשך 6 חודשים, ולאחר מכן תוחזר שגיאה.

מאפיינים ומדדים חדשים

בעדכון הזה מתווספים מאפיינים ומדדים חדשים ל-Real Time Reporting API. כדאי לעיין ברשימה המלאה בחומר העזר בנושא מאפיינים ומדדים.

מעקב אחר אירועים

  • מאפיין - rt:eventAction - הפעולה של האירוע.
  • מאפיין - rt:eventCategory - קטגוריית האירוע.
  • מאפיין - rt:eventLabel - תווית האירוע.
  • מאפיין - rt:totalEvents - המספר הכולל של אירועים עבור הפרופיל, בכל הקטגוריות.

מעקב אחר יעדים

  • מאפיין - rt:goalId - מחרוזת שתואמת למזהה היעד.
  • מדד - rt:goalXXValue - הערך המספרי הכולל של מספר היעד המבוקש, כאשר XX הוא מספר בין 1 ל-20.
  • מדד - rt:goalValueAll - הערך המספרי הכולל של כל היעדים שהוגדרו עבור הפרופיל שלך.
  • מדד - rt:goalXXCompletions - מספר ההשלמות הכולל של מספר היעד המבוקש, כאשר XX הוא מספר בין 1 ל-20.
  • מדד - rt:goalCompletionsAll - מספר ההשלמות הכולל של כל היעדים שהוגדרו לפרופיל שלך.

מעקב אחר דפים

  • מדד - rt:pageViews - המספר הכולל של צפיות בדף.

מעקב אחר אפליקציה

  • מדד - rt:screenViews - המספר הכולל של צפיות במסך.

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

נתיבי המרות

  • מאפיין - mcf:adwordsCustomerIDPath – רצף של מספר הלקוח ב-AdWords לאורך נתיבי ההמרות.

אינטראקציות

  • מאפיין - mcf:adwordsCustomerID - תואם ל-AdWords API Customer.id.

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

נתיבי המרות

  • מאפיין - mcf:adwordsAdGroupIDPath - רצף של מזהה קבוצת מודעות ב-AdWords לאורך נתיבי המרות.
  • מאפיין - mcf:adwordsCampaignIDPath - רצף של מזהה קמפיין ב-AdWords לאורך נתיבי המרות.
  • מאפיין - mcf:adwordsCreativeIDPath - רצף של מזהה הקריאייטיב ב-AdWords לאורך נתיבי ההמרות.
  • מאפיין - mcf:adwordsCriteriaIDPath - רצף של מזהה קריטריונים ב-AdWords לאורך נתיבי המרות.

אינטראקציות

  • מאפיין - mcf:adwordsAdGroupID - תואם ל-AdWords API AdGroup.id.
  • מאפיין - mcf:adwordsCampaignID - תואם ל-AdWords API Campaign.id.
  • מאפיין - mcf:adwordsCreativeID - תואם ל-AdWords API Ad.id.
  • מאפיין - mcf:adwordsCriteriaID - תואם ל-AdWords API Criterion.id.

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

פלט טבלת הנתונים

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

  • פרמטר אופציונלי של שאילתה output נוסף ל-API. הוא יכול לשמש כדי לבחור את פורמט הפלט של נתוני Analytics בתגובה, שהוא JSON כברירת מחדל. אם המדיניות מוגדרת לערך datatable, התגובה תכלול את מאפיין dataTable שמכיל אובייקט טבלת נתונים. ניתן להשתמש באובייקט הזה ישירות באמצעות GoogleCharts. לפרטים נוספים, אפשר לעיין בחומר העזר בנושא Core Reporting API.

מאפיינים ומדדים חדשים

המאפיינים והמדדים הבאים נוספו ל-Core Reporting API:

שעה

  • מאפיין - ga:minute - החזרת הדקה בשעה. הערכים האפשריים הם בין 00 ל-59.
  • מאפיין - ga:nthMinute - אינדקס לכל דקה בטווח התאריכים שצוין. האינדקס של הדקה הראשונה של היום הראשון (כלומר, תאריך ההתחלה) בטווח התאריכים הוא 0, 1 לדקה הבאה וכן הלאה.

קהל

  • מאפיין - ga:visitorAgeBracket – טווח הגיל של המבקר.
  • מאפיין - ga:visitorGender - מגדר המבקר.
  • מאפיין – ga:interestAffinityCategory – מציין שיש סיכוי גבוה יותר שהמשתמשים יתעניינו במידע על הקטגוריה שצוינה.
  • מאפיין – ga:interestInMarketCategory – מציין שיש סיכוי גבוה יותר שמשתמשים יהיו מוכנים לרכוש מוצרים או שירותים בקטגוריה שצוינה.
  • מאפיין – ga:interestOtherCategory – מציין שיש סיכוי גבוה יותר שהמשתמשים יתעניינו במידע על הקטגוריה שצוינה ויש יותר סיכוי שהם יהיו מוכנים לבצע רכישה.

מאפיינים וערכים המותרים בפלחים

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

  • מאפיין - ga:sourceMedium - הערכים המשולבים של ga:source ו-ga:medium.
  • מדד – ga:localItemRevenue – הכנסות מהמוצר במטבע מקומי.

מאפיינים ומדדים שהוצאו משימוש

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

  • מאפיין – ga:isMobile – צריך להשתמש במקום זאת במאפיין ga:deviceCategory (למשל, ga:deviceCategory==mobile).
  • מאפיין – ga:isTablet – צריך להשתמש במקום זאת במאפיין ga:deviceCategory (למשל, ga:deviceCategory==tablet).
  • מדד – ga:entranceBounceRate – יש להשתמש במקום זאת ב-ga:visitBounceRate.

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

AdSense

  • נוספה גישה לנתוני AdSense:

    • התקבל – ga:adsenseRevenue – סך כל ההכנסות ממודעות AdSense.
    • הושלם - ga:adsenseAdUnitsViewed - מספר יחידות המודעות של AdSense שנצפו. יחידת מודעות היא קבוצת מודעות שמוצגת כתוצאה מחלק אחד של קוד מודעות של AdSense. פרטים: https://support.google.com/adsense/answer/32715.
    • בוצע - ga:adsenseAdsViewed - מספר מודעות AdSense שנצפו. אפשר להציג כמה מודעות בתוך יחידת מודעות.
    • שיעור הקליקים - ga:adsenseAdsClicks – מספר הפעמים שלחצו על מודעות AdSense באתר שלך.
    • בוצע - ga:adsensePageImpressions - מספר הצפיות בדף שבמהלכן הוצגה מודעת AdSense. לחשיפה של דף יכולות להיות כמה יחידות מודעות.
    • התוצאות - ga:adsenseCTR – אחוז החשיפות של דפים שהובילו לקליק על מודעת AdSense. (ga:adsenseAdsClicks/ga:adsensePageImpressions)
    • התוצאות - ga:adsenseECPM – העלות המשוערת לאלף חשיפות של דף. זוהי ההכנסה שלך ב-AdSense לכל 1000 הופעות. (ga:adsenseRevenue/(ga:adsensePageimpressions/1000).
    • בוצע - ga:adsenseExits - מספר הסשנים שהסתיימו כתוצאה מלחיצה של משתמש על מודעת AdSense.

שעה

  • עמעום - ga:isoYear – שנת הביקור בפורמט ISO. פרטים: http://en.wikipedia.org/wiki/ISO_week_date. יש להשתמש ב-ga:isoYear עם ga:isoWeek רק כי ga:week מייצג יומן גרגוריאני.
  • עמעום - ga:isoYearIsoWeek - הערכים המשולבים של ga:isoYear ו-ga:isoWeek.

AdWords

  • הנתונים האלה מופיעים בדוחות AdWords:

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

תאריכים יחסיים
  • תמיכה בתאריכים יחסיים נוספה ל-MCF Reporting API. today, yesterday ו-NdaysAgo הם עכשיו ערכים חוקיים לפרמטרים של השאילתה start-date ו-end-date.
  • שימוש בערכים האלה יקבע באופן אוטומטי את טווח התאריכים על סמך התאריך הנוכחי בזמן ביצוע השאילתה, ועל סמך אזור הזמן של התצוגה המפורטת (הפרופיל) שצוין בשאילתה. פרטים נוספים זמינים בחומר העזר בנושא API.
רמת הדגימה
  • הוספנו פרמטר חדש, samplingLevel, שמאפשר לך להגדיר את רמת הדגימה (כלומר, מספר הביקורים המשמשים לחישוב התוצאה) עבור שאילתת דיווח. הערכים המותרים הם: DEFAULT, FASTER ו-HIGHER_PRECISION.
  • 2 שדות חדשים נוספו לתגובת ה-API: sampleSize ו-sampleSpace. תוכל להשתמש בערכים אלו כדי לחשב את אחוז הביקורים ששימשו לתגובה שנדגמה.
  • לפרטים נוספים, עיינו בחומר העזר בנושא API ובדגימה.

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

תאריכים יחסיים
  • תמיכה בתאריכים יחסיים נוספה ל-Core Reporting API. today, yesterday ו-NdaysAgo הם עכשיו ערכים חוקיים לפרמטרים של השאילתה start-date ו-end-date.
  • שימוש בערכים האלה יקבע באופן אוטומטי את טווח התאריכים על סמך התאריך הנוכחי בזמן ביצוע השאילתה, ועל סמך אזור הזמן של התצוגה המפורטת (הפרופיל) שצוין בשאילתה. פרטים נוספים זמינים בחומר העזר בנושא API.
רמת הדגימה
  • הוספנו פרמטר חדש, samplingLevel, שמאפשר לך להגדיר את רמת הדגימה (כלומר, מספר הביקורים המשמשים לחישוב התוצאה) עבור שאילתת דיווח. הערכים המותרים הם: DEFAULT, FASTER ו-HIGHER_PRECISION.
  • 2 שדות חדשים נוספו לתגובת ה-API: sampleSize ו-sampleSpace. תוכל להשתמש בערכים אלו כדי לחשב את אחוז הביקורים ששימשו לתגובה שנדגמה.
  • לפרטים נוספים, עיינו בחומר העזר בנושא API ובדגימה.

זוהי הגרסה הראשונית של Metadata API:

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

זוהי הגרסה הראשונית של Real Time Reporting API בגרסת בטא מוגבלת:

  • Real Time Reporting API מאפשר לכם לדווח על פעילות שמתרחשת בנכס כרגע. אתם יכולים להשתמש ב-Real Time Reporting API כדי לבצע שאילתות על מאפיינים ומדדים כדי ליצור ווידג'טים ומרכזי בקרה שמיועדים ללקוחות. פרטים נוספים זמינים במאמר סקירה כללית של Real Time Reporting API.

תיקוני באגים

  • הקוד ga:adwordsCustomerID מחזיר כעת בצורה תקינה את מספר הלקוח בן 10 הספרות ב-AdWords, התואם ל-AccountInfo.customerId של AdWords API. תיקון זה מאפשר לצרף נתוני Analytics לחשבונות AdWords מרובים.

כחלק מההשקה של הפלחים החדשים, נשיק את השינויים הבאים ב-Core Reporting API.

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

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

מעקב אחר אפליקציה

  • הנתונים האלה מופיעים בדוחות של פרופיל האפליקציה:
    • Dim - ga:appId - מזהה האפליקציה.
    • עמעום - ga:appInstallerId – מזהה של המתקין (למשל, חנות Google Play) שממנה האפליקציה הורדה. כברירת מחדל, המזהה של מתקין האפליקציה מוגדר על סמך השיטה PackageManager#getInstallerPackageName.
    • Dim - ga:appName - שם האפליקציה.
    • Dim - ga:appVersion - גרסת האפליקציה.
    • עמעום - ga:exitScreenName – שם המסך כשהמשתמש יצא מהאפליקציה.
    • עמעום - ga:landingScreenName – שם המסך הראשון שנצפה.
    • עמעום - ga:screenDepth – מספר הצפיות במסך לכל סשן באתר שדווחו כמחרוזת. יכול להיות שימושי להיסטוגרמות.
    • עמעום - ga:screenName - שם המסך.
    • שיעור התוצאות שנצפה – ga:avgScreenviewDuration – משך הזמן הממוצע שמשתמשים בילו במסך בשניות.
    • בוצע - ga:timeOnScreen – משך הזמן שהוקדש לצפייה במסך הנוכחי.
    • בוצע - ga:screenviews - המספר הכולל של צפיות במסך. יש להשתמש בקוד הזה במקום ב-ga:appviews.
    • בוצעו - ga:uniqueScreenviews – מספר ה-ga:screenviews (הייחודיים) השונים במהלך סשן. יש להשתמש בקוד הזה במקום ב-ga:uniqueAppviews.
    • בוצעו - ga:screenviewsPerSession – המספר הממוצע של ga:screenviews בכל סשן. יש להשתמש בקוד הזה במקום ב-ga:appviewsPerVisit.

הוצא משימוש

המדדים הבאים הוצאו משימוש. במקום זאת, יש להשתמש בשם של המדד החדש.

  • בוצע - ga:appviews – יש להשתמש במקום זאת ב-ga:screenviews.
  • בוצע - ga:uniqueAppviews – יש להשתמש במקום זאת ב-ga:uniqueScreenviews.
  • בוצע - ga:appviewsPerVisit – יש להשתמש במקום זאת ב-ga:screenviewsPerSession.

משתנים או עמודות מותאמים אישית

  • גישה למאפיינים ולמדדים מותאמים אישית:

    • עמעום - ga:dimensionXX – שם המאפיין המותאם אישית המבוקש, כאשר XX מתייחס למספר/האינדקס של המאפיין המותאם אישית.
    • Met - ga:metricXX – שם המדד המותאם אישית המבוקש, כאשר XX מתייחס למספר/האינדקס של המדד המותאם אישית.

שינויים בתיעוד

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

  • ga:customVarName(n) ← ga:customVarNameXX
  • ga:customVarValue(n) ← ga:customVarValueXX

מסחר אלקטרוני

  • Dim - ga:currencyCode - קוד המטבע המקומי של העסקה לפי תקן ISO 4217.
  • בוצע - ga:localItemRevenue – ההכנסות מהמוצר במטבע המקומי.
  • בוצע – ga:localTransactionRevenue – ההכנסות מעסקאות במטבע המקומי.
  • השירות בוצע - ga:localTransactionShipping – עלות המשלוח של העסקה במטבע המקומי.
  • בוצע - ga:localTransactionTax – מס עסקה במטבע המקומי.

חריגים

  • הנתונים האלה מגיעים ממעקב אחר חריגים.
    • עמעום - ga:exceptionDescription - התיאור של החריג.
    • בוצעו – ga:exceptionsPerScreenview – מספר החריגים שהופעלו חלקי מספר הצפיות במסך.
    • התרעה – ga:fatalExceptionsPerScreenview – מספר החריגים הקטלניים שהמערכת ביצעה, חלקי מספר הצפיות במסך.

המרות ליעד

  • עמעום - ga:goalCompletionLocation – נתיב הדף או שם המסך שתאמו לכל השלמה של מטרה עסקית מסוג יעד.
  • עמעום - ga:goalPreviousStep1 - נתיב הדף או שם המסך שתאמו לכל יעד מסוג יעד, שלב אחד לפני המיקום של יעדים שהושלמו.
  • עמעום - ga:goalPreviousStep2 - נתיב הדף או שם המסך שתאם ליעד מסוג כלשהו של יעד, שני שלבים לפני מיקום היעד שהושלם.
  • עמעום - ga:goalPreviousStep3 – נתיב הדף או שם המסך שתאמו לכל יעד מסוג יעד, שלושה שלבים לפני המיקום של השלמת היעד.

שינויים בתיעוד

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

  • ga:goal(n)AbandonRate ← ga:goalXXAbandonRate
  • ga:goal(n)Abandons ← ga:goalXXAbandons
  • ga:goal(n)Completions ← ga:goalXXCompletions
  • ga:goal(n)ConversionRate ← ga:goalXXConversionRate
  • ga:goal(n)Starts ← ga:goalXXStarts
  • ga:goal(n)Value ← ga:goalXXValue
  • ga:searchGoal(n)ConversionRate ← ga:searchGoalXXConversionRate
  • בוצע - ga:percentSearchRefinements - אחוז הפעמים שבהן חל שיפור (כלומר, מעבר) בין מילות מפתח בחיפוש פנימי במהלך פעילות באתר.

מעקב אחר דפים

  • בוצע - ga:pageValue - הערך הממוצע של הדף הזה או של קבוצת הדפים הזו. ערך דף מחושב באופן הבא: ((הכנסה מעסקאות + ערך כולל של יעד) חלקי צפיות בדף ייחודיות של הדף או קבוצת הדפים).

פלטפורמה או מכשיר

  • נתונים אלה נגזרים מהמחרוזת של סוכן המשתמש ב-HTTP.

    • עמעום - ga:deviceCategory – סוג המכשיר: מחשב, טאבלט או נייד.
    • עמעום - ga:isTablet – מציין מבקרים שמשתמשים בטאבלט. הערכים האפשריים הם Yes או No.
    • עמעום - ga:mobileDeviceMarketingName - השם השיווקי המשמש למכשיר נייד.

אינטראקציות חברתיות

  • נתונים אלו מגיעים ממעקב אחר אינטראקציות חברתיות באתר.

    • עמעום – ga:socialEngagementType – סוג אינטראקציה. הערכים האפשריים הם Socially Engaged או Not Socially Engaged.

שעה

  • עמעום - ga:dateHour - הערכים המשולבים של ga:date ו-ga:hour.
  • Dim - ga:dayOfWeekName - שם היום בשבוע (באנגלית).
  • Dim - ga:isoWeek - מספר השבוע לפי תקן ISO, שבו כל שבוע מתחיל ביום שני. פרטים: http://en.wikipedia.org/wiki/ISO_week_date.
  • עמעום - ga:yearMonth - הערכים המשולבים של ga:year ו-ga:month.
  • עמעום - ga:yearWeek - הערכים המשולבים של ga:year ו-ga:week.

מקורות תנועה

  • עמעום - ga:fullReferrer - כתובת ה-URL המלאה שמפנה, כולל שם המארח והנתיב.
  • עמעום - ga:sourceMedium - הערכים המשולבים של ga:source ו-ga:medium.
  • לגרסה הזו נוספו 5 מדדים חדשים של מהירות אתר:
    • ga:domInteractiveTime
    • ga:avgDomInteractiveTime
    • ga:domContentLoadedTime
    • ga:avgDomContentLoadedTime
    • ga:domLatencyMetricsSample
  • בגרסה הזו נוסף פלח ברירת מחדל חדש ל'תנועה בטאבלטים', gaid::-13.

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

מעקב אחר אפליקציה

  • הנתונים האלה מופיעים בדוחות של SDK למעקב באפליקציות לנייד:
    • המרות שבוצעו - ga:uniqueAppviews – מספר הצפיות באפליקציה בכל סשן.
    • ההמרות שבוצעו - 'ga:appviews - מספר הצפיות הכולל באפליקציה.
    • שיעור הקליקים - ga:appviewsPerVisit – המספר הממוצע של צפיות באפליקציה בכל סשן.

מקורות תנועה

  • עמעום - ga:socialNetwork - מחרוזת שמייצגת את שם הרשת החברתית. זה יכול להיות קשור לרשת החברתית המפנה למקורות תנועה, או לרשת החברתית לפעילויות של המרכז לנתוני רשתות חברתיות. למשל, Google+, Blogger, Reddit וכו'.
  • Dim - ga:hasSocialSourceReferral - מציין ביקורים שהגיעו לאתר ממקור חברתי (כלומר, רשת חברתית כגון Google+, Facebook, Twitter וכו'). הערכים האפשריים הם 'כן' או 'לא', כאשר האות הראשונה חייבת להיות אות רישית.

פעילויות חברתיות

  • נתונים אלו מגיעים מפעילות מחוץ לאתר שיובאה משותפי המרכז לנתוני רשתות חברתיות.
    • עמעום - ga:socialActivityDisplayName - עבור פעילות של מרכז נתונים חברתיים, המחרוזת הזו מייצגת את הכותרת של הפעילות החברתית שפורסמה על ידי המשתמש ברשת החברתית.
    • עמעום - ga:socialActivityEndorsingUrl - עבור פעילות של מרכז נתונים חברתיים, המחרוזת הזו מייצגת את כתובת האתר של הפעילות החברתית (למשל, כתובת האתר של הפוסט ב-Google+, כתובת האתר של התגובה בבלוג וכו').
    • עמעום - ga:socialActivityPost - עבור פעילות של מרכז נתונים חברתיים, המחרוזת הזו מייצגת את התוכן של הפעילות החברתית שפורסם על ידי המשתמש ברשת החברתית (למשל, תוכן ההודעה של פוסט ב-Google+ )
    • עמעום - ga:socialActivityTimestamp - עבור פעילות של מרכז נתונים חברתיים, המחרוזת הזו מייצגת את המועד שבו הפעילות החברתית התרחשה ברשת החברתית.
    • עמעום - ga:socialActivityUserPhotoUrl - עבור פעילות של מרכז נתונים חברתיים, מחרוזת זו מייצגת את כתובת האתר של התמונה המשויכת לפרופיל המשתמש ברשת החברתית.
    • עמעום - ga:socialActivityUserProfileUrl - עבור פעילות של מרכז נתונים חברתיים, המחרוזת הזו מייצגת את כתובת האתר של פרופיל המשתמש המשויך ברשת החברתית.
    • עמעום - ga:socialActivityContentUrl - עבור פעילות של מרכז נתונים חברתיים, מחרוזת זו מייצגת את כתובת האתר ששותפה על ידי המשתמש ברשת החברתית.
    • עמעום - ga:socialActivityTagsSummary - עבור פעילות של מרכז נתונים חברתיים, זוהי קבוצה מופרדת בפסיקים של תגים המשויכים לפעילות החברתית.
    • עמעום - ga:socialActivityUserHandle - עבור פעילות של מרכז נתונים חברתיים, מחרוזת זו מייצגת את הכינוי של הרשת החברתית (כלומר השם) של המשתמש שיזם את הפעילות החברתית.
    • עמעום - ga:socialActivityAction - עבור פעילות של מרכז נתונים חברתיים, המחרוזת הזו מייצגת את סוג הפעולה החברתית שמשויכת לפעילות (למשל, הצבעה, תגובה, סימון 1+ וכו').
    • עמעום - ga:socialActivityNetworkAction - עבור פעילות של מרכז נתונים חברתיים, מחרוזת זו מייצגת את סוג הפעולה החברתית ואת הרשת החברתית שממנה הגיעה הפעילות.
    • בוצע - ga:socialActivities - מספר הפעילויות שבהן כתובת URL של תוכן שותפה או הוזכרה ברשת שותפה של המרכז לנתוני רשתות חברתיות.

אינטראקציות חברתיות

  • נתונים אלו מגיעים ממעקב אחר אינטראקציות חברתיות באתר.
    • עמעום - ga:socialInteractionAction - באינטראקציות חברתיות, מחרוזת שמייצגת את הפעולה החברתית שאחריה מתבצע מעקב (למשל, סימון 1+, 'אהבתי', סימניה)
    • Dim - ga:socialInteractionNetwork - באינטראקציות חברתיות, מחרוזת שמייצגת את הרשת החברתית שעוקבים אחריה (למשל Google, Facebook, Twitter, LinkedIn)
    • עמעום - ga:socialInteractionNetworkAction - עבור אינטראקציות חברתיות, מחרוזת שמייצגת את השרשור של ga:socialInteractionNetwork ו-ga:socialInteractionAction שעוקבים אחריהם (למשל Google: +1, Facebook: אהבתי)
    • עמעום - ga:socialInteractionTarget - עבור אינטראקציות חברתיות, מחרוזת שמייצגת את כתובת האתר (או המשאב) שמקבלת את פעולת הרשת החברתית.
    • נפגשנו - ga:socialInteractions - המספר הכולל של אינטראקציות חברתיות באתר שלך.
    • נפגשנו - ga:uniqueSocialInteractions - המספר הכולל של אינטראקציות חברתיות ייחודיות באתר שלך. על סמך צמד הערכים ga:socialInteractionNetwork ו-ga:socialInteractionAction
    • מתקיים בתאריך - ga:socialInteractionsPerVisit - ga:socialInteractions מתוך ga:uniqueSocialInteractions. המספר הממוצע של אינטראקציות חברתיות בכל ביקור באתר שלך.

גיאוגרפי / רשת

  • עמעם - ga:metro - אזור השוק הייעודי (DMA) שממנו הגיעה התנועה.

מעקב אחר דפים

  • Dim - ga:pagePathLevel1 - מאפיין זה ממזג את כל ה-pagePaths ברמה ההיררכית הראשונה ב-pagePath.
  • Dim - ga:pagePathLevel2 - מאפיין זה ממזג את כל ה-pagePaths ברמה ההיררכית השנייה ב-pagePath.
  • Dim - ga:pagePathLevel3 - מאפיין זה ממזג את כל ה-pagePaths ברמה ההיררכית השלישית ב-pagePath.
  • Dim - ga:pagePathLevel4 - מאפיין זה ממזג את כל ה-pagePaths ברמה ההיררכית הרביעית ב-pagePath. כל הרמות הנוספות בהיררכיית pagePath מסוכמות גם הן במאפיין זה.

מעקב אחר חריגים

  • הנתונים האלה מגיעים מנתוני מעקב אחר חריגים.

    • בוצע - ga:exceptions - מספר החריגים שנשלחו אל Google Analytics.
    • Met – ga:fatalExceptions – מספר החריגים שבהם הערך isFatal מוגדר כ-True.

תזמוני משתמשים

  • הנתונים האלה מגיעים מנתוני תזמון של משתמש.

    • Dim - ga:userTimingCategory - מחרוזת לסיווג כל משתני התזמון של משתמשים בקבוצות לוגיות, למטרות דיווח נוח יותר.
    • עמעום - ga:userTimingLabel - מחרוזת לציון שם הפעולה של המשאב שאחריהן מתבצע מעקב.
    • עמעום - ga:userTimingVariable – מחרוזת שניתן להשתמש בה כדי להעניק גמישות בהצגת תזמוני משתמש בדוחות.
    • עמעם - ga:userTimingValue מספר אלפיות השנייה הזמן שחלף שנשלחו אל Google Analytics.
    • בוצעו - ga:userTimingSample - מספר הדגימות שנשלחו.
    • בוצע - ga:avgUserTimingValue – הערך הממוצע של תזמון משתמש. ga:userTimiingValue מתוך ga:userTimiingSample

מכשיר / פלטפורמה

  • הנתונים האלה מגיעים מסוכן המשתמש של הנתונים שנאספו.
    • Dim - ga:mobileDeviceBranding – שם היצרן או שם המותג של המכשיר הנייד (דוגמאות: Samsung, HTC, Verizon, T-Mobile).
    • עמעום - ga:mobileDeviceModel – דגם המכשיר הנייד (לדוגמה: Nexus S)
    • עמעום - ga:mobileInputSelector – הבורר שנמצא בשימוש בנייד (לדוגמה: מסך מגע, ג'ויסטיק, גלגל מגע, סטיילוס)
    • Dim - ga:mobileDeviceInfo – המותג, הדגם והשם השיווקי ששימשו לזיהוי המכשיר הנייד.

זוהי הגרסה הראשונה של ממשק ה-API לדיווח על משפכים מרובי-ערוצים:

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

תיקוני באגים

  • עכשיו ה-API מטפל בצורה תקינה בתווי UTF-8 במסנן או בפלח דינמי.

גרסה זו מאפשרת לחשבונות פרימיום של Google Analytics לגשת לעד 50 משתנים מותאמים אישית.

בגרסה הזו מתוקנים שני באגים:

תיקוני באגים

  • מסנני שאילתות שמכילים תווים מיוחדים בביטויים רגולריים כבר לא מחזירים שגיאות שרת.

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

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

מדדים חדשים

  • המדדים הבאים של מהירות האתר נוספו:
    • ga:speedMetricsSample
    • ga:domainLookupTime
    • ga:pageDownloadTime
    • ga:redirectionTime
    • ga:serverConnectionTime
    • ga:serverResponseTime
    • ga:avgDomainLookupTime
    • ga:avgPageDownloadTime
    • ga:avgRedirectionTime
    • ga:avgServerConnectionTime
    • ga:avgServerResponseTime

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

תזכורת להוצאה משימוש של גרסה 2.3 של API

  • גרסה 2.3 של ממשק ה-API לייצוא נתונים הוצאה משימוש למשך חודשיים. בעוד כ-4 חודשים נוספים נשבית את השירות הזה ונתמוך רק בגרסה 3.0 ובגרסה 2.4 החדשה של Core Reporting API.

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

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

  • כל הבקשות לגרסה 2.3 JSON או לספריית הלקוח של JavaScript ב-Google Data שמשתמשת בפלט JSON בגרסה 2.3, יחזירו קודי סטטוס 404.

  • כדי ליהנות ממכסה מלאה, גם בגרסה 3.0 וגם בגרסה 2.4 צריך לרשום את האפליקציה במסוף Google APIs ולהשתמש במפתח API (או אסימון OAuth 2.0) בכל בקשה.

תיקנו באג קטן ב-ga:visitLength. המאפיין הזה מחזיר עכשיו את הנתונים הנכונים.

גרסה זו משפיעה על כל מפתחי ה-API של Google Analytics. ההודעה מודיעה על שתי גרסאות חדשות של ה-API, מחייבת את האפליקציות להירשם, מציגה מדיניות חדשה בנושא מכסות ומשנה את שם ה-API ל-Core Reporting API. לבסוף, הוא מוציא משימוש את גרסה 2.3 של ממשק ה-API לייצוא נתונים.

גרסה 3.0

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

  • תכונות חדשות

  • עדכונים

    • כתובת URL חדשה לשליחת בקשות: https://www.googleapis.com/analytics/v3/data/ga….
    • נדרשים אסימונים של רישום ומפתח.
    • את כל הבקשות לנתוני הגדרות יש לבצע דרך Management API.

גרסה 2.4

  • גרסה 2.4 של ה-Core Reporting API היא שדרוג גרסה משני שמותאם בעיקר לגרסה 2.3 של ממשק ה-API לייצוא נתונים.

  • עדכונים

    • כתובת URL חדשה לשליחת בקשות: https://www.googleapis.com/analytics/v2.4/data…
    • נדרשים אסימונים של רישום ומפתח.
    • פלט XML שתואם לגרסה 2.3, כך שספריות הלקוח האחרות של נתוני Google ימשיכו לפעול.
    • קוד השגיאה של שגיאות המכסה השתנה מ-503 ל-403
    • אין תמיכה בתגובות JSON.
    • ספריית הלקוח של JavaScript בנתוני Google אינה נתמכת.
    • אין פיד חשבון. את כל הבקשות לנתוני הגדרות יש לבצע דרך Management API.

הרשמה

  • כל האפליקציות שנוצרו באמצעות Google Analytics API חייבות להיות רשומות כפרויקט דרך מסוף Google APIs.

  • כל בקשה ל-API חייבת לכלול מפתח API או עבור OAuth 2.0, מזהה לקוח וסוד לקוח.

מדיניות בנושא מכסות

  • המכסה הבאה חלה על ממשקי Anlaytics API (Management API ו-Data Export API)

    • 50,000 בקשות לכל פרויקט ביום
    • 10 שאילתות לשנייה (QPS) לכל כתובת IP

  • המכסה הבאה חלה על ממשק ה-API לייצוא נתונים

    • 10,000 בקשות לכל פרופיל ביום
    • 10 בקשות בו-זמניות לכל פרופיל

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

הוצאה משימוש

  • כמו כן, הגרסה הזו מודיעה על הוצאה משימוש של גרסה 2.3 ועל ההוצאה משימוש של פיד החשבון ב-Data Export API. בעוד שישה חודשים:

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

    • לא תהיה תמיכה בבקשות לפלט JSON בגרסה 2.3 בתגובה של גרסה 2.4, והן יחזירו קודי סטטוס מסוג 404 Not Found. אם צריך תגובת JSON, צריך לשדרג לגרסה 3.0.

    • בקשות אל פיד החשבון ב-Data Export API יחזירו קודי סטטוס מסוג 404 Not Found. את כל הבקשות לנתוני הגדרות יש לבצע דרך Management API.

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

  • נתוני AdWords מתעדכנים עכשיו תוך שעה. לפני שהנתונים מתעדכנים מדי יום.

  • הקלות מספר הגבלות על שילובים חוקיים עם נתוני Google Ads.

לפני כמה שבועות, עשינו שינוי כדי לא לאפשר שאילתות API עם בקשות ga:adGroup או ga:adContent עם ga:impressions, מאחר שהשילוב הזה החזיר 0. בעקבות השינוי הזה, השילוב הזה חזר לפעול ותוקן כך שהחזיר נתונים נכונים.

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

שילובים לא חוקיים של מדדים/מאפיינים לא חוקיים

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

    • לא ניתן לשלב מאפייני מוצר עם מדדי עסקאות.
    • לא ניתן לשלב ga:adContent או ga:adGroup עם ga:impressions.

    במקום להחזיר תשובה עם 0 תוצאות, ה-API מחזיר עכשיו קוד שגיאה 400 לכל השאילתות שמבקשות את השילובים האלה.

בגרסה הזו נוציא משימוש את ערך הרווח בר-הסמך במדדים.

הוצאה משימוש של רווח בר-סמך

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

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

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

עדכוני נתונים חדשים

  • הוספנו ל-API 3 מדדים חדשים שעוסקים בביצועים של מהירות האתר:
    • ga:pageLoadSample
    • ga:pageLoadTime
    • ga:avgPageLoadTime

עדכוני מדדים

  • כדי לציין ערכי מטבע במסננים, עליכם לציין את הערך שהועבר בפועל מקוד המעקב (לדוגמה, יחידה אחת תצוין עכשיו כ-1).

  • ga:CTR מחזירה עכשיו את האחוז בפועל (למשל, ערך של 2% מוחזר כ-2).

הגרסה הזו משפרת את הביצועים של פיד הנתונים ומוסיפה נתונים חדשים:

שיפור ביצועים

  • הגרסה הזו משפרת את זמן האחזור של פיד הנתונים ב-30% עד 35%.

עדכוני נתונים חדשים

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

בקרוב יהיו שינויים

  • נכון לעכשיו, צריך לציין ערך של מסנן מטבע כיחידות מיקרו (למשל, יחידת מטבע אחת מצוינת כ-1000,000). בעתיד הקרוב יהיה עליך לציין את הערך שהועבר בפועל מקוד המעקב, (לדוגמה, יחידה אחת תסומן כעת כ-1).

  • נכון לעכשיו, ga:CTR הוא percent ומחזירה את הערך 0.02. בעתיד הקרוב הערך הזה ישתנה ויחזיר את האחוז בפועל (למשל 2).

בגרסה הזו נוספים נתונים לפיד הנתונים:

עדכוני נתונים חדשים

  • מאפיין הזמן הבא נוסף: ga:dayOfWeek

  • המדד הבא של חיפוש פנימי נוסף: ga:percentVisitsWithSearch

  • המדדים הבאים של מעקב אחר אירועים נוספו:

    • ga:visitsWithEvent
    • ga:eventsPerVisitWithEvent

בקרוב יהיו שינויים

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

בגרסה הזו נוספו הרבה נתונים לפיד הנתונים:

עדכוני נתונים חדשים

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

  • נוספו 10 מאפייני AdWords חדשים: ga:adDistributionNetwork, ga:adMatchType, ga:adMatchedQuery, ga:adPlacementDomain, ga:adPlacementUrl, ga:adFormat, ga:adTargetingType, ga:adTargetingOption, ga:adDisplayUrl, ga:adDestinationUrl.

  • המדד ga:organicSearches נוסף לקבוצת הקמפיינים.

  • המדד ga:searchResultViews נוסף לקבוצה הפנימית של חיפוש אתרים.

  • נוספו 3 מאפיינים חדשים שמבוססים על זמן: ga:nthDay, ga:nthWeek, ga:nthMonth.

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

מדדים מחושבים חדשים

המדדים המחושבים הבאים נגזרים מחישובים שמבוססים על מדדי הבסיס. הערה: כל שם עם (n) תומך בערכים 1-20.

  • מבוסס על יעד: ga:costPerConversion, ga:costPerGoalConversion, ga:costPerTransaction, ga:goal(n)AbandonRate, ga:goal(n)Abandons, ga:goal(n)ConversionRate, ga:goalAbandonRateAll, ga:goalAbandonsAll, ga:goalConversionRateAll, ga:goalValueAllPerSearch, ga:goalValuePerVisit.

  • מבוסס על תוכן: ga:entranceBounceRate, ga:visitBounceRate, ga:entranceRate, ga:exitRate, ga:pageviewsPerVisit, ga:avgTimeOnPage, ga:avgTimeOnSite, ga:avgEventValue.

  • מבוסס על חיפוש פנימי באתר: ga:avgSearchDepth, ga:avgSearchDuration, ga:avgSearchResultViews, ga:searchGoalConversionRateAll, ga:searchGoal(n)ConversionRate, ga:searchExitRate.

  • מבוסס מסחר אלקטרוני: ga:itemsPerPurchase, ga:margin, ga:percentNewVisits, ga:revenuePerItem, ga:revenuePerTransaction, ga:ROI, ga:RPC, ga:totalValue, ga:transactionRevenuePerVisit, ga:transactionsPerVisit.

בגרסה הזו נוספה תכונה חדשה לפיד הנתונים:

תכונות חדשות

  • רכיב XML חדש נוסף מאפשר למשתמשים לדעת אם הנתונים נדגמו. true. הרכיב הזה תמיד יוחזר גם אם הנתונים נדגמו או לא עם true או עם false. גם ספריות Java ו-JavaScript עודכנו בשיטות מסייעות לגישה לרכיב זה.

בגרסה הזו מתוקנים שני באגים:

תיקוני באגים

  • בעבר הייתם מוסיפים אופרטור OR לביטוי סינון עם מאפיין (כלומר ga:keyword==store,ga:keyword==bar) יכולים לקבל ערכים שונים מאשר אם כל מסנן יופעל בנפרד בשאילתות מרובות. הבעיה תוקנה והשימוש באופרטור OR מחזיר עכשיו ערכים עקביים.

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

בגרסה הזו מתוקנים 3 באגים:

תיקוני באגים

  • תוקנה בעיית קידוד בספריית הלקוח של JavaScript. מעקב אחר בעיות ב-Analytics

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

  • הערך של מאפיין ומדד במאפיין OR לא תקין עבור 'או' בפרמטר של מסנן השאילתה בפיד הנתונים. לדוגמה: ga:source==google,ga:visits>5. הודעת השגיאה עבור השאילתה הלא חוקית הזו עודכנה ועכשיו היא: Cannot OR dimension filter(s) with metric filter.

בגרסה הזו נוספים נתונים חדשים ומתקנת באג:

תכונות חדשות

  • 5 המאפיינים הבאים נוספו לקטגוריה החדשה D8. Adwords:

    • ga:adwordsAdGroupId: תואם ל-AdGroup.id של AdWords API
    • ga:adwordsCampaignId: תואם ל-Campaign.id ב-AdWords API
    • ga:adwordsCreativeId: תואם ל-Ad.id של AdWords API
    • ga:adwordsCriteriaId: תואם ל-AdWords API Criterion.id
    • ga:adwordsCustomerId: תואם ל-AccountInfo.customerId ב-AdWords API

תיקוני באגים

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

בגרסה הזו נוספו מספר תכונות חדשות ותיקוני באג:

תכונות חדשות

  • פלח ברירת המחדל של iPhone (gaid::-11) עודכן ועכשיו הוא יכול לדווח על כל המכשירים הניידים. המזהה זהה לזה הקודם (-11), אבל השם של הפלח הוא עכשיו: Mobile Traffic.

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

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

    • נכס אינטרנט יחיד עשוי לשלוח עד 10,000 בקשות בכל 24 שעות.
    • אפליקציה יכולה לשלוח רק 10 בקשות בכל פרק זמן נתון של שנייה אחת.
    • בכל רגע נתון, לאפליקציה יכולות להיות רק 4 בקשות בהמתנה.

  • חלק מההגבלות על שילובי המאפיינים והמדדים הקלות. ga:nextPagePath וגם ga:previousPagePath שייכים עכשיו לקבוצה D3. Content. הקבוצה D8. Custom Variable נקראת עכשיו הקבוצה D6. Custom Variable. אפשר לעיין במדריך העזר המעודכן לגבי השילובים החדשים האלה.

תיקוני באגים

  • תיקנו באג באופן שבו ה-API מדווח על הערך confidenceInterval במדדים. בעבר, רווח בר-סמך היה יכול לקבל ערך של INF או מספר בין 0 ל-1. עכשיו לכל רווח בר-סמך יהיה ערך של INF או מספר גדול מ-0 או שווה לו.

  • ga:itemQuantity ו-ga:uniquePurchases הוחלפו בעבר והחזירו את הערך זה של זה. עכשיו הן תוקנו כדי להחזיר את הנתונים הנכונים.

תזכורת: אנחנו מוציאים משימוש מאפיינים ומדדים

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

לגרסה הזו נוספו כמה תכונות חדשות:

הגרסה הזו מעלה את מספר הגרסה הראשית ל-2

  • כדי להשתמש בחלק מהתכונות, צריך להשתמש בספריות הלקוח העדכניות ביותר. אנחנו תומכים באופן רשמי ב-Java וב-JavaScript. יכול להיות שספריות של צד שלישי עדיין לא עודכנו.

    • כדי לבקש את גרסה 2, יש להוסיף את הכותרת GData-Version: 2 לכל בקשה של חשבון או פיד נתונים. אפשר לקרוא פרטים נוספים במסמכי התיעוד.
    • מרחב שמות חדש בפורמט XML נוסף גם לפיד החשבון וגם לפיד הנתונים:
      xmlns:ga='http://schemas.google.com/ga/2009'

  • ממשק ה-API תומך כעת בגרסה 2 של פרוטוקול Google Data.

תמיכה מתקדמת בפילוח

  • פרמטר שאילתה של פלחים דינמיים:

    • ...&segment=dynamic::ביטוי
    • מאפשר ליצור פלחים מתקדמים "תוך כדי תנועה".
    • יכול להיות כל מאפיין או מדד, ועליו להיות כתוב בתחביר זהה למסננים.

  • פרמטר השאילתה של פלחים שמוגדרים כברירת מחדל ופלחים בהתאמה אישית:

    • ...&segment=gaid::מספר
    • כאשר המספר הוא מזהה שמפנה לפלח מתקדם שמוגדר בממשק האינטרנט של Google Analytics.
    • מספר החשבון מופיע בפיד החשבון.

  • בפיד החשבון מתוארים נתוני הפילוח באמצעות המאפיינים והרכיבים הבאים ב-XML:

    • ga:visitorType==Returning Visitor

  • פיד הנתונים גם כולל רכיב XML שמציין אם פלח מסוים הוחל בבקשת ה-API.

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

יש נתוני יעדים חדשים

  • יעדים מסוג 'יעד' ו'מעורבות' שזמינים בפיד החשבון:

  • נוספו 48 מדדי יעדים חדשים ליעדים 5 עד 20, שכולם תואמים למוסכמה goal(n)Completions, כאשר (n) הוא מספר בין 1 ל-20.

    • ga:goal(n)Completions
    • ga:goal(n)Starts
    • ga:goal(n)Value

  • GoalCompletionAll, GoalStartsAll ו-GoalValueAll עודכנו כדי להביא בחשבון את נתוני היעדים החדשים.

נתונים חדשים של משתנה מותאם אישית

  • כל המשתנים המותאמים אישית שנאספו אי פעם על ידי כל פרופיל נוספו כרכיב XML חדש אל פיד החשבון:

  • 10 מאפיינים חדשים נוספו למשתנים מותאמים אישית. הם תואמים למוסכמה customVar(n), שלפיה (n) יכול להיות מספר בין 1 ל-5.

    • ga:customVarName(n)
    • ga:customVarValue(n)

מאפיינים ומדדים שהוצאו משימוש יוסרו.

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

    • ga:countOfVisits
    • ga:countOfVisitsToATransaction
    • ga:sourceMedium
    • ga:percentNewVisits

  • השמות של המאפיינים הבאים השתנו:

    • האפשרות ga:countOfVisits נקראת ga:visitCount עכשיו
    • האפשרות ga:countOfVisitsToATransaction נקראת ga:visitsToTransaction עכשיו

לגרסה הזו נוספו תכונות חדשות ונוציא משימוש חלק מהפונקציונליות הישנה:

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

    • ga:countOfVisits
    • ga:countOfVisitsToATransaction
    • ga:sourceMedium
    • ga:percentNewVisits

  • השמות של המאפיינים הבאים השתנו:

    • ga:countOfVisits הוא עכשיו ga:visitCount
    • ga:countOfVisitsToATransaction נקרא עכשיו ga:visitsToTransaction

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

    ד7. אירועים (מאפיינים) * ga:eventCategory * ga:eventAction * ga:eventLabel

    M7. אירועים (מדדים) * ga:eventValue * ga:totalEvents * ga:uniqueEvents

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

    ד6. ניווט * ga:previousPagePath * ga:nextPagePath

  • הניווט בדף הנחיתה נחשף כעת באמצעות המאפיינים הבאים:

    ד 3. תוכן * ga:landingPagePath * ga:secondPagePath

  • האורך המקסימלי של ביטויים רגולריים בפרמטר של שאילתת הסינון בפיד הנתונים הוגדל מ-32 ל-128 תווים.

  • הדוח 'משך ביקור' (שניתן למצוא דרך ממשק המשתמש בקטע 'מבקרים' -> 'נאמנות מבקרים') מוצג עכשיו באמצעות המאפיין החדש:

    • ga:visitLength

בגרסה הזו מתבצע עדכון של Google Analytics Data Export API באופן הבא:

  • חלק מההגבלות על שילובי המאפיינים והמדדים הקלות. עכשיו ניתן להריץ שאילתות ביחד על רוב המאפיינים ברמת התוכן וברמת המבקר. לדוגמה: ga:pagePath ו-ga:source הוא עכשיו שילוב חוקי. אפשר לעיין במדריך העזר המעודכן לשילובים החדשים האלה: http://code.google.com/apis/analytics/docs/gdata/gdataReferenceValidCombos.html

  • המספר הכולל של שורות שאפשר לבקש בבקשה אחת הוגדל ל-10,000. מספר השורות שהוחזרו כברירת מחדל הוא עדיין 1,000, אבל עכשיו אפשר להגדיל אותו על ידי הגדרת פרמטר השאילתה max-results.

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

  • אנחנו אוכפים עכשיו ששאילתות נתונים חייבות לכלול לפחות מדד חוקי אחד.

  • כל השינויים הקודמים שהוצאו משימוש נכנסו לתוקף.

בגרסה הזו יוסרו תכונות שהוצאו משימוש מגרסת הבטא הפרטית שלנו:

  • הבקשות לפיד חשבון לא יתמכו יותר בשם משתמש בהן. במקום זאת, יתקבלו רק בקשות בפורמט הבא:
    https://www.google.com/analytics/feeds/accounts/default

  • אנחנו מסירים את המדדים הבאים ולא יפעלו יותר. במקום זאת, סיפקנו הוראות לחישוב הערכים האלה כאן: http://code.google.com/apis/analytics/docs/gdata/gdataReferenceCommonCalculations.html

    • ga:avgPageDuration
    • ga:avgPageviews
    • ga:avgSessionTime
    • ga:bounceRate
    • ga:exitRate
    • ga:costPerConversion
    • ga:costPerGoalConversion
    • ga:costPerTransaction
    • ga:revenuePerClick
    • ga:revenuePerTransaction
    • ga:revenuePerVisit
    • ga:adFunnels1
    • ga:adFunnels2
    • ga:adFunnels3
    • ga:adFunnels4
    • ga:goalConversionRate
    • ga:goalConversionRate1
    • ga:goalConversionRate2
    • ga:goalConversionRate3
    • ga:goalConversionRate4
    • ga:goalValuePerVisit

  • השמות של המאפיינים והמדדים הבאים השתנו. השמות הישנים לא יפעלו יותר. יש לוודא שהשתמשת בשמות הרשמיים במסמכי התיעוד שלנו כאן: http://code.google.com/apis/analytics/docs/gdata/gdataReferenceDimensionsMetrics.html

    ga: ga שהערך להשגת * ga: subConentRegion לפגוע ga:subContinentRegion הרספונסיביות ga:subConent * ga:organization שמשתתפים - ga:networkLocation * ga:domain תבטיח ga:networkDomain * ga:visitNumber ] ga:countOfVisits * ga:platform בתמונה } ga:operatingSystem * ga:platformVersion ga:operatingSystemVersion * ga:content ga:adSystemVersion * ga:content לבניית מדי יום

    מדובר: מדף יעדים גידורשים: גימטריית גיסים גיסים:אתר *יעד גיסים:אתר *המרה: מ *לצורך יעד * השגת יעד גיאומטריה *השגת : גיסים לחזור: Floodlight imimal סים , gagmail_goal:זית לחזור Floodlight Floodlight imulation בחנים * השלמת *השגת היעד * השגת יעד גיסים gmail: * Floodlight Floodlight imimal im ליצירה:יעד גיאומטריה זמנים זמנים derאז.