For the complete documentation index, see llms.txt. This page is also available as Markdown.

Create a VIP purchase event

Use your loyalty app's VIP tier or points data to send a separate VIP purchase event to Meta, so your campaigns optimize for your most loyal customers.

What you'll build

A VIPPurchase event that fires only when a top-tier loyalty customer buys. You'll expose your loyalty app's data with a custom data source, then create a custom event conditioned on it.

Your loyalty app already knows who your best customers are. Most loyalty apps sync that data to Shopify as customer metafields, which the Event Editor can read. A VIP-only event lets a destination report on, trigger from, or optimize toward your most loyal buyers.

What you need

  • A loyalty app that writes VIP tier or points data to Shopify customer metafields (see the table below)

  • At least one Littledata destination connected, for example Meta Conversions API

  • Access to the Event Editor in the Littledata app

This setup works with any loyalty app that syncs customer metafields to Shopify. Examples:

Loyalty app
Customer metafields
Condition on

Smile.io

VIP tier name

Tier name

Rivo

vip_tier, status, points_balance, credits_balance

Tier name

LoyaltyLion

points_pending, referral_url

Points threshold

Yotpo Loyalty (Swell Rewards)

point_balance, is_affiliate

Points threshold

The exact metafield namespace and key depend on your app and setup; you'll find yours in the metafield list in step 1. Some apps need the sync switched on first. For example, Smile.io's VIP metafield sync is opt-in and available on its Growth plan and up.

Steps

1

Expose the loyalty metafield

Go to Settings → Custom Data Sources.

Under Customers, find your loyalty app's tier or points metafield, for example Rivo's vip_tier, and select it.

If it doesn't appear, click Refresh metafields and check back in a few minutes. See Custom data sources.

2

Add a custom event

Go to Settings for your destination, then open the Events tab.

Click Add event. Name the event VIPPurchase, or match the naming style your destination expects, and select Purchase as the base event. See Derive a new custom event.

3

Scope it with a trigger condition

Add a condition so the event only fires for your VIPs.

If your app writes a tier metafield, match on your top tier name:

Field
Operation
Value

Loyalty tier metafield

is

Gold

If your app writes a points metafield instead, match on a points threshold that marks out your best customers:

Field
Operation
Value

Loyalty points metafield

greater than

1000

See Trigger conditions.

4

Preview and save

Use the event preview to check the payload, then click Save.

Destination notes

  • Meta: in Events Manager, mark VIPPurchase as a custom conversion and choose it as a campaign's optimization event. Meta builds its audience model on your most loyal buyers.

  • GA4: report VIP revenue share by channel, or mark the event as a key event.

  • Klaviyo: use the event to trigger VIP-only flows.

Verify it's working

  1. Place a test order with a customer account in your top loyalty tier (or above your points threshold), or wait for a real VIP order.

  2. Confirm the VIPPurchase event appears alongside the standard purchase event, for example in Meta Events Manager.

Make it yours

This setup is a custom event conditioned on an exposed metafield. Swap the condition to redraw the segment:

  • No loyalty app? Condition on order value instead: properties.total_price greater than or equal your threshold gives you a high-value purchase event with no metafields needed.

  • Loosen the condition to include your top two tiers, or lower the points threshold.

  • Prefer audiences over a separate conversion? Skip the custom event and map the tier or points value onto the standard purchase event as a custom parameter instead. See Remap existing events.

Last updated

Was this helpful?