Recurly Engage integration
Drive action across your in-app subscriber lifecycle with Recurly's integration with Recurly Engage.
Overview
Required plan
This feature may not be included in the Starter or Pro plans. If you are interested, please contact Recurly Sales to discuss upgrade options.
Additional Cost
This feature or setting requires an additional cost. Please reach out to your Recurly account manager or [email protected] for more pricing details.
Book a Recurly Engage demoDefinition
Redfast is a platform that delivers real-time, personalized messages across web, mobile, and TV based on users’ behavior, allowing B2C companies to guide their customers to take actions that will drive acquisition, retention, and upselling. Your best chance to get your subscribers' attention is when they’re actively using your product.
Key benefits
- Personalized subscriber engagement: Deliver targeted in-app messages to drive actions like purchases, renewals, and upgrades.
- Increased subscriber lifetime value: Enhance customer experience and loyalty through tailored prompts and guidance.
- Streamlined implementation: Easily create and manage engaging subscriber journeys without extensive development resources.
Key details
- Minimal dev lift and easy to implement: Growth and product teams can drive engagement and subscriber journey prompts without waiting for engineering resources.
- Real-time and cross-platform: Don’t wait for that scheduled email to go out, deliver real-time prompts based on actions and segments across desktop and mobile web, iOS, Android, Apple TV, Roku, Fire TV, and Samsung TV. No other platform offers TV device support.
- Predict and prevent churn: Predict users likely to cancel and create personalized cancellation flows to save them.
- Subscription changes with 1-click: With only 1-click from your subscribers, automatically make changes to their subscription in Recurly (ie. add-ons, pause, change plans, apply coupons).
A/B test and analyze what’s working: Easily A/B test unlimited variations to drive conversions and optimize revenue. - Drive engagement across your subscriber’s lifecycle: Prompt your customers at every phase of their journey, from acquisition to renewals, upgrading, and cancellation.
Implementation guide
Step 1: Recurly configuration /Recurly Engage (pulse account) provisioning
- From within Recurly Admin: go to Integrations section ->Recurly Engage
- When a merchant has purchasedRecurly Engage, they will be able to connect from within the Recurly app.
- Fill out the form to create aRecurly Engage instance.
- This will automatically generate yourRecurly Engage instance, provision the Recurly API key, and complete the creation process.


- ConfigureRecurly Engage.
- You will receive an invitation to create your account/password in Recurly Engage.

- Log intoRecurly Engage using your newRecurly Engage account from the step above.
Note: You can only have one email address associated with eachRecurly Engage instance (site/subdomain).
- If you are planning to be in more than one instance (site/subdomain), you will have to use the alias process (similar to Recurly), e.g., [email protected].
- Once you are logged intoRecurly Engage, go to Settings > Application:
- Enter your domain.
- You can also change/edit the name of the instance here if needed—make it descriptive so that you know what the instance usage will be.
- Click save changes.
Note: the ID and API keys should already be populated from Recurly.
Inviting a co-worker to the Recurly Engage console is easy:
- Go to Settings > Users and click on 'Add User'.
- Enter their email and click + Add User.
- Learn more inRecurly Engage: invite users.

Step 2: ConfigureRecurly Engage / addRecurly Engage tag
-
Go to Settings > User Tracking
- User tracking is set by either enabling theRecurly Engage tag in Google Tag Manager or copying the script displayed to each page in the customer’s storefront to enable tracking.
- Once one of these options is enabled on the storefront, tracking will begin. You can verify this by noting the status of “Active” with a green dot.

- You can configure additional tracking items here. Some examples include identifying the cancellation button ID or creating a new tracker.
- Learn more inRecurly Engage: usage tracking
Step 3: Fetch ID logic
In order forRecurly Engage to populate prompts to users, theRecurly Engage tag needs to be able to access information about the user.
Example: A webpage that authenticates a user, and pulls in information from Recurly including the account code, plan information, and other customer attributes, needs to be live to allow theRecurly Engage JS tag to access this data to identify the user. Device applications (mobile & TV SDKs) will also need to authenticate a user in order to provide targeted prompts to the users.
- Learn more inRecurly Engage: custom JS snippet.
Admin users may override certain behaviors of theRecurly Engage Javascript SDK. Upon deployingRecurly Engage for the first time, it is important to configure the following to ensure that users are recognized using your unique identifiers. These identifiers will be utilized for 1-click actions as well as downstream reporting, so it is important that these are correctly configured.
You may need to work with your developers to determine the best method to identify users. The most common methods to retrieve a User ID are:
- localStorage or sessionStorage item
- browser cookie
- accessing an item stored in the browser's dataLayer
Step 4: Import user traits (using both Recurly andRecurly Engage sites)
Recurly - Automated Exports
Within Recurly, go to Integrations > Automated Exports and enable the following automated exports:
- Billing Info v6
- Filter on "Modified Yesterday"
- Invoices - Summary v5
- Filter on "Modified Yesterday"
- Subscriptions v5
- Filter on "Modified Yesterday"
- External Subscriptions v5
- Filter on "Modified Yesterday"
- Note: this is only available if utilizing App Management

