Setting up an outgoing postback or webhook from Routy

Routy is able to send events to other systems using postbacks (S2S) or webhooks. Typical use cases of this functionality include:

• Sending conversions to third party ad platforms for ad optimization
• Sending conversions to your partners
• Send conversions on other platforms for a more unified view

How to set up an outgoing postback or webhook

1. Go to Traffic Sources on the side menu

2. Choose the traffic source that you'd like to set up an outgoing postback for

3. Select the Webhooks tab and press Add

4. Set up the webhook

Name - Set a distinct name for your webhook

Http Method - Select the method of the receiving system of the postback

Event Source - Choose the event source (e.g. Google Ads, Facebook Ads etc,) for which you want to send conversions. Choose ALL if you want all events to be sent, regardless of the source

Conversion Types - Choose the events that will trigger the webhook. If you are setting up a postback, make sure that if the postback is (for example) a registration postback, you only trigger it for a registration, as this will result in a mismatch of numbers.

URL - Input the URL for the receiving postback or webhook. If you are setting up a postback, note that Routy recognizes a variable using ${variable}

If you're setting up a postback, you can see the full list of parameters when you input ${ in your postback. A few examples include:

• clickId - this is the Routy click ID
• eventName - this is the name of the event that triggered the postback
• mainAttributions.externalClickId - this is the cid parameter you pass in your Routy link
• mainAttributions.fbclid - this is the Facebook click ID that would be captured by the Routy pixel
• mainAttributions.gclid - this is the Google click ID that would be captured by the Routy pixel
• mainAttributions.msclkid - this is the Microsoft click ID that would be captured by the Routy pixel
• mainAttributions.parameterA - this is the pa parameter you pass in your Routy link
• mainAttributions.parameterB - this is the pb parameter you pass in your Routy link
• mainAttributions.term - this is the search term captured by the Routy pixel