Impact.com Quick Start Guide

Send advertising events directly to impact.com

Destination Info

• Supports Track and Identify calls

• Supports HIPAA mode

• Supports forwarding from the Google Tag Manager Integration

• Refer to this destination as impactdotcom in the Integrations object

• Connection Modes:

	Client-side	Server-side
Web
Mobile
Server

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.

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.

   
2. Get the Campaign / Program ID at Settings -> Manage Programs.

   

Required Properties

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.

Freshpaint property	impact.com API field	Type	Description
$irclickid	ClickId	string	impact.com passes a unique irclickid 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.
order_id	OrderId	string
event_type_id	EventTypeId	number	One or the other of Event Type ID or Event Type Code is required
event_type_code	EventTypeCode	string	One or the other of Event Type ID or Event Type Code is required

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.

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

   2. Click "Modify Data"

   3. Select your Freshpaint conversion event, select the Impact.com destination, then click Save & Add Transformations

   
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

   
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:

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.

1. Select Start test in a new window.

1. 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.

1. 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.