Table of Contents
Overview
Segments are objects that contain a group of users for the purpose of targeting. Users may be added to a segment through either an event or segment tag placed in a live environment, or uploading a file with first-party data that contains users through a segment upload. When using a tag or pixel to trigger an event for adding users to a segment, the pixel can be incorporated into a web environment. Alternatively, users can be gathered by embedding the tag within a creative, thus capturing all viewers of that creative and adding them to a segment.
Accessing Segments Page
To access the Segments page, navigate to Trafficking > Segments at the top of the screen.
Segments List View
List View Fields
Column Name | Description |
---|---|
Name & ID | Name & ID of created segment. |
Segment Description | If a description was added during segment creation, it will display here. |
Alt ID | Any number or string. Used to map this object to an object in a third-party system. |
Advertiser | Advertiser or account this segment belongs to. |
Segment Key | The unique ID for a segment in a buzz key. |
Segment Count (APAC, EMEA, NAM) | Segment count by region. Displays how many user IDs were uploaded to each region for segment. |
Count Update Date | Date of when the segment count has been refreshed. |
Create a Segment
- To create a segment, navigate to Trafficking > Segments. Additionally, segments may be created by clicking the button, then clicking Segment at the top right of the UI.
- Click New Segment on the upper right hand corner of the segment list view.
A window will appear with the following fields to complete:
*RequiredField Name Description Segment ID An ID that will be generated and applied to this segment upon creation. Segment Key The unique ID for a segment in an account. Advertiser or Account Segments can belong to an account or to an individual advertiser. Select “Account Level Segment” to create a segment that will be available to all advertisers in the account. Select an individual advertiser to have this segment available to a single advertiser.
Leaving this blank will place the segment at account level, and allow any advertiser to target the segment.
Segment Name* Specify the name of the segment. Time-to-Live Days This determines the number of days to keep the user in this segment. If not set, the default is 30 days. The max number you can set is 90 days.
Custom Segment Expiration, or Time-To-Live (TTL), allows customers to specify how many days users stay in a segment.
How It Works
- In the Create Segment screen, the "Days" field sets the TTL, with a maximum of 90 days.
- The TTL is applied to the segment itself, so all users in that segment inherit the same TTL.
- The countdown starts from the segment’s creation time when users are associated.
- Segments created without a specified TTL default to 30 days.
- Once set, the TTL for a segment cannot be changed.
Verb Usage
Define the way in which line items can use the segment in targeting. For example, segments with a ‘Verb Usage’ of EXCLUDE, will not be able INCLUDE or REQUIRE users when being applied to a line item.
This value can not be changed once the segment has been created.
Alternative ID Any number or string. Used to map this object to an object in an outside system Description Give the segment a description (e.g. how it should be used, classification of the users inside) or add any notes you relevant to the segment. Active (Y/N) Make the segment either active or inactive. Inactive segments will not be targetable at line item level. De-activating segments does not remove them from QPS if using advanced filtering. Extensible (Y/N) Choosing "Yes" for extensible allows for the segment to be extended using Liveramp or Freewheel graphs.
Tag Type Dropdown including the following options:
- Iframe tag that incudes exchange sync pixels
- Tag for implementing in mobile apps with user_id passed in manually
- Image tag for adding a user into a segment
- Image tag using Alternative ID to add users into a segment
Once the tag type has been selected, click Save & Generate Tag for the tag to be generated and copied.
Segment Categories Segment Categories can be used to organize segments into a hierarchy for a cleaner appearance in the Targeting > Segments section of the Edit Line Item screen. This field is strictly visual and does not impact behavior.
- Click Save & Close.
Segment Tags
Segment tags are objects that get added to an advertiser's website or app environment to capture data about activity, or add users to a segment. Below are the available tag types with descriptions:
Tag Type | Description |
---|---|
Iframe tag that includes exchange sync pixels (recommended for desktop) | Using this tag will fire a number of sync with Beeswax exchanges when loaded by the user. This helps to increase the presence of Beeswax User IDs in bid requests, and improve ability to identify users. Contact your Beeswax account manager before implementing this if your organization is subject to GDPR. |
Tag for implementing in mobile apps with user_id passed in manually | Export this URL to be called in order to add a user to a segment in a mobile app environment. The users device ID must be manually populated just after the &user_id= parameter in the URL. |
Image tag for adding a user into a segment | This is a typical website-based pixel and is exported as an HTML tag and should be implemented in an HTML environment (site or container). |
Image tag using Alternative ID to add users into a segment | Similar to the above, however uses the Alternative ID of the segment to add users into the segment. |
Advanced Segment Targeting
Advanced segments enable the creation of custom audiences by combining various basic segments—usually derived from 1st or 3rd party data—using Boolean logic. This method facilitates the establishment of rules to merge and target multiple segments into a single targeting segment through the use of AND, OR, or NOT statements.
Steps to Enable Advanced Segment Targeting:
To create a new advanced segment, follow these steps below:
- Once basic segments are uploaded to the UI (see Segment Uploads for more details on this), navigate to a line item > Targeting screen > Segments tab > click the icon at the top right of the segments view. This will display a free text box below where boolean expressions can be added, delimited by AND/OR statements.
- Set up AND OR rules for targeting segments. You can manually enter a boolean phrase in the segment field or find and include segments using the search feature. Examples of advanced targeting below*:
- To target only users who appear in multiple segments, for example in segments 20 and 6:
- beeswax-20 AND beeswax-6
- To target users who appear in one segment or another, for example in segments 20 or 6
- beeswax-20 OR beeswax-6
- To target users who appear in one segment and appear in either of another two or more segments, for example users who are in segment 20 and either segment 4 or 6:
- beeswax-20 AND (beeswax-4 OR beeswax-6)
- To target users who appear in one segment and do NOT appear in another segment, for example users who are in segment 20 but not segment 5:
- beeswax-20 AND NOT beeswax-5
- To target only users who appear in multiple segments, for example in segments 20 and 6:
The word "beeswax" should be replaced by your buzz key