Skip to content

Understanding Klaviyo events and properties

Each event Bloop sends shows up in Klaviyo as a metric. This page lists what every event carries, so you know which values you can print in an email and which ones you can branch a flow on. To connect Klaviyo first, see How to connect Klaviyo. To build flows from these events, see How to build referral flows in Klaviyo.

Event data is only available inside a flow triggered by that event. Read a value with the event lookup, using the exact name from the tables below:

{{ event|lookup:'BLOOP - Referral link' }}

Profile properties work everywhere, in flows and campaigns, with the person lookup:

{{ person|lookup:'BLOOP Hub Portal' }}

Most referral events carry the same four campaign values. The tables below call them the campaign details.

Event property What it holds
BLOOP - Campaign name The campaign’s name
BLOOP - Campaign id The campaign’s id. Use it to limit a flow to one campaign
BLOOP - Referral link The referrer’s own referral link for that campaign
BLOOP - Referral code The referrer’s own referral code for that campaign. It’s the code they share, not a reward

Two events don’t carry them: BLOOP - Referee receives discount and BLOOP - Removed from program.

Every referral event lands on the referrer’s profile, except BLOOP - Referee receives discount, which lands on the referred friend’s profile.

Metric Fires when Data on the event
BLOOP - Join program A customer becomes a referrer for the first time Campaign details
BLOOP - Referral sharing A referrer sends the share-by-email form Campaign details, BLOOP - Referred emails (the addresses they typed)
BLOOP - Referral purchase pending A friend’s order is tracked and the reward is waiting, for example during the review period Campaign details, BLOOP - Purchase amount, BLOOP - Currency
BLOOP - Successful referral The referrer’s reward is issued Campaign details, BLOOP - Successful referee email, BLOOP - Referrer reward type, BLOOP - Referrer code, BLOOP - Reward expiry date
BLOOP - Referral made ineligible A referral is rejected, or its order is cancelled or refunded Campaign details, BLOOP - Reason
BLOOP - Referee receives discount The referred friend gets their discount code BLOOP - Referee discount code
BLOOP - Left campaign One customer stops qualifying for a campaign’s audience BLOOP - Campaign name and BLOOP - Campaign id only. The link and code are left empty on purpose
BLOOP - Removed from program You ban a referrer in the Fraud Center No event data

BLOOP - Successful referral is the event most reward emails start from. What it carries depends on the reward:

Value Discount code Free product Store credit Cash Custom
BLOOP - Referrer reward type DISCOUNT FREE_PRODUCT CREDIT CASH CUSTOM
BLOOP - Referrer code The reward code The reward code Empty Empty Empty
BLOOP - Reward expiry date When set When set When set Empty Empty

The same event also updates three profile properties, so later emails can still show the latest reward: BLOOP - Referrer reward type, BLOOP - Referrer code, and BLOOP - Referrer Reward. BLOOP - Referrer Reward holds the reward code for a discount or free product, and the amount for store credit or cash.

BLOOP - Reason is a short label for your own use. It isn’t written for customers, so branch on it and don’t print it in an email.

Value Meaning
Order cancelled / Order refunded The friend’s order was cancelled or refunded before the reward was issued
Rejected You rejected the referral yourself
Disqualified The referral stopped qualifying, for example when the referrer is banned
A code in capitals, such as SELF_REFERRAL_EMAIL A fraud signal. Several signals are joined with commas

Plan your emails around these gaps:

  • The friend’s name and the order number are never sent. BLOOP - Successful referral carries the friend’s email only.
  • The order amount is only on BLOOP - Referral purchase pending, not on BLOOP - Successful referral.
  • The friend’s discount arrives as a code only, with no value and no expiry date. State the offer and its expiry in the email text.
  • Past events aren’t replayed. Connecting Klaviyo or pressing Re-sync profiles creates and updates profiles, not events. A referrer who joined before you connected never triggers a BLOOP - Join program flow. Reach them with a segment instead.
  • Joining a second campaign. BLOOP - Join program fires once, when someone first becomes a referrer. Later campaigns update their profile and the campaign segment.
  • Bulk audience changes. When many customers move in or out of a campaign at once, profiles and segments update but no BLOOP - Join program or BLOOP - Left campaign events fire.
  • Ending or disabling a campaign. It doesn’t fire BLOOP - Left campaign. Press Re-sync profiles after you disable a campaign.
  • The section is off. Nothing is sent while the Referral program or Affiliate program switch on the Klaviyo page is off.
  • No email address. A referrer or affiliate without an email has no Klaviyo profile to attach an event to.

Affiliate events land on the affiliate’s profile. Every one carries BLOOP Affiliate status (approved, pending or rejected) and BLOOP Affiliate coupon, plus BLOOP Affiliate link when the affiliate has a link and BLOOP Affiliate Campaigns when their campaign is known.

Metric Fires when Extra data on the event
BLOOP - Affiliate joined program Someone signs up through your registration form, whether or not they need approval None
BLOOP - Affiliate added manually You add an affiliate yourself None
BLOOP - Affiliate approved / BLOOP - Affiliate rejected An application is approved or rejected, including automatic approval None
BLOOP - Affiliate new coupon An affiliate gets a new coupon None
BLOOP - Affiliate new sale A sale is recorded for an affiliate, before you review it BLOOP Affiliate order name, BLOOP Affiliate commission amount, BLOOP Affiliate currency
BLOOP - Affiliate sale approved / BLOOP - Affiliate sale declined You approve or decline a sale The same three values as a new sale
BLOOP - Affiliate payout paid You mark a payout as paid BLOOP Affiliate commission amount, BLOOP Affiliate sale count, BLOOP Affiliate currency