Publishing an Email from AEM to Email Service Providers Silverpop & ExactTarget

Solution:

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.

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 http://:/cf#/content/campaigns/geometrixx-outdoors/e-mails.html.

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

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

Authoring an email 

Adding ExactTarget Email Tools to your email

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

• Open an email to be published to ExactTarget.
• Add the component ET - Email Tools to your page using the sidekick. Open the component in Edit mode.

• 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.

• 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

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

• Open the e-mail to be published to your e-mail service.
• Add the component Text & Personalization from the sidekick. This component is the part of newsletter group. Open this component in the edit mode.

• Add the required personalized field to the text by selecting the field from the drop-down menu and clicking Insert.
• Click OK to finish.

Applying E-mail Service Configuration to E-mail Settings


To apply your E-mail service configuration to a newsletter:
• Create an E-mail Service configuration. 
• Open your email/newsletter.
• Open the email/newsletter settings by either clicking Settings or by clicking Page Properties in the sidekick.  
• 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.



• Click OK. 
Publishing Emails to Email Service


Emails/Newsletters can be published to your E-mail Service by following these steps:
• Open the email.
• Before publishing a email, make sure you have applied the correct configuration to your email.
• Click Publish. This opens the Publish Newsletter To E-mail Service Provider window. 
• 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. 





• Click Publish. 

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

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


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: 




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.




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.

AEM Integrating with Silverpop Engage

Solution : AEM with Silverpop integration

Pre-requisite:

Note:

Silverpop integration is not available out of the box. You must download the Silverpop integration package from Package Share and install it on your instance. After you have installed the package

The integration provides you with the following features:

• The ability to create/manage/ Emails in AEM and publish them to Silverpop for distribution.
• The ability to set action of a AEM form to create an Silverpop subscriber.

Publishing Newsletters to an Email Service.

After Silverpop Engage is configured, you can publish newsletters or emails to Silverpop Engage. See Publishing Newsletters to an Email Service.

https://helpx.adobe.com/experience-manager/6-4/sites/classic-ui-authoring/using/classic-personalization-campaigns-email-newsletters.html

Different ways to add Silverpop Configuration to AEM

Silverpop configurations can be added via 

1. Cloudservices, 

2. Tools, or 

3. API end points. All methods are described in this section.

1. Configuring Silverpop via Cloudservices

To create a Silverpop configuration in Cloud Services:

• In AEM, tap or click Tools > Deployment > Cloud Services. (Or directly access at http://:/etc/cloudservices.html.)

• Under third-party services, click Silverop Engage and then Configure. The Silverpop configuration window opens.

• Enter a title and optionally, a name and click Create. The Silverpop Settings configuration window opens.
• Enter the username, password and select an API endpoint from the dropdown list.

• Click Connect to Silverpop. When you have successfully connected you see a success dialog. Click OK to exit the window. You can go to Silverpop by clicking Go to Silverpop Engage. 

• Silverpop has been configured. You can edit the configuration by clicking Edit. 

• Additionally, Silverpop Engage framework can be configured for personalized actions by providing title and name (optional). Click Create will successfully create the framework for the already configured Silverpop connection.
• Imported data extension columns can later be used through the AEM component - Text and Personalization.

2. Configuring Silverpop via Tools

• To create a Silverpop configuration in Tools:

In AEM, tap or click Tools > Deployment > Cloud Services. Or navigate there directly by going to http://:/misadmin#/etc.

• Select Tools, then Cloud Services Configurations, then Silverpop Engage.

• Click New to open the Create Page window.

• Enter the Title and optionally the Name, and click Create.

• Enter the configuration information as outlined in step 4 in the previous procedure. Follow that procedure to finish configuring Silverpop.

 Adding multiple configurations

• To add multiple configurations:

On the welcome page, click Cloud Services and click Silverpop Engage. Click on Show Configurations button which appears if one or more Silverpop configurations is available. All available configurations are listed.

• Click the + sign next to Available configurations. This opens the Create Configurations window. Follow the previous configuration procedure to create a new configuration.

3. Configuring API end points for connecting to Silverpop

• Currently, AEM has six unsecured end points (Engage 1 to 6). Silverpop now provides two new end points as well as changed connection end points for the existing ones.
• To configure the API end points :

Go to /libs/mcm/silverpop/components/silverpoppage/dialog/items/general/items/apiendpoint/options node on http://:/crxde.

• Right-click and select Create, then Create Node.

• Enter the Name as sp-e0 and choose Type as cq:Widget.

• Add two properties to the newly added node:

1. Name: text, Type: String, Value: Engage 0
2. Name: value, Type: String, Value: https://api0.silverpop.com

• Click on "Save All" button.

• Create one more node with Name as sp-e7 and Type as cq:Widget.
•    Add two properties to the newly added node:

1. Name: text, Type: String, Value: Pilot
2. Name: value, Type: String, Value: https://apipilot.silverpop.com/XMLAPI

To change the existing API End points (Engage 1 to 6), click each of them one-by-one and replace the values as follows:




Node Name	Exisiting End Point Value	New End Point Value
sp-e1	http://api.engage1.silverpop.com/XMLAPI	https://api1.silverpop.com
sp-e2	http://api.engage2.silverpop.com/XMLAPI	https://api2.silverpop.com
sp-e3	http://api.engage3.silverpop.com/XMLAPI	https://api3.silverpop.com
sp-e4	http://api.engage4.silverpop.com/XMLAPI	https://api4.silverpop.com
sp-e5	http://api.engage5.silverpop.com/XMLAPI	https://api5.silverpop.com
sp-e6	http://api.pilot.silverpop.com/XMLAPI	https://api6.silverpop.com

• Click Save All. AEM is now ready to connect to Silverpop over secured end points.