Spotler Mail+

A Spotler Mail+ integration sends mailing activity and contact data from Spotler Mail+ to SEINō. Use this page to connect an account and check which dimensions, metrics, and contact fields SEINō receives.

Supported mailing types

SEINō imports both regular mailings and messages sent by automations. The mailing type remains available as a campaign dimension.

Mailing type	Description
MAILING	A regular mailing in Spotler Mail+.
AUTOMATION	A message sent by a Mail+ automation.

What SEINō receives

SEINō combines Mail+ mailing interactions into the Campaigns dataset. Contact records are stored separately as daily contact history.

Dimensions

Campaign dimensions describe the mailing, message, and clicked link associated with each interaction.

Dimension	Description
Send date	The date when Mail+ sent the message.
Event date	The date when the interaction occurred.
Account	The account name entered when the integration was connected.
Mailing type	Whether the message belongs to a regular mailing or an automation.
Mailing name	The mailing name returned by Mail+.
Message name	The message name returned by Mail+.
Subject	The message subject line.
Preview	A link to the online version of the message.
Link ID	The Mail+ identifier for a clicked link.
Link name	The name assigned to a clicked link in Mail+.
Link URL	The destination URL of a clicked link.
UTM source	The utm_source value extracted from a clicked URL.
UTM medium	The utm_medium value extracted from a clicked URL.
UTM campaign	The utm_campaign value extracted from a clicked URL.
UTM term	The utm_term value extracted from a clicked URL.
UTM content	The utm_content value extracted from a clicked URL.
Day	The day component of the send date.
Week	The week component of the send date.
Month	The month component of the send date.
Year	The year component of the send date.
Year-week	The year and week grouping derived from the send date.

Metrics

Campaign metrics count the send, bounce, open, click, and unsubscribe activity returned by Mail+.

Metric	Description
Sent	Number of unique send events.
Delivered	Number of sent messages minus soft and hard bounces.
Opens	Number of unique open events.
Opens (%)	Unique opens as a percentage of delivered messages.
Clicks unique	Number of unique click events.
Clicks unique (%)	Unique clicks as a percentage of delivered messages.
Click to open (%)	Unique clicks as a percentage of unique opens.
Clicks all	Total click events, including repeated clicks.
Soft bounces	Number of unique soft-bounce events.
Soft bounces (%)	Soft bounces as a percentage of sent messages.
Hard bounces	Number of unique hard-bounce events.
Hard bounces (%)	Hard bounces as a percentage of sent messages.
Unsubscribes	Number of unsubscribes reported in the Mail+ mailing totals.
Unsubscribes (%)	Unsubscribes as a percentage of delivered messages.
Deliverability (%)	Delivered messages as a percentage of sent messages.

Contact fields

SEINō stores the following fields for each Mail+ contact snapshot.

Field	Description
id	The encrypted Mail+ contact ID.
created_at	When the contact was created in Mail+.
updated_at	When the contact was last changed in Mail+.
test_group	Whether the contact belongs to the Mail+ test group.
permissions	The combined numeric value of the contact’s enabled permissions.
channel_email	Whether the email channel is enabled for the contact.

Set up the integration

The Spotler Mail+ integration uses a consumer key and consumer secret to authenticate with the Mail+ REST API.

Create API credentials in Spotler Mail+

Create REST API credentials in your Mail+ account before connecting it to SEINō.

1. Create an integration in Spotler Mail+.
2. Copy its consumer key and consumer secret.
3. Store both values securely until you have added them to SEINō.

Spotler’s MailPlus REST API documentation explains how the credentials authenticate your Mail+ account.

Connect Spotler Mail+ to SEINō

Add the Mail+ credentials from your account to the integration settings in SEINō.

1. Open Settings → Integrations → Spotler Mail+ in your SEINō workspace.
2. Select Enable. Select Add account instead if another Mail+ account is already connected.
3. Enter an account name that identifies the Mail+ account in reports.
4. Enter the consumer key and consumer secret.
5. Select Confirm.

SEINō checks the credentials before saving the account. The account appears in the integration after the connection succeeds.

Refresh schedule

SEINō processes Spotler Mail+ event files approximately every three hours.

Limits and notes

• Mail+ provides send, bounce, open, and click events through separate interaction feeds. Unsubscribes come from the mailing totals.
• Mail+ does not identify machine opens or bot clicks in the data used by this integration.
• UTM dimensions are available only when the clicked URL contains the matching UTM parameter.
• SEINō matches events to messages using the available mailing details. Reused or missing identifiers can affect that match.
• For an email-enabled contact without an external ID, SEINō writes the encrypted Mail+ contact ID to the external ID field. Existing external IDs remain unchanged.
• Contact snapshots are retained as history. A completed daily snapshot is not rewritten.

FAQ

Why did the Mail+ connection fail?

Check that the consumer key and consumer secret belong to the same active Mail+ integration. Enter both values again, then select Confirm.

Why does the account appear without campaign data?

Campaign data appears after SEINō imports mailing interactions. Check again after the next refresh. Contact support@seino.ai if the account remains empty.

Why did a contact receive an external ID?

SEINō uses the encrypted Mail+ contact ID when an email-enabled contact has no external ID. SEINō does not replace an existing external ID.