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.
How to read event data in Klaviyo
Section titled “How to read event data 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' }}Campaign details on referral events
Section titled “Campaign details on referral events”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.
Referral events
Section titled “Referral events”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 |
What a successful referral carries
Section titled “What a successful referral carries”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.
Why a referral was made ineligible
Section titled “Why a referral was made ineligible”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 |
What isn’t sent
Section titled “What isn’t sent”Plan your emails around these gaps:
- The friend’s name and the order number are never sent.
BLOOP - Successful referralcarries the friend’s email only. - The order amount is only on
BLOOP - Referral purchase pending, not onBLOOP - 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 programflow. Reach them with a segment instead.
When an event doesn’t fire
Section titled “When an event doesn’t fire”- Joining a second campaign.
BLOOP - Join programfires 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 programorBLOOP - Left campaignevents 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
Section titled “Affiliate events”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 |
Related
Section titled “Related”- How to connect Klaviyo - the connection, profile properties and segments
- How to build referral flows in Klaviyo - welcome and reward flows, step by step
- How to configure referral email notifications - the emails Bloop sends itself
- How to control when a reward is issued and revoked - why a reward is pending before it’s issued

