В этом документе описывается, как отправлять общие попадания в протокол измерений.
Обзор
В этом документе показано, как форматировать 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 , вы должны использовать следующую полезную нагрузку:
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 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.
Просмотрите это попадание в конструкторе попаданий протокола измерений.
Отслеживание событий
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.
Просмотрите это попадание в конструкторе попаданий протокола измерений.
Расширенное отслеживание электронной торговли
Вместо обращений электронной торговли следует использовать обращения расширенной электронной торговли. Если вы уже внедрили отслеживание электронной торговли и хотите начать использовать расширенное отслеживание электронной торговли, есть два варианта:
Используйте новое свойство
Вы можете создать новый ресурс и отправлять в него обращения расширенной электронной торговли.
Перенести существующий ресурс
Перенесите все обращения электронной торговли в обращения расширенной электронной торговли, следуя примерам ниже. Данные о транзакциях и товарах, ранее собранные с помощью обращений электронной торговли , не будут затронуты и останутся доступными в ресурсах и представлениях, в которые они были первоначально отправлены.
Измерение показов
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.
Просмотрите это попадание в конструкторе попаданий протокола измерений.
Измерительные действия
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.
Просмотрите это попадание в конструкторе попаданий протокола измерений.
Объединение впечатлений и действий
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.
Просмотрите это попадание в конструкторе попаданий протокола измерений.
Измерение покупок
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.
Просмотрите это попадание в конструкторе попаданий протокола измерений.
Измерение возвратов
Если вам нужно отправить данные о возврате с помощью события, и это событие не является частью обычно измеряемого поведения на месте (т. е. не инициируется пользователем), рекомендуется отправить событие отсутствия взаимодействия . Это предотвратит влияние события на такие показатели, как показатель отказов, продолжительность сеанса и т. д.
// 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.
Просмотрите это попадание в конструкторе попаданий протокола измерений.
// 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.
Просмотрите это попадание в конструкторе попаданий протокола измерений.
Измерение процесса оформления заказа
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.
Просмотрите это попадание в конструкторе попаданий протокола измерений.
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.
Просмотрите это попадание в конструкторе попаданий протокола измерений.
Измерение внутреннего продвижения
Рекламные показы
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.
Просмотрите это попадание в конструкторе попаданий протокола измерений.
Клики по продвижению
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.
Просмотрите это попадание в конструкторе попаданий протокола измерений.
Отслеживание электронной торговли
Чтобы отправить данные электронной торговли, отправьте одно попадание 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.
Просмотрите это попадание в конструкторе попаданий протокола измерений.
Попадание в предмет
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.
Просмотрите это попадание в конструкторе попаданий протокола измерений.
Социальные взаимодействия
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.
Просмотрите это попадание в конструкторе попаданий протокола измерений.
Отслеживание исключений
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?
Просмотрите это попадание в конструкторе попаданий протокола измерений.
Отслеживание времени пользователя
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.
Просмотрите это попадание в конструкторе попаданий протокола измерений.
Отслеживание приложений/экранов
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.
Просмотрите это попадание в конструкторе попаданий протокола измерений.
Использование прокси-сервера
Некоторые среды не могут отправлять обращения напрямую в Google Analytics. Примерами этого являются старые мобильные телефоны, которые не могут запускать JavaScript, или корпоративные интрасети за брандмауэром. В этих случаях обычно запросы отправляются на прокси-сервер, который затем использует протокол измерения для пересылки обращений в 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.
Просмотрите это попадание в конструкторе попаданий протокола измерений.