The new Search Ads 360 Reporting API is now available. Join thesearchads-api-announcementsGoogle group to stay up to date on upcoming enhancements and releases.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[[["\u003cp\u003eCurrency metrics like \u003ccode\u003emetrics.cost_micros\u003c/code\u003e require including \u003ccode\u003esegments.date\u003c/code\u003e in both the SELECT and WHERE clauses to appear in results.\u003c/p\u003e\n"],["\u003cp\u003eAvoid using the \u003ccode\u003eCONTAINS\u003c/code\u003e operator for substring checks in string fields; utilize \u003ccode\u003eREGEX_MATCH\u003c/code\u003e instead for this purpose.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eCONTAINS\u003c/code\u003e operator is designed for verifying if a list-type field contains specific values.\u003c/p\u003e\n"]]],["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"],null,["# FAQ\n\nThis page collects some tips that could be useful when creating your first\nqueries.\n\nProblem: A metric does not appear in results\n--------------------------------------------\n\nCurrency related metrics (e.g. metrics.cost_micros) need to include\n`segments.date` in the SELECT clause and in the WHERE clause.\n\nProblem: CONTAINS operator does not work with a string field\n------------------------------------------------------------\n\nWhen you need to check if a string field contains a substring, don't use the\n`CONTAINS` (or `CONTAINS NOT`) operator.\n\n`CONTAINS` is meant to be used with fields that keep lists of values and you\nwant to check if the list contains one or more specific values.\n\nTo check the presence of a substring you can use `REGEXP_MATCH`, for example \n\n SELECT\n customer.descriptive_name,\n ... // other fields\n FROM\n campaign\n WHERE customer.descriptive_name REGEXEP_MATCH 'Customer.*'\n\nLearn more\n----------\n\n- [Sample queries](/search-ads/reporting/query/sample-queries)"]]