Proper configuration of your Campaign Studio instance is important for branding, performance, and the user experience of your team working in the instance.
These global settings are generally permanent after initial configuration.
Mautic’s root URL: When a user signs in to their Campaign Studio instance, they go to customdomain.domain.com (the root URL). That page is accessible to the public. If a contact visits the root address, they see the Campaign Studio login page for the instance. Create a Campaign Studio landing page to greet contacts visiting your root URL.
Once you’ve done that, users can sign in to Campaign Studio by visiting https://customdomain.domain.com/s/login.
Campaign Studio10.Default timezone: The users’ default time zone, typically set to the time zone of the company headquarters. Time zones can be set for individual users. The default is UTC.
For example: Headquarters is in Boston and the default is set to US Eastern Time (America New York). A user in San Francisco (US Pacific Time America Los Angeles) can display Pacific Time in the user interface.
English - United States by default.10 minutes as the default.1 Month.Cross-Origin Resource Sharing (CORS) enables data to pass between your website and Campaign Studio.
Valid Domains: A list of domains allowed to communicate with your Campaign Studio instance. In the text box, list the exact URL of the top level domain you want to enable, one per line. For example: https://www.acquia.com tracks any activity on acquia.com pages, but http://www.acquia.com won’t because acquia.com is a secure website.
In the Valid Domains field, don’t include a slash at the end. For example, use https://www.acquia.com instead of https://www.acquia.com/.
URL Shortener: If you use a URL shortening service like bit.ly for links in SMS messages, enter your access token here. For bit.ly, use:
https://api-ss..bitly.com/v3/shorten?access_token=[ACCESS_TOKEN]&format=txt&longUrl0 seconds.To use the API functionality in Campaign Studio, do the following:
Access token lifetime: When authorizing a new application or integration, limits how long the access token is valid (in minutes). The default is 60 minutes.
For example: You add a new integration to your SaaS platform. Enter 30 here to limit the access token validity to 30 minutes. If you haven’t completed the authentication in that period of time, you must revalidate.
Refresh token lifetime: When using OAuth 2.0, the lifetime of the refresh token used to request a new access token once expired. Once the refresh token expires, you must reauthorize. The default is 14 days.
In Settings > API Credentials, configure the API credentials.
Full API documentation is available here.
Name to send mail as: The default name emails come from. This is typically something like {YourCompany} Marketing Team or {YourCompany}.
This field supports tokens. For more information, see Advanced in Email Basics.
Email address to send mail from: The email address for the name you’re sending mail from. The address displays in the From: field when your contacts receive your emails.
This field supports tokens. The sender domain used must be configured and verified. For more information, see Advanced in Email Basics.
Ensure that you configure your sender domain, DKIM, bounce, and click tracking domains. For more information, see email domains document.
Mautic is the default setting to route your emails through the Campaign Studio Sparkpost account. However, if you are sending emails through your own email service, select the service and enter your credentials. For more information, see Configuring your own email transport.Campaign Studio provides an option to pause email communication for a defined time and date range. This option is applicable to segment emails, and "Send Email to Contacts" and "Send Marketing Message" campaign events.
Text for the {webview_text} token: The message indicating the reader can view the email in their browser. The default is:
Having trouble reading this email? Click here.
To change the text, change the message between the ``<a href="|URL|">`` and
``</a>`` tags. Don't change the ``|URL|`` text, because that is a token for
each contact.Configure the following fields to ensure that your contacts can see your preference center landing page.
Options toggled to No do not display on preference centers pages even if the preference center includes a slot for the option.
Text for the {unsubscribe_text} token: Change a basic
Unsubscribe link to a personalized message. For example, Update your contact preferences or Do not want to hear from us anymore? Click here.
Edit between the anchor (<a href=|URL|"> </a>) tags. The URL is a token, so do not change it. To use custom text on an email, hyperlink the text with the {unsubscribe_url} token as the link.
Unsubscribed and resubscribed confirmation message: If a contact
unsubscribes or resubscribes, the message in this field displays on the page after the respective action.
Note
Do not edit the |EMAIL| or |URL| tokens in the <a href> tag.
Show contact preference settings: When set to Yes, the
unsubscribe link directs the user to the preference center.
If this option is set to Yes and a contact clicks the Unsubscribe link, the contact will see the preference center that is created and configured for the email from which the contact clicked the Unsubscribe link. If no preference center is configured for that email, the contact will see a default preference center page. The configuration option for default theme determines the styling of the default preference center page.
If this option is set to No, contacts who click the Unsubscribe link in an email see a page with the Unsubscribed confirmation message.
Show contact segment preferences: Toggle the setting to Yes to
enable a contact to change which segments they are part of on the preference center page. Segments display on the preference center page if they are published and public.
Show contact frequency preferences: Toggle the setting to Yes
to enable an individual to limit the number of marketing messages they receive on each channel from the preference center.
Show pause contact preferences: When set to Yes, a contact can
disable messages from your Campaign Studio account to their email address for a specified date range. This is not a full unsubscribe. At the end of the date range the messages resume sending to the contact.
Show contact’s categories: If you have categories set for contacts,
campaigns, emails, etc., and set this option to Yes, the contact can opt out of the categories they choose from the preference center page.
Show contact’s preferred channel option: If you have multiple channels
available in your Campaign Studio account (email, SMS, mobile push, web notifications, etc.), contacts may choose their preferred channel. This can be useful when using the Marketing Messages Marketing Messages feature of Campaign Studio.
Do not accept submission from these domain names: To block contacts with specific email domains from submitting your forms, enter those domains in the dialog box. Select an option on each form you want to apply this block to. You can restrict either specific email aliases that belong to a domain or an entire domain. To block the entire domain, you can use wildcards (*). For more information, see Blocking domains from submitting forms.
If a campaign or webhook is automatically unpublished because of a high volume of errors, Campaign Studio sends a notification alerting users.
Tracking code: Insert this code on any page you would like to have tracked in Campaign Studio before the ending </body> tag.
The default tracking code provided in a new instance updates and changes after you set up a new custom domain or when you make changes to an existing one. You must use the new tracking code that reflects the new or edited custom domain. If you are using the plugin for WordPress, Drupal, or Joomla, re-enter your account information in the plugin.
Multiple tracking scripts can be implemented on one website to send data across multiple instances. For each instance where you want to send data, make the following changes in the script:
"First Name",``”Last Name”,””, ``"some text".Enter the names of the attributes the configured IDP uses for the Campaign Studio user fields. Match the field name from your identity provider to the field name Campaign Studio uses for user creation.
Use a custom X.509 certificate and private key to secure communication between Campaign Studio and the IDP. Upload your:
For more information, see SAML Single Sign On (SSO).
You can use an OpenID Connect provider to set up single sign-on (SSO) and multi-factor authentication (MFA) for authorization and authentication of users through external providers.
For more information, see OpenID Connect.
Campaign Studio provides integration with Acquia DAM so you can use Acquia DAM assets in your emails and landing pages.
In the Subdomain field, enter only the name of the subdomain of your DAM account. For example, if your subdomain is https://mysubdomain.com, then only enter mysubdomain in the Subdomain field.
For more information, see: What URL options are available for my Acquia DAM site?. If you do not know the subdomain of your DAM account, contact your DAM account manager or create a Support ticket.
Configuring a new subdomain does not affect the images that are already added to emails or landing pages through the previously-configured subdomain. However, to add images through the new subdomain, you must log in to the newly configured DAM.
If this content did not answer your questions, try searching or contacting our support team for further assistance.
Proper configuration of your Campaign Studio instance is important for branding, performance, and the user experience of your team working in the instance.
These global settings are generally permanent after initial configuration.
Mautic’s root URL: When a user signs in to their Campaign Studio instance, they go to customdomain.domain.com (the root URL). That page is accessible to the public. If a contact visits the root address, they see the Campaign Studio login page for the instance. Create a Campaign Studio landing page to greet contacts visiting your root URL.
Once you’ve done that, users can sign in to Campaign Studio by visiting https://customdomain.domain.com/s/login.
10.Default timezone: The users’ default time zone, typically set to the time zone of the company headquarters. Time zones can be set for individual users. The default is UTC.
For example: Headquarters is in Boston and the default is set to US Eastern Time (America New York). A user in San Francisco (US Pacific Time America Los Angeles) can display Pacific Time in the user interface.
English - United States by default.10 minutes as the default.1 Month.Cross-Origin Resource Sharing (CORS) enables data to pass between your website and Campaign Studio.
Valid Domains: A list of domains allowed to communicate with your Campaign Studio instance. In the text box, list the exact URL of the top level domain you want to enable, one per line. For example: https://www.acquia.com tracks any activity on acquia.com pages, but http://www.acquia.com won’t because acquia.com is a secure website.
In the Valid Domains field, don’t include a slash at the end. For example, use https://www.acquia.com instead of https://www.acquia.com/.
URL Shortener: If you use a URL shortening service like bit.ly for links in SMS messages, enter your access token here. For bit.ly, use:
https://api-ss..bitly.com/v3/shorten?access_token=[ACCESS_TOKEN]&format=txt&longUrl0 seconds.To use the API functionality in Campaign Studio, do the following:
Access token lifetime: When authorizing a new application or integration, limits how long the access token is valid (in minutes). The default is 60 minutes.
For example: You add a new integration to your SaaS platform. Enter 30 here to limit the access token validity to 30 minutes. If you haven’t completed the authentication in that period of time, you must revalidate.
Refresh token lifetime: When using OAuth 2.0, the lifetime of the refresh token used to request a new access token once expired. Once the refresh token expires, you must reauthorize. The default is 14 days.
In Settings > API Credentials, configure the API credentials.
Full API documentation is available here.
Name to send mail as: The default name emails come from. This is typically something like {YourCompany} Marketing Team or {YourCompany}.
This field supports tokens. For more information, see Advanced in Email Basics.
Email address to send mail from: The email address for the name you’re sending mail from. The address displays in the From: field when your contacts receive your emails.
This field supports tokens. The sender domain used must be configured and verified. For more information, see Advanced in Email Basics.
Ensure that you configure your sender domain, DKIM, bounce, and click tracking domains. For more information, see email domains document.
Mautic is the default setting to route your emails through the Campaign Studio Sparkpost account. However, if you are sending emails through your own email service, select the service and enter your credentials. For more information, see Configuring your own email transport.Campaign Studio provides an option to pause email communication for a defined time and date range. This option is applicable to segment emails, and "Send Email to Contacts" and "Send Marketing Message" campaign events.
Text for the {webview_text} token: The message indicating the reader can view the email in their browser. The default is:
Having trouble reading this email? Click here.
To change the text, change the message between the ``<a href="|URL|">`` and
``</a>`` tags. Don't change the ``|URL|`` text, because that is a token for
each contact.Configure the following fields to ensure that your contacts can see your preference center landing page.
Options toggled to No do not display on preference centers pages even if the preference center includes a slot for the option.
Text for the {unsubscribe_text} token: Change a basic
Unsubscribe link to a personalized message. For example, Update your contact preferences or Do not want to hear from us anymore? Click here.
Edit between the anchor (<a href=|URL|"> </a>) tags. The URL is a token, so do not change it. To use custom text on an email, hyperlink the text with the {unsubscribe_url} token as the link.
Unsubscribed and resubscribed confirmation message: If a contact
unsubscribes or resubscribes, the message in this field displays on the page after the respective action.
Note
Do not edit the |EMAIL| or |URL| tokens in the <a href> tag.
Show contact preference settings: When set to Yes, the
unsubscribe link directs the user to the preference center.
If this option is set to Yes and a contact clicks the Unsubscribe link, the contact will see the preference center that is created and configured for the email from which the contact clicked the Unsubscribe link. If no preference center is configured for that email, the contact will see a default preference center page. The configuration option for default theme determines the styling of the default preference center page.
If this option is set to No, contacts who click the Unsubscribe link in an email see a page with the Unsubscribed confirmation message.
Show contact segment preferences: Toggle the setting to Yes to
enable a contact to change which segments they are part of on the preference center page. Segments display on the preference center page if they are published and public.
Show contact frequency preferences: Toggle the setting to Yes
to enable an individual to limit the number of marketing messages they receive on each channel from the preference center.
Show pause contact preferences: When set to Yes, a contact can
disable messages from your Campaign Studio account to their email address for a specified date range. This is not a full unsubscribe. At the end of the date range the messages resume sending to the contact.
Show contact’s categories: If you have categories set for contacts,
campaigns, emails, etc., and set this option to Yes, the contact can opt out of the categories they choose from the preference center page.
Show contact’s preferred channel option: If you have multiple channels
available in your Campaign Studio account (email, SMS, mobile push, web notifications, etc.), contacts may choose their preferred channel. This can be useful when using the Marketing Messages Marketing Messages feature of Campaign Studio.
Do not accept submission from these domain names: To block contacts with specific email domains from submitting your forms, enter those domains in the dialog box. Select an option on each form you want to apply this block to. You can restrict either specific email aliases that belong to a domain or an entire domain. To block the entire domain, you can use wildcards (*). For more information, see Blocking domains from submitting forms.
If a campaign or webhook is automatically unpublished because of a high volume of errors, Campaign Studio sends a notification alerting users.
Tracking code: Insert this code on any page you would like to have tracked in Campaign Studio before the ending </body> tag.
The default tracking code provided in a new instance updates and changes after you set up a new custom domain or when you make changes to an existing one. You must use the new tracking code that reflects the new or edited custom domain. If you are using the plugin for WordPress, Drupal, or Joomla, re-enter your account information in the plugin.
Multiple tracking scripts can be implemented on one website to send data across multiple instances. For each instance where you want to send data, make the following changes in the script:
"First Name",``”Last Name”,””, ``"some text".Enter the names of the attributes the configured IDP uses for the Campaign Studio user fields. Match the field name from your identity provider to the field name Campaign Studio uses for user creation.
Use a custom X.509 certificate and private key to secure communication between Campaign Studio and the IDP. Upload your:
For more information, see SAML Single Sign On (SSO).
You can use an OpenID Connect provider to set up single sign-on (SSO) and multi-factor authentication (MFA) for authorization and authentication of users through external providers.
For more information, see OpenID Connect.
Campaign Studio provides integration with Acquia DAM so you can use Acquia DAM assets in your emails and landing pages.
In the Subdomain field, enter only the name of the subdomain of your DAM account. For example, if your subdomain is https://mysubdomain.com, then only enter mysubdomain in the Subdomain field.
For more information, see: What URL options are available for my Acquia DAM site?. If you do not know the subdomain of your DAM account, contact your DAM account manager or create a Support ticket.
Configuring a new subdomain does not affect the images that are already added to emails or landing pages through the previously-configured subdomain. However, to add images through the new subdomain, you must log in to the newly configured DAM.
If this content did not answer your questions, try searching or contacting our support team for further assistance.