{
  "template_name": "Weekly Google Ads client report",
  "status": "original sample; proposed report input schema",
  "fields": [
    {
      "key": "client_id",
      "type": "foreign-key",
      "required": true
    },
    {
      "key": "ad_account_id",
      "type": "text",
      "required": true
    },
    {
      "key": "period_start",
      "type": "date",
      "required": true
    },
    {
      "key": "period_end",
      "type": "date",
      "required": true
    },
    {
      "key": "timezone",
      "type": "iana-timezone",
      "required": true
    },
    {
      "key": "currency",
      "type": "iso-currency",
      "required": true
    },
    {
      "key": "campaign_id",
      "type": "text",
      "required": true
    },
    {
      "key": "campaign_name",
      "type": "text",
      "required": true
    },
    {
      "key": "impressions",
      "type": "nonnegative-integer",
      "required": true
    },
    {
      "key": "clicks",
      "type": "nonnegative-integer",
      "required": true
    },
    {
      "key": "cost",
      "type": "nonnegative-decimal",
      "required": true
    },
    {
      "key": "conversions",
      "type": "nonnegative-decimal",
      "required": true
    },
    {
      "key": "conversion_source",
      "type": "text",
      "required": true
    },
    {
      "key": "conversion_action",
      "type": "text",
      "required": true
    },
    {
      "key": "imported_at",
      "type": "datetime-with-offset",
      "required": true
    }
  ],
  "derived_metrics": {
    "ctr": "clicks / impressions",
    "average_cpc": "cost / clicks",
    "conversion_rate": "conversions / clicks",
    "cost_per_conversion": "cost / conversions"
  },
  "rules": [
    "Group totals only within matching currency, date range, time zone, and conversion definition.",
    "Treat zero denominators as unavailable, not zero.",
    "Keep report access scoped to the client owner and assigned agency staff.",
    "Select one conversion action per report; reject duplicate account-campaign-period keys."
  ]
}