Zephr Integration

Paywall Integration

Introduction

It is possible to display a Limio page/campaign in the Zephr paywall. This functionality can be handy if you'd like to use Limio as the commerce layer and manage all campaigns centrally in Limio, but would like to take advantage of Zephr Rule Engine.

For example, you can show a Limio Component displayed Offers stored on a Limio Campaign within the Zephr paywall. Once the customer clicks on Subscribe, they would be taken to Limio Checkout to complete their order, creating a basket in the process. 

Configuring campaigns/offers for Zephr

The campaign can be set up just like any other regular campaign. Make sure it has a tag and some assets (else the page will be empty).

The URL

Once the campaign and offers are saved in Limio, it will be possible to use the functionality with the URL of the Campaign:

https://sandbox-shop.dev.limio.com/new-campaign

You just need to enter this URL into a Zephr Hosted UI Component (Delivery > Component Library). The component will then call Limio whenever the page is requested and apply the content directly to your site.

Example of a Component displaying a Limio Campaign created in Zephr

You can load the component into a Zephr Product > Features > Outcome to test the display.

Example of a Zephr component displayed within a Feature's Outcome.

Note: Zephr caches some of these requests so changes may take some time to show up.

iFrame option

Limio can also return the URL of the page within an iFrame and then your site will load it programmatically. This is particularly useful to prevent CSS cascading and also to enable your website to make the request into Limio directly, in case it needs to share cookies or any other data relevant to journeys you cannot pass through Zephr.

To use the iFrame option, you just need to add a query string parameter framed, as follows:

https://sandbox-shop.dev.limio.com/new-campaign?framed

Entitlement Integration

Limio supports creating Entitlement Code in Limio that can map to Zephr Entitlement code. At the time of order or switch (update/downgrade), Limio will generate a webhook with the entitlement that can be sent to Zephr via a middleware to provision the necessary entitlement for the customer. This is particularly useful to allow for real-time provisioning of digital access at the time of purchase.

Go to Settings > Webhooks to configure the endpoint for Entitlement updates. Learn more about Limio webhooks here. 

Once configured, you can see webhooks at /objects/webhooks/limio .