The new Search Ads 360 Reporting API is now available. Join the
searchads-api-announcements Google group to stay up to date on upcoming enhancements and releases.
FAQ
This page collects some tips that could be useful when creating your first
queries.
Problem: A metric does not appear in results
Currency related metrics (e.g. metrics.cost_micros) need to include
segments.date
in the SELECT clause and in the WHERE clause.
Problem: CONTAINS operator does not work with a string field
When you need to check if a string field contains a substring, don't use the
CONTAINS
(or CONTAINS NOT
) operator.
CONTAINS
is meant to be used with fields that keep lists of values and you
want to check if the list contains one or more specific values.
To check the presence of a substring you can use REGEXP_MATCH
, for example
SELECT
customer.descriptive_name,
... // other fields
FROM
campaign
WHERE customer.descriptive_name REGEXEP_MATCH 'Customer.*'
Learn more
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-10-09 UTC.
[null,null,["Last updated 2024-10-09 UTC."],[[["Currency metrics like `metrics.cost_micros` require including `segments.date` in both the SELECT and WHERE clauses to appear in results."],["Avoid using the `CONTAINS` operator for substring checks in string fields; utilize `REGEX_MATCH` instead for this purpose."],["The `CONTAINS` operator is designed for verifying if a list-type field contains specific values."]]],["Currency metrics like `metrics.cost_micros` require `segments.date` in both the SELECT and WHERE clauses. The `CONTAINS` operator is not for substring searches within string fields; it's for checking value lists. Use `REGEXP_MATCH` to find substrings in string fields, as demonstrated with the example of searching `customer.descriptive_name` for patterns like 'Customer.*'.\n"]]