Setup + Configuration

prerequisites before you can use the newsletter plugin, it needs to be activated by purple contact your project manager or customer success team to request activation of the newsletter plugin in your hub initial configuration 1\ access newsletter settings after the plugin is activated navigate to all settings in your purple hub look for the new entry called newsletters click to open the newsletter settings page 2\ configure service provider the newsletter plugin currently supports multiple email service providers, of which one can be selected each of them requires its own credentials to configure inxmail professional select inxmail professional from the service provider dropdown enter the following required credentials base url the endpoint where the inxmail professional api can be found client id your inxmail client identifier client secret your inxmail client secret key these credentials enable the newsletter module to interact with the inxmail professional api for sending newsletters to configure maileon select maileon from the service provider dropdown enter the following required credentials account name your maileon client identifier base url the endpoint where the maileon api can be found api key your maileon client secret key these credentials enable the newsletter module to interact with the maileon api for sending newsletters also configurable mailchimp activecampaign constant contact 3\ continue reading label this setting moved to the page post inserter block customization docid\ r3il7z av9dcvfg01mpyl 4\ save configuration after entering all required information, save your settings the system is now ready to create and send newsletters 5\ usage without configuring a service provider please note if you want to try out the newsletter plugin without selecting a service provider, please change the dropdown from ' select service provider ' to 'manual / other ' otherwise the layouts will not be displayed and certain functionality will not behave correctly newsletter width newsletters are 600 pixels wide by default if your layout needs more room — for example for teasers that place text next to an image — set a different value in the newsletter width field of the newsletter settings the width applies to every newsletter in the hub, both in the editor and in the sent email, so the editor keeps showing the same width the recipients get existing newsletters and saved layouts pick up the new width automatically, their content does not have to be touched good to know the setting is hub wide it cannot be set per newsletter or per layout on narrow screens the newsletter is still scaled down to fit, so a larger width does not break display on mobile layouts that were designed for the previous width keep working, but blocks with an explicit pixel size — for example an image or a spacer set to a fixed width — are worth checking after the change inxmail unsubscribe link inxmail requires unsubscribe links to use a special link code (a so called doo link), for example \[%url\ verify opt out;https //your site com/unsubscribe successful;;;"unsubscribe newsletter"] this code cannot be entered as a link target in the editor directly instead, configure it once and use a placeholder in your newsletter content in the newsletter settings, paste the link code provided by inxmail into the inxmail unsubscribe link field and save in your newsletter (typically in the footer of your layout), select the text or button that should act as the unsubscribe link and set its link target to exactly \#newspack unsubscribe when the newsletter is sent to inxmail, this placeholder link is automatically replaced with the configured link code the preview and test emails already show the replaced link, so you can verify it before sending inxmail link click tracking by default, clicks on links inside a newsletter sent via inxmail do not show up in the inxmail click reports, because inxmail only counts clicks on links that use its own tracking syntax enable the enable inxmail link click tracking checkbox in the newsletter settings to have purple rewrite the links in the newsletter content into inxmail tracked links when the mailing is sent no configuration on the inxmail side is required which links are affected all regular links in the newsletter content, including links on buttons and images, are rewritten the unsubscribe link, internal anchor links, and mailto / tel links are left untouched in the inxmail reports, each tracked link is listed under a name if you do not set a name yourself, it is derived automatically from the link's url (the protocol is stripped, for example example com/article/my story ) very long urls are shortened to get a meaningful name instead of the url, set a name in report on the individual link in the newsletter editor this value is used as the link alias in the inxmail reporting exports, so campaigns can be evaluated without matching urls by hand to set it select the linked text in the newsletter and open the link menu click the pencil icon to edit the link enter the name into the name in report field at the bottom of the link menu and confirm with enter or by clicking outside the field good to know the field only appears when inxmail professional is the selected service provider and enable inxmail link click tracking is active the name is optional links without one keep the automatically derived url name quotes, semicolons and brackets are removed from the name, because inxmail uses them as separators, and the name is limited to 80 characters currently only text links can carry a name, not links on buttons or images maileon unsubscribe & online version links maileon provides ready made merge tags for the unsubscribe link and the online (web) version link unlike inxmail, you do not need to configure any code in the newsletter settings — you only link to the tag in your layout in your newsletter layout, select the text or button that should act as the link, then set its link target to one of \[\[unsubscribe]] — the recipient's personal unsubscribe link \[\[online version]] — a link to open the newsletter in the browser when the newsletter is sent, maileon automatically replaces each tag with the correct per recipient link open tracking is also added automatically, so you don't need to insert anything for it you might need to switch the block to "code editing" to insert such a placeholder as a link to help with this, insert a link with some other target first, then switch to code editor, and then replace the link href with the placeholder above in the editor preview these tags appear as plain text (for example \[\[unsubscribe]] ) and the links will not work yet — this is expected they only resolve once maileon sends the email, so always verify them with a real test send link management make sure to also set up frontend links in purple hub docid\ wz7w 0fokon0mlpxupgvv , so that the newsletter can use the correct links to published articles when sending an e mail that contains links