Measurement

Daily measured incremental impact, spend, and incremental ROI per campaign, from the nested getCompany.adLift.measurement.advertisingFactors.campaigns field.

Select what you need with measures and dimensions, narrow the period with a reportDate filter, paginate with page, and order with sort. The input.kpi argument selects the KPI the measurement targets. Each item is an AdLiftAdvertisingFactorRecord.

Field	Description
reportDate	Date of the measurement period
partner.id	Partner platform identifier assigned by Incremental
partner.name	Partner platform name (e.g., Amazon, Walmart)
partnerCampaignId	Campaign ID on the partner platform
partnerCampaignName	Campaign display name
partnerCampaignType	Type of campaign (e.g., SPONSORED_PRODUCTS, DISPLAY)
partnerCampaignFunnelObjective	Funnel stage: AWARENESS, CONSIDERATION, CONVERSION, or RETENTION
partnerCampaignTargetingTactic	Targeting approach: BLENDED, BRANDED, CATEGORY, or CONQUEST
rawAdSpend	Total advertising spend amount
totalResponse	The incremental sales dollars attributed to this campaign by the attribution model
totalIRoi	Incremental ROI = totalResponse / rawAdSpend
impressions	Total ad impressions
clicks	Total clicks
engagements	Total engagements
conversions	Total conversions
adAttributedSales	Sales attributed to the campaign
unitsOrdered	Number of units ordered
returnOnAdSpend	Traditional ROAS = adAttributedSales / rawAdSpend

note

All rawAdSpend / totalResponse / adAttributedSales values are reported in cents — divide by 100 to convert to dollars. totalResponse is representative of incremental sales.

query FetchCampaignMeasurementAnalytics($companyId: ID!) {
  getCompany(id: $companyId) {
    id
    adLift {
      measurement {
        advertisingFactors {
          campaigns(
            measures: [
              RAW_AD_SPEND
              TOTAL_RESPONSE
              TOTAL_I_ROI
              IMPRESSIONS
              CLICKS
              ENGAGEMENTS
              CONVERSIONS
              AD_ATTRIBUTED_SALES
              UNITS_ORDERED
              RETURN_ON_AD_SPEND
            ]
            dimensions: [
              REPORT_DATE
              COMPANY_ID
              PARTNER_ID
              PARTNER_NAME
              PARTNER_CAMPAIGN_ID
              PARTNER_CAMPAIGN_NAME
              PARTNER_CAMPAIGN_TYPE
              PARTNER_CAMPAIGN_FUNNEL_OBJECTIVE
              PARTNER_CAMPAIGN_TARGETING_TACTIC
            ]
            input: { kpi: SALES }
            filter: [
              {
                reportDate: {
                  between: [
                    "2025-01-01T00:00:00.000Z"
                    "2025-01-31T23:59:59.999Z"
                  ]
                }
              }
            ]
            page: { page: 0, limit: 10 }
            sort: [{ sortKey: REPORT_DATE }, { sortKey: PARTNER_CAMPAIGN_ID }]
          ) {
            items {
              reportDate
              partner {
                id
                name
              }
              partnerCampaignId
              partnerCampaignName
              partnerCampaignType
              partnerCampaignFunnelObjective
              partnerCampaignTargetingTactic
              rawAdSpend
              totalResponse
              totalIRoi
              impressions
              clicks
              engagements
              conversions
              adAttributedSales
              unitsOrdered
              returnOnAdSpend
            }
            pageInfo {
              size
              page
              totalCount
              hasNextPage
            }
          }
        }
      }
    }
  }
}

Variables

{
  "companyId": "<COMPANY_ID>"
}

Response

{
  "data": {
    "getCompany": {
      "id": "<COMPANY_ID>",
      "adLift": {
        "measurement": {
          "advertisingFactors": {
            "campaigns": {
              "items": [
                {
                  "reportDate": "2025-01-01",
                  "partner": {
                    "id": "4de0db3a-3f0f-48d9-88ca-23d0313f0c1c",
                    "name": "Amazon Advertising"
                  },
                  "partnerCampaignId": "99999999999",
                  "partnerCampaignName": "Campaign Name",
                  "partnerCampaignType": "SPONSORED_PRODUCTS",
                  "partnerCampaignFunnelObjective": "CONVERSION",
                  "partnerCampaignTargetingTactic": "BLENDED",
                  "rawAdSpend": 1000,
                  "totalResponse": 2000,
                  "totalIRoi": 2,
                  "impressions": 500,
                  "clicks": 20,
                  "engagements": 20,
                  "conversions": 8,
                  "adAttributedSales": 7000,
                  "unitsOrdered": 8,
                  "returnOnAdSpend": 7
                }
              ],
              "pageInfo": {
                "size": 10,
                "page": 0,
                "totalCount": 100,
                "hasNextPage": true
              }
            }
          }
        }
      }
    }
  }
}