NOMA Sync Docs

Appearance

Campaign Mapping Guide

Why Mapping Matters ​

Givebutter and Square use their own “campaign” or “location” concepts. LGL uses funds (and campaigns). NOMA Sync needs a mapping so every donation and order lands in the correct LGL fund.

All mapping is done in the Dashboard → Mappings page (no code change required for new campaigns or locations).

Givebutter: Type Defaults ​

  1. Open Dashboard → Mappings.
  2. Find the type defaults (or “Givebutter” section).
  3. For each transaction type (e.g. donation, ticket, peer_to_peer), set the default LGL fund (and optionally campaign, gift type, payment type).
  4. Save. All future Givebutter syncs of that type use this fund unless overridden.

Givebutter: Campaign Overrides ​

  1. In Mappings, open campaign overrides (or “Givebutter overrides”).
  2. Click Add override (or equivalent).
  3. Select the Givebutter campaign from the dropdown (list is cached from Givebutter API; use Refresh if you don’t see a new campaign).
  4. Select the LGL fund (and optional campaign).
  5. Save. All transactions for that Givebutter campaign now go to that fund.

Square: Type Default ​

  1. In Mappings, find the Square section.
  2. Set the Square type default – the default LGL fund for all Square orders when no location override applies.
  3. Save.

Square: Location Overrides ​

  1. In Mappings, open Square location overrides.
  2. Select a Square location (from the list pulled from Square API).
  3. Select the LGL fund (and optional campaign).
  4. Save. All orders from that Square location now use this fund.

Refreshing Data ​

  • Givebutter campaigns: Use Refresh in Mappings (or Settings) to pull the latest campaign list from Givebutter.
  • LGL funds: Use Settings → Refresh LGL reference data so new funds appear in Mappings dropdowns.

Examples ​

ScenarioAction
All general donations → UnrestrictedSet type default for "donation" to Unrestricted Fund.
"Rally 2026" event → Rally FundAdd campaign override: Givebutter campaign "Rally 2026" → LGL fund "Rally 2026".
Square online store → General FundSet Square type default to General Fund.
Square pop-up at event → Event FundAdd location override: that location → Event Fund.