arrow_back_ios

How to process UTM parameters?

Bukza supports five main types of UTM tags: utm_source, utm_medium, utm_campaign, utm_term, and utm_content.
You can include these parameters in the direct widget URL, for example:
https://app.bukza.com/?utm_content=buffercf3b2&utm_medium=social&utm_source=facebook.com&utm_campaign=buffer#/user/999/timetable/9999
Alternatively, you can add them to the URL of your website page. The widget code will automatically process the UTM parameters from your page.
You can also pass tags to the widget using JavaScript after the widget has been initialized. To do this, use the following code:
window.bukzaCallbackForBukzaContainer99999 = function(payload){
    switch(payload.message.event){
        case 'INITIALIZED':
        window.bukzaSetUtmForBukzaContainer99999({
            utm_source: 'Google',
            utm_medium: 'cpc',
            utm_campaign: 'spring_sale',
            utm_term: 'running+shoes',
            utm_content: 'textlink',
        });
        break;
    }
};
In the example above, replace 99999 with your widget's ID.
To pass parameters from an internal frame, use HTML like the following:
<html>
  <head>
    <meta charset="UTF-8">
  </head>
  <script>
    parent.postMessage(JSON.stringify({
      type: 'BUKZA_CROSS_FRAME_WIDGET',
      event: 'SET_UTM',
      data: {
        utm_source: 'Google',
        utm_medium: 'cpc',
        utm_campaign: 'spring_sale',
        utm_term: 'running+shoes',
        utm_content: 'textlink',
      }
    }), '*');
  </script>
</html>

Parameters handling

You can display the received parameters in the orders table. To do this, use the columns: Campaign source (utm_source), Campaign medium (utm_medium), Campaign name (utm_campaign), Campaign term (utm_term), and Campaign content (utm_content).
On the order details page, UTM parameters are shown in the widget parameters form.
To open this form, click the widget icon in the order number block.
You can also insert the received UTM parameters into web requests.