# Impact.com Quick Start Guide

## Destination Info

* Supports [Track](https://documentation.freshpaint.io/developer/freshpaint-sdk-reference#track) and [Identify](https://documentation.freshpaint.io/developer/freshpaint-sdk-reference#identify) calls
* Supports [HIPAA mode](https://documentation.freshpaint.io/hipaa-mode)
* Supports forwarding from the [Google Tag Manager Integration](https://documentation.freshpaint.io/integrations/google-tag-manager-integration)
* Refer to this destination as **impactdotcom** in the [Integrations object](https://documentation.freshpaint.io/reference/developer/freshpaint-sdk-reference#using-the-integrations-object)
* 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 impact.com Account SID, Auth Token
2. Campaign / Project ID for your conversions
3. Account SID, API Key, Campaign ID, Event Type ID configured in Freshpaint
4. Conversion Events configured in your Freshpaint Event Library, or a plan to use [precision tracking](https://documentation.freshpaint.io/integrations/sources/web/precision-tracking).

### To set up impact.com with Freshpaint, follow these steps:

1. Find the Account SID and Auth Token at [Settings -> API in your impact.com account](https://demo.impact.com/secure/advertiser/accountSettings/techintegration/adv-wsapi-table-flow.ihtml). <br>

   <figure><img src="https://1666823438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MA7aDqsXMFbUsWVqonF%2Fuploads%2FS7h7E3yQlyCG2WpUkVxg%2Fimpact-sid.png?alt=media&#x26;token=35479ca7-585f-4ff1-9393-81ffae572900" alt=""><figcaption></figcaption></figure>
2. Get the Campaign / Program ID at [Settings -> Manage Programs](https://demo.impact.com/secure/advertiser/accountSettings/view-campaigns-flow.ihtml). <br>

   <figure><img src="https://1666823438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MA7aDqsXMFbUsWVqonF%2Fuploads%2FbGNtJfcRZ5oxkkHKI0Iy%2FScreenshot%202023-12-04%20at%2012.21.47%20PM.png?alt=media&#x26;token=ac90592f-8612-4c93-b83f-da21210357ca" alt=""><figcaption></figcaption></figure>

### Required Properties

{% hint style="info" %}
The following event properties are **required** in order to attribute events to specific ads, and if in HIPAA mode, must be selected in the Required Properties Allow List.
{% endhint %}

<table data-header-hidden data-full-width="true"><thead><tr><th width="165"></th><th width="164"></th><th width="103"></th><th></th></tr></thead><tbody><tr><td><strong>Freshpaint property</strong></td><td><strong>impact.com API field</strong></td><td><strong>Type</strong></td><td><strong>Description</strong></td></tr><tr><td><code>$irclickid</code></td><td><code>ClickId</code></td><td>string</td><td>impact.com passes a unique <code>irclickid</code> query string parameter into the landing page URL when redirecting the user through our tracking domains. The value associated with this parameter is used to perform attribution analysis.</td></tr><tr><td><code>order_id</code></td><td><code>OrderId</code></td><td>string</td><td></td></tr><tr><td><code>event_type_id</code></td><td><code>EventTypeId</code></td><td>number</td><td>One or the other of Event Type ID or Event Type Code is required</td></tr><tr><td><code>event_type_code</code></td><td><code>EventTypeCode</code></td><td>string</td><td>One or the other of Event Type ID or Event Type Code is required</td></tr></tbody></table>

There are other optional parameters you can add to your events in order to achieve different use cases. You can view the full list of parameters [here](https://documentation.freshpaint.io/integrations/destinations/apps/impactdotcom/impact.com-reference).&#x20;

### Adding Event Type Information for Impact.com

Impact.com requires either an `event_type_id` or `event_type_code`.&#x20;

1. Add this information to your events by creating a Transformation in Freshpaint:

   1. Click on "Create New" in [Transformations](https://app.freshpaint.io/transformations)
   2. Click "Modify Data"
   3. Select your Freshpaint conversion event, select the Impact.com destination, then click Save & Add Transformations

   <figure><img src="https://1666823438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MA7aDqsXMFbUsWVqonF%2Fuploads%2FYMMT74fFJXETQxdqd3Ra%2FScreenshot%202025-06-11%20at%204.24.59%E2%80%AFPM.png?alt=media&#x26;token=76142c5f-cda0-47ff-89f0-efddc601a170" alt=""><figcaption></figcaption></figure>
2. Select the Send Constant Property transformation option:

   * For `event_type_id` enter your Impact Event Type ID (Number) as the property value
   * For `event_type_code` enter your Impact Event Type Code (Text) as the property value

   <figure><img src="https://1666823438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MA7aDqsXMFbUsWVqonF%2Fuploads%2FQ075dR4mYuGoz9pDKuwx%2FScreenshot%202025-06-11%20at%204.28.14%E2%80%AFPM.png?alt=media&#x26;token=30513a89-0489-4fa4-8de1-3e02fef13fa0" alt=""><figcaption></figcaption></figure>
3. Click Save

### That's it! Now all you need to do to send an event to impact.com is enable the destination in the Freshpaint event definition:

Navigate to your Freshpaint event, and toggle the destination on to enable the event to be sent to the impact.com destination:<br>

<figure><img src="https://1666823438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MA7aDqsXMFbUsWVqonF%2Fuploads%2FNaYBaUTB5J9ilpOFmlnz%2FScreenshot%202023-12-04%20at%202.43.29%20PM.png?alt=media&#x26;token=36314e38-fda8-4152-a8a5-be1d1c88f527" alt=""><figcaption></figcaption></figure>

### Confirm and Validate Conversions in impact.com

Follow these steps to test and verify that events are being tracked in Impact.

1. Select your Event to Test
   1. Go to **Settings > Tracking > Event Types** in your Impact account.
   2. Locate the event you want to test. Click **More options > Test**.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfuN329OQ6Vozd3WeBclZwcqhlt9NQyI2tbwhMR2DTTzqoDEFs7Z3znCXCXwkq_XvfNb-0vuXPVtxuJ_3K0FUcUgpfQg5QyqqF4ejbFkjxFB1vEompNbktmqV1lRG7GYrBVDpa7?key=zDHKcG0icR4gkDVtEta6ag" alt=""><figcaption></figcaption></figure>

2. Select Start test in a new window.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXexB5O1Q-BMcMxySBU83ceAZuJqZr7c8SRBHw7BXK8sQkEuoAixC8A3zQC4TH-H7jhDCRSSB3pDEH0rkds9lgXfoynoxKb3goNep_AMkSbkexOufaeWstvYkifCCP7XJUECbSCJGg?key=zDHKcG0icR4gkDVtEta6ag" alt=""><figcaption></figcaption></figure>

3. Test the Event&#x20;
   1. Perform the action on your site that triggers this event. Example: completing a purchase, signing up for a subscription, etc.
   2. In Freshpaint, navigate to **Event Verification** and confirm the event was successfully sent to **Impact**. The event should show an OK status.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcPa0fY-Z0CDnSC2mGhK4i3egbWR7l7cfpCUxiluljfIVAyQoYPrxHkh69RbuYtncr4YkTm5mZ1KIvp3pYtFxfdioyGpyjYBsuwuGay9NRKreojLqJpfs04wUn_9bADwFzPSaOYMw?key=zDHKcG0icR4gkDVtEta6ag" alt=""><figcaption></figcaption></figure>

4. Check for Pending Status
   1. After the test, the event should appear with a **Pending** status in Impact. This may take a few hours to update.

Congratulations! Once you have confirmed conversion in impact.com, you have finished setting up this integration.

You can find more detailed documentation on this integration in the [impact.com-reference](https://documentation.freshpaint.io/integrations/destinations/apps/impactdotcom/impact.com-reference "mention").