DocumentationAEM 6.4Classic UI Authoring Guide

Publishing an Email to Email Service Providers publishing-an-email-to-email-service-providers

Last update: Wed May 03 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • User
CAUTION
AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our technical support periods. Find the supported versions here.

You can publish newsletters to e-mail services such as ExactTarget and Silverpop Engage. This document describes how to configure AEM to publish a newsletter to these e-mail services.

NOTE
You need to configure the service provider before you can create and publish an email. See Configuring ExactTarget and Configuring Silverpop Engage for more information.

To publish your email to the email service provider, you need to perform the following steps:

  1. Create an email.
  2. Apply the Email Service configuration to the email.
  3. Publish the email.
NOTE
If you update email providers, do a flight test, or send a newsletter, these operations fail if the newsletter is not published to the Publish instance first or if the Publish instance is not available. Be sure to publish your newsletter and make sure the Publish instance is up and running.

Creating an Email creating-an-email

An email or newsletter that you want to publish to an e-mail service can be created under a campaign using the Geometrixx Newsletter template. You can also use the Geometrixx Outdoors E-Mail template. Sample email/newsletter-based on the Geometrixx Outdoors E-Mail template are available at https://<hostname>:<port>/cf#/content/campaigns/geometrixx-outdoors/e-mails.html.

To create a new email that is published to the configured e-mail service:

  1. Go to Websites and then Campaigns. Select a campaign.
  2. Click New to open the Create Page window.
  3. Enter the title, name, and select the Geometrixx Newsletter template from the list of available templates.
  4. Click Create.
  5. Open the created email.
  6. Switch to design mode to select the components you want to display in the sidekick.
  7. Switch to edit mode and start adding content (text, images, email tools, personalization variables, and so on) to your email.

Adding ExactTarget Email Tools to your email adding-exacttarget-email-tools-to-your-email

NOTE
This section is specific to the ExactTarget service.

The Email Tools component for ExactTarget can add more email functionality to your email/newsletter.

  1. Open an email to be published to ExactTarget.

  2. Add the component ET - Email Tools to your page using the sidekick. Open the component in Edit mode.

    chlimage_1

  3. Select an option from the Options menu:

Physical Mailing Address (Required)
This component inserts the physical mailing address of your organization in your email.
Profile Center (Required)
The profile center is a webpage where subscribers can enter and maintain the personal information that you keep about them.
View Email as a Web Page
This component allows the user to view the email as a webpage.
Privacy Policy
This component inserts the link to your privacy policy in the email.
Unsubscribe Center
Gives the option to the user to unsubscribe from your mailing list.
Subscription Center
A subscription center is a web page where a subscriber can control the messages they receive from your organization.
Track Email Opens
A hidden component that allows you to use ExactTarget tracking feature.
NOTE
The Options drop-down menu is only populated if ExactTarget configuration is applied to the email. See Applying Email Service Configuration to Email Settings for more information.

  1. Publish the email to ExactTarget.

    The email with the email tools is available for use in the configured ExactTarget account.

NOTE

  • The URLs within the email tools are replaced (in the received email) by their actual values only when an email is sent using Simple Send or Guided Send but not Test Send.

  • Two of the email tools are required: Physical Mailing Address (Required) and Profile Center (Required). When the email is published to ExactTarget, these two email-tools are added to the bottom of every mail by default.

Adding Text and Personalization tool to your e-mail adding-text-and-personalization-tool-to-your-e-mail

You can add personalized fields in an email by adding the Text and Personalization component to the page:

  1. Open the e-mail to be published to your e-mail service.

  2. To enable personalization field from your email service, add the framework configuration while configuring the email service. See configuring Silverpop Engage and configuring Exact Target for more information.

  3. nAdd the component Text & Personalization from the sidekick. This component is the part of newsletter group. Open this component in the edit mode.

    chlimage_1-110

  4. Add the required personalized field to the text by selecting the field from the drop-down menu and clicking Insert.

  5. Click OK to finish.

Applying E-mail Service Configuration to E-mail Settings applying-e-mail-service-configuration-to-e-mail-settings

To apply your E-mail service configuration to a newsletter:

  1. Create an E-mail Service configuration.

  2. Open your email/newsletter.

  3. Open the email/newsletter settings by either clicking Settings or by clicking Page Properties in the sidekick.

  4. Click Add Service in Cloud Services tab. You see the list of services. Select your required configuration - either ExactTarget or Silverpop - from the list from the drop-down list.

    chlimage_1-5

  5. Click OK.

Publishing Emails to Email Service publishing-emails-to-email-service

Emails/Newsletters can be published to your E-mail Service by following these steps:

  1. Open the email.

  2. Before publishing a email, make sure you have applied the correct configuration to your email.

  3. Click Publish. This opens the Publish Newsletter To E-mail Service Provider window.

  4. Fill in the Newsletter Name field. The email/newsletter is published to E-mail Service Provider with this name. In case a email name is not provided, then the email is published using the page name of the newsletter in AEM.

  5. Click Publish.

    chlimage_1-6

    If successful, AEM confirms you can view the email in ExactTarget or Silverpop Engage.

    In the case of ExactTarget the published email can ve viewed by clicking View Published Email. This takes you directly to the published newsletter in the ExactTarget (https://members.exacttarget.com/.).

NOTE
If a email/newsletter is published with the same name as that of a email/newsletter already published, then the earlier email/newsletter is not replaced. Instead, a new email/newsletter is created with same name (the IDs of two newsletters are, however, different).
Publishing the email/newsletter to E-mail Service Provider also publishes the email/newsletter to the AEM publish instance.

Updating A Published E-mail updating-a-published-e-mail

The Update button on the Publish dialog box lets you update a newsletter already published to an E-mail Service Provider. In case the newsletter has not yet been published and the Update button is clicked, a Newsletter is not published message displays.

To update a published email:

  1. Open the email/newsletter that has previously been published to an e-mail service provider that you want to re-publish after making changes to the email/newsletter.

  2. Click Publish. The Publish Newsletter to Email Service Provider window displays. Click Update.

    To check if the email/newsletter has been updated on ExactTarget, click View Published Email. This takes you to the published email in ExactTarget.

    To check if the email/newsletter has been updated on Silverpop Email Service, visit the Silverpop Engage site.

recommendation-more-help
5955305e-451f-43a0-8168-b6ad4159b4ca