{
  "schema": "causal-showcase-manifest/1",
  "slug": "targeted-promotion",
  "version": "1.3",
  "title": "Targeted Promotion with Virtual Buyers",
  "question": "Which customers should receive a 10% offer when inventory and fulfillment capacity are limited?",
  "lastValidated": "2026-10-28",
  "evidence": "Validated",
  "scenario": {
    "objective": "Maximize expected profit while keeping stockout probability under 20%.",
    "runs": 2000,
    "params": [
      {
        "key": "share",
        "label": "Share of customers targeted",
        "min": 0,
        "max": 60,
        "step": 5,
        "default": 10,
        "unit": "%"
      },
      {
        "key": "discount",
        "label": "Discount depth",
        "min": 5,
        "max": 25,
        "step": 5,
        "default": 10,
        "unit": "%"
      },
      {
        "key": "inventory",
        "label": "Seasonal inventory",
        "min": 30,
        "max": 60,
        "step": 5,
        "default": 45,
        "unit": "k units"
      }
    ],
    "alternatives": [
      {
        "name": "No offer",
        "description": "Baseline season without promotion.",
        "params": {
          "share": 0,
          "discount": 10,
          "inventory": 45
        }
      },
      {
        "name": "Loyalty targeting",
        "description": "Current practice: top 30% most loyal customers.",
        "params": {
          "share": 30,
          "discount": 10,
          "inventory": 45
        }
      },
      {
        "name": "Uplift top 10%",
        "description": "Recommended: highest-uplift segments only.",
        "params": {
          "share": 10,
          "discount": 10,
          "inventory": 45
        }
      },
      {
        "name": "Uniform offer",
        "description": "Everyone gets 10% off.",
        "params": {
          "share": 60,
          "discount": 10,
          "inventory": 45
        }
      }
    ],
    "metrics": [
      {
        "key": "profit",
        "label": "Expected profit",
        "unit": "k$",
        "base": 1840,
        "sd": 70,
        "higherIsBetter": true,
        "sensitivity": {
          "share": 9.5,
          "discount": -14,
          "inventory": 6
        },
        "curvature": {
          "share": -0.32,
          "discount": -0.8
        }
      },
      {
        "key": "conversion",
        "label": "Conversion",
        "unit": "%",
        "base": 21.8,
        "sd": 0.6,
        "higherIsBetter": true,
        "sensitivity": {
          "share": 0.14,
          "discount": 0.22,
          "inventory": 0.02
        }
      },
      {
        "key": "stockout",
        "label": "Stockout probability",
        "unit": "%",
        "base": 14,
        "sd": 2,
        "higherIsBetter": false,
        "sensitivity": {
          "share": 0.62,
          "discount": 0.7,
          "inventory": -1.4
        },
        "constraint": {
          "max": 20,
          "label": "Limit 20%"
        }
      }
    ]
  },
  "technical": {
    "dag": [
      [
        "Loyalty",
        "Offer"
      ],
      [
        "Loyalty",
        "Purchase"
      ],
      [
        "Expected demand",
        "Offer"
      ],
      [
        "Expected demand",
        "Purchase"
      ],
      [
        "Offer",
        "Purchase"
      ],
      [
        "Purchase",
        "Inventory"
      ],
      [
        "Inventory",
        "Stockout"
      ],
      [
        "Stockout",
        "Retention"
      ]
    ],
    "estimand": "CATE(x) = E[Y(1) − Y(0) | segment = x], Y = purchase within 14 days",
    "assumptions": [
      "No unmeasured confounding given loyalty and expected demand",
      "Positivity: every segment has offer and no-offer customers",
      "No interference between customers outside the social edges modeled",
      "Effects stable within the season"
    ],
    "equations": [
      "Inventory(t+1) = Inventory(t) − Fulfilled(t) + Replenishment(t)",
      "P(buy | offer) = σ(β₀ + β·x + τ(x))",
      "Profit = Σ margin·orders − discount cost − stockout penalty"
    ],
    "engines": {
      "Causal": "causal-core 3.4.1",
      "Twins": "twin-runtime 2.8.0",
      "DES": "des-kernel 5.1.2",
      "ABM": "agentflow 1.9.3",
      "Monte Carlo": "mc-sampler 4.0.0",
      "Optimization": "policy-opt 2.2.5"
    },
    "seed": 20261028,
    "validation": [
      {
        "name": "Held-out Brier score",
        "value": "0.081"
      },
      {
        "name": "Backlog reproduction error",
        "value": "5.8%"
      },
      {
        "name": "Placebo uplift",
        "value": "0.003 (ns)"
      }
    ]
  },
  "provenance": {
    "authors": [
      "Platform Education Team"
    ],
    "reviewers": [
      "Causal Methods Review Board"
    ],
    "rights": "CC BY 4.0. Synthetic data generated by the platform.",
    "sourceData": "Synthetic customers, orders, promotions, inventory, fulfillment events and social edges (seed 20261028).",
    "changelog": [
      {
        "version": "1.3",
        "date": "2026-10-28",
        "note": "Revalidated after twin-runtime 2.8 upgrade."
      },
      {
        "version": "1.2",
        "date": "2026-06-11",
        "note": "Added inventory stress case."
      },
      {
        "version": "1.0",
        "date": "2026-02-03",
        "note": "Initial publication."
      }
    ]
  },
  "exportedAt": "2026-11-18T23:10:21.065Z"
}