يوضّح هذا المستند كيفية إرسال النتائج الشائعة إلى Measurement Protocol.
نظرة عامة
يوضّح هذا المستند كيفية تنسيق طلبات HTTP لإرسال أنواع النتائج الشائعة إلى Measurement Protocol في "إحصاءات Google". اقرأ ما يلي:
- مرجع البروتوكول – وصف كامل لكيفية تنسيق طلبات البروتوكول.
- مرجع المعلّمات – قائمة بجميع المعلّمات المقبولة في البروتوكول.
إرسال القيم المطلوبة
لإرسال بيانات تفاعل المستخدم، يمكنك إرسال طلب HTTP POST إلى نقطة النهاية هذه.
POST /collect HTTP/1.1 Host: www.google-analytics.com payload_data
وتكون المعلّمات التالية مطلوبة لكل حمولة:
v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t= // Hit Type.
يجب أن تحتوي كل حمولة على نوع نتيجة صالح، بينما يحتوي كل نوع نتيجة على مجموعة خاصة من الحقول المطلوبة. لإرسال مشاهدة صفحة على الويب إلى صفحة /home، يمكنك استخدام الحمولة التالية:
v=1&tid=UA-XXXXX-Y&cid=555&t=pageview&dp=%2Fhome
تقدم الأقسام أدناه أمثلة على أنواع النتائج الشائعة.
تجميع نتائج متعددة في طلب واحد
لإرسال نتائج متعددة في طلب واحد، استخدِم نقطة نهاية /batch بدلاً من /collect وحدِّد كل حمولة على السطر الخاص بها.
على سبيل المثال، لإرسال نتائج مشاهدة الصفحة على الويب &للصفحة الخاصة، "الصفحة الرئيسية&&;;&;;;معلومات عنا&;; &&;;;&;;Contact": يمكن إرسال الطلب المجمّع التالي.
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 ألف بايت.
- لا يمكن أن تكون حمولة النتيجة الواحدة أكبر من 8 ألف بايت.
إرسال أنواع النتائج الشائعة
في ما يلي أمثلة على كيفية إرسال أنواع النتائج الشائعة إلى "إحصاءات Google".
بالإضافة إلى هذه الأمثلة، يمكنك مزج معلمات مختلفة ومطابقتها لتحقيق علاقات جديدة مع البيانات. على سبيل المثال، لمعرفة الصفحة التي وقع فيها الحدث، أرسِل معلّمة pagePath،
p، إلى جانب معلّمات تتبّع الأحداث على النحو الموضّح أدناه.
اقرأ مرجع المعلمة للحصول على قائمة كاملة بجميع المعلمات التي يمكنك إرسالها إلى "إحصاءات Google".
تتبع الصفحات
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.
استخدام خادم وكيل
يتعذّر على بعض البيئات إرسال النتائج إلى "إحصاءات Google" مباشرةً. ومن أمثلة ذلك الهواتف الجوّالة القديمة التي لا يمكنها تشغيل JavaScript أو الشبكات الداخلية للشركات خلف جدار ناري. وفي هذه الحالات، من الشائع إرسال الطلبات إلى خادم وكيل يستخدم بروتوكول القياس لإعادة توجيه النتائج إلى "إحصاءات Google".
لجمع عنوان IP ووكيل المستخدم من جهاز العميل وليس الخادم الوكيل، يمكنك تحديد كلتا القيمتَين في بروتوكول القياس، وستلغيان القيم التي يحصل عليها "إحصاءات Google" عادةً من عناوين الطلبات.
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.