> ## Documentation Index
> Fetch the complete documentation index at: https://docs.virtuous.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Engagement Flow

> How campaigns, communications, segments, emails, and events connect to contacts and giving.

This page shows how campaign planning flows through outreach channels into contact engagement — and ultimately into gift attribution.

## Campaign planning

A campaign is the top-level initiative. It breaks into communications (channels) and then segments (recipient groups). The segment is the link back to giving — every gift carries a `SEGMENT_KEY` that traces it to the campaign that solicited it.

```mermaid theme={null}
flowchart TB
  GIFTS(["GIFTS"])

  subgraph Planning["Campaign Planning"]
    direction LR
    CAMPAIGNS["Campaigns"]
    COMMUNICATIONS["Communications"]
    SEGMENTS["Segments"]
  end

  subgraph Measurement["Measurement"]
    direction LR
    CONTACT_SEG_STATS["Contact Segment Stats"]
    COMM_STATS["Communication Stats"]
  end

  Planning -->|"SEGMENT_KEY"| GIFTS
  Planning --> Measurement

  classDef hub fill:#00A3E0,color:#ffffff,stroke:#081F2C,font-weight:bold
  classDef entity fill:#CEE7F2,color:#243746,stroke:#41B6E6
  class GIFTS hub
  class CAMPAIGNS,COMMUNICATIONS,SEGMENTS,CONTACT_SEG_STATS,COMM_STATS entity
  style Planning fill:#F0F8FF,stroke:#CEE7F2,color:#243746
  style Measurement fill:#F0F8FF,stroke:#CEE7F2,color:#243746
```

## Outreach channels

Campaigns deliver outreach through two primary channels — email and events. Both connect back to contacts, and contact engagement ultimately drives giving.

```mermaid theme={null}
flowchart TB
  CONTACTS(["CONTACTS"])
  GIFTS(["GIFTS"])

  subgraph EmailChannel["Email Channel"]
    direction LR
    EMAILS["Emails"]
    EMAIL_VERSIONS["Email Versions"]
    SENT_EMAILS["Sent Emails"]
  end

  subgraph EventChannel["Event Channel"]
    direction LR
    EVENTS["Events"]
    EVENT_TICKETS["Tickets"]
    EVENT_SPONSORSHIPS["Sponsorships"]
  end

  EmailChannel -->|"delivered to"| CONTACTS
  EventChannel -->|"attended by"| CONTACTS
  CONTACTS -->|"gives"| GIFTS

  classDef hub fill:#00A3E0,color:#ffffff,stroke:#081F2C,font-weight:bold
  classDef entity fill:#CEE7F2,color:#243746,stroke:#41B6E6
  class CONTACTS,GIFTS hub
  class EMAILS,EMAIL_VERSIONS,SENT_EMAILS,EVENTS,EVENT_TICKETS,EVENT_SPONSORSHIPS entity
  style EmailChannel fill:#F0F8FF,stroke:#CEE7F2,color:#243746
  style EventChannel fill:#F0F8FF,stroke:#CEE7F2,color:#243746
```