Google Ads

Explain why a metric moved

Decomposes a period-over-period change in one metric across campaigns, devices, networks, countries and search terms, and ranks the segments by how much of the total change each one accounts for. Use when: the user says something dropped, spiked or "looks wrong" and wants to know why. This is the right first tool for that question. Do not use when: the user just wants the numbers (google_get_campaign_performance) or a single dimension they already suspect (google_get_device_performance, google_get_geo_performance). Returns, per dimension, the segments that moved most, with their share of the total change. Read the top one or two lines and say what they mean — a change concentrated in one campaign is an account change, one spread evenly across every dimension is usually seasonality or an auction-wide shift you did not cause. Two cautions worth repeating to the user: a short window makes everything look dramatic, and conversions keep arriving for days after the click, so the most recent days always look worse than they will turn out to be. If you are unsure which account, campaign or period the user means, ask them — do not guess ids or dates.

post/api/v1/tools/google_explain_performance_anomaly/execute

Request

  • Base URL: https://adako.ai
  • URL: https://adako.ai/api/v1/tools/google_explain_performance_anomaly/execute
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Optional 8-128 character key. A successful envelope is cached for 24 hours; replaying the key with the same arguments returns it again with Idempotent-Replayed: true, and replaying it with different arguments answers 409.

Request body

Response

The tool ran. A write returns proposal_id and approve_url while the change waits for approval.

successunknown required
toolstring required
dataobject required

Machine-readable result.

markdownstring required

The same result written for a person or a model.

proposal_idstring

Present for writes. Nothing changes on the ad platform until it is approved.

approve_urlstring

Where a person approves the proposal.

request_idstring required

Changes

No recorded changes to this operation across all 1 revision of this API.