Sponsored Offer Lifecycle¶

Governs sponsored retail-media offers from preparation through consent-aware activation and attribution.

Object: sponsored-offer · States: 4 · Transitions: 2

State Diagram¶

flowchart LR

    %% ── classDef palette ─────────────────────────────────────
    classDef stInit  fill:#0d9488,stroke:#0f766e,color:#fff,font-weight:bold
    classDef stNorm  fill:#3b82f6,stroke:#2563eb,color:#fff
    classDef stOk    fill:#16a34a,stroke:#15803d,color:#fff,font-weight:bold
    classDef stFail  fill:#dc2626,stroke:#b91c1c,color:#fff,font-weight:bold
    classDef stHold  fill:#d97706,stroke:#b45309,color:#fff

    %% ── nodes ───────────────────────────────────────────────
    draft(["Draft"])
    active["Active"]
    attributed[["Attributed"]]
    expired[["Expired"]]

    %% ── transitions ─────────────────────────────────
    draft -->|"sponsored-offer-activated"| active
    active -->|"sponsored-offer-attributed"| attributed

    %% ── class assignments ───────────────────────────
    class draft stInit
    class active stNorm
    class attributed stOk
    class expired stFail

States¶

State	Label	Description	Initial	Terminal
`draft`	Draft	Sponsored offer is being configured and has not been activated.	✓
`active`	Active	Sponsored offer may be served to eligible audiences at approved touchpoints.
`attributed`	Attributed	A closed-loop attribution outcome has been recorded.		✓
`expired`	Expired	Offer is no longer eligible to be served or attributed.		✓

Transitions¶

From	To	Trigger	Guards
`draft`	`active`	`sponsored-offer-activated`	Audience policy; placement; effective dates; and attribution method are approved.
`active`	`attributed`	`sponsored-offer-attributed`	Exposure; order outcome; and consent evidence meet the approved attribution method.