...

...

Overview

This feature must be enabled by the Beeswax team.  Please contact Support and your Account Manager if you are interested.

You can dynamically add a user to a given segment with a value from a website instead of installing With this feature, users can be dynamically added to segments using values from a website, eliminating the need to install a separate pixel for every possible potential segment.   For example,  if you are a retailer who wishes a retailer who wants to pass us the a brand name or product name (or a concatenation of both) when a user visits a product details page and add that can use this solution to add the user to a specific segment in the Beeswax platform, this solution will accommodate that use case.  

How it Works

...

platform. This feature must be enabled by the FreeWheel team. To get started, please reach out to your Account Representative for more information.

How It Works

1. Create a New Segment

   • Navigate to Trafficking > Segments > New Segment.
     
     

2. Name the Segment

   • Assign a name to the segment as needed.
     
     

3. Define the Alternative ID

   • In the Alternative ID field,

...

1. • enter the dynamic value

...

1. • that will be

...

1. • passed to

...

1. • FreeWheel for

...

1. • this segment.

...

1. • It’s recommended to use lowercase letters and avoid spaces or special characters to minimize potential issues.
   • If your

...

1. • key-value library includes

...

1. • special characters

...

1. • , FreeWheel supports them, but it is advised to do additional QA to ensure proper URL escaping.
     
     

2. Select the Tag Type

   • Choose the tag type: Javascript Tag Using Alternative ID to add users into a segment

...

1. • .
     
     

2. Save and Generate Tag

   • Click

1. • Save & Generate Tag

...

1. • . Note the account_id is a required parameter for this tag, unlike in a standard segment tag. The generated tag will look

...

1. • like this:

   HTML
   <img src="https://segment.prod.bidr.io/associate-segment?buzz_key=buzzkey&segment_alt_id=shamim&account_id=1&value=" height="0" width="0">

...

2. Install the Pixel

1. • Install the pixel on the conversion page

...

1. • .
   • Use JavaScript or another technology to dynamically populate the segment alternative ID when the pixel is

...

1. • triggered on the page.

...

1. • The tag will

...

1. • result in a 3XX redirect with additional parameters.

...

Using a

...

Single Segment Tag to

...

Populate Multiple Segments with Alternative IDs

The segment tag Segment tags can be configured to add the a user to multiple segment keys in their Beeswax bidding instancewithin the platform. This can be is done by specifying more than one multiple segment_alt_id parameter within parameters in the segment URL.

Example of Adding Multiple Segments:

 <img src="https://segment.prod.bidr.io/associate-segment?buzz_key=buzzkey&segment_alt_id=shamim&segment_alt_id=ari&segment_alt_id=ram" height="0" width="0"> 

If you would like to specify a value to the is needed for each user-segment association, this can be done by specifying the specify the value parameter in the same order in which the as the segment_alt_ids are specified, for example:id parameters.

Example with Value Assignments:

To If you want to assign a value of 1.5 to segment shamim and a value of shamim and 3.6 to   ari, you can perform use either of the below calls (as the order in which the values are specified is the same as the order in which the segment keys are specified)following:

Option 1:

 <img src="https://segment.prod.bidr.io/associate-segment?buzz_key=buzzkey&segment_alt_id=shamim&segment_alt_id=ari&value=1.5&value=3.6" height="0" width="0"> 

Option 2:

 <img src="https://segment.prod.bidr.io/associate-segment?buzz_key=buzzkey&segment_alt_id=shamim&value=1.5&segment_alt_id=ari&value=3.6" height="0" width="0"> 

If you would like want to assign a value values to only some segments and not others, you will need to ensure that there is , make sure an empty &value= parameter specified parameter is included for each segment being added to, to ensure that does not receive a value. This ensures that the key-to-value order is preservedmaintained. The number of  value parameters parameters must equal match the number of  segmentsegment_alt_id parameters parameters.You may add a user to no more than 100 different

...

Limits

• A user can be added to up to 100 segment keys in a single associate-segment call.
• This is a hard limit and cannot be increased.