Skip to main content

Google Tag Manager Integration

Matt Lawrie avatar
Written by Matt Lawrie
Updated over a week ago

Our Google Tag Manager integration is available on the Business Plan.


Google Tag Manager is a user-friendly system that helps you easily add and edit tags in your app. Tags capture important information about user events, allowing you to gain valuable insights about your users. With Google Tag Manager, you can manage these tags effortlessly, even if you're not technically inclined. It's a tool that simplifies the process of understanding user behaviour on your app.

How to add Google Tag Manager to your app:

In Google Tag Manager

  1. Set up a new or open your existing Google Tag Manager account

  2. Set up your container. A container is where all of your tags will live, so you should name this after your site or URL.

  3. Select ‘Web’ from the container options and click ‘Create’.

4. You will now be dropped into your GTM Workspace. Copy your Container ID - it will look something like GTM-5JGGN23


In the Movement Admin

  1. Navigate to Engage > Integrations in the black lefthand sidebar.

  2. Click on ‘Google Tag Manager’.

  3. Paste in your Container ID that you copied from your Google Tag Manager Account.

Add Tags

Check out Google’s guide on setting up tags.

Events
The full list of events are as follows:

page_view

{
"event": "custom_page_view",
"data": {
"page": {
"title": string // Page title
"content_type": string,
}
},
"user": { "id": string | number } | null // null when logged out, { id: string } when logged in
}

login

{
"event": "login",
"user": { "id": string | number } | null
}

sign_up

{
"event": "sign_up",
"user": { "id": string | number } | null
}

form_submit

{
"event": "form_submit",
"data": {
"form": {
"id": ${form.id},
"title": ${form.title},
},
"submission": {
"id": number,
data: {
// Key values from form submission
"key": value
}
}
},
"user": { "id": string | number } | null
}

search

{
"event": "search",
"data": {
"total_results": Number, // Total number of search results
"initial": Boolean, // Whether it was the the initial search when the search modal opens
"term": String, // User provided search term
},
"user": { "id": string | number } | null
}

button_click

{
"event": "button_click",
"data": {
"text": String, // Text on the button
"href": String, // Destination of the button
},
"user": { "id": string | number } | null
}

navigation_item_click

Only triggers on links in the navbar and sidebar, e.g.

{
"event": "navigation_item_click",
"data": {
"text": String, // Text of the link
"href": String, // Destination of the link
},
"user": { "id": string | number } | null
}

link_click

Any v-link click

{
"event": "link_click",
"data": {
"text": String, // Text of the link
"href": String, // Destination of the link
},
"user": { "id": string | number } | null
}

feed_join

{
"event": "feed_join",
"data": {
"feed": {
"id": string,
"title": string
}
},
"user": { "id": string | number }
}

file_download

{
"event": "file_download",
"data": {
"href": string
},
"user": { "id": string | number } | null
}

telephone_click

Any link click that starts with tel:

{
"event": "telephone_click",
"data": {
"text": String, // Text of the link
"href": String, // Destination of the link
},
"user": { "id": string | number } | null
}

email_click

Any link that starts with mailto:

{
"event": "email_click",
"data": {
"text": String, // Text of the link
"href": String, // Destination of the link
},
"user": { "id": string | number } | null
}

video_start

{
"event": "video_start",
"data": {
"video": {
"id": Number, // ID of the video
"title": String // Title of the video
"link": String // Streaming link of the video
},
},
"user": { "id": string | number } | null
}

video_watch

{
"event": "video_watch",
"data": {
"video": {
"id": Number, // ID of the video
"title": String // Title of the video
"link": String // Streaming link of the video
},
"watched_seconds": Number,
"watched_percentage": Number
},
"user": { "id": string | number } | null
}

social_click

Clicks on social blocks:

{
"event": "social_click",
"data": {
"text": String, // Text of the link
"href": String, // Destination of the link
},
"user": { "id": string | number } | null
}

Connecting Meta & TikTok Pixels to your App.


Once you’ve connected your Google Tag Manager Container ID to Movement, you can connect things like Meta and TikTok Pixels to your app with Google Tag Manager. Check out the following resources on how to do this:

Connect Facebook Pixel To Movement with Google Tag Manager

Connect TikTok Pixel to Movement with Google Tag Manager.

Did this answer your question?