Skip to main content

Migrate a Bid Model

Migrate a Bid Model from DV360 to IQM by comparing each platform's API methods for creating and managing Bid Model settings.

The definitions and API comparison tables highlight the shared terminology, actions and API methods between IQM and DV360 for creating and managing Bid Model settings. Select an endpoint to review each platform's relevant API documentation. By comparing APIs, you can migrate your workflow from DV360 to IQM.

For a comprehensive overview of IQM's Bid Model services, see the Bid Model API guidelines.

Definitions​

IQMDV360Description
Bid ModelCustom Bidding AlgorithmThe set of optimizations applied to a campaign or insertion order. These optimizations control where ads appear, and define their priorities, bids, and budget allocation.
Bid Model DataScript or RulesA Bid Model setting that adjusts a campaign's base bid based on specified parameters.
DimensionDimensionA property in digital advertising used to categorize, filter, or analyze audiences, campaigns or inventories. It serves as a targeting parameter for Advertisers, specifying where an ad appears.
Bid ModifierScore or MultiplierA multiplier applied to a base bid.
Spend RatioWeighted ConversionsA setting that determines how the campaign budget is distributed across targeting dimensions.
Dimension PriorityA setting that dictates the order in which a campaign should attempt to deliver impressions based on the available budget.
NOTE

IQM's Bid Model currently supports applying Bid Modifiers to the following dimensions:

  • Creative: Creative ID
  • Location: State, City, ZIP code
  • Inventory: Open Exchange, Publisher Category*, Deal ID**
  • Device: Traffic Type, Device Type
  • Exchange: Exchange ID
  • Audience: Audience ID***

*Spend Ratios are not supported for the Publisher Category dimension subcategory. Refer to Spend Ratio overview Help Center article for more information.

**Bid Modifiers are not supported for the Deal ID dimension subcategory. Refer to the Bid Modifier overview Help Center article for more information.

***Spend Ratios and Allowlist/Blocklist targeting are not supported for the audience dimension.

API comparison​

Base URLs
  IQM: https://api.iqm.com
  
  DV360: https://displayvideo.googleapis.com
ActionIQM endpointDV360 endpointNotes
Add Bid Model settingsPUT/api/v3/bm/campaigns/{campaignId}/bid-models/{dimensionId}POST/v4/customBiddingAlgorithms
Add Bid Model settings to insertion orderPUT/api/v3/bm/io/{ioId}/bid-modelsPOST/v4/advertisers/{lineItem.advertiserId}/lineItems
PATCH/v4/advertisers/{lineItem.advertiserId}/lineItems/{lineItem.lineItemId}		Add Bid Model settings to an insertion order and its associated campaigns.

DV360 adds Custom Bidding when creating/updating Line Items. Add a customBiddingAlgorithmId to the MaximizeSpendBidStrategy object within the bidStrategy object.
Update Bid Model settingsPUT/api/v3/bm/campaigns/{campaignId}/bid-models/{dimensionId}PATCH/v4/customBiddingAlgorithms/{customBiddingAlgorithm.customBiddingAlgorithmId}
Add/update multiple Bid ModelsPUT/api/v3/bm/campaigns/{campaignId}/bid-models/{dimensionId}n/aIQM endpoint supports adding, updating, and deleting Bid Model data.
Get campaign Bid Model detailsGET/api/v3/bm/campaign/{campaignId}/dimensions/bid-models/count
GET/api/v3/bm/campaigns/{campaignId}/dimension/{dimensionId}/spent
POST/api/v3/bm/campaigns/{campaignId}/bid-models/dimensions/{dimensionId}		GET/v4/customBiddingAlgorithms/{customBiddingAlgorithmId}IQM endpoints get counts of dimensions, spending by dimension, and modeled items count by campaignId.
Include/exclude managementPOST/api/v2/cmp/deviceType/includeExclude
POST/api/v2/cmp/exchange/includeExclude
POST/api/v2/cmp/trafficsource/includeExclude
POST/api/v3/bm/campaigns/{campaignId}/include-Exclude/dimensions/{dimensionId}		POST/v4/customBiddingAlgorithms/{customBiddingAlgorithmId}/scripts
GET/v4/customBiddingAlgorithms/{customBiddingAlgorithmId}:uploadScript		IQM has separate endpoints for including/excluding device types, exchanges, traffic sources, and dimensions.

DV360 specifies include/exclude options with the CustomBiddingScriptRef object when creating a Script. The CustomBiddingScript is then uploaded to a CustomBiddingAlgorithm. See More Bid Model resources below for reference material.

More Bid Model resources​

IQM:

DV360:

Have a question?
Ask the community
Was this page helpful?