검색어는 사들인 키워드가 아니라 사람들이 실제로 입력한 말입니다. 둘의 차이에 낭비되는 지출의 대부분이 있고, 그것을 읽는 일은 아무것도 바꿀 수 없는 호출 한 번입니다.
호출
curl -sG https://top-rated.team/google-ads/v1/accounts/1234567890/report \ -H "X-API-KEY: $MAKEHYBRID_KEY" \ --data-urlencode 'query=SELECT search_term_view.search_term, metrics.impressions, metrics.clicks, metrics.cost_micros, metrics.conversions FROM search_term_view WHERE segments.date DURING LAST_30_DAYS ORDER BY metrics.cost_micros DESC' \ --data-urlencode 'max_rows=200'
쿼리는 Google Ads Query Language이며, Google이 보고하는 것은 모두 이 방식으로 물을 수 있습니다. 캠페인, 광고 그룹, 키워드, 광고, 애셋, 예산, 전환, 잠재고객, 변경 기록. 응답 한 번에 최대 200행입니다.
돌아온 것 읽기
- 비용은 마이크로 단위입니다. 1,000,000 마이크로가 계정 통화의 1 단위입니다. 4,310,000인 검색어의 비용은 4.31입니다.
- 30일 동안 지출은 있는데 전환이 없는 검색어가 가장 먼저 볼 것이며, 보통의 답은 입찰 조정이 아니라 제외 키워드입니다.
- GET은 쿼리를 URL에 담습니다. 같은 주소로의 POST는 URL에 들어가지 않는 긴 쿼리를 위해 본문에 담습니다. 둘 다 읽기만 합니다.
이 레시피의 어떤 것도 계정을 바꿀 수 없습니다. 보고는 읽기이고, 무언가를 바꾸는 호출은 다른 것이며, 그 끝에는 사람이 있습니다.
자주 묻는 질문
GAQL을 알아야 하나요?
쿼리를 직접 쓰려면 알아야 하지만, SQL과 비슷해서 배우지 않아도 읽을 수 있습니다. 실제로는 이 키의 AI 에이전트가 말로 부탁한 내용에서 쿼리를 쓰고, 실행하고, 행을 읽어 줍니다.
왜 마이크로 단위인가요?
Google이 돈을 그렇게 보고하므로 여기서도 그렇게 답합니다. 백만분의 일 단위의 정수라서, 통화의 소수 단위를 주고받을 때 생기는 반올림 오차를 피할 수 있습니다. 백만으로 나누면 사람이 말하는 금액이 됩니다.
보고가 계정에 손댈 수 있나요?
아니요. 보고 호출은 SELECT가 아닌 것은 거부하므로, 이것을 통해 계정을 바꿀 수 있는 쿼리는 없습니다. 여기서 실수하면 헷갈리는 응답을 받을 뿐 다른 손해는 없습니다.