# 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).&#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="/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&#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](/integrations/destinations/apps/impactdotcom/impact.com-reference.md).


---

# Agent Instructions: 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/apps/impactdotcom/impact.com-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.