albertsons · Schema

Performance Metric

Performance metrics for an advertising campaign at a given time period.

GroceryRetailRetail MediaAdvertisingCampaignsAnalyticsConsumer GoodsFoodPharmacy

Properties

Name	Type	Description
date	string	Date of the metric data point.
campaignId	string	Campaign identifier associated with these metrics.
impressions	integer	Number of ad impressions served.
clicks	integer	Number of ad clicks recorded.
conversions	integer	Number of conversions attributed to the campaign.
spend	number	Total ad spend in USD for the period.
roas	number	Return on ad spend ratio.
clickThroughRate	number	Click-through rate as a decimal (clicks / impressions).

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/albertsons/refs/heads/main/json-schema/retail-media-api-performance-metric-schema.json",
  "title": "Performance Metric",
  "description": "Performance metrics for an advertising campaign at a given time period.",
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "description": "Date of the metric data point.",
      "example": "2026-03-15"
    },
    "campaignId": {
      "type": "string",
      "description": "Campaign identifier associated with these metrics.",
      "example": "500123"
    },
    "impressions": {
      "type": "integer",
      "description": "Number of ad impressions served.",
      "example": 45000
    },
    "clicks": {
      "type": "integer",
      "description": "Number of ad clicks recorded.",
      "example": 675
    },
    "conversions": {
      "type": "integer",
      "description": "Number of conversions attributed to the campaign.",
      "example": 34
    },
    "spend": {
      "type": "number",
      "format": "double",
      "description": "Total ad spend in USD for the period.",
      "example": 1250.0
    },
    "roas": {
      "type": "number",
      "format": "double",
      "description": "Return on ad spend ratio.",
      "example": 4.2
    },
    "clickThroughRate": {
      "type": "number",
      "format": "double",
      "description": "Click-through rate as a decimal (clicks / impressions).",
      "example": 0.015
    }
  }
}