検索語句とは、買ったキーワードではなく、人が実際に入力した言葉です。その差のところに無駄な出費の大半があり、それを読むのは、何も変更できない 1 回の呼び出しです。
呼び出し
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 がレポートするものはすべて、この方法で尋ねられます。キャンペーン、広告グループ、キーワード、広告、アセット、予算、コンバージョン、オーディエンス、変更履歴。1 回の応答は最大 200 行です。
返ってきたものを読む
- 費用はマイクロ単位です。1,000,000 マイクロがアカウントの通貨の 1 単位です。4,310,000 の語句なら、費用は 4.31 です。
- 30 日間で支出があるのにコンバージョンがない語句は、最初に見るものです。たいていの答えは、入札の調整ではなく除外キーワードです。
- GET はクエリを URL に入れます。同じアドレスへの POST は、URL に収まらない長いクエリのために、本文に入れます。どちらも読むだけです。
このレシピのどれも、アカウントを変えられません。レポートは読み取りで、何かを変更する呼び出しは別のもので、その先には人がいます。
よくある質問
GAQL を知っている必要はありますか？
手でクエリを書くなら必要ですが、SQL に近いので、学ばなくても読めます。実際には、このキーの AI エージェントが、あなたが言葉で頼んだことからクエリを書き、実行し、行を読み上げます。
なぜマイクロ単位なのですか？
Google がお金をそう報告するので、ここもそう答えます。100 万分の 1 を単位にした整数で、通貨の端数を持ち回ると出る丸め誤差を避けられます。100 万で割れば、人が口にする金額になります。
レポートでアカウントに触れてしまうことはありますか？
ありません。レポートの呼び出しは SELECT 以外を拒否するので、これを通してアカウントを変えられるクエリは存在しません。ここでの間違いは、わかりにくい応答が返るだけで、ほかに損はありません。