AdspirerInstall

Summary

Explain the cause of a performance anomaly for a specified metric within a given date range on the Google Ads platform.

Inputs

• Platform (required) — Select the advertising platform; for this operation, only 'Google Ads' is relevant.
• Customer Id — Google Ads customer ID; required when Platform is Google Ads.
• Metric (required) — The performance metric to analyze, must be one of: 'roas', 'ctr', 'cpc', 'conversions', or 'conversion_rate'.
• Period Start (required) — Start date of the anomaly period in ISO format (YYYY-MM-DD).
• Period End (required) — End date of the anomaly period in ISO format (YYYY-MM-DD).
• Raw Data — If true, the response returns only raw metric data as a JSON code block, omitting severity labels, recommendations, and benchmarks.

Output shape

a JSON object containing the explanation of the anomaly based on the specified metric and period on Google Ads; or raw metric data if requested

The returned data structure varies based on the 'Raw Data' flag: if true, only raw metrics are returned; otherwise, the output includes detailed severity labels, suggested bids/budgets, industry benchmarks, and optimization recommendations.

Examples

Example 1: Analyze the cause of a decrease in ROAS on a Google Ads account for a specified week.

Set Platform to 'Google Ads', input Customer Id, specify 'roas' as Metric, and provide start and end dates for the anomaly period. Optionally set Raw Data to false to receive detailed explanations.

Links

• n8n community nodes installation guide