google_ads_conversions_create
Create a Google Ads conversion action to track and attribute conversions such as purchases or signups. Specify the conversion name, type, and category, with optional default value and attribution windows.
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. |