update_type | string or SelectableOption | No | - | Choose ‘single’ to upload one conversion from the individual fields, or ‘bulk’ to upload many conversions from a data source such as a Google Sheet. Defaults to ‘single’ |
account_id | string | No | - | The Google Ads account ID receiving the conversions, for example ‘123-456-7890’. Required in single mode; in bulk mode it can instead come from an ‘account_id’ column in the rows, with this field as the default |
login_account_id | string | No | - | Optional manager (MCC) account ID, when access to the account goes through a manager. In bulk mode it can also come from a ‘manager_account_id’ column in the rows |
conversion_action_id | string | No | - | The Google Ads conversion action ID the conversions are uploaded to. Must be an UPLOAD_CLICKS type conversion action (create one with gads_create_conversion_action). Required in single mode; in bulk mode it can instead come from a ‘conversion_action_id’ column in the rows, with this field as the default |
structured_data | array (also accepts a comma-separated string) | No | - | Bulk mode: rows of conversions from a previous node. Supported columns: ‘gclid’, ‘email’, ‘phone’, ‘event_time’ (RFC 3339 with timezone, ‘conversion_time’ also accepted), ‘conversion_value’, ‘currency’, ‘order_id’, ‘event_source’, and optionally ‘account_id’, ‘manager_account_id’, and ‘conversion_action_id’ to override the node-level values per row. Each row needs event_time and at least one of gclid, email, or phone. Emails and phones are normalized and SHA-256 hashed before sending |
gclid | string | No | - | Single mode: the Google click ID (gclid) that led to the conversion |
email | string | No | - | Single mode: email address of the converting user, used for matching when no click ID is available. Normalized and SHA-256 hashed before sending; a pre-hashed 64-character hex value is also accepted |
phone | string | No | - | Single mode: phone number of the converting user in E.164 format, for example ‘+14155550123’. Normalized and SHA-256 hashed before sending; a pre-hashed 64-character hex value is also accepted |
event_time | string | No | - | Single mode: when the conversion happened, in RFC 3339 format, for example ‘2026-08-25T14:30:00Z’ or ‘2026-08-25 14:30:00+04:00’. Must not be in the future |
conversion_value | number | No | - | Single mode: the value of the conversion for the advertiser |
currency | string | No | - | Single mode: ISO 4217 currency code for the conversion value, for example ‘USD’ |
order_id | string | No | - | Single mode: optional unique transaction or order ID, used to avoid duplicate conversions |
event_source | string or SelectableOption | No | - | Where the conversions originated, applied to all uploaded conversions. Options: ‘WEB’, ‘APP’, ‘IN_STORE’, ‘PHONE’, ‘MESSAGE’, ‘OTHER’. Defaults to ‘WEB’ (conversions attributed to ad clicks in a browser). In bulk mode an ‘event_source’ column can override it per row |
ad_user_data_consent | string or SelectableOption | No | - | Whether the users consented to ad user data, applied to all uploaded conversions. Options: ‘GRANTED’, ‘DENIED’ |
ad_personalization_consent | string or SelectableOption | No | - | Whether the users consented to ad personalization, applied to all uploaded conversions. Options: ‘GRANTED’, ‘DENIED’ |
validate_only | boolean | No | False | When true, validates the upload without applying it. Only errors are returned |