Recurly Engage - Importing Traits
Follow the steps outlined inRecurly Engage: user traits - After completing these steps inRecurly Engage, you can:
- Create a CSV file.
- Upload the file to AWS.
- This file will be validated after it is uploaded. Notify Recurly Support to complete this process. Once complete, you can view the attributes in Settings > User Traits.
Recurly Engage - customizing user traits
Learn more inRecurly Engage: customizing user traits
- WithinRecurly Engage, go to Settings > User Traits to view the attributes.
- Configure the Type field for each attribute: Boolean, String, Number, or Date.
- Configure the Display field for each attribute: HINT, the options are different for each type so assign accordingly.
Step 5: Customize segments, triggers, and actions
Continuing inRecurly Engage and based on Use Cases, modify the specific user segments, triggers and actions.
Test Users
To test your implementation, configure Test Users as outlined withinRecurly Engage, (Settings > Users > Test Users) https://help.redfast.com/docs/test-users
Guides
WithinRecurly Engage, you sill see the two pre-built guides for Cancel Save and Failed Payment. Follow the steps below to customize these guides.

Syncing Recurly data
Recurly data will be synced toRecurly Engage for use in building out offers. This includes plan and coupon data. In order to keep plan and coupon data in sync, there is a step to take anytime that a new plan or coupon is created.
To force a sync, navigate toRecurly Engage -> Settings -> Integrations -> External -> Recurly. Uncheck the active checkbox, save, then recheck it, which forces a refresh

Cancel save guide
- Add or modify the options on the reasons for cancellation screen. The following three options are standard (optional):
- Too expensive with CTA to a save offer
- Not enough content with CTA to save offer or the latest content
- Technical issues with CTA to support
- Create an A-B experiment on any of the prompts in the guide to experiment with offers or design (optional).
- Set the segment to Test Users (optional - this will allow you to test the guide).
- Set the trigger to activate using the cancel button click (required).
- The 'Live' feature can detect and add the cancel click event.
- Start the guide (required).
- Add your User ID to the Test Users segment within Settings > Users > Test Users (required for using the test users segment).
- Confirm that the guide launches when you click on cancel (required).
Failed payment guide
Configuration steps: failed rebill.
- The failed payment guide will be set to “Journey” (required).
- The first prompt is set to a Notification prompt type that is shown when the first subscription renewal attempt has failed (required).
- Set the CTA for this prompt to redirect to your payment update screen (required).
- You may also set the redirect to Recurly’s hosted billing info update page.
- Create an A-B experiment on any of the prompts in the guide to experiment with offers or design (optional).
- Set the segment to Test Users (optional - this will allow you to test the guide).
- Set the trigger to activate on Any Page (this may be changed later).
- Start the guide (required).
- Add your user ID to the Test Users segment from Settings > Users > Test Users (required for using the test users segment).
- Confirm that the guide is triggered as configured (required).
- Change the targeting for this prompt to be members with failed payment (required).
Step 6: Set up, test, activate prompts
Based on use cases, set up the specific prompts triggered by actions.
- Configure all additional prompts and guides.
- Apply the applicable segments to all prompts and guides.
- Complete testing of all additional prompts and guides.
- Activate all prompts and guides.
Testing on your production account is favorable and has many benefits. By using Test Users, you can test your prompts on your production instance of Recurly and/orRecurly Engage. This will reduce effort to change site alias, rebuilt prompts, and or change API keys. When testing against Test Users, these test accounts can be added to a segment that will apply to the prompts you are testing. Learn more about Test Users in theRecurly Engage docs portal here.
Post go-live
After the merchant is up and running with prompts, CSM can help monitor the progress and results of prompts to optimize their business. This is a mix ofRecurly Engage performance data and Recurly Analytics.
Helpful resources
Learn more aboutRecurly Engage by visiting these resources:
Recurly's subscriber engagement solutions RedfastAlready interested? Book aRecurly Engage demo
FAQs
**Q: What isRecurly Engage and how doesRecurly Engage work?
A:**Recurly Engage is a no-code platform that presents prompts to customers when using the merchant application. It utilizes Google Tag Manager (GTM) and aRecurly Engage JS token on the merchant web page, or SKDs or mobile apps.
Q: What is a prompt?
A: A prompt refers to content or behavior that is presented to users within one or more segments.
Q: What is a guide?
A: A guide is a collection of prompts that appear one after another.
Q: What segmentation is available inRecurly Engage?
A: Recurly subscriber data can be used for driving segmentation across prompts and guides to target the message to your unique subscribers.
Q: How do I monitor the success of the prompts displayed to customers?
A: Recurly Engage offers robust analytics to measure prompt performance. Recurly analytics can provide insight into the effectiveness of the overall strategy using Recurly Built-In Benchmarks. We are evaluating pulling data fromRecurly Engage into Recurly Analytics.
Q: What if a merchant does not use Google Tag Manager?
A: Adobe, Tealium or GTM are the tag options out of the box. Other tag managers can be used, and need to have tag script added to each page
Q: Does my Recurly Engage API key count towards my API key limit?
A: Yes, theRecurly Engage API key that is generated via the Recurly provisioning flow will utilize one of your API keys. If you need additional API keys, contact sales to increase your limit.
Updated 1 day ago