Welcome to the Marin Software Support Center. We're glad you're here. Here's what you can look forward to:
  • Real-time search so you can find what you need faster than ever.
  • Easy-to-follow video guides for our most popular articles.
  • Interactive simulations and Live Screenshots to make learning easy.
  • Regular content updates to ensure every word you read is accurate and up-to-date.

Bidding and Optimization

Home > English > Bidding and Optimization > Bidding Basics > Dynamic Actions

Dynamic Actions


Dynamic Actions allow advertisers to harness the power of their data warehouses and 3rd party data feeds to build flexible rules that adjust bids based on trends in this contextual data. For example, an advertiser could integrate inventory data into the platform via dimensions and then leverage this data to boost bids for keywords with high inventory. Other uses could include setting bid overrides, bid caps, and bid floors based on changes in external data.

All Dynamic Actions can be turned into parameters by using Dimension values to control the boost or bid adjustment that is applied. Dynamic actions work seamlessly with the platform’s automated bidding, allowing for additional controls and bid optimization on top of the platform's already best-in-class bidding algorithm.

Dynamic Actions are compatible with both Marin Bidding and MarinOne Bidding. If you would like to learn more about accessing this feature in your Client Account, please reach out to your platform representative. 

Note: The maximum number of dynamic actions per MarinOne or Marin Search account is 5. This article includes information on how to use this feature in either MarinOne or Marin Search. 

Example of a dynamic action

The following is an example Dynamic Action that boosts (i.e. increases) bids by 15% for all keywords where the Featured Item dimension has the value TRUE. Once this Dynamic Action has campaigns or groups applied and dimensions have been tagged accordingly, it will begin running, applying a 15% boost to the applicable objects. 



When creating a new action, the following fields are required:

  • Name: This is a descriptive name for your action. In the example above, our action is called Promotion Boost because we will set up an action to boost bids for certain keywords associated with products running a promotion.
  • Status: You can set your actions to active or paused status. Active actions will run each day and influence bids while paused actions will not affect any bids.
  • Apply to: Using the Campaigns and Groups buttons, you can add or remove campaigns and groups from being associated with the action.
  • Criteria: You can add up to five criteria. These criteria will be evaluated for active keywords within the selected Groups and Campaigns to determine the exact set of keywords where the Dynamic Action will be applied. When building your criteria set, you can select Satisfy All (i.e. all criteria must be true for a Keyword to be selected) or Satisfy Any (i.e. apply action if any of the criteria are met).
  • Action: This is the action that will be applied to keywords in selected groups and campaigns that also satisfy the Criteria set for the action. In this example, we will boost bids by 15% for these keywords. Note that this boost is applied as part of Marin/MarinOne Bidding and will only be applicable to keywords in Bid Strategies set to Traffic or Preview (only the suggested bid is affected for Bid Strategies on Preview mode).

Supported actions

The following actions are currently supported:

  • Boost bid by value (or Dimension Value)

    This action applies a boost (either positive or negative) to the recommended bid calculated by Marin/MarinOne’s bidding algorithm. This boost is applied in a similar manner to the Bid Strategy's boost setting, and acts as an additional multiplicative boost factor.
  • Set bid to value (or Dimension Value)

    This action acts like a bid override and sets the bid for the Keyword to the value configured in the Dynamic Action, disregarding all Bid Strategy rules.
  • Don’t bid above value (or Dimension Value)

    This action sets a bid cap for the keyword; when this action is applied, a bid will never be set above this value.

    Note: If you set a Dynamic Action "Don't bid above" value, this will take priority over the Bid Strategy-level bid cap, regardless of whether the Bid Strategy-level cap is north or south of the Dynamic Action cap.

    This can be supported for the following scenarios:
    • If the Dynamic Action bid cap is lower than the Bid Strategy-level bid cap
    • If the Dynamic Action bid cap is equal to the bid cap applied
    • If the Dynamic Action bid cap is higher than the Bid Strategy-level bid
  • Don’t bid below value (or Dimension Value)

    This action sets a bid floor for the keyword, which replaces the Bid Strategy-level bid floor. When this action is applied, a bid will never be set below this value. All four actions can be configured using an absolute value (e.g. Boost bid by -10%) or a Dimension value (e.g. Boost bid by the amount stored in Dimension ‘Sale Boost’).

