Settings - Tracking
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.
Update Google Analytics Settings
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.
Authentication
- API Key
Headers
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
Indicates if Google Analytics is enabled.
The name of the campaign.
Used to differentiate ads
Name of the marketing medium (e.g. "Email").
Name of the referrer source.
Any paid keywords.
{
"enabled": true,
"utm_source": "sendgrid.com",
"utm_medium": "email",
"utm_term": "",
"utm_content": "",
"utm_campaign": "website"
}
Responses
Indicates if Google Analytics is enabled.
The name of the campaign.
Used to differentiate ads
Name of the marketing medium (e.g. "Email").
Name of the referrer source.
Any paid keywords.
{
"enabled": true,
"utm_source": "sendgrid.com",
"utm_medium": "email",
"utm_term": "",
"utm_content": "",
"utm_campaign": "website"
}
Need some help?
We all do sometimes. Get help now from the Twilio SendGrid Support Team.
Running into a coding hurdle? Lean on the wisdom of the crowd by browsing the SendGrid tag on Stack Overflow or visiting Twilio's Stack Overflow Collective.