setup-conversion-tracking

Set up conversion tracking with Converly

Tracking only works when THREE things are all true. A flow is published, the destination platform is connected (for server side platforms), and the Converly snippet is installed on the website. Never end this workflow without all three handled or handed to the user.

Steps

1. Understand the goal. Ask which form tool the site uses (Typeform, Webflow forms, Gravity Forms and so on) and which ad platform conversions should go to, unless the user already said.

2. Check the destination. Call list_destinations. If the target platform isn't connected and it is a server side platform (its entry in list_destination_types has a non empty connection_types), call connect_destination. Share the link it returns, explain the account owner must open it in their browser and authorize, and ask them to tell you when they've finished. Then confirm with check_handoff_status. Browser side pixel platforms (empty connection_types) need no connection step.

3. Build the flow. Call list_trigger_types for the trigger id and list_action_types for the exact action config the destination needs. Create with create_flow, then run validate_flow and fix any problems it reports.

4. Publish. Call publish_flow. Read its result carefully. If install_status.detection is "never_seen", the loader has never phoned home from the site. That usually means the snippet still needs to be installed, so offer it. The check is quick to settle: the loader phones home when a page loads, so once the snippet is in, ask the user to open any page of their site and check get_install_status again. Detection flips to "confirmed" within moments. If it stays "never_seen" after a page load, the snippet is not live yet (site builders need a republish). Two setups never send the phone-home signal: sites using the Converly Webflow app, and visitors with privacy signals or unconsented cookie banners. For those, a real form submission appearing in list_events is the proof instead.