Transferring Postback to Voluum
Verification of Postback URL Settings
The instruction below only covers tracker integration. If you want a more comprehensive understanding of Voluum and MGID integration, please follow this link here.
MGID Ads Dashboard Settings
Start by creating an event and Postback URL in the MGID dashboard.
Follow these steps:
- Create a new advertising campaign or edit an existing one by clicking on its respective icon in the dashboard.
2. Navigate to the Conversion tracking section and select the Postback option in the Tracking settings tab.
3. Add a new conversion goal and create a unique name for the goal. We recommend adding the client’s ID to the goal name (e.g., test_even_123456). In addition, you can select an existing goal.
Repeat these steps (i.e., add another goal) if you want to track more than one conversion goal.
4. Click Get Postback URL and then copy the URL. Save the link on your device, as you will need it later.
5. Add the parameter click_id={click_id} to the Tracking Tags section.
The {click_id} macro is required to transfer the hash. It can be added on the Voluum side as well.
To make sure your Postback works as intended, add the real value for the {click_id} macro in this field. For instance, if your {click_id} macro is located in the {sub_id} macro of your analytic system, you need to add sub_id={click_id} at the end of the link.
Voluum Dashboard Settings
The next step will be creating a traffic source, campaign and offer on the Voluum side.
Follow these steps:
- Log into the Voluum panel to create a new traffic source.
- Click Traffic sources and then Create
3. We recommend selecting the default MGID traffic source template. Type “mgid” in the search field, select the MGID template and click Next.
Additional parameters and macros will be filled in automatically, as shown in the screenshot below.
4. The final step is to fill in the Postback URL (the link that was copied while creating Postback goals in the MGID dashboard) with a correct macro for Voluum.Example:
https://a.mgid.com/postback/client_ID?c={externalid}&e=test_event&r={payout}
Where:
- client_ID is a unique parameter for our system that is transferred to our system alongside the event's status.
- c is a click ID’s macro. For Voluum, replace {click_id} with the {externalId} macro.
- e=test_event is a Postback goal identifier that can be displayed in form of a {status} macro or status name
- r is an optional parameter to which conversion revenue can be transferred. For Voluum, replace {revenue} with the {payout} macro.
In the event you want to pass more than one conversion event to MGID, it is necessary to switch on the "Traffic source postback URL per event type" option in Voluum and paste the additional postback links there.
5. Create a new offer. Click Offers and then Create.
The Postback URL is taken from the offer to transfer conversions from the landing page (site) to the Voluum tracker.
Therefore, only the offer name and the offer page URL is required here (e.g., http://yoursite.com?click_id={clickid}).
However, we recommend you also provide the parameter that is used by the Affiliate Network/Offer Owner to the Offer URL along with the {clickid} token.
To find out more, please contact the Affiliate Network or Offer Owner.
6. Create a new campaign in the Voluum dashboard. Click Campaigns and then Create.
Specify the information below:
- Traffic source: Select the traffic source.
- Redirect mode: Specify the type of redirection from Voluum to the landing page (site).
- Path Destination: This is the funnel that your user will have to get through to visit the offer. Select either Landers & Offers (pre-sale and sale site) or Offers only (sale site).
Select the lander and/or offer you will be using in your campaign in the same way as the Offer URL from the previous step (e.g., http://yoursite.com?click_id={clickid}).
In this case, the click_id parameter transfers the internal clickid of the Voluum tracker to the landing page.
7. After saving the campaign, the link to the campaign will be displayed in the "Tracking & Automizer" tab. Copy the link and use it as your teaser link in the MGID Dashboard.
8. Your MGID campaign settings should resemble something like this:
Transferring Postback to Voluum
After customizing the MGID and Voluum dashboard, set up the transfer of Postback to the Voluum tracker from the Affiliate Network or the Offer Owner.
A POST request transfers Postback to Voluum.
The link should closely resemble this: http://voluum_dedicated_domain.com/postback?cid=REPLACE&payout=OPTIONAL&txid=OPTIONAL
The domain may vary depending on the Voluum cabinet. In this case, we transfer the parameters cid - internal Voluum’s click_id; txid - transaction id; and payout - an optional parameter but necessary to transfer revenue to our conversion. Any handy solution for transferring Postback to Voluum can be chosen, e.g. JavaScript, GTM or PHP.
Verification of Postback URL Settings
Next, we recommend that you ensure postback setup was done successfully and is working properly. You can verify the setup by following this instruction.
To review the Postback setup:
- Find an existing campaign you have created
- Navigate to the Ads section
- Click on the Ads preview button, displayed in the form of an eye icon
- Click any advertisement widget and complete the conversion action.
- View data regarding test conversions in the Campaign List and Campaign statistics interfaces (it will be displayed under the conversion column within 15 minutes).
By performing this check, the statistics can be reviewed and the desired additional parameter can be selected with a timestamp indication in the tracker: