Piggybacks

Piggyback functionality in Epom Ad Server allows using third party services to track conversions.

Workflow

  1. Publisher or Advertiser in your network provides you with a pixel tag or a pixel URL from the third party network.
  2. You insert that tag or URL to the Piggyback Settings pane.
  3. Whenever the conversion is counted towards Epom Analytics, the Piggyback Pixel is fired.

Advertiser's Piggyback Setup

To start using the Advertisers' Piggybacks in your network:

  1. Log into your network account and go to the Advertisers tab.
  2. Select the existing Advertiser > Campaign or add the new ones.
  3. Activate the Piggybacks pane from the right side menu.
  4. Click . The Piggyback window appears:
    • Select the Piggyback type depending on the tracking method: Piggyback Beacon for Pixel Tracking; Piggyback URL for S2S methods.
    • Choose the Action which will trigger the Piggyback from the corresponding list. With this field left empty, all the Actions will fire the Piggyback.
    • Paste the Piggyback Beacon (JS-only) or Piggyback URL.
  5. Click Save. The corresponding entry will appear in the Piggybacks pane.

From now on, every time the Action takes place, the Piggyback will be fired.

If you'd like to deactivate the Piggyback, double-click its Status in the list, select Inactive and click Update.

Publisher's Puiggyback Setup

To start using the Publishers' Piggybacks in your network:

  1. Log into your network account and go to the Publishers pane.
  2. Select an existing Site or Placement, or add the new ones.
  3. Activate the Piggyback pane from the right side menu:
    • Select the Piggyback type depending on the tracking method: Piggyback Beacon for Pixel Tracking; Piggyback URL for S2S methods.
    • Paste the Piggyback Beacon (JS-only) or Piggyback URL.
  4. Click Save.

🚧

Note!

Site level Piggybacks will be ignored if Placement level Piggybacks are configured.

Macros in Piggybacks

Piggybacks support the following Epom macros:

Macro's name Description
$$CUSTOM_PARAM(paramName)$$ Is used to pass custom parameters which are specified in the Invocation code.
$$PUBLISHER_ID$$ Site ID.
$$PLACEMENT_ID$$ Placement ID.
$$CAMPAIGN_ID$$ Campaign ID.
$$NET$$ Net.
$$GROSS$$ Gross.
$$CHANNEL$$ Returns channel value.
$$CHANNEL_ESC$$ Returns encoded channel value.
$$RANDOM$$ Returns a random numeric string.
$$TIMESTAMP$$ Returns the current timestamp in milliseconds.
$$REMOTE_COUNTRY$$ Client's country code (US, UK).
$$REMOTE_COUNTRY_ESC$$ Encoded client's country.
$$CUSTOM_PARAM_ESC(paramName)$$ Is used to pass encoded custom parameters which are specified in the Invocation code.