> For the complete documentation index, see [llms.txt](https://documentation.freshpaint.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.freshpaint.io/integrations/destinations/demand-side-platforms-dsps/simpli.fi-conversions-api-early-access/simpli.fi-quick-start-guide.md).

# Simpli.fi Quick Start Guide

This is a guide to help you get started on sending your conversion events to Simpli.fi via Freshpaint. If you've already completed set up and are looking for more information, see [Simpli.fi Reference](/integrations/destinations/demand-side-platforms-dsps/simpli.fi-conversions-api-early-access/simpli.fi-reference.md).

{% hint style="warning" %}
The Simpli.fi Conversions API destination is currently in Early Access. Please contact <support@freshpaint.io> for more information about this integration.
{% endhint %}

## Destination Info

* Supports [Track](/reference/developer/freshpaint-sdk-reference.md#track) calls
* Supports [HIPAA mode](/readme/hipaa-mode.md)
* Supports forwarding from the [Google Tag Manager Integration](/integrations/google-tag-manager-integration.md)
* Refer to this destination as **Simpli.fi** in the [Integrations object](/reference/developer/freshpaint-sdk-reference.md#using-the-integrations-object)
  * If you've configured multiple Pixel IDs, you can choose a specific one by suffixing the Pixel ID, such as: **Simpli.fi::123456.** You can retrieve this value from the Simpli.fi configuration page for the Pixel ID of interest.

{% hint style="info" %}
When no suffix is specified, all configured Pixel IDs are selected for inclusion / exclusion.
{% endhint %}

* Connection Modes:

<table><thead><tr><th width="200.33333333333331" align="right"></th><th data-type="checkbox">Client-side</th><th data-type="checkbox">Server-side</th></tr></thead><tbody><tr><td align="right">Web</td><td>false</td><td>true</td></tr><tr><td align="right">Mobile</td><td>false</td><td>true</td></tr><tr><td align="right">Server</td><td>false</td><td>true</td></tr></tbody></table>

## Getting Started

### What You'll Need

1. Your Simpli.fi audience key
2. Events in Freshpaint mapped to your Simpli.fi conversion audience

### Configure the Simpli.fi Conversions API destination in Freshpaint

1. Navigate to the [Freshpaint Destinations page](https://app.freshpaint.io/destinations/catalog).
2. Search for the Simpli.fi Conversions API destination.
3. Click Save on the Configuration row.
4. If you are a HIPAA account, it is highly recommended to set the Freshpaint allowlist for Simpli.fi to allow Freshpaint to forward the required properties. `audience_key` is required for all conversion events. `$sifi_transaction_id`, `$sifi_day`, and `$ip` are recommended for view-through attribution. `purchase_value_usd` and `purchase_order_id` are also recommended for e-commerce tracking.
5. Enable the [impression pixel](https://documentation.freshpaint.io/integrations/impression-pixel) for Simpli.fi. This enables Freshpaint to do view-through attribution within Freshpaint and report the conversion event to Simpli.fi. Then copy the `Pixel Configuration URL`. Click Save once you have set your preferred configuration options and copied the URL.
6. In your Simpli.fi account, navigate to the campaign(s) you wish to enable view-through tracking on and add the URL copied in step 5 to the impression tracking settings. This is required for view-through conversion tracking via Freshpaint. The URL that you paste in should look like:

`https://freshpaint-impression.com/pixel.png?env_id=<your-env-id>&dest_id=<your-dest-id>&$sifi_transaction_id={{transactionID}}&$sifi_day={{sifiDay}}`

7. Enable the Simpli.fi Conversions API destination.

Once you've followed the steps above you can start sending events to Simpli.fi Conversions API.

### Set Up in Simpli.fi

For each conversion event you want to track in Freshpaint, you will need to create a corresponding Conversion Audience in Simpli.fi.

1. Log in to your Simpli.fi account and open the First-Party Audiences screen.
2. Click **New Audience → Freshpaint Conversion** from the dropdown menu.
3. In the dialog window that opens:
   1. Name the conversion audience. Note: do not include medically specific terms in the naming convention.
   2. Select a **Conversion Event Type** (Other, Lead, Signup, or Purchase/Sale).
   3. Click **Save**.
   4. The audience will populate in the First-Party Audiences table.
4. Locate the conversion audience in the table, click the ••• menu on the right, then click **Copy Audience Key**.
5. Use this audience key when configuring your Send Constant Property transformation in Freshpaint (see Setting Up Conversion Events below).

### Setting Up Conversion Events

To send a conversion event to Simpli.fi, each event must include an `audience_key` property that identifies the Simpli.fi conversion audience you want to attribute the conversion to. This value is provided by your Simpli.fi account team.

Mapping a Freshpaint event to a Simpli.fi conversion audience

1. Navigate to the Simpli.fi Conversions API destination in Freshpaint and click Configure next to Event Transformations.

<figure><img src="/files/PCjWByqq4K8yKlhTy6Gi" alt="Simpli.fi destination configuration page with &#x22;configure&#x22; next to event transformations highlighted"><figcaption></figcaption></figure>

2. Click "**+ Create New**".
3. Select "**Modify Data**". Choose the event you'd like to send to Simpli.fi, select the **Simpli.fi Conversions API** destination, click "**Enable it?**" if the event is not yet enabled for this destination, and click Save.

<figure><img src="/files/Og7NUwzUIgbY5lAQYCSh" alt="Freshpaint transformations page showing a Purchase event selected for the Simpli.fi Conversions API destination"><figcaption></figcaption></figure>

4. Once in the transformation edit page, add a new transformation of type Send Constant Property.
5. Set the Property Name to `audience_key`, and the Property Value to your Simpli.fi conversion audience key provided by your Simpli.fi account team.

<figure><img src="/files/n5VywagodYGrpuEOY4Nb" alt="Transformation page showing example send constant property transformation for the property audience_key"><figcaption></figcaption></figure>

6. Click Save.

Once you've set up the transformation, Freshpaint will include the `audience_key` on every matching event sent to Simpli.fi.

### Sending Purchase Data (Optional)

If you'd like to include purchase data with your conversion events, you can send `purchase_value_usd` and `purchase_order_id` as additional properties. These can be set in two ways:

Using a Send Constant Property transformation (for fixed values):

1. In the same transformation edit page, add another Send Constant Property transformation.
2. Set the Property Name to `purchase_value_usd`, and the Property Value to the purchase amount in USD.
3. Optionally, add another Send Constant Property transformation with Property Name set to `purchase_order_id` and Property Value set to the order ID.

If your events already capture purchase value and order ID as event properties, you can map them directly from your Event Definition without a transformation. Simply ensure the properties are named `purchase_value_usd` and `purchase_order_id` on the event, or use a Rename Property transformation to map your existing property names to these values.

<figure><img src="/files/IgFy3SUmrGcVoN3pZgbC" alt="Rename transformation example, renaming the property value to purchase_value_usd"><figcaption></figcaption></figure>

### Verify Your Setup <a href="#verify-your-setup" id="verify-your-setup"></a>

Once your integration is active:

1. Verify in Freshpaint that the events are triggering and flowing through successfully to Simpli.fi by using Freshpaint's [Liveview and Event Verification tools](https://documentation.freshpaint.io/admin-panel/investigate-testing-and-debugging).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://documentation.freshpaint.io/integrations/destinations/demand-side-platforms-dsps/simpli.fi-conversions-api-early-access/simpli.fi-quick-start-guide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.