במסמך הזה נסביר איך לשלוח היטים נפוצים ל-Measurement Protocol.
סקירה
במסמך הזה מודגמת הפורמט של בקשות HTTP כדי לשלוח סוגי היטים נפוצים אל Google Analytics 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 ולציין כל מטען ייעודי (payload) בשורה נפרדת.
לדוגמה, כדי לשלוח היטים של צפיות בדף לדפים 'דף הבית', 'מי אנחנו' ו'יצירת קשר' באתר מסוים, אפשר לשלוח את הבקשה הבאה באצווה.
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 היטים לכל בקשה.
- הגודל הכולל של כל המטען הייעודי (payloads) של היטים לא יכול להיות גדול מ-16,000 בייטים.
- המטען הייעודי (payload) של היטים הבודדים לא יכול להיות גדול מ-8,000 בייטים.
שליחת סוגי היטים נפוצים
בהמשך מוצגות דוגמאות לשליחת סוגי התאמות נפוצים אל 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 Hit Builder.
מעקב אחר אירועים
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 Hit Builder.
מעקב אחר מסחר אלקטרוני משופר
יש להשתמש בהיטים של מסחר אלקטרוני משופר במקום בהיטים של מסחר אלקטרוני . אם כבר יישמת מעקב אחר מסחר אלקטרוני וברצונך להתחיל להשתמש במעקב אחר מסחר אלקטרוני משופר, יש שתי אפשרויות:
שימוש בנכס חדש
תוכל ליצור נכס חדש ולשלוח היטים של מסחר אלקטרוני משופר לנכס החדש.
העברת נכס קיים
יש להעביר היטים של מסחר אלקטרוני להיטים של מסחר אלקטרוני משופר, לפי הדוגמאות שבהמשך. נתוני עסקאות ופריטים שנאספו בעבר באמצעות התאמות של מסחר אלקטרוני לא יושפעו ויישארו זמינים בנכסים ובתצוגות המפורטות שאליהם הם נשלחו במקור.
מדידת חשיפות
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 Hit Builder.
פעולות מדידת
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 Hit Builder.
שילוב של חשיפות ופעולות
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 Hit Builder.
מדידת רכישות
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 Hit Builder.
מדידת החזרים כספיים
אם אתם צריכים לשלוח נתוני החזר כספי באמצעות אירוע, והאירוע לא חלק מהתנהגות באתר שנמדדת בדרך כלל (כלומר לא ביוזמת המשתמש), מומלץ לשלוח אירוע ללא אינטראקציה. כך לא ניתן יהיה להשפיע על מדדים כמו שיעור העזיבה, משך הסשן וכו'.
// 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 Hit Builder.
// 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 Hit Builder.
מדידת תהליך התשלום
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 Hit Builder.
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 Hit Builder.
מדידת קידומי מכירות פנימיים
חשיפות של קידום מכירות
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 Hit Builder.
קליקים בקידום מכירות
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 Hit Builder.
מעקב אחר מסחר אלקטרוני
כדי לשלוח נתוני מסחר אלקטרוני, צריך לשלוח היט 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 Hit Builder.
היט פריט
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 Hit Builder.
אינטראקציות חברתיות
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 Hit Builder.
מעקב אחר חריגים
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 Hit Builder.
מעקב אחר תזמון משתמש
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 Hit Builder.
מעקב אחר אפליקציה / מסך
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 Hit Builder.
שימוש בשרת proxy
בסביבות מסוימות אין אפשרות לשלוח היטים ישירות ל-Google Analytics. דוגמאות לכך הן טלפונים ניידים ישנים יותר שלא יכולים להריץ JavaScript או רשתות אינטראנט ארגוניות מאחורי חומת אש. במקרים כאלה, מקובל לשלוח בקשות לשרת proxy שמשתמש ב-Measurement Protocol כדי להעביר את ההיטים ל-Google Analytics.
כדי לאסוף את כתובת ה-IP ואת סוכן המשתמש ממכשיר הלקוח ולא משרת ה-proxy, אפשר לציין את שני הערכים ב-Measurement Protocol, והם יבטלו את הערכים ש-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 Hit Builder.