Mapping to Google: score is Quality Score 1-10, expectedCtr is search_predicted_ctr, adRelevance is creative_quality_score, landingPageExperience is post_click_quality_score. The three ratings are BELOW_AVERAGE, AVERAGE or ABOVE_AVERAGE.
Every field is null when Google has not rated the keyword: too little traffic, or a negative keyword, which Google never rates. Google's own UNKNOWN and UNSPECIFIED buckets are reported as null too, so "unrated" has one representation rather than three.
The existing top-level qualityScore still works and still means the same thing; it is marked deprecated in favour of quality.score.
Worth being straight about what this was: the three component ratings were already being fetched from Google and stored on our side, and the API was simply dropping them on the way out. So this was a plumbing gap rather than new capability, and your report is what surfaced it.
Log in to comment and vote
Comments1
Miquel Palet López
Sep 15
Shipped and verified live on production data. All four are on
GET /v1/ads/keywords(and the single-keyword read) under aqualityobject:"quality": { "score": 3, "expectedCtr": "AVERAGE", "adRelevance": "BELOW_AVERAGE", "landingPageExperience": "BELOW_AVERAGE" }Mapping to Google:
scoreis Quality Score 1-10,expectedCtrissearch_predicted_ctr,adRelevanceiscreative_quality_score,landingPageExperienceispost_click_quality_score. The three ratings areBELOW_AVERAGE,AVERAGEorABOVE_AVERAGE.Every field is
nullwhen Google has not rated the keyword: too little traffic, or a negative keyword, which Google never rates. Google's own UNKNOWN and UNSPECIFIED buckets are reported as null too, so "unrated" has one representation rather than three.The existing top-level
qualityScorestill works and still means the same thing; it is marked deprecated in favour ofquality.score.Worth being straight about what this was: the three component ratings were already being fetched from Google and stored on our side, and the API was simply dropping them on the way out. So this was a plumbing gap rather than new capability, and your report is what surfaced it.