Recipe Metrics and Operators

Every Recipe rule requires a time frame, metric, operator, and a value. This document contains all the available timeframes, metrics and operators you can use when constructing your Recipe rules.

Timeframe

A timeframe is required for every valid rule to determine the date range for which to evaluate the conditions.

• Requires ‘over the’
• Accepts ‘last X days ’ and ‘lifetime’
• Can select up to 180 days

Examples

• over the last 30 days clicks > 5
• over the lifetime orders = 0

‍

Numeric Conditions

Numeric Metrics

Must be combined with a numeric operator and a numeric value.

roi

aov

acos

clicks

impressions

orders

sales

roas

cpc

cac

ctr

cvr

spend

bid

budget

KDP Numeric Metrics

The following metrics are only available for KDP ad accounts:

blended profit

blended acos

blended roas

blended rpc

blended cvr

blended cac

blended aov

adjusted sales

adjusted orders

adjusted page reads

adjusted estimated royalties

pages read

estimated royalties

Numeric Operators

>

>=

=

<

<=

=

!=

Numeric Values

Numeric values can be integers, decimals, or percentages for applicable metrics.

• 8
• 1.2
• 25%

‍

String Conditions

String Metrics

String metrics must be combined with string operators and string values (text based values). String values must be wrapped in quotes.

campaign name

ad group name

String Operators

=

!=

contains

does not contain

starts with

ends with

String Values

Can be any text based value and must be wrapped in quotes.

• "lottery"
• "broad_match"
• "1st priority"

‍

State Conditions

State Metrics

state

State Operators

=

!=

State Values

State values are considered string values and must be wrapped in quotes.

enabled (synonyms: active, running)

effectively enabled

paused

archived

‍

Date Conditions

Date Metrics

campaign start date

campaign end date

Date Operators

Will accept all numeric operators and the following date operators:

before (synonym: <)

after (synonym: >)

Date Values

Date values are written in the format 'X days ago'

• > 7 days ago
• before 14 days ago

Date values are converted to YYYYMMDD format when being evaluated.

• '> 7 days ago' becomes '> 20240317' and will include any dates after the date March 17th, 2024
• 'before 14 days ago' becomes 'before 20240303' and will include any dates before the date March 3rd, 2024

‍

Boolean Operators

Boolean operators are used to combine multiple conditions in a single rule, or to combine multiple rules inside a single Recipe.

and

or