Overview
Sometimes, a quick action campaign needs to target a specific subscription and it isn't sufficient to send out the quick action to be applied to the default targets like next billing, last paused, or last cancelled subscriptions.
For example, consider a campaign where a merchant is trying to send out a swap quick action targeting people who have subscribed to the Apple soda encouraging them change over to the Orange soda. In this case, it isn't sufficient to use the default skio_nextBillingActiveSubscriptionId because a subscriber could have multiple subscriptions and the next billing one may not actually have the Apple soda.
To accomplish this, we'll create a special custom profile property in Skio called skio_adhocQuickActionData which will store the subscription ID of the Orange soda. With this, we can modify the quick action link to use this new profile property. For example, we'd change out a link like
https://demo-skio-store.myshopify.com/a/account/quick-action-v3?stackId=217f10be-8cfc-41a7-853a-8da7566b9fba&subscriptionId={{ person.skio_nextBillingActiveSubscriptionId|default:'' }}
to become
https://demo-skio-store.myshopify.com/a/account/quick-action-v3?stackId=217f10be-8cfc-41a7-853a-8da7566b9fba&subscriptionId={{ person.skio_adhocQuickActionData|default:'' }}
Exporting the email list
The first step is to gather an export of subscribers which you'd like to email to and the relevant subscription IDs. For the above example, we'd be looking for a CSV of all subscriber emails of folks who have subscribed to the Apple soda and the subscription IDs.
You can do this using our segments tool or our GraphQL API.
Uploading the list into Klaviyo
First, prepare your subscriber export by creating a CSV with two columns.
- email (this will come from storefrontUserEmail in the segments export)
- skio_adhocQuickActionData (this will be the subscription ID in the segments export for our example)
Then create a Klaviyo list with this data.
Sending the email campaign
Configure an email campaign in Klaviyo which targets the Klaviyo list you just created. For the quick action link, use the Klaviyo Campaign link with Next Active Billing Subscription.
The link should look something like https://andrew-dev-skio-1.myshopify.com/a/account/quick-action-v3?stackId=7ec3c8d7-d997-49c7-abf7-881f166d0079&subscriptionId={{ person.skio_nextBillingActiveSubscriptionId|default:'' }}
Replace the subscriptionId variable with the skio_adhocQuickActionData field and use this link
https://andrew-dev-skio-1.myshopify.com/a/account/quick-action-v3?stackId=7ec3c8d7-d997-49c7-abf7-881f166d0079&subscriptionId={{ person.skio_adhocQuickActionData|default:'' }}