Commission ID

Every commission in PalDock has its own ID. Sending it with a tracking request tells PalDock exactly which commission to apply, instead of letting the system choose.

When you need it

• You have more than one commission for the same conversion type and the advertiser has to say which one applies.
• You pay different amounts for different products or plans inside one offer.
• You want the recurrence limit counted separately for each commission, because the limit is counted per commission.
• You want deduplication on the external ID to allow a second conversion for a different commission. See below.

If you only have one commission per conversion type, you do not need it.

How to send it

• Parameter name: commission_id
• Format: the commission UUID, for example 9e321d3b-3690-4100-821d-86476cc4c2fb
• Supported in the tracking pixel, S2S postback, and the Tracking API
• Not used in the affiliate postback, which sends results out rather than in
• Alternatively, send commission_code with the commission’s own text code instead of the ID

The parameter is optional in every request. See Tracking parameters for the full list.

Commission code

Instead of the Commission ID, you can send a commission code: a short text label you set on the commission yourself.

• It works as an alias, so commission_code=premium-plan does the same as sending that commission’s ID.
• It is easier to read and easier for advertisers to implement than a UUID.
• It does not change any behaviour. Everything on this page applies to the code the same way it applies to the ID: the conditions are still checked, deduplication still works per commission, and the recurrence limit is still counted per commission.
• If you send both, the Commission ID wins.

Use the code when the advertiser maps their own product names to your commissions. Use the ID when the request is generated by a system that can store it.

What happens when you do not send it

When neither the Commission ID nor the commission code is sent, PalDock falls back to commission order:

• If type is sent, the first commission in the list for that conversion type is used.
• If neither is sent, the first commission in the list is used.

See How PalDock picks a commission.

What happens when the ID does not fit

The Commission ID does not skip the commission conditions, it only narrows the choice to one commission. That commission still has to match the conversion.

• If the commission belongs to a different offer, conversion type, channel, or source, it will not be applied and no transaction is created.
• The request itself is still accepted and the conversion is still recorded. Check the conversion log to see that no transaction was created.

Always send an ID that belongs to the same offer as the conversion.

Effect on deduplication

The Commission ID changes how deduplication on the advertiser’s external ID works.

• Without a Commission ID: a second conversion with the same external ID is refused, no matter which commission would apply.
• With a Commission ID: a second conversion with the same external ID is refused only if that specific commission already created a transaction for it. A different commission can still be applied.

This is useful when one order should create two transactions, for example a prospect and a sale, and both arrive with the same external ID.