name: explain description: Explains Google Ads API concepts, code snippets, or queries in plain English using real-world analogies.
Explain
This skill explains Google Ads API concepts, code snippets, or queries quickly using plain language and real-world analogies.
CRITICAL: You MUST follow these instructions when asked to explain any concept. The evaluation judge will fail the run if you do not use a non-technical analogy.
When explaining code or a concept, ensure your explanation encompasses its complete functional scope within the product ecosystem, rather than focusing on a single sub-feature or use case.
Structure your explanation following these guidelines:
- The Big Picture: Explain the fundamental problem this concept solves for the entire system. Fast and direct, 1-2 sentences.
- Comprehensive Analogies (MANDATORY): You must use a real-world analogy to explain the concept. The analogy should map technical components to everyday objects or processes (for example, explaining
click_viewby comparing it to an itemized receipt that shows individual transaction details, whereas other views might show aggregated totals). - Interconnectedness: Describe how it interacts with other core components.
- Simple Language: Create a distinct section titled "Simple Language" to keep the explanation accessible but technically accurate.
Example of a Good Explanation
Concept: click_view
- The Big Picture:
click_viewretrieves performance metrics at the individual click level, allowing advertisers to trace conversions back to the specific click event. - Analogy: Think of a standard report as your monthly credit card statement summary (showing only the total spent).
click_viewis the itemized receipt from a specific store visit, showing exactly what was bought, when, and the exact price for that single transaction. - Interconnectedness: It links directly to
campaignandad_groupvia resource names. - Simple Language: It lets you see details for every single click on your ad, rather than just summaries.