Email Notification Tutorial

Send an email notification HTML or plain-text email to registered users.

When writing an email, you can create an HTML version of your message, but you must also create a plain text version. Users who cannot receive HTML emails will receive the plain text version.

See the Email Notifications message type reference for more information about available email options and settings.

Resources:

 Tip

You can save this message as a Composer Favorite — a reusable message with preset settings and content. You can use Composer Favorites instead of recreating commonly used messages. See: Use Composer Favorites.

  1. Click Create and select Message.

  2. (Optional) Add a message name and/or flag the message as a test.
    1. Click   in the header.
    2. Enter the name.
    3. Enable Test.
    4. Click outside the box to close it.

    See also: Name a Message and Flag a Message as a Test.

  3. Define your message Audience.

    1. Select the Email channel. When Email is the only enabled channel, the composer is reduced to only fields and settings relevant to email notifications.

    2. Select the group of users you want to send your message to.
      • All Users: Sends the message to your entire audience.
      • Target Specific Users: Create a recipient group based on segmentation data. See: Target Specific Users.
      • Test Users: Predefined recipient groups. After choosing Test Users, select from the Test Groups dropdown menu that appears. See: Test Groups.
      • Upload Users: Upload a list of users just before sending the message. Select this option if you want to include merge fields in your message. See: Upload Users.
    3. Click Content in the header to move on.

  4. Add your message Content.

    1. (Optional) Click Edit   to update Sender Information if you want to change the Name or Email and Reply to addresses for your message, or if you want to designate the message as Transactional.

      By default, messages are for commercial use and require unsubscribe links. You can edit Sender Information to change your message to transactional, change your email addresses, add BCC addresses, or disable tracking events.

      If you designate a message as Transactional you will see the option to Bypass Opt-in Status. Enable this if you want to send the message to audience members even if they have opted out of transactional messages. Use this setting for business critical emails only.

      If you have registered email addresses with Airship for BCC capabilities, you can also select the addresses that you want to blind copy on this message. Contact Airship to enable and register BCC addresses.

    2. Enter your Subject line. Click Add  , enter your Subject line, then click Done.

    3. Create the HTML version of your message. Click Add  , and select how you want to input your HTML message.

      Click Paste HTML or Upload HTML File to use your own HTML.
      1. Paste or upload your HTML.
      2. (Optional) If your message includes HandlebarsAirship’s message personalization syntax using double curly braces, more commonly known as {{handlebars}}. Use handlebars to insert variables and conditional logic in messages and templates. , click {+} Preview with sample values to test your message with JSON sample data.
      3. Click Done.
      Select an Existing Layout or start from a Blank Template.

      The email WYSIWYG editor supports merge fields using attributes, custom event properties, etc.

      1. Select a default layout, or select Blank Template to design your own layout.

      2. (Optional) Style the message Body — the width, font, and background color — of your message.

      3. Click and drag Content or Block elements into your template. Click elements in your template to style them. See the WYSIWYG Editor Reference for details. Click   to duplicate an element or   to delete it.

        • Blocks: Blocks are single- or multi-column rows, synonymous with content columns. You might use blocks to organize the message layout before inserting content elements.
        • Content: Add columns, buttons, dividers, HTML, images, and text to a row in the layout.
      4. Style the elements in your message, then click Done.

    4. Enter the Plain Text Body — a non-HTML version of your message for recipients who do not accept HTML emails. Click Add  , enter the message text, and click Done. If your plain text body includes HandlebarsAirship’s message personalization syntax using double curly braces, more commonly known as {{handlebars}}. Use handlebars to insert variables and conditional logic in messages and templates. , click {+} Preview with sample values to test your message with JSON sample data.

    5. Click Delivery in the header to move on.

  5. Set Delivery options for your message.

    1. Select a delivery type.

      Send now Send the messages immediately after review.
      Schedule Choose an exact time of day to send the message. Enter a date in YYYY-MM-DD format and select the time and time zone.

    2. Set Optional Features.

    3. Click Review in the header to move on.

  6. Review your message.

    1. If you want to make changes, click the associated step in the header, make your changes, then return to Review.

    2. If you chose Upload Users in the Audience step, click Upload & Send and select your file. Uploaded merge field names will be verified against the merge fields set in the Content step.

    3. Click Send Message or Schedule Message.

Send a Templated Email Notification

You must use the Upload Users option to send a notification using a template. You should have the user list that you want to upload ready before you begin this tutorial.

