Beeswax Migration Guide
Overview
This guide provides you with tools to assist migrating common ad-tech workflows from Beeswax to the IQM platform: platform terminology, entity mapping, and endpoint-specific API protocol comparisons. These workflows use the unique REST API protocols of each platform to create and manage Campaigns and Insertion Orders, optimize budgets and audience-targeting parameters, apply advanced Conversion settings, and more.
Refer to the Entities Comparison table for naming conventions and their descriptions, and to the migration guide's subsequent pages to compare detailed endpoint-specific protocols.
Entities Comparison
Both IQM and Beeswax use similar organizational frameworks for their advertising management. While each platform has different naming conventions, their hierarchical structure is similar and involves some of the same relationships.
This table compares each platform's terminology and entity relationships. The descriptions use IQM's terminology. For full naming and hierarchy details, refer to IQM Platform Overview and Accounts, Users, Roles, Permissions.
| IQM | Beeswax | Description | Resources |
|---|---|---|---|
| Organization | Account | The entity containing an Organization's or company's details (address, email, website, etc.). | IQM: Workspace API, IQM Platform OverviewBeeswax: Accounts, Users, Roles, Permissions |
| Workspace (User) | User | A user that signs up with the platform and receives authentication credentials: Organization Workspace ID (owId) for IQM; Account ID for Beeswax. Workspace Users are also referred to as Advertisers or Customers in different contexts. | |
| Advertiser (Customer) | Role (Permissions) | Once an Advertiser is assigned to a Workspace User, they become a Customer (they also operate as their own Workspaces). An advertiser can be assigned to one Workspace; and they can have multiple Insertion Orders assigned to them. | |
| Insertion Order | Campaign | The contract between advertisers and a media partner that outlines the budget details and parameters of an advertising Campaign. An Insertion Order is assigned to one advertiser. | IQM: Campaign API, Create a Campaign (Quickstart Guide), Create a Campaign (Help Center Article) Beeswax: Line Items |
| Campaign | Line Item | The targeting and optimization strategies of an advertising run: select Inventories, set goals, and attach Creatives. | |
| Creative | Creative | The media file used in the advertisement. A Creative can be assigned to multiple Campaigns/Ad Groups. | IQM: Creative APIBeeswax: Creatives, Creative Assets, Templates, Rules |
| Audience | Targeting | The group of people targeted for a Campaign. Audiences are made up of included/excluded demographic data used to optimize targeting. On the IQM platform, this is referred to as the "audience segment" (static lists of segment data are in the Master API); Beeswax refers to this as Targeting Modules and Targeting Keys. | IQM: Selecting Your Audiences, Master APIBeeswax: Targeting |
| Bid Model | Bid Modifiers | Advanced bidding options that tailor bid prices for various targeting dimensions within Campaigns (or, Line Items for Beeswax). Fine-tune where ads appear, manage Campaign priority and dimensions. | IQM: Bid Model API, Campaign Delivery and OptimizationBeeswax: Bid Modifiers |
| Reports | Reporting | The tool used to execute and schedule Reports to generate insights and inform current and future Campaign optimization. Customizable by quantitative metrics and qualitative dimensions. Downloadable in CSV or Excel format. | IQM: Reports API, Reporting and AnalyticsBeeswax: Reporting |
| Inventory | Inventory | An organizational tool that provides advertisers a way to create collections or groups based on ad format, placement type, targeting options, and other properties. IQM has options to bid on Open Exchange Inventory or create Private Marketplace Deals or Programmatic Guaranteed Deals as a way for advertisers to negotiate directly with publishers. | IQM: Inventory API, Select Inventory Beeswax: List Items |
| Conversions | Conversion Tags | The string of HTML code that can be placed on your website to measure Conversions. IQM supports client-side (Pixel) and server-side (Postback) Conversions to track visitor activity. Beeswax refers to their Conversions as Conversion Events and Conversion Tags. | IQM: Conversions API, Choose Your Conversion Beeswax: Conversion Events |
| Planner | n/a | IQM manages proposals in the Planner API to draft ad strategies that meet clients' requirements and Campaign goals. |