How to create a dynamic action

In MarinOne

Once the Dynamic Actions feature is enabled, you can create and manage your Dynamic Actions as follows:

  1. The first step, as always, is to log into MarinOne. 
  2. Next, click on the Optimization tab ('light bulb' icon) in the bottom-left navigation. 


  3. Next, click on the Dynamic Actions tab. 


  4. Click on the Create button ('plus sign' icon)da3.jpg
  5. Give your new Dynamic Action a name, status (Active or Paused), and select the campaigns or groups where you'd like it to be applied. We'll review each of these fields in more detail later in this article. 


  6. Next, you'll input your Criteria. We'll talk about the criteria in more detail later in this article. 
  7. Finally, you'll determine the Action you'd like for this Dynamic Action to take, such as increasing your bid, setting a bid cap, or setting a specific bid value. We'll talk more about the various actions that can be taken later on in this article. 
  8. Lastly, click Save to create your new Dynamic Action. 



You can also edit or delete existing Dynamic Actions from this page. Remember to Save all changes to each Dynamic Action when performing edits.

In Marin Search

Once the Dynamic Actions feature is enabled, you can create and manage your Dynamic Actions as follows:

  1. Click on the Admin link near the top right corner of the application.
  2. Navigate to the Actions sub-tab. All Dynamic Actions will be shown in the grid on the left side of the Actions page.
  3. Click Create to Create a new Dynamic Action.

  4. You can also edit or delete existing Dynamic Actions from this page. Remember to Save all changes to each Dynamic Action when performing edits.

Timing of dynamic actions

A daily job runs at 11 a.m. in the time zone of your Marin Client Account and determines, for each active Dynamic Action, which keywords currently match the action’s campaign / group mapping and criteria set. This job stores these matches in the back-end to be used by the next Bidding job (which runs daily at 5pm).

As a result, dimension data must be updated prior to 11 a.m. in the time zone of your Marin Client Account for it to be taken into account during that evening’s bidding job at 5 p.m.

Reporting on dynamic action performance

You can gain insights into how your Dynamic Actions are performing in a variety of ways, including:

Daily Activity Log file

Each day, a file will be produced in the Activity Log which will document any Warnings or Errors regarding your active Dynamic Actions. For example, the Activity Log file will report on keywords which:

  1. Are not in a Bid Strategy set to Preview or Traffic
  2. Are on bid or position override
  3. Have invalid Dimension data
  4. Have multiple Dynamic Actions matched


Note: The Daily Activity Log file will only show data regarding warnings and errors relating to your Dynamic Actions. It will not show successful actions, but you can always run a one-time report to access this data in volume. 

In Marin Search

Marin Search has several unique columns, which we'll outline below.

Last Action Applied Grid Column (Keywords Grid) 

A new column is available in the Keywords grid called Last Action Applied, which shows the Dynamic Action that was most recently applied to a given keyword. Navigate to the View Builder settings column list to add this column to the Keywords Grid. Note: This column is only visible to those with the closed beta enabled.

Actions Grid Column (Campaign And Groups Grid) 

A new column is available in the Campaigns and Groups grids called Actions, which shows a comma separated list of Dynamic Actions currently mapped to a given Campaign (or Group). Navigate to the View Builder Settings column list to add this column to the Grid. Note: This column is only visible to those with the closed beta enabled.

Bid Category Column / Folder Summary Charts 

The Bid Category column indicates, for a given keyword, what the primary influencer of the keyword’s recommended bid was (during the last bidding job). A new value for this column – Dynamic Actions – has been created and will appear in the Bid Category (Keywords Grid) column and Folder Summary Page pie charts (Bidding grid -> Select Folder -> Summary sub-tab) for Keywords who have their bid adjusted by a Dynamic Action.

Dynamic actions and Bid Strategy Bidding Rule Interactions

