addedInput schema / properties / campaign_data / properties / google_pmax
Added value: +{
+ "additionalProperties": false,
+ "description": "The Google Ads channel as Performance Max, in place of the google block: one asset group (a Performance Max ad, a landing page offer and an audience signal), bidding, daily budget and channel settings, as the Classic campaign builder sets them. Keywords, more asset groups or ads, lead gen offers, other ad types and other bid strategies are refused. Needs the account's Performance Max access.",
+ "properties": {
+ "asset_group": {
+ "additionalProperties": false,
+ "description": "The campaign's one asset group.",
+ "properties": {
+ "ad_id": {
+ "description": "Performance Max ad from create_update_google_pmax_ad.",
+ "type": "integer"
+ },
+ "name": {
+ "description": "Asset group name (default 'Asset Group 1').",
+ "maxLength": 255,
+ "type": "string"
+ },
+ "offer_id": {
+ "description": "Landing page offer; lead gen offers are refused.",
+ "type": "integer"
+ },
+ "target_group_id": {
+ "description": "Audience signal from create_google_target_group.",
+ "type": "integer"
+ }
+ },
+ "required": [
+ "ad_id",
+ "offer_id",
+ "target_group_id"
+ ],
+ "type": "object"
+ },
+ "bidding": {
+ "additionalProperties": false,
+ "description": "Bid strategy (MAXIMIZE_CONVERSIONS on a new channel when omitted). TARGET_CPA and TARGET_ROAS are for Lead Gen campaigns only, as in the Classic builder. A dailyBudget is saved under a plain maximize bid and the target bid is set again after it.",
+ "properties": {
+ "strategy": {
+ "enum": [
+ "MAXIMIZE_CONVERSIONS",
+ "MAXIMIZE_CONVERSION_VALUE",
+ "TARGET_CPA",
+ "TARGET_ROAS"
+ ],
+ "type": "string"
+ },
+ "target_cpa": {
+ "description": "Target cost per conversion, a whole amount in the same currency as the daily budget, for TARGET_CPA.",
+ "maximum": 9999999999,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "target_roas_percent": {
+ "description": "Target return on ad spend in percent (400 is 4x), for TARGET_ROAS.",
+ "maximum": 100000,
+ "minimum": 1,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "strategy"
+ ],
+ "type": "object"
+ },
+ "dailyBudget": {
+ "description": "Daily budget in USD (platform minimum $10).",
+ "minimum": 10,
+ "type": "number"
+ },
+ "excluded_devices": {
+ "description": "Devices the campaign does not show on, never all three; replaces the current list.",
+ "items": {
+ "enum": [
+ "DESKTOP",
+ "MOBILE",
+ "TABLET"
+ ],
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "excluded_locations": {
+ "additionalProperties": false,
+ "description": "Where the Google Ads Performance Max campaign must NOT serve — the UI's Negative Locations editor under Advanced Settings. WARNING: COUNTRY-LEVEL ONLY: the platform stores exclusions as bare location ids with no country/state discriminator and state ids overlap country ids, so an excluded state would be read back as an unrelated country. To narrow within a country, target the states you want via `locations.states` instead.",
+ "properties": {
+ "countries": {
+ "description": "Country NAMES to exclude, e.g. [\"India\", \"Pakistan\"].",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "type": "object"
+ },
+ "extension_ids": {
+ "description": "Library extensions (list_extensions) to attach beside any already attached; image, business logo and business name extensions are refused for Performance Max.",
+ "items": {
+ "type": "integer"
+ },
+ "type": "array"
+ },
+ "final_url_suffix": {
+ "description": "Query parameters added to the landing page URL, without a leading ? or #; on Performance Max it replaces the automatic UTM tracking. An empty string clears it.",
+ "maxLength": 2048,
+ "type": "string"
+ },
+ "languages": {
+ "description": "Languages by the platform's language names (for example ENGLISH, SPANISH); replaces the current list.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "location_targeting": {
+ "description": "Reach people in the locations (PRESENCE, the platform default) or also people interested in them.",
+ "enum": [
+ "PRESENCE",
+ "PRESENCE_OR_INTEREST"
+ ],
+ "type": "string"
+ },
+ "locations": {
+ "additionalProperties": false,
+ "description": "Where the Google Ads Performance Max campaign SERVES — the UI's Location picker. WARNING: OMITTING THIS LEAVES THE PLATFORM DEFAULT OF UNITED STATES. Set it whenever the user names a geography.",
+ "properties": {
+ "countries": {
+ "description": "Country NAMES to target, e.g. [\"United States\", \"Canada\"]. Common shorthand resolves (\"USA\", \"UK\"). An unrecognised name is rejected, not skipped.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "states": {
+ "description": "US state NAMES to target, e.g. [\"Texas\", \"California\"]. US-only. Naming states without countries keeps the channel's current countries.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "type": "object"
+ },
+ "negative_keyword_lists": {
+ "description": "Negative keyword list names to attach.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "url_exclusions": {
+ "description": "Landing page URLs Google may not send traffic to; replaces the current list.",
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "operator": {
+ "enum": [
+ "CONTAINS",
+ "EQUALS"
+ ],
+ "type": "string"
+ },
+ "value": {
+ "maxLength": 2048,
+ "type": "string"
+ }
+ },
+ "required": [
+ "operator",
+ "value"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "asset_group"
+ ],
+ "type": "object"
+}