> ## Documentation Index
> Fetch the complete documentation index at: https://docs.runconverge.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Attentive

> An introduction to the Attentive marketing source

export const Icon = ({name}) => {
  return <div className="h-4 w-4 fill-gray-800 dark:fill-gray-100 text-gray-800 dark:text-gray-100 inline-block align-middle">
            <svg className="w-4 h-4 bg-gray-800 dark:bg-gray-100" style={{
    maskImage: `url('https://mintlify.b-cdn.net/v6.5.1/solid/${name}.svg')`,
    maskRepeat: "no-repeat",
    maskPosition: "center center"
  }} />
        </div>;
};

<Note>
  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.
</Note>

## 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](mailto:whiteglove@attentivemobile.com)), filling in the bracketed details.

<Note>Copy and edit the email below.</Note>

```text theme={null}
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](https://ui.attentivemobile.com/settings/sftp-account-settings).

Keep the username and password handy for the next step. For more detail, see Attentive's [Connect to Attentive SFTP guide](https://docs.attentive.com/pages/developer-guides/sftp-solution/connect-to-attentive-sftp/).

***

## Set up the Marketing source

1. Navigate to the [Marketing Sources Tab](https://app.runconverge.com/-/ad-platforms) 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.

<Note>
  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.
</Note>

***

## Converge functionality

This integration supports the following Converge marketing source functionality.

| Converge Feature   | Supported             |
| ------------------ | --------------------- |
| Sync Frequency     | Every day             |
| Custom Conversions | <Icon name="check" /> |

<Note>
  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.
</Note>

***

## Supported metrics

We ingest a focused set of metrics that mirror the definitions you see in Attentive's own reporting.

<AccordionGroup>
  <Accordion icon="cart-shopping" title="Revenue and Conversions">
    Sourced from the **Conversions feed**. These are the purchases Attentive attributes to your messaging.

    | Metric          | Description                                                         |
    | --------------- | ------------------------------------------------------------------- |
    | **Conversions** | The number of purchases Attentive attributes to a message.          |
    | **Revenue**     | The total revenue from purchases Attentive attributes to a message. |
  </Accordion>

  <Accordion icon="comment-sms" title="Engagement metrics">
    Sourced from the **General Events feed**. These count messaging engagement per message.

    <Note>
      These are raw event counts, so they can read slightly higher than the unique,
      bot-filtered figures shown in Attentive's own dashboard.
    </Note>

    | Metric                  | Description                                                               |
    | ----------------------- | ------------------------------------------------------------------------- |
    | **Text message sends**  | The number of SMS/MMS messages sent.                                      |
    | **Email message sends** | The number of emails Attentive processed for sending.                     |
    | **Emails delivered**    | The number of emails successfully delivered to the recipient.             |
    | **Email opens**         | The number of times a delivered email was opened.                         |
    | **Link clicks**         | The number of times a tracked link in a message was clicked.              |
    | **Soft bounces**        | The number of emails that failed to deliver due to a temporary issue.     |
    | **Hard bounces**        | The number of emails that failed to deliver due to a permanent issue.     |
    | **Emails dropped**      | The number of emails Attentive skipped sending (e.g. suppressed address). |
    | **Spam complaints**     | The number of times a recipient reported an email as spam.                |
    | **Unsubscribes**        | The number of times a recipient opted out.                                |
  </Accordion>
</AccordionGroup>

***

## FAQ

<AccordionGroup>
  <Accordion title="How often does the data update?">
    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.
  </Accordion>

  <Accordion title="How far back can I backfill?">
    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.
  </Accordion>

  <Accordion title="Why are my open and click numbers higher than in Attentive?">
    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.
  </Accordion>

  <Accordion title="Can I track spend or ROAS for Attentive?">
    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.
  </Accordion>

  <Accordion title="Which Attentive messages show up in Converge?">
    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.
  </Accordion>
</AccordionGroup>