Budget optimization

Optimal spend allocation and predicted KPI per campaign, from Company.budgetOptimizationAnalytics. The input.kpi argument selects the KPI the optimization targets; budget periods come back as budgetStartDate/budgetEndDate pairs.

Field	Description
partner.id	Partner platform identifier assigned by Incremental
partner.name	Partner platform name
partnerCampaignId	Campaign ID on partner platform
partnerCampaignName	Campaign display name
budgetStartDate	Start date of the budget optimization period
budgetEndDate	End date of the budget optimization period
prevAdSpend	Previous/baseline advertising spend (what was actually spent). Daily figure for the period, in cents
optimalAdSpend	Recommended optimal ad spend amount. Daily figure for the period, in cents
prevKpi	Previous incremental sales achieved at baseline spend. Daily figure for the period
predictedKpi	Predicted incremental sales if optimal budget is used. Daily figure for the period
prevIRoi	Previous incremental ROI at baseline spend
optimalIRoi	Expected incremental ROI at optimal spend

query FetchBudgetOptimizationAnalytics($companyId: ID!) {
  getCompany(id: $companyId) {
    id
    budgetOptimizationAnalytics(
      input: { kpi: SALES }
      dimensions: [
        COMPANY_ID
        PARTNER_ID
        PARTNER_NAME
        PARTNER_CAMPAIGN_ID
        PARTNER_CAMPAIGN_NAME
        BUDGET_START_DATE
        BUDGET_END_DATE
      ]
      measures: [
        PREV_AD_SPEND
        OPTIMAL_AD_SPEND
        PREV_KPI
        PREDICTED_KPI
        PREV_I_ROI
        OPTIMAL_I_ROI
      ]
    ) {
      items {
        partner {
          id
          name
        }
        partnerCampaignId
        partnerCampaignName
        budgetStartDate
        budgetEndDate
        prevAdSpend
        optimalAdSpend
        prevKpi
        predictedKpi
        prevIRoi
        optimalIRoi
      }
      pageInfo {
        size
        page
        totalCount
        hasNextPage
      }
    }
  }
}

Variables

{
  "companyId": "<COMPANY_ID>"
}

Response

{
  "data": {
    "getCompany": {
      "id": "<COMPANY_ID>",
      "budgetOptimizationAnalytics": {
        "items": [
          {
            "partner": {
              "id": "4de0db3a-3f0f-48d9-88ca-23d0313f0c1c",
              "name": "Amazon Advertising"
            },
            "partnerCampaignId": "99999999999",
            "partnerCampaignName": "Campaign Name",
            "budgetStartDate": "2024-10-04T00:00:00.000Z",
            "budgetEndDate": "2024-11-01T00:00:00.000Z",
            "prevAdSpend": "1234.310344827586",
            "optimalAdSpend": "1234.00000000001",
            "prevKpi": "4500.751905977355",
            "predictedKpi": "5600.600000032",
            "prevIRoi": "6.247736885620005",
            "optimalIRoi": "6.576589146710412"
          }
        ],
        "pageInfo": {
          "size": 10,
          "page": 0,
          "totalCount": 100,
          "hasNextPage": true
        }
      }
    }
  }
}