Dynamic Actions work seamlessly with the platform’s automated bidding, allowing you to layer additional bid adjustments on top of the platform’s best-in-class bidding algorithm. When Dynamic Actions are applied, the following interactions with Bid Strategy rules are observed:

  • Boost bid by value (or Dimension Value)

This action is applied with the same rule preference as the Bid Strategy boost setting. All other Bid Strategy rules are honored. For example, if a Dynamic Action is set to boost a keyword’s bid by 50%, but the resulting bid exceeds the Bid Strategy's bid cap, the resulting bid will be capped at the Bid Strategy's bid cap.

Important: Note that bid dampening (i.e. Max Bid Change %), if enabled, will still be applied and limit the resulting effective boost that a Dynamic Action can influence a bid by for a given day.

  • Set bid to value (or Dimension Value)

This action acts like a bid override, and takes over the bid calculation. Bid Strategy economic bidding and all Bid Strategy rules are ignored when using a Dynamic Action to set a bid to a specified value.

  • Don’t bid above value (or Dimension Value)

This action, when triggered, replaces the Bid Strategy bid cap and is fired with the exact same level of priority as the Bid Strategy bid cap. Note that, if the Dynamic Actions bid cap is less than the Bid Strategy bid floor, the Dynamic Action bid cap will be ignored.

  • Don’t bid below value (or Dimension Value)

This action, when triggered, replaces the Bid Strategy bid floor and is fired with the exact same level of priority as the Bid Strategy bid floor. Note that, if the Dynamic Actions bid floor is greater than the Bid Strategy bid cap, the Dynamic Action bid cap will be ignored.

Note that Keywords on Bid or Position override will not have their bid adjusted by Dynamic Actions, as Bid Overrides take priority over all Platform automated bidding.


The following Matrix outlines the interaction between each supported Dynamic Action type and each Bid Strategy bidding rule.


  • *1: The keyword's bid will be set to zero and will thus use the Group bid which in turn will observe the "rule" i.e. Bid Strategy bid cap, bid floor or campaign budget cap.
  • *2: If current bid is greater than Dynamic Actions bid cap, bid cap wins. Otherwise bid dampening wins.
  • *3: If current bid is less than bid floor, bid floor wins. Otherwise bid dampening wins.

Important information about Dynamic Actions

The following are some key pieces on information to keep in mind while using Dynamic Actions:

  • What keywords are eligible to have bids adjusted via Dynamic Actions:
    • Dynamic Actions will be applied to Keywords
      • Dynamic Actions will only be applied to active keywords (i.e keywords that are active within an active ad group and active campaign).
      • Important: By default, Dynamic Actions will only run if the keyword appears on the Keywords grid without enabling the All Keywords toggle.
    • Only one Dynamic Action will be applied per keyword per day (i.e. per Bidding job). If multiple Actions match a Keyword, the action that appears closer to the top of the list shown on the Dynamic Actions tab will be chosen to be applied to the keyword.
    • Dynamic Actions work in conjunction with MarinOne Bidding. As a result, only keywords in Bid Strategies set to Preview or Traffic can have a Dynamic Action applied (only the suggested bid is affected for Bid Strategies on Preview).
    • Note that Dynamic Actions will not be applied to keywords in Awareness Targeting Bid Strategies.
  • Dynamic Actions for Shopping campaigns:
    • We support Dynamic Actions for Shopping campaigns.
    • If you are bidding on product groups, you can leverage this feature to layer in advanced rules based on values in their dimension.
    • To opt in and start using this feature, please get in touch with your MarinOne platform representative so that they can ensure this feature is enabled for your account.
  • Important Information regarding Criteria:
    • Text-based Criteria (e.g. Promotion Equals (Text) TRUE) match Keywords in a case sensitive manner.
    • When using Numeric Criteria (e.g. Inventory Less Than 5.5), ensure all Dimension values are properly formatted numbers using the appropriate decimal separator for the account’s locale.
  • Note that Dynamic Actions are fully compatible with Portfolio Optimization. See our Help article for more details.
  • Dynamic Actions is not currently available for Display Keywords or Placements.

Related articles

The following articles will be valuable if you're working with Dynamic Actions:

Last modified



This page has no classifications.