Getting started with AMP in Tripolis Dialogue
In this article we will guide you through the various steps you need to take in order to send emails with an AMP HTML version using Tripolis Dialogue. For clarity, these are the steps we will discuss:
- Make sure you can receive AMP emails in gmail or outlook.com.
- Create and send emails from the AMP Playground.
- Setup a Workpace in Tripolis Dialogue.
- Create and send (test) AMP emails from Tripolis Dialogue.
- Register with Google for whitelisting.
Receive AMP emails in Gmail or Outlook.com
In order to send test emails to yourself you need to enable dynamic emails in your gmail or outlook.com client.
To receive dynamic AMP emails in Gmail, go to Settings – General – Dynamic email and change these 2 settings:
- Check the “enable dynamic email” box
- Click on “developer settings” and check the first option (to receive emails from the playground) and enter the From address that you will be using for test emails in the designated field.
Though Outlook.com doesn’t support AMP emails from third parties yet, developers can whitelist a list of email addresses to send test emails from. You can find this in Settings – Mail – Message handling:
Send AMP emails from the Playground
In the AMP for Email playground you can create emails and send them to yourself:
The playground provides a list of example emails to use as a starting point, chosen from a the dropdown in the top right corner of the page. You can edit the subject and content, using the inline validator to make sure your AMP HTML is valid. When you are logged into gmail the [SEND] button will publish the current email to yourself.
Setup a Workspace in Tripolis Dialogue
To send emails with an AMP part from Tripolis Dialogue you need to create a Workspace with custom domains (incl SPF and DKIM) and create a Direct Email type with AMP HTML enabled.
Custom domains, SPF, DKIM, DMARC
Before you can send AMP emails from Tripolis Dialogue you need to setup a custom domain with SPF and DKIM to use in the workspace. Our support team can help you set this all up and provide you with a DNS proposal for your desired domain.
Note that HTTPS is needed for the image custom domain: AMP requires that all images are served over HTTPS. Because of this you will also need a certificate and we will send a CSR as part of the setup process.
When all domains are aligned, including the From domain used, you are automatically DMARC compliant.
Send test emails without a custom domain
If you want to start testing before you have custom domains setup, you can do this by using the Tripolis custom domains. For this you need to do the following:
- Set https://td[xx].tripolis.com/public as the public url for links and pages and public url for images in the Workspace details (SETUP – content – Details).
Replace td[xx] with your Dialogue instance. You can find it in the URL that you use to login; for example td35, td38, td42, etc.
- Use your <clientname>@tripolis.com as the From address, where <clientname> is the name of the client (without spaces and special characters).
Use tripolis.com domains like this for testing puroses only. To send AMP in production you need to use your own custom domains.
Direct Email Type: Enable AMP HTML
Create a Direct Email Type in [SETUP – content] and check the box “Enable AMP HTML” in the details.
Send AMP emails from Tripolis Dialogue
For Direct Emails of types that have AMP HTML enabled you see an AMP HTML display option in the Preview page, as well as an AMP HTML code editor in the menu bar.
AMP HTML Editor
The AMP HTML code editor uses the same validator as the AMP Playground, including inline error messages and the validation status at the bottom of the page. The editor has a few other features:
- The Copy HTML menu option copies the regular HTML template into the AMP HTML editor. This action does not convert the regular HTML into AMP HTML, so the result is never a working template.
- The Insert boilerplate option inserts the default AMP boilerplate into the editor that can be used as a starting point.
The Special Link button in both editors now also includes an online view link for the AMP version of the email. This can be used to give recipients of the regular HTML version the option to access the AMP version of the email. There is no need to include this online view link in the AMP HTML of course, since that version only shows in browsers that already render AMP HTML properly.
HTTPS for images
Make sure all images used in the AMP HTML template are served over HTTPS.
Make sure that the domain of the From address is aligned with the custom domains in setup.
Testing and Publishing
The Quick Test and Sample Test options both include the AMP part and can therefore be used to send test AMP email. Publishing an email that includes AMP HTML is the same as a regular publication.
Get whitelisted by Google
Before you can send production emails with an AMP part to recipients with a gmail address you need to get whitelisted by Google, using the following steps:
- Make sure your custom domains are setup and images are all using http (see above).
- Create a production quality email.
- Send this email to firstname.lastname@example.org and make a note for yourself with the date and subject line for future reference. Don’t wait for an answer from Google and simply proceed with the next step.
- Register with Google using this 5 page form and wait for a positive response. This may take a few weeks in which you will not receive any other notifications from Google.