يوضّح هذا المستند كيفية إرسال النتائج الشائعة إلى 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 وحدِّد كل حمولة في سطرها الخاص.
على سبيل المثال، لإرسال نتائج مشاهدة الصفحة لصفحة الويب التالية: "الصفحة الرئيسية" و"لمحة عنّا" و "التواصل" لأحد المواقع الإلكترونية، يمكنك إرسال الطلب المجمّع التالي.
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 ووكيل المستخدم من جهاز العميل وليس من الخادم الوكيل، يمكنك تحديد القيمتَين في Measurement Protocol، وسيتم إلغاء القيم التي تحصل عليها "إحصاءات 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.