Skip to main content
The Attentive marketing source brings your Attentive SMS and email performance (sends, deliveries, opens, clicks, and attributed revenue) into Converge, so you can analyze it alongside your other marketing channels.

​
How it works

Attentive does not offer a reporting API, so Converge reads Attentive’s daily SFTP data feeds instead. Once your Attentive team enables them, Attentive drops two CSV files onto an SFTP server each day:
  • Conversions feed: one row per attributed purchase, used for revenue and conversions.
  • General Events feed: an event log of messaging engagement (sends, deliveries, opens, clicks, and more).
Converge imports each new file as Attentive publishes it. Attentive updates the feeds once per day, though the exact time varies, so your Attentive data refreshes daily. Events are grouped per message, and each Attentive message maps to a campaign in Converge. Attentive keeps a rolling 30 days of files, so Converge can backfill up to 30 days when you first connect.

​
Before you start

Connecting Attentive requires two one-time steps on the Attentive side.

​
1. Request the SFTP data feeds

Attentive needs to provision the SFTP feeds for you. Send the email below to your Attentive CSM (or to Attentive support), filling in the bracketed details.
Copy and edit the email below.
Subject: SFTP data feed setup - [Company]

Hi team,

We'd like to set up an SFTP data feed for our Attentive account to sync our
messaging performance into our analytics platform (Converge).

Account details:
- Company display name: [your company]
- Website: [yourdomain.com]
- Attentive account email: [your Attentive account email]

Could you please:
1. Create an SFTP account, and
2. Enable the daily Conversions and General Events data feeds.

CONVERSIONS FEED - columns:
- message_id
- message_name
- uuid
- amount
- timestamp

GENERAL EVENTS FEED - event types:
- MESSAGE_RECEIPT
- MESSAGE_LINK_CLICK
- EMAIL_PROCESSED
- EMAIL_DELIVERED
- EMAIL_MESSAGE_OPENED
- EMAIL_SOFT_BOUNCE
- EMAIL_HARD_BOUNCE
- EMAIL_DROPPED
- EMAIL_SPAM_REPORTED
- OPT_OUT

GENERAL EVENTS FEED - columns:
- type
- message_id
- message_name
- timestamp

Backfill: our system reads up to your 30-day retention window, so a 30-day
backfill on both feeds would be ideal.

Once the SFTP account is ready, please share the SFTP username and host; we'll
set the password from our Attentive settings.

Thanks!
[Your name]

​
2. Set your SFTP password

After Attentive creates the SFTP account, they will share your SFTP username. You set the password yourself from the Attentive SFTP account settings page. Keep the username and password handy for the next step. For more detail, see Attentive’s Connect to Attentive SFTP guide.

​
Set up the Marketing source

  1. Navigate to the Marketing Sources Tab in Converge, click Connect a new ad platform, and choose Attentive.
  2. Give your connection a name, e.g. Attentive | {Account name}.
  3. Enter your SFTP credentials:
    • SFTP Username: the username Attentive shared with you.
    • SFTP Password: the password you set in the Attentive SFTP settings page.
    • Currency: the currency your Attentive account reports in. The feed has no currency column, so Converge tags all synced revenue with this value.
  4. Press Create. Converge will connect to the feed and start syncing your Attentive data.
You do not need to enter an SFTP host. Converge uses Attentive’s standard host (sftp.client.attentivemobile.com) automatically. If Attentive gave you a non-standard host, contact your Converge representative.

​
Converge functionality

This integration supports the following Converge marketing source functionality.
Converge FeatureSupported
Sync FrequencyEvery day
Custom Conversions
Attentive’s data feed does not include billable spend, so spend based metrics such as ROAS and CPA are not available for this source. Converge ingests Attentive’s attributed revenue, conversions, and engagement metrics.

​
Supported metrics

We ingest a focused set of metrics that mirror the definitions you see in Attentive’s own reporting.
Sourced from the Conversions feed. These are the purchases Attentive attributes to your messaging.
MetricDescription
ConversionsThe number of purchases Attentive attributes to a message.
RevenueThe total revenue from purchases Attentive attributes to a message.
Sourced from the General Events feed. These count messaging engagement per message.
These are raw event counts, so they can read slightly higher than the unique, bot-filtered figures shown in Attentive’s own dashboard.
MetricDescription
Text message sendsThe number of SMS/MMS messages sent.
Email message sendsThe number of emails Attentive processed for sending.
Emails deliveredThe number of emails successfully delivered to the recipient.
Email opensThe number of times a delivered email was opened.
Link clicksThe number of times a tracked link in a message was clicked.
Soft bouncesThe number of emails that failed to deliver due to a temporary issue.
Hard bouncesThe number of emails that failed to deliver due to a permanent issue.
Emails droppedThe number of emails Attentive skipped sending (e.g. suppressed address).
Spam complaintsThe number of times a recipient reported an email as spam.
UnsubscribesThe number of times a recipient opted out.

​
FAQ

Attentive generates the feed files once per day, though the exact time varies. Converge imports the new file the same day, so your Attentive data updates once per day.
Attentive keeps a rolling 30 days of feed files, so Converge backfills up to 30 days of history when you first connect. Data older than 30 days is not available from the feed.
Converge counts every engagement event in the feed. Attentive’s dashboard typically shows unique, bot-filtered figures, so raw counts read slightly higher. Both are correct; they measure different things.
No. The Attentive feed does not include billable spend, so spend based metrics like ROAS and CPA are not available for this source. You still get attributed revenue, conversions, and engagement metrics.
Each Attentive message, whether a one-time campaign or an automated journey, maps to its own campaign in Converge. Metrics and revenue are grouped at the message level.