Setup and operations
Setting Up Reliable Conversion Postbacks
A postback is trustworthy only when its conversion can be joined to the original click and repeated delivery cannot double count it.
Choose the attribution key
Generate or preserve a click identifier that can be stored by each required system without exposing unrelated personal data. Document its format, lifetime, and the exact hop where it enters the destination journey.
Define the conversion payload
Specify event name, click ID, status, value and currency if applicable, timestamp semantics, and authentication. Reject unknown or malformed fields rather than silently interpreting them differently across systems.
Design idempotent delivery
Give each conversion event a stable identity, accept safe retries, and distinguish temporary network failures from permanent validation errors. Use bounded backoff and an operator-visible failure queue instead of infinite request loops.
Limit and authenticate the endpoint
Transmit only required attribution data over protected transport, validate credentials, and keep secrets out of campaign URLs. Define retention and access according to the surrounding analytics policy.
Reconcile clicks with outcomes
Send known test conversions, intentional duplicates, an unknown click ID, and an invalid signature. Compare sender logs, receiver response, stored conversion, and the original routing event before relying on aggregate reporting.