If your template includes merge fields, your user list can also include the data that you want to pass into your message when you upload users. For more information, see Dynamic Content and Merge Fields.

 Tip

To use email templates for commercial messages, you must include an unsubscribe link. If you do not include an unsubscribe link in your template, your message must have the Transactional option selected.

After you select a template, you can click   and then select Custom HTML to add or remove unsubscribe links to support your message.

  1. Click Create and select Message.

  2. (Optional) Add a message name and/or flag the message as a test.
    1. Click   in the header.
    2. Enter the name.
    3. Enable Test.
    4. Click outside the box to close it.

    See also: Name a Message and Flag a Message as a Test.

  3. Define your message Audience.

    1. Select the Email channel.

    2. Select Upload Users. You will upload your user list just before sending the message.

    3. Click Content in the header to move on.

  4. Add your message Content.

    1. Click Select Template.
    2. Select the template you want to use and click Continue with Selected Template.

    3. (Optional) Click Edit   to update Sender Information if you want to change the Name or Email and Reply to addresses for your message, or if you want to designate the message as Transactional.

      By default, messages are for commercial use and require unsubscribe links. You can edit Sender Information to change your message to transactional, change your email addresses, add BCC addresses, or disable tracking events.

      If you designate a message as Transactional you will see the option to Bypass Opt-in Status. Enable this if you want to send the message to audience members even if they have opted out of transactional messages. Use this setting for business critical emails only.

      If you have registered email addresses with Airship for BCC capabilities, you can also select the addresses that you want to blind copy on this message. Contact Airship to enable and register BCC addresses.

    4. Click Delivery in the header to move on.

  5. Set Delivery options for your message.

    1. Select a delivery type.
      Send now Send the messages immediately after review.
      Schedule Choose an exact time of day to send the message. Enter a date in YYYY-MM-DD format and select the time and time zone.
     Note

    If your template includes an External Data FeedA connection to an external API. When you send a message, Airship uses a response from that API to personalize messages. , you must set the error behavior, and the values of variables in the feed URL, in the Delivery step.

    1. Set Optional Features.

    2. Click Review in the header to move on.

  6. Review your message.

    1. Review the device preview and message summary. If you want to make changes, click the associated step in the header, make your changes, then return to Review.

    2. Click Upload & Send and select the CSV file containing your list of users and merge fields. Uploaded merge field names will be verified against the merge fields set in the Content step.

    3. Click Send Message or Schedule Message.

Unsubscribe Links for Email

When sending a commercial email, your message must include a link to unsubscribe from your mailing list.

  • In the HTML Body of your email, include a link with a data-ua-unsubscribe="1" attribute in the format:

    <a data-ua-unsubscribe="1" title="unsubscribe" href="https://www.unsubscribe.com">Link Title</a>

  • In the Plain Text Body of your email, include a link in the format: [[ua-unsubscribe href="your url here"]]

If your unsubscribe link includes an href, Airship unsubscribes the user before redirecting to your page.

Airship reflects unsubscribe events in the Real-Time Data Stream. When users unsubscribe, Airship also assigns them commercial_opted_out or transactional_opted_out values based on the type of email they unsubscribed from.

Upload Users

In the Audience step when sending a message, you can use the Upload Users feature to send your message to a CSV list of recipients. When uploading a list of SMS, email, or open channels, Airship both registers new users found in your list and sends your message.

 Tip

You can take advantage of this feature using our Create-and-send API to register and send messages to new email, SMS, or open channel users.

See Upload Users CSV Format for information about formatting your CSV. The first column of your CSV must contain the channel ID or address (email, MSISDN, etc.) for a new user. For SMS, the second column should be the Sender IDThe alphanumeric code that your SMS messages come from — like a phone number or name. Your audience subscribes to each individual sender ID they want to receive messages from. . Your CSV can contain additional columns with information that you use to personalize a message using HandlebarsAirship’s message personalization syntax using double curly braces, more commonly known as {{handlebars}}. Use handlebars to insert variables and conditional logic in messages and templates. — e.g., {{name}}.

To use the Upload Users feature:

  1. In the Audience step, select the channel you want to send your message to and then click Upload Users. You cannot use the Upload Users feature if you select more than one channel.

  2. In the Review step, click Upload and Send.

  3. Click Choose File and select the file that contains your list of users.

  4. Click Send Message.