Conversion Tags

Conversion, or Event Tags are generated by the Buzz API or UI and should be placed on the website where a conversion will be recorded.

Sample Tag

A conversion tag will typically look like this:

<!--BEGIN BEESWAX CONVERSION TAG, DO NOT REMOVE --> <img src="https://cnv.event.prod.bidr.io/log/cnv?tag_id=12345&buzz_key=stinger&value=[VALUE]&segment_key=12345&order=[ORDER]&ord=[CACHEBUSTER]" height="0" width="0"> <!--END BEESWAX CONVERSION TAG, DO NOT REMOVE -->

Parameters

Parameter

What it means

What do you need to do

tag_id

Unique identifier for the tag in Buzz, auto-generated

Do not edit

buzz_key

Unique instance of Buzz, auto-generated

Do not edit

value

The value assigned to the conversion. For example if the value is set to "30" the conversion will be aggregated with a value of 30. If omitted, the tag value set when the event was created in Buzz will be used.

If you want to set the value in real time when the user converts, you should replace the value with a number.

segment_key

The unique id of a segment to put the user into when the user converts. This is generally set when the event is created.

Do not edit

order

The number of items purchased as part of the conversion. For example if the value is set to "2" the conversion will be aggregated with a order of 2. If omitted, the tag value set when the event was created in Buzz will be used.

If you want to set the order in real time when the user converts, you should replace the order with a number.

ord

Random number to prevent browser caching of the conversion

Replace the [CACHEBUSTER] string with a random number generated at run time.

Example Javascript

Conversion tags can either be inserted server-side by your content management system, or client-side in Javascript on your page. The only requirement for implementation is to replace the [CACHEBUSTER] macro with a random number. The code below provides a javascript example, where you should replace the tag with the one generated from Buzz:

var cachebuster = Math.floor(Math.random() * 10000000000),
 
img = new Image(); 
img.width = 0;
img.height = 0;
 
//replace this with the tag you generated from Buzz
img.src = 'https://cnv.event.prod.bidr.io/log/cnv?tag_id=12345&buzz_key=stinger&value=[VALUE]&segment_key=12345&order=[ORDER]&ord=' + cachebuster;
 
document.body.appendChild(img); // or wherever the image should be placed