Google Analytics Tracking Values

This option is available on a Sendgrid Send Email to Contact action. Use the Google Analytics Tracking section to overwrite UTM parameters populated by Sendgrid. This tool is helpful for identifying campaigns sent by Simon Data within Google Analytics reporting.

All fields can be edited but fields are pre-populated with default information from your flow.

To learn more about UTM parameters, you can refer to the Google Analytics documentation.

SendGrid Engagement Metrics

Simon supports reporting on email metrics in near real-time for any flows that are configured to send emails through SendGrid. These metrics are collected via SendGrid's webhook events. You can read SendGrid's documentation for more detail.

Metrics are updated every 15 minutes.

Aggregate SendGrid Metrics

On the flows index page, you'll see metrics for any flow with a SendGrid action:

These metrics are aggregated at the flow level for the lifetime duration of the flow. If a flow has multiple variants sending different emails, these numbers represent the sum of metrics across all variants.

• Delivered: the total number of emails sent by this flow
• Opened: the number of contacts who opened this email
  • The rate here is opens over deliveries - the percentage of opens out of all email deliveries
• Clicked: the number of contacts who clicked a link within this email
  • The rate is the percentage of contacts who clicked this email out of total contacts who opened this email

These calculations are approximations, which will be very nearly identical to the actual event volumes, for exact measures navigate to the flow detail pages with additional metrics.

Detailed SendGrid Metrics

Click into any flow with SendGrid metrics as seen above, and you'll see individual flow level metrics:

Note that if the flow is configured as a one-time message, the date range selector will not be displayed and all metrics will be computed over the entire lifetime of the flow. If this flow has multiple variants sending different emails, these numbers will represent the sum of metrics across all of those emails.

• Sends: the number of total messages delivered, dropped, and bounced
  • Delivered: the number of total messages delivered (the rate is over sends)
  • Undelivered: the sum of total messages bounced and dropped (the rate is over sends)
  • Unsubscribed: the number of contacts who unsubscribed to this email (the rate is over sends)
• Open Rate: the percentage of contacts who opened this email out of total contacts who were delivered this email
  • Unique opens: the number of contacts who opened this email
  • Total opens: the number of total email opens (including cases in which the same contact opened an email multiple times)
  • Opens per contact: the average amount of email opens per each contact who opened this email
• Click-to-open Rate: the percentage of contacts who clicked this email out of total contacts who opened this email
  • Unique clicks: the number of contacts who clicked this email
  • Total clicks: the number of total clicks (including cases in which the same contact clicked an email multiple times)
  • Clicks per contact: the average amount of clicks per each contact who clicked this email
• First Send: the timestamp of the first email delivered by this flow
• Last Event: the timestamp of the most recent event for this flow

---

SendGrid templates

Templates allow you to create an email message entirely within Simon, with your HTML code and dynamic personalization defined in a single place.
:::(Info)
Email templates are only available with SendGrid as the email delivery channel.
:::

Templates consist of HTML code combined with dynamic content in the form on Jinja code. If you are already familiar with Custom Context, the Jinja code in templates follows the same syntax and conventions. A key difference with templates is that all the dynamic content is defined within the template, so there is no need for separate Custom Context to be defined. You can still define metadata when you set up your flows.

Access and using templates in simon

To get to templates, click on your email address to reveal the dropdown of options, and then select Content. On this page you can access any existing templates and create new ones.

The template editor lets you edit the HTML for your message, add dynamic personalization, preview the message for both a single contact and a batch of contacts, and perform a test send.

After you have completed setting up a template and saved your changes, you can use it in the flow builder by selecting the channel action Send Email To Contact with Simon Templates. Simply chose your template from the list, enter a subject, and complete the rest of the flow set-up. You will also have the option to preview the message and do a test send from within the flow builder. A template can be used in an unlimited number of flows.

Creating and editing templates

The template editor consists of the code editor on the left-hand side, and the preview and personalization tabs on the right hand size.

