> 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/apps/impactdotcom/impact.com-quick-start-guide.md).

# 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](/integrations/google-tag-manager-integration.md)
* 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="/files/XbscO4V6mnWJIw7iDylx" 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="/files/e79gl0QsNL0ALI9QAbnO" 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](/integrations/destinations/apps/impactdotcom/impact.com-reference.md).

### Adding Event Type Information for Impact.com

Impact.com requires either an `event_type_id` or `event_type_code`.

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="/files/67ZcK1TOo1gbL7i9AQUX" 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="/files/HmTk0DdraXVlENqgyNnr" 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="/files/NqYP4N0V091H3zNRSCjO" 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
   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](/integrations/destinations/apps/impactdotcom/impact.com-reference.md).