google_ads_conversions_create
Create a new conversion action in Google Ads to track website or offline conversions. Customize name, type, category, and attribution windows. Returns the resource name of the newly created conversion action.
Instructions
Create a new Google Ads conversion action. Returns {resource_name:'customers//conversionActions/'} of the newly created row. Mutating — the conversion action is persisted with status ENABLED by default. Reversible via google_ads_conversions_update with status='REMOVED' or google_ads_conversions_remove. Name must be <= 256 characters. Category defaults to 'DEFAULT'. For updating an existing action use google_ads_conversions_update.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| customer_id | No | Google Ads customer ID as a 10-digit string without dashes (e.g. '1234567890'). Optional — falls back to GOOGLE_ADS_CUSTOMER_ID / GOOGLE_ADS_LOGIN_CUSTOMER_ID from the configured credentials when omitted. | |
| name | Yes | Human-readable conversion action name shown in the Google Ads UI (e.g. 'Purchase - Checkout Complete'). Required. Max 256 characters. | |
| type | No | ConversionActionType enum. Default 'WEBPAGE' (site tag fires). Use 'UPLOAD_CLICKS' for offline-conversion uploads or 'WEBSITE_CALL' for call conversions. | |
| category | No | Conversion category. Default 'DEFAULT'. Smart bidding uses this to group similar goals. | |
| default_value | No | Default monetary conversion value in account currency (e.g. 5000 = ¥5,000). Used when the site tag does not send a value. | |
| always_use_default_value | No | When true, always use default_value even if the site tag sends a dynamic value. | |
| click_through_lookback_window_days | No | Click-through attribution window in days (1-90). Server-side validated — invalid values raise ValueError. | |
| view_through_lookback_window_days | No | View-through attribution window in days (1-30). Server-side validated. |