Marketing 1-Click Action In Emails

Updated August 31, 2023 18:58

NOTE: This is a custom experience that must first be purchased through Ordergroove to be enabled.

Creating this experience will require work from both the client team as well as Ordergroove. If you're interested in this experience as well as any possible customizations to it please reach out to your Ordergroove representative to determine the overall scope, implementation fees, and timing for delivery.

Caution: Some aspects of this article may require technical expertise with coding languages.

If you do not currently have someone on staff or contract that can provide that level of technical assistance, Ordergroove suggests seeking out that level of support before attempting to add or alter any working code relating to your subscriptions or storefront.

Synopsis	Ordergroove can add a One-Click token URL to the order reminder email that, once clicked, will redirect the customer to the destination of your choice. In addition, OG will append the URL with a parameter containing what we call an Action Token. When used in conjunction with our LEGO endpoint, the token will automatically trigger an action on the experience defined. The scenario below outlines a Skip Order action experience.
Areas Impacted	Upcoming Orders Email Website Frontend
Out of Scope of Solution	Transactional emails powered outside of Ordergroove Skip Order Tokens are for use with OG-powered transactional emails. Other APIs and/or webhooks are available for merchant-powered email. Only 1 URL with the appended token can be configured. There is no support for multi-language experiences that would require the URL to be dynamic based on customer locale."
Requirements	Only available for Klaviyo & SFMC email triggers from Ordergroove. If Ordergroove does not trigger transactional emails through either of these ESPs for you, a custom solution and SOW will be required to move forward. Merchant must build a Front End confirmation experience
Resources Required	Client/Systems Integrator [L] Create a landing page with the front end experience when a customer clicks the Skip Link from their email. [M] Create a backend call to Ordergroove's LEGO endpoint to officially cancel the order. This should trigger in conjunction with the submit experience you require from the customer. [S-M] Provide an HTML template with the Skip Order button/link. Effort varies based on design. Ordergroove Add the dynamic token code to the provided HTML template. Merchant configuration to enable one-click actions.
Other	Note that as an alternative you can review our webhooks documentation to try and achieve these results without the need for Ordergroove customizations by following the Marketing One-Click flow and applying it to transactional events.

Overview

Ordergroove can add a One-Click token URL to the order reminder email that, once clicked, will redirect the customer to the destination of your choice. In addition, OG will append the URL with a parameter containing what we call an Action Token. When used in conjunction with our LEGO endpoint, the token will automatically trigger an action on the experience defined. The scenario below outlines a Skip Order action experience.

How To Set It Up

Email Setup
Ordergroove will add this token value as a dynamic field in the email trigger content. At this point, we only power one-click actions for Skip Order and Cancel Subscription

Confirmation Experience
Once the customer has reached the landing page and completed the one-click flow confirmation that you have built, you will follow the steps below to trigger the confirmation to Ordergroove.

Take the token query parameter value from the URL
Decode this value using JS built-in functions

JSON.parse(atob(decodeURIComponent(encoded_token_value)))

Decoding from Step 2 will give you a value such as:

{
experience: "skip_order",
auth: {
public_id: "ca80b8701d2711eba195bc764e10b970"
sig: "Bp165d886LT2CKW9Hppv5LPja4k8dTtG8STDtub/jgs="
ts: 1585925651
trust_level: "recognized"
sig_field: "26115443"
},
resource_id: "c1e7a5766f9811eabe8abc764e10028e"
}

Take the value of the resource_id and hit the Ordergroove lego endpoint
- Staging: https://staging.restapi.ordergroove.com/orders/<resource_id>/cancel/
- Production: https://restapi.ordergroove.com/orders/<resource_id>/cancel/
With the following Headers
- 'Authorization': JSON.stringify(<auth>),
- 'Content-Type': 'application/json'

The value of <auth> will be taken directly from the parsed token value:

{
public_id: "ca80b8701d2711eba195bc764e10b970"
sig: "Bp165d886LT2CKW9Hppv5LPja4k8dTtG8STDtub/jgs="
ts: 1585925651
trust_level: "recognized"
sig_field: "26115443"
}

You've now implemented a Skip Order feature into your order reminder emails.