Skip to main content
Glama

Metadata MCP Connector

Create Campaign — Channel First / Native Structure (N×N×N)

create_native_structure_campaign

Create a draft campaign using Channel First Structure (NxNxN), also called Native Structure. Audiences, ads, and offers are grouped within channel-specific containers. Returns the draft campaign and channel configuration or validation errors. This tool does not launch it.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "campaign_data": "<campaign_data>"
    },
    "name": "create_native_structure_campaign"
  }
}

Input Schema

NameRequiredDescriptionDefault
campaign_dataYesComplete Channel First / Native Structure (N×N×N) campaign configuration. Each channel takes a `containers` list; each container groups one audience with an `ad_offers` list of {ad, offer} pairs.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • changedInput schema / properties / campaign_data / properties / google / description
      Previous value: -"Google Ads Precision-Optimization block. All containers share one experiment. Each container can carry its own keyword group."New value: +"Google Ads Search Precision-Optimization block. All containers share one experiment. Each container can carry its own keyword group. This block builds a Search campaign; build a Performance Max one with google_pmax instead."
    • 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"
      +}
  2. First observed

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources