Set Up Postbacks for Partners

You can set up postbacks for your partners that trigger real-time HTTP notifications (postbacks) directly from our platform to your partner’s system every time an event occurs. This way, you can avoid the need to implement additional pixels or build custom server-side integrations.

By using the partner and Optimize media source integrations, you streamline your technical stack and ensure data consistency without modifying your website's code.

Choose your partner postback configuration

Partner integration postbacks

The partner tracking integration allows you to set up a partner’s postbacks to sync conversion data with their own system without placing additional pixels or tags on the site, reducing development effort, maintenance, and the risk of tracking conflicts.

These postbacks allow partners to access the necessary conversion data via a reliable server-to-server flow, while avoiding duplicate implementations and unnecessary frontend changes.

Important: The event type used for the partner notification postback setup needs to be in the partner contract.

From the left navigation, select Engage → Partners → Partners.
Hover over the partner for whom you want to set up a postback, then select [More] → Partner Integration.
In the top-right, select Add Postback.

Optimize media source postbacks

Note: This section only applies if you have access to Optimize.

You can bypass the traditional contracting process by adding your technology partner as a media source and setting up notifications. This setup allows a seamless postback delivery without requiring a formal contract or specific event type at the contract level.

From the left navigation bar, select Optimize → Settings → Networks.
Hover over the media source for which you want to set up a postback, then select [More] → Event Notifications.
In the top-right, select Add Postback.

Configure the postback fields

Select the action tracker (event type) for which you want to set up postbacks.
Set Event Trigger to Always.
Optionally, for mobile app event types, select [Checkbox] Install to set up postbacks for any app installations.
- If you have selected a mobile app as the event type, please select the exact in-app event name required for the postback.
Enter your server's URL. This is the URL to which impact.com will send postbacks. Optionally, include additional placeholder parameter values. Prior to calling the URL, the parameter placeholders are replaced with their actual values. E.g., http://www.domain.com?campaignId={CampaignId}.
- Refer to Order Level and Item Level Parameters below to view which parameters you can use.
Select your preferred HTTP method.
- Refer to Integration methods (GET & POST) below for more information on these methods.
Optionally, enter the HTTP Header.
Optionally, select Show advanced settings.
- Enter a Minimum Delay between when a non-standard event happens and when the postback is generated and sent to your system.
- Enter a rate limit for the Maximum Requests impact.com can make to your system per second.
- Enter what you want the Success Response to a postback to be.
- Enter what you want the Error Response to a postback to be.
Select Save and repeat for all events.

Order Level Parameters

Parameter

Mapping / Description

{CampaignId}

Program ID

{ActionTrackerId}

Event Type ID

{MediaPartnerId}

Partner ID

{CampaignName}

Program Name

{ActionTrackerName}

Event Type Name

{MediaPartnerName}

Partner Name

{ActionId}

Action ID

{Status}

Action Status

{StatusDetail}

More details about the action status, for example the reason for an action modification

{AdId}

Ad ID

{Payout}

Action payout to the Partner, in the Partner currency

{DeltaPayout}

The change of the Payout Amount

{IntendedPayout}

The intended Payout Amount for an overlimit action

{Amount}

Action amount, in the account's currency.

{DeltaAmount}

Corrected Amount from previous action.

{IntendedAmount}

The intended Sale Amount for an overlimit action

{Currency}

Currency for the action

{OriginalCurrency}

Original (i.e. cart) currency for the action

{OriginalAmount}

Original (i.e. cart) amount for the action

{EventDate}

The date of when the conversion took place

{CreationDate}

The date the action is created in the system

{LockingDate}

Date, in ISO 8601 format, when the action will be locked.

{ClearedDate}

Date, in ISO 8601 format, when the action is scheduled to clear

{ReferringDomain}

Domain where the referral took place (if online)

{LandingPageUrl}

Url of landing page (if online)

{RefCustomerArea}

Customer Area, derived from IP address

{RefCustomerCity}

Customer City, derived from IP address

{RefCustomerRegion}

Customer Region, derived from IP address

{RefCustomerCountry}

Customer Country Code, derived from IP address

{RefClickId}

A unique case-sensitive identifier that is generated on the click (if applicable)

{SharedId}

A value that a Partner can include in the click URL which becomes available to your advertisers

{PromoCode}

Promo code

{CustomerStatus}

Customer status

{Oid}

Order ID

{Note}

A note supplied with the reported action

{CustomerPostCode}

Customer Post Code

{CustomerCity}

Customer City, supplied with the reported action

{CustomerCountry}

Customer Country Code, supplied with the reported action

{CustomerRegion}

Customer Region, supplied with the reported action

{Text1}