Proper configuration is important for branding, performance, and the user experience for your team as they do their jobs. These 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
.
404 page: Select the page that you want to use as the 404 page. If you don’t want to use Campaign Studio’s default 404 error page, create a custom landing page and select that page here. If you don’t select any page, Campaign Studio uses the default error page.
Default item limit per page: The number of contacts, campaigns, emails,
etc. which each page when you go to an item section. The default is 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.
Default language: The initial language assigned to users. Individual
users may select their own settings. Campaign Studio uses English - United
States
by default.
Cached data timeout (minutes): Campaign Studio caches data to speed up
page loads. Update this setting to change how long Campaign Studio caches the
data. Campaign Studio uses 10 minutes
as the default.
Date Range Filter Default: Sets the default for how far
back from the current date Campaign Studio looks for data in reports
(including campaign and email snapshots reports on the item page. If you’ve
changed the setting on a report, Campaign Studio uses what you’ve entered.
Campaign Studio’s default value is 1 Month
.
Default format for full dates, date only, short dates, and time only: The defaults are set for standard US time format. See the PHP manual for date functions to change formats.
Cross-Origin Resource Sharing (CORS) enables data to pass between your website and Campaign Studio.
Restrict Domains: When set to No, any web page can pass information to Campaign Studio. Select Yes to limit communication with your Campaign Studio instance to websites listed in Valid Domains.
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.
Note
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/
.
IP lookup service: By default, Campaign Studio uses MaxMind GeoLite2 City to identify the city of a website visitor, based on the location of the Internet Service Provider (ISP) for their IP address.
IP lookup service authentication: To use another available IP lookup service, enter your credentials.
List of IPs not to track contacts with: To disable tracking for particular IP addresses, enter the addresses, one per line. Acquia doesn’t recommend adding your office IP address. If you list your internal IP address, Campaign Studio won’t track clicks, page hits, etc., from that IP, including testing clicks.
List of Bots to not track with: Campaign Studio has identified and disabled tracking for several known bots. To track activity from those bots, remove them from this list. To disable tracking for other bots, add them here (one per line).
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&longUrl
Item max lock time: When a user edits a campaign, email, landing page,
etc., Campaign Studio locks the item to prevent simultaneous edits by other
users. When the initial user saves and closes or cancels out, the item may
remain locked for this period of time. The default is 0 seconds
.
Translate page titles: To translate page titles from non-Latin (non-English) characters to Latin characters (English).
Full API documentation is available here.
API enabled: Select Yes to pass data in and out of Campaign Studio through the API.
Enable HTTP basic auth?: Enables basic authentication for Campaign Studio’s API. Acquia recommends only using with secure sites (HTTPS).
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.
Name to send mail as: The default name emails come from. This is typically
something like {YourCompany}
Marketing Team or {YourCompany}
.
Note
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.
Note
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.
Reply to address: To have contacts reply to a different address than the address defined in Email address to send mail from, add the desired address to receive replies. This is the default address where messages are sent whenever contacts reply to messages sent from Campaign Studio. If this field is blank, the address specified in Email address to send mail from is used. This is useful if your configured sender domain, which you use in the from address, contains a subdomain that does not have MX records or is otherwise an address that cannot receive emails.
Mailer is owner: If contacts in Campaign Studio have Owners, select Yes to display the owner as sending all emails to the contacts they’re listed as the owner for. Mailer is owner overrides any other name or email to send mail from, including the default and individual emails. Every contact owner’s domain must have SPF and DKIM records. You can see this configuration for individual emails, rather than globally. See Mailer is owner.
Service to send mail through: For most Campaign Studio subscribers, this
should remain set to Mautic
. Your emails route through the Campaign Studio
Sparkpost account. If you are sending through your own email service, select
the service and enter your credentials. See
Configuring your own email transport.
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.
Text for the {unsubscribe_text} token: Like the {webview_text}
token,
customize the Unsubscribe link. For example:
Edit between the <a href="|URL|">
and </a>
tags. Don’t change the URL
as it is tokenized. If you add {unsubscribe_url}
as a token in the email,
you won’t see this text.
Unsubscribed and resubscribed confirmation message: If a contact
unsubscribes or resubscribes, this message displays on the page after the
respective action. Don’t edit the |EMAIL|
or the |URL|
token in the
<a href>
tag.
Show contact preference settings: Select Yes to direct the unsubscribe link to your configured preference center. If you haven’t created a preference center, Campaign Studio creates a default page based on the next 5 settings. The created page uses the default theme for styling.
Show contact segment preferences: Select Yes to enable a contact to change which segments they’re part of on the preference center page. Segments won’t display on the preference center page if they aren’t published and public.
Show contact frequency preferences: Select 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: Select Yes to enable contacts to disable messages from your Campaign Studio account to their email address for a specified date range. This action isn’t a full unsubscribe, and at the end of the date range, the message is sent to that address once again.
Show contact’s categories: If you have categories set for contacts, campaigns, emails, etc., select Yes to enable the contact to opt out of the categories they choose from the preference center page.
Show contact’s preferred channel option: If you have multiple channels available within your Campaign Studio account (email, SMS, mobile push, web notifications, etc.), contacts can choose their preferred channel. This can be useful if you are using the Marketing Messages feature of Campaign Studio. For more information about the preference center, see Preference centers.
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.
Note
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.
Identify visitor by tracking URL: Select Yes to have Campaign Studio begin tracking a contact after the contact clicks a link in an email on a device where no cookie exists.
Anonymize IP: Select Yes to not store full IP addresses for your visitors/contacts. This setting aids customers in achieving GDPR compliance.
Do Not Track 404 error for anonymous contacts Select Yes to not track page hits on any 404 error page tracked by the tracking code. This option helps prevent bots tracking.
Note
"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:
Social settings¶