Skip to content Skip to navigation Skip to topbar

Update Google Analytics Settings

API Overview

You can track many of your recipients' interactions with your emails, including:

Opening emails
Clicking links
Subscribing to (or unsubscribing from) your emails

For more information about tracking, please see our Tracking Settings documentation.

Operation overview

PATCH/v3/tracking_settings/google_analytics

Base url: https://api.sendgrid.com

This endpoint allows you to update your current setting for Google Analytics.

Google Analytics helps you understand how users got to your site and what they're doing there. For more information about using Google Analytics, please refer to Google’s URL Builder and their article on "Best Practices for Campaign Building".

We default the settings to Google’s recommendations. For more information, see Google Analytics Demystified.

Operation details

Authentication

API Key

Headers

Property nameTypeRequiredDescription

Authorizationstringrequired

Default: Bearer <<YOUR_API_KEY_HERE>>

on-behalf-ofstringOptional

The on-behalf-of header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You will use the parent account's API key when using this header. When making a call on behalf of a customer account, the property value should be "account-id" followed by the customer account's ID (e.g., on-behalf-of: account-id <account-id>). When making a call on behalf of a Subuser, the property value should be the Subuser's username (e.g., on-behalf-of: <subuser-username>). See On Behalf Of for more information.

Request body

SchemaExample

Property nameTypeRequiredDescriptionChild properties

enabledbooleanOptional

Indicates if Google Analytics is enabled.

utm_campaignstringOptional

The name of the campaign.

utm_contentstringOptional

Used to differentiate ads

utm_mediumstringOptional

Name of the marketing medium (e.g. "Email").

utm_sourcestringOptional

Name of the referrer source.

utm_termstringOptional

Any paid keywords.

Responses

200

SchemaExample

Property nameTypeRequiredDescriptionChild properties

enabledboolean

Indicates if Google Analytics is enabled.

utm_campaignstring

The name of the campaign.

utm_contentstring

Used to differentiate ads

utm_mediumstring

Name of the marketing medium (e.g. "Email").

utm_sourcestring

Name of the referrer source.

utm_termstring

Any paid keywords.

Update Google Analytics Settings

Node.js

Python

Java

PHP

Ruby

curl


_26const client = require('@sendgrid/client');
_26client.setApiKey(process.env.SENDGRID_API_KEY);
_26
_26const data = {
_26  "enabled": true,
_26  "utm_source": "sendgrid.com",
_26  "utm_medium": "email",
_26  "utm_term": "",
_26  "utm_content": "",
_26  "utm_campaign": "website"
_26};
_26
_26const request = {
_26  url: `/v3/tracking_settings/google_analytics`,
_26  method: 'PATCH',
_26  body: data
_26}
_26
_26client.request(request)
_26  .then(([response, body]) => {
_26    console.log(response.statusCode);
_26    console.log(response.body);
_26  })
_26  .catch(error => {
_26    console.error(error);
_26  });