Add 1-Click Actions to Klaviyo Flows

Reduce friction and frustration by giving your customers the opportunity to update their subscriptions with 1-Click actions. This guide will take you through what 1-Click is, how to add links to Klaviyo, and includes a list of all currently available actions.

How 1-Click Actions Work

1-Click actions are unique and secure URLs you can send to your customers through email and SMS messages. When clicked on, they will perform a specific pre-determined action such as reactivating a churned subscription.

Let’s follow the same example, say a customer wants to add a limited time item to their next upcoming order. Normally they would have to find your Subscription Manager on the store homepage, log in, locate the subscription, and click to reactivate it; or go through checkout again. With 1-Click actions, you can cut down all of those steps to just one: clicking on their unique URL. 

For more information, see 1-Click Actions Overview.

The Anatomy of a 1-Click URL

1-Click actions use links to store information about the action, user, and changes to make within Ordergroove. All 1-click actions have the same basic structure that look like this:

https://STORE_URL/?og_quick_action=ACTION&og_quick_action_token=TOKEN_STRING

Customizing the URL to work for your store is simply defining where, what, and who by changing the bolded items to your information.

• STORE_URL: The page you would like your users to see when they click to take the 1-click action. We recommend building a specific page for the experience, but many merchants use their default homepage.
• ACTION: The action that you want to perform, taken from the list below
• TOKEN_STRING: Generated by Ordergroove and stored in Klaviyo

Note: previous versions of this article used '#' characters in the 1-click action URLs. If you have 1-click action URLs with # in them, they will continue work and do not need to be changed. Moving forward, we recommend using '?' characters for new URLs.

Enabling 1-Click Actions for your store

To ensure your customers have a seamless branded experience with the 1-click, Ordergroove has developed a 1-click handler that can live on your site. Before configuring any 1-click actions, you’ll need to confirm Ordergroove’s handler is on your STORE_URL you plan on using.

Ordergroove’s handler comes in the form of a script that lives on your site as either

"https://static.ordergroove.com/MERCHANT_PUBLIC_ID/main.js”

or

"https://static.ordergroove.com/MERCHANT_PUBLIC_ID/oca.js”

If you are not sure if our handler is on your site, please submit a support ticket and we’ll be happy to help.

If you do need to add the Ordergroove handler, you can follow the instructions below based on your eCommerce platform.

<script type=“text/javascript” src=“https://static.ordergroove.com/<MERCHANT_PUBLIC_ID>/main.js”></script>.

<script type=“text/javascript” src=“https://static.ordergroove.com/<MERCHANT_PUBLIC_ID>/main.js”></script>.

<script type=“text/javascript” src=“https://static.ordergroove.com/<MERCHANT_PUBLIC_ID>/main.js”></script>.

Adding 1-Click Actions to Klaviyo

1-Click Actions can be added to Klaviyo Campaigns and Flows; to both SMS and email messages. The process is slightly different depending on the type of message:

Add 1-Click action to an email

1. Log in to Klaviyo. Open an existing email message you would like to add a 1-Click action to, or create a new one.
2. Add a new button to your email template.
3. Copy one of the sample code snippets listed below and paste it into the button’s URL field.
4. Replace <STORE_URL> with your store homepage.
5. Save and exit.

Add 1-Click action to an SMS message

1. Log in to Klaviyo. Open an existing SMS message you would like to add a 1-Click action to, or create a new one.
2. Copy one of the sample code snippets listed below and paste it into your message.
3. Replace <STORE_URL> with your store homepage.
4. Save Content.

Testing 1-Click Actions

1. Create an order reminder flow with a 1-click action for delay.
2. Mark the flow as Manual in Klaviyo.
3. Set up a subscription in Ordergroove, and change the order to send one day past the trigger in Klaviyo. Ex: set it for 5 days if the reminder is triggered at day 4.
4. Wait for order placement to run the next day. The event should show in Klaviyo, where you can test the 1-click in the preview.

Available 1-Click Actions

The following is a list of all available 1-Click Actions along with an example URL. 1-Click Actions is under active development, and this list will grow as we build out the program.

