How to event stream data from your Vue app to Google Analytics using RudderStack
Pre-Requisites
Before getting started, you need to ensure your Vue app is installed and set up. If you haven’t done it yet, refer to the Vue documentation for more information.
Step 1: Integrating your Vue app with the JavaScript SDK
Creating a JavaScript source in RudderStack
You need to set up a JavaScript source in your RudderStack dashboard that will track events from your Vue app. Follow these steps to set up the source:
1. Log into your RudderStack dashboard. If you’re new to RudderStack, sign up here.
2. Write down the Data Plane URL. You will need this later.
3. Create a Source by clicking on the Add Source option. You can also click on the Directory option in the left navigation bar and select Event Streams under Sources, as shown. Next, select JavaScript.
4. Add a name for JavaScript Source and click on Next.
5. Your JavaScript source is now configured and ready to track events. Note the Write Key associated with this source. You will need it to set up the RudderStack integration with your Vue app.
Installing and configuring the JavaScript SDK in your Vue app
Integrate RudderStack JavaScript code with your Vue app and set up the tracking code following steps given below:
- In your Vue app's project folder, navigate to the public folder and open index.html.
- Place the following script within the <head> section of the page:
HTML
<script>rudderanalytics=window.rudderanalytics=[];for(var methods=["load","page","track","identify","reset"],i=0;i<methods.length;i++){var method=methods[i];rudderanalytics[method]=function(a){return function(){rudderanalytics.push([a].concat(Array.prototype.slice.call(arguments)))}}(method)}rudderanalytics.load("WRITE_KEY","DATA_PLANE_URL");</script><script src="https://cdn.rudderlabs.com/rudder-analytics.min.js"></script>
3. Replace WRITE_KEY and DATA_PLANE_URL with your JavaScript source write key and the data plane URL obtained in the Creating a JavaScript source in RudderStack section above.
Important: Refer to the sample Vue app in the RudderStack Sample Applications repository for more information on modifying these files.
Step 2: Configuring a destination in RudderStack for routing your Vue app events
This section details the steps required to set up a destination platform in RudderStack, where you can send all the events tracked by the JavaScript SDK. For this guide, we will set Google Analytics as our destination.
To add Google Analytics as a destination in RudderStack, follow the steps given below:
1. Click on Destinations in the left navigation bar of your RudderStack dashboard and select Add Destination.
2. Next, choose Google Analytics as your Destination.
3. Assign a name to your destination and click on Next
4. Now, connect the JavaScript source that we have already configured in Step 1 and click Next.
5. On the Connection Settings page, configure your Google Analytics destination with your Google Analytics Tracking ID and other optional settings, as shown below. Then, click on Next.
Note: You can also transform your events before sending them to Google Analytics. For more information on this feature, check out our documentation on User Transformations.
Great job! Google Analytics is now configured as a destination. You should now see the following source-destination connection in your dashboard:
Step 3: Deploying your Vue app and verifying the Event Stream
To verify if your event stream works correctly, deploy your Vue app and test if the events are tracked by the JavaScript source and delivered to your Google Analytics destination correctly.
Follow these steps to find:
- On your Terminal or cmd, navigate to your Vue app's root folder and run the following command:
HTML
npm run serve
2. Open the local server URL (http://localhost:4000) in your browser to view the app.
3. Next, verify if rudder-analytics.js (RudderStack’s JavaScript SDK) has loaded correctly. To do this, go to your browser’s Developer tools and navigate to the Network tab. The following screenshot highlights this option for Google Chrome:
4. Click on the various links or pages in your Vue app for RudderStack to track these actions.
5. Check if RudderStack can track the different pageviews and clicks by clicking on the Live Events tab of your JavaScript source on the RudderStack dashboard page:
Note: After deploying your app, there can sometimes be a lag before events start sending and are visible in your dashboard and destination. Don’t worry. All events are captured and sent; just be aware that they can take a few minutes to show up.
6. Upon successful tracking, you will see the events in your RudderStack dashboard:
7. To check if the events are delivered successfully to your Google Analytics destination, navigate to the Realtime > Events option on your Google Analytics dashboard.
Your tracked events will be shown in this window along with other metrics including number of active users, source platform, etc.
Questions?
In this guide, we covered how to instrument your Ember.js app with the RudderStack JavaScript SDK to send event data to your preferred destinations in real-time, using Google Analytics as an example. If you have any questions about this integration or would like to learn more about RudderStack, please contact us or start a conversation in our Slack community.