Redirect Webhook

The Redirect Webhook feature allows for an enterprise-grade expansion of the Voluum platform. With it, you can connect Voluum with your own server to override a campaign or path settings in real-time, without the need of manually editing campaign elements. This allows you to perform fully-automated A/B testing, use advanced redirecting rules and so on.

Despite the fact that a visitor's journey is re-routed through your servers, Voluum still records all events as usual and keeps all data in reports.

Danger

Feature availability:

The following feature is available in Voluum for Agencies.

Benefits

The override of your campaign's setting in Voluum enables you to test on a much bigger scale, with various automated scenarios. The benefits include:

  • Change destinations for several campaigns, single campaigns or for specific paths.

  • Direct visitors to their destinations using their visit characteristics, such as device ID, country or others.

  • Re-route your visitors during a specific part of a day or week.

  • Use complex and reactive testing scenarios to grasp the hidden patterns of visitor's behavior.

You can do all this using your own rules, conditions, and scenarios without the need for manually editing Voluum elements.

How Does It Work?

With this feature enabled, a visitor's flow depends on you. Once you activate Redirect Webhook for a given path or a campaign, Voluum's backend will make an HTTP request to your server when a campaign URL is activated. This request may pass additional visit characteristics that you configure when submitting a URL of your server. Your server should send a correct response with a landing page or offer page address. The time windows for the response is 1 second. After receiving the response, Voluum will direct a visitor to the destination passed in this response. If it took more than 1 second for your server to send a response, a visitor will be directed to a destination set in a Voluum campaign.

Prerequisites

The only requirement is having a server that is capable of receiving requests and sending a correct response within 1 second. If you target multiple GEOs, you should consider using a network of servers to keep lag as low as possible. If you target a one specific GEO, one server should be enough

Using the Redirect Webhook Feature

In order to use this feature, perform the following steps:

I. Submit a Redirect Webhook URL

The first thing you need to do is to submit a URL of your server to VOluum's settings page:

  1. In Voluum, click the profile_settings.png icon to go to Settings.

  2. Go to the Redirect Webhook tab.

  3. Provide a URL of your server in the URL text field. You can include tracking parameters in this URL that you want to pass. to your server.

  4. Click the Save button.

    rrapi2.png

II. Enable Redirect Webhook in your campaign flow

The second thing you need to do is to enable Redirect Webhook for a campaign or a path:

  1. Create a campaign in the advanced form.

  2. Provide basic campaign information in the BASIC tab.

  3. In the DESTINATION tab, go to the Routing callbacks section and enable it:

    • On a campaign level: select the Enable radio button to enable Redirect Webhook for the whole campaign.

      rrapi3.png
    • For a specific path: select the Selected paths radio button and set the Redirect Webhook toggle to Enable in settings of selected paths.

      rrapi4.png
  4. Set destination settings that will be used as a fallback if your server will be unreachable within 1 second.

  5. Click the Save button.

You have successfully set a server-based override to your campaign destination settings.