A Disposition Code is a custom code that either initializes an action's state or updates an action's state when it's been updated.
In most cases, disposition codes are used to define custom reasons for why an action has changed (i.e., modified, approved, or reversed). In scenarios with open-ended locking or long action approval windows, disposition codes can provide more transparency to partners, enabling them to see a reporting status update of a pending action.
Disposition Codes are used when submitting conversions to impact.com, or when submitting action updates (modifications & reversals).
From the left navigation menu, select
[Menu] → Settings.In the Program column on the right, find the Tracking section and select Event Types.
Find the event type you want to add disposition codes to, select
[Menu] → Disposition Codes.On the Disposition Codes page, in the top right corner select Add Disposition Code.
Configure the disposition code to your requirements:
- Dispostion Code
Choose whether to use a standard code, or create your own code. Disposition codes are case-sensitive—when using them, you must submit the exact value you provide here.
- Disposition Name
Provide a name for this disposition code, which will appear on the Disposition Codes page for the event type.
- State Transition
Choose the reporting state that this disposition will apply to the action—the partner will be able to see this.
- Action change
Choose what will happen to the action when this disposition code is applied.
Select Save to create the code.
From the left navigation menu, select
[Menu] → Settings.In the Program column on the right, find the Tracking section and select Event Types.
Find the event type you want to add disposition codes to, select
[Menu] → Disposition Codes.On the Disposition Codes page, find the disposition code you want to delete.
In the Actions column, select
[Drop-down menu] → Delete.In the warning modal, select I understand, continue.
From the left navigation menu, select
[Menu] → Settings.In the Program column (right side), find the Tracking section and select Event Types.
Find the event type you want to add disposition codes to, select
[Menu] → Disposition Codes.On the Disposition Codes page, find the disposition code you want to edit.
In the Actions column, select
[Drop-down menu] → Edit.Make your edits, then select Save.
In this example, we’ll configure a disposition code for a standard online sale/CPA event type that expects modifications & reversals via a CSV file.
We have three requirements:
We want a custom disposition code that signifies when an action has been modified due to an item return.
When we modify an action using this code, we want the partner to be notified that it was because an item in the order was returned.
The action state will reflect as "modified" in impact.com.
Creating the disposition code
From the left navigation menu, select
[Menu] → Settings.
In the Program column (right side), find the Tracking section and select Event Types.
In the list of event types, we need to find the event type we want to modify. In this example, we’ll be modifying our only Sale event type.
Under the Actions column, select
[Drop-down menu] → Disposition Codes.
On the Disposition Codes page, in the top right corner select Add Disposition Code.
From here, we configure the disposition code to our requirements.
Select Save. Now this disposition code can be used as the
Reasonwhen modifying actions (either via a CSV file or via the API, depending on our event type configuration).