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

# Attentive Setup

> Connect Attentive's SFTP data feed so Northbeam can report sign-ups, visits, and revenue from your Attentive campaigns.

<span id="this-guide-will-show-you-how-to-set-up-tracking-for-the-following-attentive-metrics-in-northbeam" style={{ display: "block", scrollMarginTop: "7rem" }} />

When you're done, Northbeam shows the visits, revenue, and orders from your Attentive campaigns and flows, plus email and SMS sign-ups from Attentive's opt-in forms.

<Info>
  **Before you start**, make sure you have:

  * An Attentive login with access to the **Settings** tab
  * An **Attentive SFTP account**. If you don't have one, ask your Attentive Client Strategy Representative or Attentive's White Glove team ([whiteglove@attentivemobile.com](mailto:whiteglove@attentivemobile.com)).
</Info>

<span id="setup-steps" style={{ display: "block", scrollMarginTop: "7rem" }} />

<CardGroup cols={3}>
  <Card title="1. Connect the account" icon="plug" href="#connect-your-attentive-account">
    Set up an SFTP data feed and send Northbeam the login.
  </Card>

  <Card title="2. Add the sign-up event" icon="user-plus" href="#set-up-the-sign-up-event">
    See which channels drive your sign-ups.
  </Card>

  <Card title="3. Confirm tracking" icon="circle-check" href="#confirm-tracking">
    Check that parameters and data are arriving.
  </Card>
</CardGroup>

<Steps titleSize="h2">
  <Step title="Connect your Attentive account">
    <span id="step-1-create-an-attentive-sftp-account" style={{ display: "block", scrollMarginTop: "7rem" }} />

    Northbeam connects directly to [Attentive's SFTP data feed](https://docs.attentive.com/pages/developer-guides/sftp-solution/attentive-sftp-data-feeds/), so you need an Attentive SFTP account.

    **A. Check for an SFTP account**

    1. Log in to Attentive and open the **Settings** tab.
    2. Look for **SFTP Account Management**.

    If you don't see it, you don't have an SFTP account yet. Request one from your Attentive Client Strategy Representative or [whiteglove@attentivemobile.com](mailto:whiteglove@attentivemobile.com).

    <span id="step-2-create-permanent-password" style={{ display: "block", scrollMarginTop: "7rem" }} />

    **B. Create a permanent password**

    New accounts usually get a temporary password. Set a **permanent password** so the connection doesn't break when the temporary one expires. From [Attentive's docs](https://docs.attentive.com/pages/developer-guides/sftp-solution/connect-to-attentive-sftp/):

    1. Log in to Attentive and open the **Settings** tab.
    2. Select **SFTP Account Management**. If you don't see it, contact [whiteglove@attentivemobile.com](mailto:whiteglove@attentivemobile.com) or your CSM and ask them to create your SFTP account.
    3. Click **Reset SFTP Password**. This sends a reset request to Attentive.
    4. Follow the instructions in Attentive's email to enter a **Validation Code** and choose your new password.

    <span id="step-3-set-up-daily-logs" style={{ display: "block", scrollMarginTop: "7rem" }} />

    **C. Ask Attentive to send daily logs**

    Once your SFTP account exists, ask your Attentive Client Strategy Representative or [whiteglove@attentivemobile.com](mailto:whiteglove@attentivemobile.com) to turn on daily logs. You can use this email:

    > Hi there!
    >
    > Northbeam is a multi-touch attribution system that helps us understand our customers' digital journey. We are currently working with them and would love to integrate Attentive Mobile reporting into our analytics within their platform.
    >
    > We'd like to establish a SFTP data feed and would like the following events from the **General Events data feed**:
    >
    > Daily logs for the following Attentive Mobile events:
    >
    > * JOIN
    > * IMPRESSION
    > * CLICK
    > * MESSAGE\_RECEIPT
    > * MESSAGE\_LINK\_CLICK
    > * SUBSCRIPTION\_OPTED\_OUT
    > * PURCHASE
    >
    > Let me know if there's any more information you need for us!

    <span id="step-4-submit-your-attentive-sftp-credentials" style={{ display: "block", scrollMarginTop: "7rem" }} />

    **D. Enter your SFTP login in Northbeam**

    After the data feed is set up, add your SFTP credentials (an email address and password):

    1. Open [Connections](https://dashboard.northbeam.io/settings/connections).
    2. Scroll down to **Attentive**.
    3. Enter your **Username and Password**.
    4. Click **Connect**.

    <Frame caption="Settings > Connections > Attentive">
      <img src="https://mintcdn.com/northbeam/EpMPeQ8Ec2Yrg9EI/images/readme/7e243926-Screen_Shot_2024-12-20_at_9.14.05_AM.png?fit=max&auto=format&n=EpMPeQ8Ec2Yrg9EI&q=85&s=bc388e0e1f05832817b2e31bdfb19658" alt="Northbeam Connections page with Attentive username and password fields" style={{ maxWidth: "560px", maxHeight: "440px", width: "auto", height: "auto", margin: "0 auto" }} width="840" height="340" data-path="images/readme/7e243926-Screen_Shot_2024-12-20_at_9.14.05_AM.png" />
    </Frame>

    **If you skip this step:** sign-up volume is missing and the related metrics stay empty.
  </Step>

  <Step title="Set up the sign-up event">
    <span id="step-5-implement-sign-up-event" style={{ display: "block", scrollMarginTop: "7rem" }} />

    The connection pulls in raw sign-up events. To see which channels drove them (for example, "Facebook Ads drove X sign-ups"), place one of these on your site:

    | Type | Details |
    | :- | :- |
    | [Sign Up Event - Email](/docs/setting-up-klaviyo-for-northbeam) | Events show under the default metric **Email Sign Up**. |
    | [Custom Goal Event](/docs/setting-up-custom-goals) | Events show under a custom metric with any name you choose. |

    **If you skip this step:** sign-ups show as Unattributed.
  </Step>

  <Step title="Confirm tracking">
    For a full check:

    * **Parameters captured:** follow [Checking UTM tracking](/docs/checking-utm-tracking) to confirm UTM parameters reach your landing pages.
    * **Connection syncing:** follow [Checking platform connections](/docs/checking-api-connections) to confirm the account shows as connected and data is arriving.

    If a check fails, see [Troubleshooting Northbeam data](/docs/troubleshooting-tracking-issues).
  </Step>
</Steps>

## UTMs and spend

**UTM parameters (required):** Attentive doesn't need special Northbeam parameters. Use the standard `utm_source`, `utm_medium`, and `utm_campaign` on your Attentive links, with any values you like. If they're missing, visits and revenue aren't attributed to your Attentive campaigns.

**Spend (optional):** Northbeam doesn't import Attentive spend. To get cost-based metrics like ROAS and CAC, upload your costs with a [Custom Spendsheet](/docs/tracking-for-other-platforms#step-2-upload-costs-via-custom-spend). Without it, no costs are tied to Attentive.

## Need help?

<CardGroup cols={2}>
  <Card title="Attentive FAQ" icon="circle-question" href="/docs/channels/attentive/faq">
    Common Attentive setup and reporting questions.
  </Card>

  <Card title="Troubleshooting Northbeam data" icon="wrench" href="/docs/troubleshooting-tracking-issues">
    Start here if a check above fails.
  </Card>
</CardGroup>