Setup

Understand how to set up Email as a channel for your marketing campaigns.

Overview

This section covers various email tasks, including the integrations, and inbox previews. No matter the type of customer emails, all businesses have the same goal to get to the correct recipient's inbox. By setting up your email correctly, you ensure successful email deliverability.

Email Integrations

Before you can create email campaigns, you must integrate an email service provider with CleverTap.

CleverTap supports integrations with popular email service providers. Select your email service provider from the following list:

For all other service providers, use Generic SMTP.

Setup Provider

Once you have integrated an email service provider with CleverTap, you can set up your email service provider.

To add a provider, perform the following steps:

  1. From the dashboard, navigate to Settings > Engage > Channels > Email.
  2. Click + Provider to add a provider.
1162

Add Provider

  1. Add the following provider details:
ColumnDescription
ProviderSelect your Email Provider from the dropdown list. Select SMPT if the provider is not listed
Nickname
  • This is a mandatory field.
  • Enter the nickname for the Email Provider to uniquely identify it.
  • Callback URL
  • This is a mandatory field.
  • Callback URL is used to get the bounce, rejection, and subscription information from the Email Partner to CleverTap.
  • It is a read-only field that is pre-populated with CleverTap's callback URL.
  • Host
  • This is a mandatory field.
  • This is the address of the email server. In this case, it is the domain name (e.g., http://smtp.sendgrid.com) that directs to the server responsible for sending emails.
  • Port
  • This is a mandatory field.
  • This is the specific gate on the email server through which communication occurs. For example, 587.
  • API Key
  • This is a mandatory field.
  • You get this key while setting up the provider dashboard. For more on finding the API key for CleverTap's default service provider, refer to the Creating API Key section
  • Default From Address
  • This is a mandatory field.
  • Enter the default email address you want to use for sending your email campaigns.
  • The email address will be pre-populated under the From Email Address field as a default value when creating an Email campaign. If you want to personalize the From Address field for your email campaign, refer to sender details
  • Default Reply Address
  • This is a mandatory field.
  • Enter the default email address to which you want your users to reply to the campaign.
  • The email address will be used to pre-populate the Reply-to Email Address field as a default value when creating an Email campaign. If you want to personalize the Reply-to Email Address field, refer to sender details .
  • Email Preference Center
  • Select System from the dropdown to use a pre-built preference center with a sample preview.
  • Select Custom URL to add your hosted unsubscription page URL.
  • Select None if you want to manage the email preferences directly on your own.
  • For more information, Manage Email Preferences.
    1. Click Save.
    2. Click Send Test Email to check if the provider has been set up correctly and can send emails.

    Provider Operations

    This section describes actions for the available email service providers.

    736

    Provider Operations

    Archive Service Providers

    You can archive any of the current email service providers from the email settings. Archiving the email service provider stops any active Campaigns or Journeys for this provider. The archived provider will not be available for use in the future. However, it will still retain the provider stats.

    Follow the steps to archive an email service provider:

    1. From the CleverTap dashboard, navigate to Settings > Channels > Email > Providers tab.
    2. Click the ellipsis next to the provider.
    3. Select Archive from the list.

    Delete Service Providers

    You can delete any of the current email service providers from the email settings. Deleting the email service provider will remove all existing data from our system and stop any active Campaigns or Journeys. The deleted provider will not be available for use in the future, as well as the corresponding provider stats won't be retained.

    Follow the steps to delete an email service provider:

    1. From the CleverTap dashboard, navigate to Settings > Channels > Email > Providers tab.
    2. Click the ellipsis next to the provider.
    3. Select Delete from the list.

    Edit Settings

    Edit the email settings to change Provider credentials.

    Follow the steps to edit provider settings:

    1. From the CleverTap dashboard, navigate to Settings > Channels > Email > Providers tab.
    2. Click the ellipsis next to the provider.
    3. Select Edit settings from the list. The Provider credentials window displays.
    4. Change the required information.
    5. Click Send Test Email to check that the provider is working correctly.
    6. Click Save.

    Mark as Default

    Set a service provider as default so that the same provider is used for delivering your emails.

    1. Follow the steps to set a default email service provider:
    2. From the CleverTap dashboard, navigate to Settings > Channels > Email > Providers tab.
    3. Click the ellipsis next to the provider.
    4. Select Mark as Default from the list.

    Inbox Previews

    Before you can use inbox previews, you must enable them. Inbox previews with code analysis let you view an analysis of your HTML code. It also provides the capability to view previews across devices and inboxes before you send out a campaign.

    🚧

    Account Specifications

    Email previews are available only if you have opted for the email add-on from CleverTap.

    Enable or Disable Inbox Previews

    To enable or disable the inbox preview, perform the following steps:

    1. From the dashboard, navigate to Settings > Engage > Channels > Email.
    2. Select the Previews tab.
    3. Select a client from the list.
    4. Click on the ellipsis and click Enable or Disable.

    πŸ“˜

    Multi-select

    You can also select multiple clients, then enable or disable previews by clicking Enable in inbox previews or Disable in inbox previews.

    1172

    Enable or Disable Inbox Previews

    The Previews tab lists the available email inboxes. For example, a mobile device that runs Gmail on Android 8 or a computer that runs Apple Mail 10 on an OS X 10.10 operating system.

    🚧

    Account Specifications

    Email previews are available only if you have opted for the email add-on from CleverTap.
    This feature is not available for trial accounts.

    Advanced Setup

    AppsFlyer OneLink

    Deep linking gives your app users the most seamless experience possible by guiding them securely and contextually to in-app information.

    CleverTap automatically wraps all links in the email body to track clicks. When a user clicks on any of the links in the email, this may lead to several redirects. Turning off click tracking for deep links is one option for marketers who wish to send users straight to the content.

    The other option is to leverage the AppsFlyer OneLink with branded links. Doing so can provide your app users with the greatest experience possible as it directs them to a specific landing page, the app store, or in-app content. All this while, CleverTap tracks the click and assists in boosting conversion rates.

    3840

    AppsFlyer OneLink Integration

    Set Up AppsFlyer OneLink(s)

    The following are the steps to enable this feature:

    1. Set Up OneLink(s) in AppsFlyer

    To use the AppsFlyer OneLink feature on the CleverTap dashboard, you must first set up a Branded OneLink on your AppsFlyer account. To set up branded OneLink in AppsFlyer, refer to these steps.

    2. Set Up OneLink(s) in CleverTap Dashboard

    To set up OneLink on the CleverTap dashboard:

    a. Navigate to Settings > Channel > Email > Advanced Setup on the dashboard and click AppsFlyer OneLink dropdown.

    Advance Setup

    Advance Setup

    b. Enter your AppsFlyer OneLink domain or sub-domain and click Add.

    Add AppsFlyer OneLink

    Add AppsFlyer OneLink

    🚧

    Adding a Domain

    You can add a maximum of 20 valid domains or sub-domains.

    c. Click Save to save the domain.

    Save AppsFlyer OneLink

    Save AppsFlyer OneLink

    The message AppsFlyer domain deeplink successfully saved displays at the top.

    AppsFlyer Domain Deeplink Success

    AppsFlyer Domain Deeplink Success

    Disable Tracking via AppsFlyer OneLink

    If you want to avoid click tracking via AppsFlyer OneLink, add the following tag for all the required links in your email:

    <a data-track="off" href="donotoverrride"> Your link </a>
    

    AppsFlyer OneLink does not apply to links with this tag.

    🚧

    Note

    Turn off click tracking from your email service provider's dashboard for one link redirection to function as intended. CleverTap will receive the click data directly from AppsFlyer.

    ❗️

    Invalid AppsFlyer Branded OneLink

    AppsFlyer does not send the click data for invalid OneLink URLs configured in an Email campaign to CleverTap.

    Font Manager

    This feature enables you to add and manage custom fonts and use them in your email campaigns. It simplifies font management across the Drag & Drop and Rich Media editors.

    πŸ“˜

    Feature Availability

    The feature is available to customers on the Advanced and Cutting Edge plans.

    Add Custom Font

    You can add custom fonts by navigating to Settings > _Channel > Email > Advanced Setup from the CleverTap dashboard. You can add up to 100 custom fonts.

    The following are the steps to add a custom font:

    1. From the Advanced Setup page, click Font Manager.
    Font Manager

    Font Manager

    1. Click + Custom Font. The Add Font popup opens.
    Add Custom Font

    Add Custom Font

    1. Enter the following details:
    Field NameDescription
    Font NameUniquely identifies the font. This field has a limit of up to 50 characters.
    Font FamilyDefines the style applied to the font. This field has a limit of up to 50 characters. The custom font family must match the name of the font face in the CSS file.
    Font URLIf the font is not on your local system, you can select this option to add the URL for the font you want to add. The URL must point to a CSS file.
    If your custom font is a public font available on the web, you can directly add the URL for the font.
    If you upload the font to your private server, ensure that CORS is enabled on the server that provides the custom font file.
    Upload FontIf you already have a font downloaded on your local system, choose Upload Font, and click Upload to upload the CSS file for your custom font. The file size should be a maximum of 1 MB.

    The custom font file must have the following header: Access-Control-Allow-Origin: \*. When defining font URLs in the src attribute, utilizing the https protocol is essential. Refer to the sample CSS code.
    - Fallback Font
  • Not all email clients support custom fonts. The following are some of the email clients that support custom fonts:
    • AOL Mail
    • Native Android Mail App(excluding Gmail)
    • Apple Mail
    • iOS Mail
    • Outlook 2000
  • Select from the dropdown list specific system fonts to seamlessly replace custom fonts in unsupported email clients.
  • When defining multiple Fallback fonts, they are used in the order selected (from left to right).
  • Note: Ensure you test the fallback font before publishing the campaign.

    *The fields marked with asterisk sign are mandatory.

    1. Click Add to add the custom font.

    Sample CSS code:

    @font-face {
      font-family: 'Dancing Script';
      font-style: normal;
      font-weight: 400;
      font-display: swap;
      src: url(https://fonts.gstatic.com/s/dancingscript/v25/If2RXTr6YS-zF4S-kcSWSVi_szLgiuEHiC4W.woff2) format('woff2');
      unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+2074, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;
    }
    

    Set Up Default Font

    You can also set up the system and custom fonts as the default font for your email campaigns. Select the font from the Default font dropdown to set up the default font for your email campaigns.

    The default font cannot be deleted. If you still want to delete it, change the default font and then delete the required font.

    Set Up Custom Font as Default Font

    Set Up a Default Font

    Delete Custom Font

    You can delete one or multiple custom fonts to manage your custom font library. To delete a custom font

    1. Select one or multiple custom fonts you want to delete.
    2. Click the icon and select Delete. The Delete font? popup opens, highlighting potential impacts on drafts and saved templates and prompting you to confirm your action.
    3. Select Delete to successfully delete the custom font(s). A confirmation message is displayed.
      Upon deleting the custom font, it is unavailable for use in both the Drag & Drop and Rich Media_ editors.
    Delete Custom Font

    Delete Custom Font

    Edit Custom Font

    You can edit your custom font and update the font details.

    1. Select the custom fonts you want to edit.
    2. Click the icon and select Edit. The Edit Font popup opens.
    3. You can update the required fields related to the custom font and click Save to save the changes.
    Edit Custom Fonts

    Edit Custom Fonts

    The updated custom font is now available for both the Drag & Drop and _Rich Media editors. When making changes to the custom font, an email alert is sent to the user updating the custom font and also to the account admin.

    🚧

    Delete or Edit Custom Font

    Editing or deleting custom fonts does not impact running, scheduled, and draft engagements. The modifications take effect for the campaigns created subsequent to your changes.