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.

Note: This feature is in early development. We're actively testing it, so the listed actions are subject to change and grow without advance notice.

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.

Shopify BigCommerce Platform Agnostic

1-Click actions need to point to a URL that has Ordergroove’s main.js script tag, and can not be in the My Account section. Most Shopify merchants will have the main.js script tag automatically added to the site's homepage during integration.

Please submit a support ticket to request your Merchant Public ID. Add the following script under the <HEAD> html element to the specific account page you want to direct users to after they click the button in their Klaviyo outreach:

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

Replace MERCHANT_PUBLIC_ID with the ID # you received from Ordergroove Support.

 


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.

klaviyo_screenshot_post.png

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.

sms_post.png


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}}
  • Sample Code (via API):
https://restapi.ordergroove.com/one_click/delay/?days={{days}}&token={{event.action_token}}

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}}
  • Sample Code (via API):
https://restapi.ordergroove.com/one_click/upsell/?og_product_id={{id}}&token={{event.action_token}}

Example:

1-Click Upsell with Subscriber Dash before and after copy.gif

 

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_quick_action_token={{event.action_token}}
  • Sample Code (via API):
https://restapi.ordergroove.com/one_click/subscription_upsell/?og_product_id={{id}}&token={{event.action_t