В этом документе рассматривается отправка обращений в Google Analytics с помощью протокола передачи статистических данных (Measurement Protocol).
Обзор
Далее рассказывается о форматировании HTTP-запросов для отправки разных типов обращений с помощью протокола Measurement Protocol. Мы также рекомендуем к изучению следующие материалы:
- Справка по протоколу – подробные инструкции по форматированию запросов.
- Справка по параметрам – перечень всех параметров, принимаемых протоколом.
Обязательные значения
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.
Просмотрите это обращение в инструменте 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.
Обращение типа transaction
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.
Обращение типа item
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 только опосредованно, например старые мобильные телефоны, не позволяющие запускать JavaScript или корпоративный интранет из-за брандмауэра. Обычно в таких случаях запросы посылаются на прокси-сервер, который затем отправляет обращения в Google Analytics с помощью протокола Measurement Protocol.
Чтобы получать данные об 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.