Delay Shipment

Delays a subscribers upcoming shipment by 14 days. The number of days to delay can optionally be overwritten as a URL parameter.

• Action: delay
• Sample Code (w/ on-site confirmation via Ordergroove JS):

https://<STORE_URL>/?og_quick_action=delay&og_delay_by=14&og_quick_action_token={{event.action_token}}

• Fields:
  • og_delay_by=14: The amount of days to delay the shipment. You can replace 14 for a custom delay period.

• Sample Code (via API):

https://restapi.ordergroove.com/one_click/delay/?days={{days}}&token={{event.action_token}}

• Fields:
  • days={{days}}: The amount of days to delay the shipment. Replace {{days}} with an integer.

Reactivate Subscription

Reactivates a customer’s subscription. The first order date is set to the next day. The customer will get charged the next day, and will resume all previous subscription settings such as frequency and quantity.

• Action: reactivate
• Sample Code (w/ on-site confirmation via Ordergroove JS):

https://<STORE_URL>/?og_quick_action=reactivate&og_quick_action_token={{event.action_token}}

• Sample Code (via API):

https://restapi.ordergroove.com/one_click/reactivate/?token={{event.action_token}}

One-Time Product Upsell

Adds an item as a one-time purchase to a customer's upcoming order. Requires the ordergroove external product id of the item you want to add to the order.

• Action: upsell
• Sample Code (w/ on-site confirmation via Ordergroove JS):

https://<STORE_URL>/?og_quick_action=upsell&og_product_id=123ABC&og_quick_action_token={{event.action_token}}

• Fields:
  • og_product_ID=123ABC: The product you want to append to a customer's order. Replace 123ABC with the Ordergroove product ID. You can find the ID by logging in to Ordergroove > Products > Click the product you want to upsell > External Product ID.

• Sample Code (via API):

https://restapi.ordergroove.com/one_click/upsell/?og_product_id={{id}}&token={{event.action_token}}

• Fields:
  • og_product_ID={{id}}: The product you want to append to a customer's order. Replace {{id}} with the Ordergroove product ID. You can find the ID by logging in to Ordergroove > Products > Click the product you want to upsell > External Product ID.

Optional Parameters:

We can attach a discount to an upsold item as og_offer_id, which is how Ordergroove tracks specific types of discounts. Please reach out to help@ordergroove.com if you’d like to offer a discount and don’t know the offer_id.

Limitations

- Each Upsell can only be clicked once with a unique token. If I am offering product A and B in the same order, the maximum that can be added is 1 of A and 1 of B with the same token.

Example:

Subscription Product Upsell

Adds an item as a subscription to a customer's upcoming order. Requires the ordergroove external product id of the item you want to add to the order.

• Action: subscription upsell
• Sample Code (w/ on-site confirmation via Ordergroove JS):

https://<STORE_URL>/?og_quick_action=subscription_upsell&og_product_id=123ABC&og_every=1&og_every_period=3&og_quick_action_token={{event.action_token}}

Fields:

• og_product_ID=123ABC: The product you want to append to a customer's order. Replace 123ABC with the Ordergroove product ID. You can find the ID by logging in to Ordergroove > Products > Click the product you want to upsell > External Product ID.
• og_every: The amount of days, weeks, or months between recurring subscription orders. You'll choose day, week, or month with og_every_period.
• og_every_period: A numerical representation of a timeframe
  • 1 = Days
  • 2 = Week
  • 3 = Month

Example: A subscription renewing every 1 Month: og_every=1&og_every_period=3

• Sample Code (via API):

https://restapi.ordergroove.com/one_click/subscription_upsell/?og_product_id={{id}}&token={{event.action_t

Optional Parameters:

We can attach a discount to an upsold item as og_offer_id, which is how Ordergroove tracks specific types of discounts. Please reach out to help@ordergroove.com if you’d like to offer a discount and don’t know the offer_id.

Limitations

- Each Upsell can only be clicked once with a unique token. If I am offering product A and B in the same order, the maximum that can be added is 1 of A and 1 of B with the same token.