Notification

Welcome to the help center for Search Ads 360, a platform for managing search marketing campaigns.  While the help center is available to the public, access to the Search Ads 360 product is available only to subscribing customers who are signed in. To subscribe or find out more, contact our sales team.

regex_match

Evaluates as true if string matches all or part of a regular_expression. Use this function as a condition in the if function.

Regular expressions is a powerful language for matching patterns of partial words, whole words, or even multiple words. While basic regular expressions are straightforward to use, you can create complex expressions that are powerful but may be difficult to predict and debug --- and may be difficult for other people in your organization to understand.

So the best practice is: start with the basics, and add complexity only if you have no other choice.

Syntax

regex_match(string, regular_expression)

Parameters

string can be any of the following:

regular_expression is a case-sensitive RE2 regular expression (RE2 is an open source engine for processing regular expressions). See examples and suggestions below. The complete list of operators and syntax is available on Github.

Surround the regular expression with quotation marks.

Regular expression syntax

Here's a list of the operators and syntax you may find useful when using regular expressions in Search Ads 360:

Wildcards

. Matches any single character (letter, number or symbol) goo.gle matches gooogle, goodgle, goo8gle
* Matches zero or more of the previous item The default previous item is the previous character. goo*gle matches gooogle, goooogle
+ Matches one or more of previous item gooo+gle matches goooogle, but not google.
? Matches zero or one of the previous item labou?r matches both labor and labour
| Inclusive "or"  a|b matches a or b, or both a and b

Anchors

^ Line starts with ^site matches site but not mysite
$ Line ends with site$ matches site but not sitescan

Grouping

() Capturing group Thank(s|you) matches both Thanks and Thankyou
[] Set or range of characters in any order [ogl]+ matches google,  goooogle, or logic
- Expresses a range of characters [A-Z] creates a list for the uppercase English alphabet

Other

\ Escape special characters mysite\.com keeps the dot from being a wildcard
\s Space character \s+.* matches one or more whitespace followed by zero or more characters
\d Digit \d65\d matches "265" not "256"
\w Word character (a-z, A-Z, 0-9, _) $\w matches any string starting with a word character, such as "Campaign" but not "@Campaign"
\b Word boundary \bcity\b matches " city " not "scarcity"

Example

  • if(regex_match(ITEM_TITLE, "\bLabou?r\b"), "Apple", "Pear")
    If ITEM_TITLE is "Ministry of Labour" or "Ministry of Labor", the formula returns "Apple". Otherwise, the formula returns "Pear".
    If ITEM_TITLE is "Ministry of labor", the regex_max function does not find a match, so the formula returns "Pear". (regular_expression in Search Ads 360 is case-sensitive)

Was this helpful?

How can we improve it?

Need more help?

Try these next steps:

true
Search
Clear search
Close search
Google apps
Main menu
902996860872884520
true
Search Help Center
true
true
true
true
true
263
false
false