This server-side tag allows you to track Voluum conversions via server-to-server (S2S) postbacks and handle Click ID storage directly from your Google Tag Manager Server container.
Features
- Event Support: Handles Page View (for storing Click IDs) and Conversion (for postbacks with Redirect Linking).
- Cookie Management: Automatically extracts the Click ID from the URL during a Page View and stores it as a first-party cookie.
- Flexible Parameters: Supports sending multiple custom parameters, including Payout, Transaction ID, Currency, and Event Type.
- Optimistic Scenario: Option to trigger
gtmOnSuccess()immediately without waiting for the API response.
Configuration
-
Page View: Fires when a user reaches the landing page to store the Click ID.
- Click ID URL Parameter Name: The query parameter key for your Click ID (e.g.,
clickid). - Cookie Settings: Define Expiration (days), Domain, SameSite attribute, and HttpOnly flag for the Click ID cookie (
_voluum_cid).
- Click ID URL Parameter Name: The query parameter key for your Click ID (e.g.,
-
Conversion: Sends a postback to Voluum.
- Click ID Value: The unique tracking ID (defaults to reading from the
voluum_cidcookie or URL parameter). - Conversion Postback Tracking Domain: Your Offer’s postback domain (e.g.,
your.voluum.tracking.domain). - Use Optimistic Scenario: Check to fire the tag success trigger regardless of the actual API result.
- Additional Parameters: Map specific parameters such as
payout,txid,et,currency, andparam1-param5. - Auto-map: Quickly map
payout,txid, andcurrencyfrom standard Event Data variables.
- Click ID Value: The unique tracking ID (defaults to reading from the
Useful Resources
- Track Voluum Conversions Using S2S Postback URL
- Parameters for S2S Postback URLs
- Parameters for Custom Conversion
Open Source
The Voluum Tag by Stape is developed and maintained by the Stape Team under the Apache 2.0 license.
