Overview

You may wish to use Events to track conversions, installs, or other key activities. These will be counted as "Conversions" in our Query Tool reporting. More information on Attribution as a concept can be found here.

Creation Steps

1) Click “+New” button > Events

2) Complete the Event form:

Event Name: Name of your conversion event
Advertiser: Advertiser the conversion event belongs to
Event Type (optional): Select the event type that applies: Purchase, Landing Page, Sign-up, Lead, Other. You can also leave this blank
Segment (optional): If you select a segment, users who convert with this event will be automatically added to that segment
Value: This is the default value (in U.S. dollars) that a conversion event is worth to you. The value placed into this field will only be used by Report Builder reporting if a value is NOT present in the event tag. It is a mandatory field but the value can be 0. The value will only appear in Conversion Logs if it is populated in the tag.
Click Window: The lookback window (in days) for click conversion attribution. 30 days is the default.
View Window: The lookback window (in days) for view conversion attribution. 30 days is the default.
Alternative ID (optional): Any number or string. Used to map this object in Beeswax to an object in your system.
Attribution: Select the type of attribution you would like this Event to use. If this event will be a postback event, leave this field as is as this field is not applicable to using the postback method.

“All Line Items for this Advertiser are eligible for this Event”
- Conversions from this Event will be attributable to activity from all line items beneath this Advertiser.
- This is the default attribution functionality.
“Only selected Campaigns and Line Items for this Advertiser are eligible for this Event”
- You will be able to specify which Line Items or Campaigns are eligible for this conversion event.
- Users can choose (via the “Events” tab) which Campaigns and Line Items are eligible for which events. In order to do this, the “Custom Event Association” toggle must be set to “Yes”.
- Note: This option cannot be changed once it has been chosen and saved for an event.

You can find more information on Attribution Types in Conversion and Attribution Setup (Non-Postback)).

3) Under the “Tag Type” section on the right side, select the tag type you want to generate:

Generic image tag (recommended for web)
Image tag using Alternative ID to add users into segments
Generic URL for mobile app install Postback

4) Click “Save & Generate Tag”

5) Copy and paste the generated tag

6) Follow the implementation steps below for the javascript tag. For postbacks, implementation info can be found here: Postback Handling for Conversions

You can read more about conversion events in general here: http://docs.beeswax.com/docs/conversion-events

Implementation of Javascript tag for placing in a web environment

To implement a generic JavaScript tag, you’ll want to consider the following parameters and possible edits:

(optional) [VALUE] should be populated with a number if you want to set the value of conversion in real-time. 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 in the Report Builder reporting but it will not appear in Conversion Logs.
(optional) [ORDER] should be replaced with a number if you want the number of items purchased as part of the conversion.
(required) [ORD] should be replaced with a random number generated at run time. For example, you should use this entire code block in your implementation:

var cachebuster = Math.floor(Math.random() * 10000000000),

img = new Image(); 
img.width = 0;
img.height = 0;

//replace this with the event conversion tag you generated

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

You can find more information about these parameters here: http://docs.beeswax.com/v0.5/docs/conversion-tags-1

Table of Contents

Overview

Creation Steps

Implementation of Javascript tag for placing in a web environment