Code editor

The code editor will highlight HTML syntax, and gives you the option to search, as well as collapse and expand HTML tags to more easily navigate your code.

Message details

The message details can be found under the @ icon. This allows you to save a default value for subject line, from name, from email address and reply-to email address. These values will be loaded as defaults when this template is selected in the flow builder, but you will also have the option to update them in the flow builder, such as for a subject line test. The subject line can contain personalization using contact properties in the form of Jinja expressions.

📘

Updating message details after a flow is created

Once a flow has been set up, the message details are stored within the flow, and changes to message details made in the template will not automatically update the flow. Any changes to the subject, from name, from email, or reply-to email must be made in the flow itself.

Preview and sample contacts

The preview tab will show the message as rendered for a random contact in your database. As you change the code, the preview on the right hand side will automatically update.

You can select a segment and sample contact for your template under Contacts. The contact that is selected there will be used for both the preview and test send. If you select a segment, the contact will be sampled from that segment. The segment will also be used to select the contacts for previewing a batch.

Preview batch and test send

Preview batch allows you to preview a batch of 25 messages for randomly selected contacts in the selected segment. You can flip through the contacts to see how the content would look for each of them. Test sends will use the selected sample contact (with the ability to cycle through sample contacts) to populate the message personalization and will send the corresponding message to one or several email addresses. The test send will use the message details, if configured, and adds the text '[TEST]' before the subject. If message details have not been defined, the message will be sent as coming from your email address, with the template name as subject.

Contact properties

Templates can incorporate contact properties for personalization, much the same as Custom Context. Clicking on a contact property will insert that value in the template. You can use contact properties both as conditional statements and to present them as content. It is important that there is not a situation where there could be content missing from your message. It is always recommended to set up a default value in the event of null customer or lookup table data. There is more information about how to use contact properties in Custom Contexts - Explained.

::(Warning) (Use validations and default values when inserting dynamic content)
When working with any dynamic content it is important to ensure that content will not be missing from your message, e.g. if certain contacts are missing a property that you are using in your block. You can avoid this by adding checks for missing content and providing default values.
:::

Lookup tables

You can include content from lookup tables in your template just as you would for Custom Context. The Lookups tab lets you explore your lookup tables and clicking on a property will insert the code in the template. Just as with contact properties, it is important that you consider the situation of a missing property, in order to avoid missing or erroneous content. To find out more about how to use lookup tables, check out our tips about Getting Started with Lookup Tables.

Event data

Event data can be accessed under the Events tab if you have set up triggers using data from Simon Signal. In order to use event data within a template, you will first need to select the corresponding trigger. Make sure you use the same trigger as you intend to use in the flow. Once you've selected a trigger, you will be able to preview sample events for that trigger. You can sample different contacts to preview the content for different situations. (If a single contact has multiple events, you can move between those using the arrows).

You can learn more about how to use event data as content under Using Event Data from Triggers.

:::(Warning) (Picking the right trigger)
Because different triggers can have different data fields available, it is important to use the same trigger in the template builder and your flow. You should also confirm both in the template and flow builder that the content renders correctly.
:::

:::(Info) (Combining event data with contact properties)
Certain triggers apply to contacts that do not already exist in the system, such as a registration event. When such a trigger is selected, contact properties will not be available in the template.
:::

Content blocks

Content blocks allow you to save static text or code and reuse it in multiple places without duplicating the information. When you want to make an update, you can do it in a single place. Find out more about blocks in Content Blocks. Please note that it can take a couple of minutes for block updates to be refreshed in the templates preview.

Using templates in the flow builder

Simon templates are available within the channel action Send Email to Contact with Simon Templates. After selecting your template, fill in your subject and the rest of the email details. The subject can include dynamic personalization using Jinja.

Because the personalization is already defined in the template, there is no option to add Custom Context, but there is a separate section to enter metadata. You will also find an option for test send.