Universal Analytics Streaming
Universtal Analytics Streaming Data Source allows collecting hit-level non-sampled data with unlimited dimensions and metrics into your Google BigQuery account using your existing Google Analytics tracker even if you use a free version of Google Analytics.
Before you begin
- Make sure that BigQuery is connected to SegmentStream.
- Make sure that Google Analytics tracker already implemented in website.
How it works?
- Inside the admin panel navigate to the Data Sources page and click + NEW on the top right corner.
- Choose Universal Analytics from the list.
- Select the Integration type that suits you.
- Copy the Snippet code.
- Click Save and follow the further instructions to integrate the code.
Integrating using Google Tag Manager (GTM)
Choose this method if your Google Analytics is integrated using Google Tag Manager.
In the Variables section click New to create a customTask variable.
Add this variable as your Gooogle Analytics Settings
In case you enabled have Enable overriding settings in this tag option switched on, you would need to define
customTaskfield in each of your Universal Analytics tags.
Save the tag and Publish the container.
Integration with analytics.js (website code)
Choose this method if your Google Analytics integrated with website source code.
Add Snippet from analytics.js type to the website source code on each page after the command
ga('create', 'UA-XXXXX-Y', 'auto'); and before
ga('create', 'UA-XXXXX-Y', 'auto'); <% snippet code from admin panel %> ga('send', 'pageview');
Check if integration works correctly
Go to your website, open console > network and filter results with track.segmentstream endpoint. If snippet integrated correctly you will see requests:
Go to your Google BigQuery account and check if table with name from Destination table appears in your DataSet.
Sending hits using Measurement Protocol
Sometimes you might need to send some hits using Measurement Protocol. For example - transactions or refunds.
To achieve this you just need to send the same request you send to your Google Anlaytics to your SegmentStream data stream endpoint.
POST https://track.segmentstream.com/ds/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx // Use proper endpoint from the admin panel 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.
|hit_id||string||Nullable||Unique hit identifier|
|ip||string||Nullable||Visitor’s IP address|
|received_at||integer||Nullable||Hit time in milliseconds passed since January 1, 1970|
|ssuid||string||Nullable||Cross-domain unique user’s identifier|
|payload||string||Nullable||Raw hit payload|
|cookie||record||Repeated||1st-party cookies of major advertising platforms|
|date||date||Nullable||partitition field, Date of the hit with UTC offset|
|user_agent||string||Nullable||Visitor’s device userAgent|
By default, SegmentStream collects the following cookies alongside with the hit data:
tmr_lvid. The list of cookies can be expanded by request.
This document was last updated on March 5, 2021. If you notice any gaps, outdated information or simply want to leave some feedback to help us improve our documentation, please let us know!