יומן שינויים של Google Analytics משפכים מרובי ערוצים Reporting API

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

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

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

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

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

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

מזהה עסקה

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

בגרסה הזו נוספו ל-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 בנתיב ההמרות, אבל לא הייתה האינטראקציה הסופית של ההמרה. המאפיין הזה כולל עסקאות שהושלמו וגם עסקאות.

בגרסה הזו נוספו ל-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.

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

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

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

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