Skip to main content

Budget groups

A budget group records which budget a campaign's spend comes out of, such as "Q3 Branded". Campaign-level recommendations roll up to the budget group, so you get one recommended spend to act on per budget. To break results out by budget group, see Budget optimization by budget group.

Setting one requires the Catalog Edit permission. Values are matched case-insensitively against the groups already in use, so the first spelling of a group is the one that sticks.

Set a budget group​

updatePartnerCampaigns takes a list. id is the campaign's Incremental id, not partnerCampaignId.

mutation ($input: [UpdatePartnerCampaignInput!]!) {
  updatePartnerCampaigns(input: $input) {
    items {
      id
      budgetGroup
    }
  }
}
Variables
{
  "input": [
    { "id": "<CAMPAIGN_ID_1>", "budgetGroup": "Q3 Branded" },
    { "id": "<CAMPAIGN_ID_2>", "budgetGroup": "q3 branded" },
    { "id": "<CAMPAIGN_ID_3>", "budgetGroup": "" }
  ]
}

Read the groups in use​

Returns every budget group in use by at least one campaign, sorted, in its stored casing.

query ($companyId: ID!) {
  getCompany(id: $companyId) {
    id
    campaignBudgetGroups
  }
}
Response
{
  "data": {
    "getCompany": {
      "id": "<COMPANY_ID>",
      "campaignBudgetGroups": ["Holiday Push", "Q3 Branded"]
    }
  }
}