Email Metrics
Broadcast allows you to track email metrics such as opens, clicks, and bounce rates.
There are two ways to track email metrics:
- Natively within the Broadcast software.
- By integrating with the email service provider’s metrics.
Native Metrics
Currently, it is possible to enable native metrics for Broadcasts and Sequences.
In order to enable native metrics, all you need to do is to enable the “Track Opens” and “Track Clicks” options in the Broadcast or Sequence settings.
Email Service Provider Metrics
Broadcast can also integrate with your email service provider to track metrics such as opens, clicks, and bounce rates.
Currently, the following email service providers are supported:
- AWS SES
- Mailgun
- Postmark
- SendGrid
Setting up AWS SES
AWS SES metric integration requires you to set up a SNS topic. Follow the steps below to set it up.
In the AWS Console under the same region as your AWS SES account, create a new SNS topic. Create a topic, and choose “Standard” as the type.
Give the topic a name, such as “broadcast”. You can leave the rest of the settings as default. Click on “Create topic”.
Once created, click on “Create subscription” button. You will see a screen where you need to configure the endpoint where your AWS SNS Topic will send webhooks to.
Choose “HTTPS” as the protocol. For the endpoint itself, go to your Broadcast dashboard, click on “Channel Settings”, then “ESP Integrations”, and you will see your endpoint.
For example, if your installation is at https://broadcast.yourdomain.com, your endpoint will be at https://broadcast.yourdomain.com/wh/ses. You will see a message that says, “Waiting for verification…”. Keep this tab open because the next step will require you to copy and paste the URL that AWS SNS sends to this screen.
Go back to the AWS Console, and click on “Create subscription”. AWS SNS will send a confirmation request to the endpoint.
Go back to the Broadcast screen, and copy and paste the verification URL that AWS SNS sent to this screen.
Check that the endpoint has been verified in the AWS Console. Under “Subscriptions”, you should see the status as “Confirmed”. If you go back to the Broadcast dashboard, you will see the “Waiting for verification…” if you refresh the page. You do not need to configure anything else here, as Broadcast will receive any messages sent from AWS SNS and verify the message internally.
Now, leave the AWS SNS screen, and go to your AWS SES dashboard. On the side menu, click on “Configuration sets” and “Create set”.
Give it a name, such as “broadcast”. You will need this name later, so make sure to remember it. Leave the rest of the settings as default. Click on “Create set”.
Once the set is created, click on “Event destinations” and then on “Add destination”. Click “Select All” for all the events (eg. sends, rejects, etc), as well as opens and clicks.
On the next screen, you will need to configure the destination. Give your destination a name, such as “broadcast”. Click on Amazon SNS, and on the bottom select the topic you created in the above steps. Click “Next” and “Add destination”.
There is one more step. Within the Broadcast dashboard, go to “Channel Settings”, then “Email Servers”. Click on your AWS email server to edit it. Under “AWS SES Configuration Set”, enter the name you chose above for the configuration set. Click “Update”.
To test the integration, you can send a test email from Broadcast.
The easiest way to do this is manually add a subscriber. Go to subscribers, click on “Add subscriber”, and add a subscriber with an email of “[email protected] ”. This is a test email address that will bounce if used.
Create a new broadcast, and send it. If you go to the subscriber’s detail page, you will see that the AWS SES event is being forwarded from AWS. Because the subscriber’s email bounces, Broadcast has automatically unsubscribed and deactivated this subscriber.
Note that once the system detects a bounce, the system does not allow the user to be resubscribed in order to protect your list from having future deliverability issues.
Setting up Mailgun
Documentation for Mailgun is coming soon.
Setting up Postmark
Documentation for Postmark is coming soon.
Setting up SendGrid
Documentation for SendGrid is coming soon.
