במסמך הזה מוסבר איך לשלוח היטים נפוצים ל-Measurement Protocol.
סקירה כללית
מסמך זה מדגים איך לעצב בקשות HTTP כדי לשלוח סוגי היט נפוצים אל Google Measurement Protocol. יש לקרוא את:
- הפניה לפרוטוקול – תיאור מלא של הפורמט של בקשות לפרוטוקולים.
- הפניה לפרמטר – רשימה של כל הפרמטרים שאושרו על ידי הפרוטוקול.
שליחת הערכים הנדרשים
כדי לשלוח נתוני אינטראקציות של משתמשים, יש לשלוח בקשת HTTP POST לנקודת הקצה הזו.
POST /collect HTTP/1.1 Host: www.google-analytics.com payload_data
יש להגדיר את הפרמטרים הבאים לכל מטען ייעודי (payload):
v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t= // Hit Type.
כל מטען ייעודי (payload) צריך להכיל סוג היט חוקי, ולכל סוג היט יש קבוצת שדות חובה משלו. כדי לשלוח צפייה בדף לדף
/home, יש להשתמש במטען הייעודי (payload) הבא:
v=1&tid=UA-XXXXX-Y&cid=555&t=pageview&dp=%2Fhome
בקטעים הבאים יש דוגמאות לסוגי היטים נפוצים.
קיבוץ מספר היטים בבקשה אחת
כדי לשלוח מספר היטים בבקשה אחת, יש להשתמש בנקודת הקצה של /batch במקום ב/collect ולציין כל מטען ייעודי בשורה נפרדת.
לדוגמה, כדי לשלוח היטים של צפיות בדף עבור דפי "Home" ו-"מידע על לנו" ו-"איש קשר" של אתר, אפשר לשלוח את בקשת האצווה הבאה.
POST /batch HTTP/1.1 Host: www.google-analytics.com v=1&tid=UA-XXXXX-Y&cid=555&t=pageview&dp=%2Fhome v=1&tid=UA-XXXXX-Y&cid=555&t=pageview&dp=%2Fabout v=1&tid=UA-XXXXX-Y&cid=555&t=pageview&dp=%2Fcontact
מגבלות אצווה
בנוסף למגבלות הרגילות של היטים של Measurement Protocol, לבקשות מקובצות יש את המגבלות הנוספות הבאות:
- ניתן לציין עד 20 היטים לכל בקשה.
- הגודל הכולל של כל המטענים המותאמים לא יכול להיות גדול מ-16 אלף בייטים.
- המטען הייעודי (payload) של ההיט היחיד יכול להיות גדול מ-8K בייטים.
שליחת סוגי היט נפוצים
הנה כמה דוגמאות לשליחת סוגי היט נפוצים ל-Google Analytics.
נוסף על הדוגמאות האלה, אפשר לשלב בין פרמטרים שונים כדי
להגיע ליחסי נתונים חדשים. לדוגמה, כדי להבין
באיזה דף התרחש אירוע, שולחים את פרמטר pagePath,
p, יחד עם פרמטרים של מעקב אחר אירועים, כפי שמתואר בהמשך.
רשימה מלאה של כל הפרמטרים שאפשר לשלוח ל-Google Analytics זמינה ב- פרמטרים.
מעקב אחר דפים
v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t=pageview // Pageview hit type. &dh=mydemo.com // Document hostname. &dp=/home // Page. &dt=homepage // Title.
צפו בהיט הזה בכלי ליצירת היטים של Measurement Protocol.
מעקב אחר אירועים
v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t=event // Event hit type &ec=video // Event Category. Required. &ea=play // Event Action. Required. &el=holiday // Event label. &ev=300 // Event value.
צפו בהיט הזה בכלי ליצירת היטים של Measurement Protocol.
מעקב אחר מסחר אלקטרוני משופר
יש להשתמש בהיטים של מסחר אלקטרוני משופר במקום בהיטים של מסחר אלקטרוני. אם כבר הטמעתם מעקב אחר מסחר אלקטרוני ואתם רוצים להתחיל להשתמש במעקב אחר מסחר אלקטרוני משופר, יש שתי אפשרויות:
שימוש בנכס חדש
ניתן ליצור נכס חדש ולשלוח היטים של מסחר אלקטרוני משופר לנכס החדש.
העברת נכס קיים
מעבירים את כל ההיטים של מסחר אלקטרוני להיטים של מסחר אלקטרוני משופר, באמצעות הדוגמאות הבאות. נתוני עסקאות ופריטים שנאספו בעבר באמצעות היטים של מסחר אלקטרוני לא יושפעו, והם יישארו זמינים בנכסים ובתצוגות המפורטות שאליהם הם נשלחו במקור.
מדידת חשיפות
v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t=pageview // Pageview hit type. &dh=mydemo.com // Document hostname. &dp=/home // Page. &dt=homepage // Title. &il1nm=Search%20Results // Impression list 1. Required. &il1pi1id=P12345 // Product Impression 1 ID. Either ID or name must be set. &il1pi1nm=Android%20Warhol%20T-Shirt // Product Impression 1 name. Either ID or name must be set. &il1pi1ca=Apparel%2FT-Shirts // Product Impression 1 category. &il1pi1br=Google // Product Impression 1 brand. &il1pi1va=Black // Product Impression 1 variant. &il1pi1ps=1 // Product Impression 1 position. &il1pi1cd1=Member // Custom dimension. &il2nm=Recommended%20Products // Impression list 2. &il2pi1nm=Yellow%20T-Shirt // Product Impression 1 name. &il2pi2nm=Red%20T-Shirt // Product Impression 2 name.
צפו בהיט הזה בכלי ליצירת היטים של Measurement Protocol.
פעולות מדידה
v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t=event // Event hit type. &ec=UX // Event Category. Required. &ea=click // Event Action. Required. &el=Results // Event label. &pa=click // Product action (click). Required. &pal=Search%20Results // Product Action List. &pr1id=P12345 // Product 1 ID. Either ID or name must be set. &pr1nm=Android%20Warhol%20T-Shirt // Product 1 name. Either ID or name must be set. &pr1ca=Apparel // Product 1 category. &pr1br=Google // Product 1 brand. &pr1va=Black // Product 1 variant. &pr1ps=1 // Product 1 position.
צפו בהיט הזה בכלי ליצירת היטים של Measurement Protocol.
שילוב חשיפות ופעולות
v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t=event // Event hit type. &ec=UX // Event Category. Required. &ea=click // Event Action. Required. &el=Results // Event label. &pa=detail // Product action (detail). Required. &pr1id=P12345 // Product 1 ID. Either ID or name must be set. &pr1nm=Android%20Warhol%20T-Shirt // Product 1 name. Either ID or name must be set. &pr1ca=Apparel // Product 1 category. &pr1br=Google // Product 1 brand. &pr1va=Black // Product 1 variant. &pr1ps=1 // Product 1 position. &il1nm=Related%20Products // Impression list. &il1pi1id=P12345 // Product Impression 1 ID. &il1pi1nm=Android%20Warhol%20T-Shirt // Product Impression 1 name. &il1pi1ca=Apparel%2FT-Shirts // Product Impression 1 category. &il1pi1br=Google // Product Impression 1 brand. &il1pi1va=Black // Product Impression 1 variant. &il1pi1ps=1 // Product Impression 1 position.
צפו בהיט הזה בכלי ליצירת היטים של Measurement Protocol.
מדידת רכישות
v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t=pageview // Pageview hit type. &dh=mydemo.com // Document hostname. &dp=/receipt // Page. &dt=Receipt%20Page // Title. &ti=T12345 // Transaction ID. Required. &ta=Google%20Store%20-%20Online // Affiliation. &tr=37.39 // Revenue. &tt=2.85 // Tax. &ts=5.34 // Shipping. &tcc=SUMMER2013 // Transaction coupon. &pa=purchase // Product action (purchase). Required. &pr1id=P12345 // Product 1 ID. Either ID or name must be set. &pr1nm=Android%20Warhol%20T-Shirt // Product 1 name. Either ID or name must be set. &pr1ca=Apparel // Product 1 category. &pr1br=Google // Product 1 brand. &pr1va=Black // Product 1 variant. &pr1ps=1 // Product 1 position.
צפו בהיט הזה בכלי ליצירת היטים של Measurement Protocol.
מדידת החזרים כספיים
אם אתם צריכים לשלוח נתוני החזרים כספיים באמצעות אירוע, והאירוע אינו חלק מהתנהגות רגילה של האתר בחיפוש (כלומר, לא ביוזמת המשתמש), מומלץ לשלוח אירוע ללא אינטראקציה. הפעולה הזו תמנע מדדים כמו שיעור העזיבה, משך הביקור וכו'.
// Refund an entire transaction and send with a non-interaction event. v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t=event // Event hit type. &ec=Ecommerce // Event Category. Required. &ea=Refund // Event Action. Required. &ni=1 // Non-interaction parameter. &ti=T12345 // Transaction ID. Required. &pa=refund // Product action (refund). Required.
צפו בהיט הזה בכלי ליצירת היטים של Measurement Protocol.
// Refund a single product. v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t=event // Event hit type. &ec=Ecommerce // Event Category. Required. &ea=Refund // Event Action. Required. &ni=1 // Non-interaction parameter. &ti=T12345 // Transaction ID. Required. &pa=refund // Product action (refund). Required. &pr1id=P12345 // Product 1 ID. Required. &pr1qt=1 // Product 1 quantity. Required.
צפו בהיט הזה בכלי ליצירת היטים של Measurement Protocol.
מדידת תהליך התשלום בקופה
1. מדידת שלבים בקופה
v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t=pageview // Pageview hit type. &dh=mydemo.com // Document hostname. &dp=/checkout // Page. &dt=Checkout // Title. &pa=checkout // Product action (checkout). &pr1id=P12345 // Product 1 ID. Either ID or name must be set. &pr1nm=Android%20Warhol%20T-Shirt // Product 1 name. Either ID or name must be set. &pr1ca=Apparel // Product 1 category. &pr1br=Google // Product 1 brand. &pr1va=Black // Product 1 variant. &pr1pr=29.20 // Product 1 Price. &pr1qt=1 // Product 1 quantity. &cos=1 // Checkout step #1. &col=Visa // Checkout step option.
צפו בהיט הזה בכלי ליצירת היטים של Measurement Protocol.
2. מדידת אפשרויות תשלום
v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t=event // Event hit type &ec=Checkout // Event Category. Required. &ea=Option // Event Action. Required. &pa=checkout_option // Product action (checkout_option). &cos=2 // Checkout step. &col=FedEx // Checkout step option.
צפו בהיט הזה בכלי ליצירת היטים של Measurement Protocol.
מדידת קידומי מכירות פנימיים
חשיפות של קידום מכירות
v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t=pageview // Pageview hit type. &dh=mydemo.com // Document hostname. &dp=/home // Page. &dt=homepage // Title. &promo1id=PROMO_1234 // Promotion 1 ID. Either ID or name must be set. &promo1nm=Summer%20Sale // Promotion 1 name. Either ID or name must be set. &promo1cr=summer_banner2 // Promotion Creative. &promo1ps=banner_slot1 // Promotion Position.
צפו בהיט הזה בכלי ליצירת היטים של Measurement Protocol.
קליקים בקידום מכירות
v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t=event // Event hit type &ec=Internal%20Promotions // Event Category. Required. &ea=click // Event Action. Required. &el=Summer%20Sale // Event label. &promoa=click // Promotion action (click). Required. &promo1id=PROMO_1234 // Promotion 1 ID. Either ID or name must be set. &promo1nm=Summer%20Sale // Promotion 1 name. Either ID or name must be set. &promo1cr=summer_banner2 // Promotion Creative. &promo1ps=banner_slot1 // Promotion Position.
צפו בהיט הזה בכלי ליצירת היטים של Measurement Protocol.
מעקב אחר מסחר אלקטרוני
כדי לשלוח נתוני מסחר אלקטרוני, צריך לשלוח היט אחד (transaction)
לייצוג עסקה שלמה. לאחר מכן צריך לשלוח היט של item
לכל פריט בעסקה. מזהה העסקה ti
מקשר בין כל ההיטים כדי לייצג את הרכישה כולה.
היט לעסקה
v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t=transaction // Transaction hit type. &ti=12345 // transaction ID. Required. &ta=westernWear // Transaction affiliation. &tr=50.00 // Transaction revenue. &ts=32.00 // Transaction shipping. &tt=12.00 // Transaction tax. &cu=EUR // Currency code.
צפו בהיט הזה בכלי ליצירת היטים של Measurement Protocol.
היט פריט
v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t=item // Item hit type. &ti=12345 // Transaction ID. Required. &in=sofa // Item name. Required. &ip=300 // Item price. &iq=2 // Item quantity. &ic=u3eqds43 // Item code / SKU. &iv=furniture // Item variation / category. &cu=EUR // Currency code.
צפו בהיט הזה בכלי ליצירת היטים של Measurement Protocol.
אינטראקציות חברתיות
v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t=social // Social hit type. &sa=like // Social Action. Required. &sn=facebook // Social Network. Required. &st=/home // Social Target. Required.
צפו בהיט הזה בכלי ליצירת היטים של Measurement Protocol.
מעקב אחר חריגות
v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t=exception // Exception hit type. &exd=IOException // Exception description. &exf=1 // Exception is fatal?
צפו בהיט הזה בכלי ליצירת היטים של Measurement Protocol.
מעקב אחר תזמון משתמש
v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t=timing // Timing hit type. &utc=jsonLoader // Timing category. &utv=load // Timing variable. &utt=5000 // Timing time. &utl=jQuery // Timing label. // These values are part of browser load times &dns=100 // DNS load time. &pdt=20 // Page download time. &rrt=32 // Redirect time. &tcp=56 // TCP connect time. &srt=12 // Server response time.
צפו בהיט הזה בכלי ליצירת היטים של Measurement Protocol.
מעקב אחר אפליקציות / מסכים
v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t=screenview // Screenview hit type. &an=funTimes // App name. &av=1.5.0 // App version. &aid=com.foo.App // App Id. &aiid=com.android.vending // App Installer Id. &cd=Home // Screen name / content description.
צפו בהיט הזה בכלי ליצירת היטים של Measurement Protocol.
שימוש בשרת Proxy
סביבות מסוימות אינן יכולות לשלוח היטים ישירות ל-Google Analytics. לדוגמה, טלפונים ניידים ישנים יותר שלא יכולים להריץ JavaScript או אינטראנט ארגוני מאחורי חומת אש. במקרים כאלה, שליחת בקשות לשרת proxy היא באמצעות ה-Measurement Protocol כדי להעביר את ההיטים ל-Google Analytics.
כדי לאסוף את כתובת ה-IP וסוכן המשתמש ממכשיר הלקוח ולא משרת ה-proxy, ניתן לציין את שני הערכים בפרוטוקול המדידה, והם יחליפו את הערכים ש-Google Analytics מקבל בדרך כלל מכותרות הבקשות.
v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t=pageview // Pageview hit type. &uip=1.2.3.4 // IP address override. &ua=Opera/9.80 // User agent override.
צפו בהיט הזה בכלי ליצירת היטים של Measurement Protocol.