کار با پروتکل اندازه گیری

این سند نحوه ارسال بازدیدهای رایج به پروتکل اندازه گیری را شرح می دهد.

بررسی اجمالی

این سند نحوه قالب‌بندی درخواست‌های HTTP برای ارسال انواع ضربه‌های رایج به پروتکل اندازه‌گیری Google Analytics را نشان می‌دهد. را بخوانید:

• مرجع پروتکل - شرح کاملی از نحوه قالب بندی درخواست های پروتکل.
• مرجع پارامتر - لیستی از تمام پارامترهای پذیرفته شده توسط پروتکل.

توجه : مثال‌های زیر برای آسان‌تر خواندن پارامترهای پروتکل تنظیم شده‌اند. با این حال، هنگام ارسال داده، همه پارامترها باید در یک خط باشند، هیچ فاصله ای بین آنها وجود نداشته باشد و شامل نظرات نباشد. مرجع پارامتر را برای قالب هر پارامتر بخوانید.

ارسال مقادیر مورد نیاز

برای ارسال داده‌های تعامل کاربر، یک درخواست 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 ، از payload زیر استفاده می کنید:

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

محدودیت های دسته ای

علاوه بر محدودیت‌های استاندارد بازدیدهای پروتکل اندازه‌گیری، درخواست‌های دسته‌ای دارای محدودیت‌های اضافی زیر هستند:

• حداکثر 20 بازدید می تواند در هر درخواست مشخص شود.
• اندازه کل همه بارهای ارسال شده نمی تواند بیشتر از 16 هزار بایت باشد.
• هیچ پیلوی یک ضربه ای نمی تواند بیشتر از 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 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 مشاهده کنید.

ردیابی تجارت الکترونیک پیشرفته

مهم : پارامترهای تجارت الکترونیک پیشرفته باید با یک بازدید موجود ارسال شوند (مثلاً مشاهده صفحه، رویداد)، اما نمی‌توانند با transaction تجارت الکترونیک یا انواع ضربه‌های item ارسال شوند.

بازدیدهای تجارت الکترونیکی پیشرفته باید به جای بازدیدهای تجارت الکترونیک استفاده شوند. اگر قبلاً ردیابی تجارت الکترونیک را اجرا کرده اید و می خواهید از ردیابی تجارت الکترونیک پیشرفته استفاده کنید، دو گزینه وجود دارد:

از یک ملک جدید استفاده کنید

می توانید یک ویژگی جدید ایجاد کنید و بازدیدهای Enhanced Ecommerce را به ویژگی جدید ارسال کنید.

مهاجرت یک ملک موجود

با دنبال کردن مثال‌های زیر، تمامی بازدیدهای تجارت الکترونیک را به بازدیدهای تجارت الکترونیک پیشرفته منتقل کنید. داده‌های تراکنش و مواردی که قبلاً با استفاده از بازدیدهای تجارت الکترونیک جمع‌آوری شده‌اند تحت تأثیر قرار نمی‌گیرند و در ویژگی‌ها و نماهایی که در ابتدا به آن‌ها ارسال شده‌اند در دسترس خواهند ماند.

اندازه گیری تاثیرات

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 مشاهده کنید.

استفاده از سرور پروکسی

برخی از محیط ها قادر به ارسال بازدید مستقیم به Google Analytics نیستند. نمونه هایی از این تلفن های همراه قدیمی هستند که نمی توانند جاوا اسکریپت یا اینترانت های شرکتی را در پشت فایروال اجرا کنند. در این موارد ارسال درخواست‌ها به یک سرور پراکسی که سپس از پروتکل اندازه‌گیری برای ارسال بازدیدها به Google Analytics استفاده می‌کند، معمول است.

برای جمع‌آوری IP و عامل کاربر از دستگاه مشتری و نه سرور پراکسی، می‌توانید هر دو مقدار را در پروتکل اندازه‌گیری مشخص کنید، و آنها مقادیری را که 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 مشاهده کنید.

توجه: مهم است که از رشته های عامل کاربر معتبر استفاده کنید تا Google Analytics بتواند به درستی اطلاعات عامل کاربر را در گزارش ها شناسایی و نمایش دهد. کاردستی خودتان ممکن است در هر زمان خراب شود.