ReportingSearchTerm
Search term metadata in a report row.
Declaration
object ReportingSearchTermProperties
| Name | Type | Description |
|---|---|---|
campaignId | int64 | The identifier of the campaign that owns the search term. |
adAccountId | int64 | The identifier of the ad account that owns the search term. |
searchTermText | string | The actual user-entered query string. |
searchTermSource | string | Indicates whether the search term came from a direct user search or an auto-match source. |
keyword | ReportingKeyword | See ReportingKeyword for details. |
adGroupId | int64 | The identifier of the ad group that owns the search term. |
adGroup | ReportingAdGroupMin | See ReportingAdGroupMin for details. |
countryOrRegion | string | Country or region groupBy dimension value. |
deviceClass | string | Device class groupBy dimension value. |
Discussion
The ReportingSearchTerm object is the search term metadata embedded in search term report rows. The keyword field links the search term back to the keyword that matched it, enabling attribution of observed query behavior to specific bids.
Search term reports exclusively require the ORTZ timezone. UTC isn’t supported. The report populates the dimension fields (countryOrRegion, deviceClass) based on the groupBy dimensions in the report request. The adGroup field provides a lightweight parent ad group summary for display and grouping purposes.
Example
{
"campaignId": 123456789,
"adAccountId": 987654321,
"searchTermText": "awayfinder travel app",
"searchTermSource": "SEARCH",
"keyword": {
"id": 555666777,
"campaignId": 123456789,
"adAccountId": 987654321,
"deleted": false,
"text": "awayfinder travel app",
"status": "ENABLED",
"matchType": "BROAD",
"bid": {
"currency": "USD",
"amount": "1.50"
},
"adGroupId": 234567891,
"modificationTime": "2025-01-10T08:00:00.000",
"creationTime": "2025-01-05T08:00:00.000",
"displayStatus": "RUNNING",
"adGroup": {
"name": "AwayFinder Search - Broad",
"deleted": false
},
"countryOrRegion": "US",
"deviceClass": "IPHONE"
},
"adGroupId": 234567891,
"adGroup": {
"name": "AwayFinder Search - Broad",
"deleted": false
},
"countryOrRegion": "US",
"deviceClass": "IPHONE"
}