# FactorsAI


[FactorsAI](https://www.factors.ai/) is a marketing analytics and attribution platform. It collects and processes all data across your customer journeys to help you make smart business decisions.

Find the open source code for this destination in the [GitHub repository](https://github.com/rudderlabs/rudder-transformer/tree/main/src/v0/destinations/factorsai).

## Connection compatibility

{{< destination-config >}}

## Get started

Once you have confirmed that the source platform supports sending events to FactorsAI, follow these steps:

1. From your [RudderStack dashboard](https://app.rudderstack.com/), add the source. Then, from the list of destinations, select **Factors AI**.
2. Assign a name to your destination and click **Continue**.

## Connection settings

To successfully configure FactorsAI as a destination, you will need to configure the following settings:

- **API Key**: Enter the FactorsAI API Key. For more information on obtaining your FactorsAI API key, refer to the [FAQ]({{< ref "#faq" >}}) section below.

## Identify

You can use the [`identify`]({{< ref "event-spec/standard-events/identify.md" >}}) call to create or update a user in FactorsAI. RudderStack uses the `userId` field to perform these actions. 

A sample `identify` call is shown below:

```javascript
rudderanalytics.identify('1hKOmRA4e', {
  email: 'alex@example.com'
});
```

## Track

You can use the [`track`]({{< ref "event-spec/standard-events/track.md" >}}) call to capture user events and their associated properties, and send this information to FactorsAI.

A sample `track` call is shown below:

```javascript
rudderanalytics.track("Product Reviewed", {
  review_id: "12345",
  product_id: "123",
  rating: 4.0,
  review_body: "Good product."
})
```

## Page

The [`page`]({{< ref "event-spec/standard-events/page.md" >}}) event lets you record your website's page views with any additional relevant information about the viewed page.

A sample `page` call sent using RudderStack's JavaScript SDK:

```javascript
rudderanalytics.page("Home")
```

## Group

The [`group`]({{< ref "event-spec/standard-events/group.md" >}}) call lets you link an identified user to a group like a company, organization, or an account.

A sample `group` call is shown below:

```javascript
rudderanalytics.group("sample-group-id", {
  name: "Example Company",
  employees: 1000,
  industry: "Software"
});
```

## FAQ 

#### Where can I get the FactorsAI API key?

To get your FactorsAI API key:

1. Log in to your [FactorsAI dashboard](https://app.factors.ai/).
2. Click the menu button in the left corner and go to **Settings** > **Integrations**.
3. From the integrations list, select **RudderStack**  to generate the API key:

{{< image src="images/event-stream-destinations/factorsai-api-key.webp" alt="FactorsAI API key" >}}