arrow_back_iosQuestions
help

How to process UTM parameters?

check_circle
Bukza supports 5 main types of UTM tags: utm_source, utm_medium, utm_campaign, utm_term и utm_content.
You can include these parameters in the direct widget URL, for example, like this:
https://app.bukza.com/?utm_content=buffercf3b2&utm_medium=social&utm_source=facebook.com&utm_campaign=buffer#/user/999/timetable/9999
Or you can put them into the URL of your website's page. The widget code will process the UTM parameters of your page automatically.
You can also pass tags to the widget using JS code after the widget is 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 the ID of your widget.
To pass parameters from an internal frame, use HTML looking like this:
<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 table of orders. 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 displayed on the widget parameters form.
To open this form, click on the widget icon in the order number block.
You can also insert received UTM parameters into web requests.
Didn't find the answer to your question?
Feel free to ask it at
mail_outline support@bukza.com