SendGrid Account Settings
The deltaDNA platform can be used to deliver emails through SendGrid as part of a campaign. Before full integration can be achieved there are a number of steps that you must first complete including creating a new credential/teammate; adjusting mail and subscription settings; and integrating with the deltaDNA platform.
After logging into your SendGrid account, navigate to Settings > Teammates and press Add Teammate. The teammate can be added with admin, developer or custom access. The easiest option is to invite as an admin, however, if you require more granularity you can invite with custom access – just be sure to provide them with access to API Keys, Email Activity, Mail, Mail Settings and Tracking.
After setting up the profile for the new teammate you should be presented with two accounts: the main administrator account and the account that will be used to interact with the deltaDNA platform.
The next step is to enable and configure Event Webhook – this will allow SendGrid to post back to deltaDNA, in turn generating sendgridEmail events in the platform. Navigate to Settings > Mail Settings and click the Event Webhook section. Enter ‘https://sendgrid.deltadna.net’ as the HTTP POST URL, ensure that all the actions are checked, and then switch the toggle to “On” or “Enabled” to activate the changes.
After enabling Event Webhooks, the next step is to enable Subscription Tracking, allowing your users to unsubscribe from your email campaigns. Navigate to Settings > Tracking and click the Subscription Tracking section. Follow the instructions to configure your unsubscribe content, ensuring you include a <% %> tag to place the unsubscribe link. After configuring, switch the toggle to “On” or “Enabled” to activate Subscription Tracking.
Accounts created on SendGrid after 6 Apr 2020 require you to verify the identity of the email you use in the From field on your outbound emails. If you don’t verify your sender identity with SendGrid you will not be able to send emails from it. Please review the following Sender Identity guide on the SendGrid site for further information.
If you encounter any issue sending emails from deltaDNA through SendGrid please review the “Activity” page on your SendGrid account. You should be able to drill into your individual messages and view a log of the deltaDNA send, SendGrid delivery steps and any subsequent recipient actions.
deltaDNA do not provide any email address or management features and it is the responsibility of the publisher/developer to ensure any email collection and usage complies with the terms of any stores the game is available on and the privacy and COPA legislation of any territories the game is available in. The email parameter will already exist on the game’s newPlayer event but it can be added to any other event using the Event Manager tool. This will allow the developer to send or update the email address from the game client or from a server using a GHOST event.
The publisher/developer will also be responsible for ensuring that any email addresses used in campaigns are verified.
Most email platforms will block or suspend accounts sending emails if the bounce rate exceeds acceptable levels. There are a number of services you can use to verify your email addresses and clean your email lists. A few of these services are listed below:
- After completing the SendGrid account setup, you will have to integrate the account with deltaDNA using the Manage Identity tool
- Learn more about using email as an Out of Game Action
- Use the Message Test Tool to test your integration