!NPM Packagenpmnpm-url
!NPM Downloadsnpm-downloads-per-monthnpm-trends
!Geinsmit-shield
!Start Geins Free Trialgeins-tiral-imggeins-tiral-url !Geins Docsgeins-docs-imggeins-docs-url
Add the module to your Geins PWA Storefront Ralph by adding the following line to your
h ## To use with Geins CMS (no-code)
Use the @geins/ralph-module-cms-json-container
Add module to your
Set the
| Type of activity | Event tracked | Information tracked | | ----------------- | ---------------------------------------------------- | ------------------- | | Identify customer | User Login/Register, Newletter signup, Cart checkout | E-mail | | Viewed product | Product clicked, Product page viewed | Product name & ID | | Added to cart | Product added to cart | Product name & ID | | Checkout started | User clicks to checkout cart | Products in cart |
Currently only
!Start Geins Free Trialgeins-tiral-imggeins-tiral-url !Geins Docsgeins-docs-imggeins-docs-url
Klaviyo Marketing Automation module for Geins PWA Storefront
A module for Geins PWA Storefront Ralph that adds Klaviyo marketing automation to your storefront in seconds.Pre-requisites
- Geins Account and PWA Storefront Ralph. Get a free trial here
- Klaviyo Account. Get account here
Description
This module will seamlessly integrate Klaviyo's powerful marketing automation capabilities into your Geins Storefront. With this module, you effortlessly boost your marketing efforts and customer engagement.Installation
- Install the module
npm i @geins/ralph-module-klaviyo
- Add the module to your Geins PWA Storefront Ralph
Add the module to your Geins PWA Storefront Ralph by adding the following line to your nuxt.config.json
file:...
modules: [
[
'@geins/ralph-module-klaviyo',
{
enabled: true,
debug: true,
companyId: 'your-klaviyo-site-id'
}
]
]
h ## To use with Geins CMS (no-code)
- Add the module to your Geins PWA Storefront Ralph
Use the @geins/ralph-module-cms-json-containernpm i @geins/ralph-module-cms-json-container
- Add the module to your Geins PWA Storefront Ralph
Add module to your nuxt.config.json
file:// nuxt.config.js
...
modules: [
'@geins/ralph-module-cms-json-container'
]
..
Set the
widgetRenderTypesComponents
in your nuxt.config.json
file to use the GeinsWidgetJsonContainer
component for the JSON
widget type.// nuxt.config.js
...
publicRuntimeConfig: {
widgetRenderTypesComponents: {
JSON: 'GeinsWidgetJsonContainer'
},
}
...
Module Options
Add extra options to module configuration innuxt.config.json
file.
| Parameter | Default | Required | Example |
|-|-|-|-|
| enabled | true
| Yes | Enables the module|
| debug | false
| No | Enables debug info to console |
| companyId | none | Yes | Your Klaviyo Site ID Klaviyo Account Settings |Usage (event tracking)
The module will track activity on your site related to your users.| Type of activity | Event tracked | Information tracked | | ----------------- | ---------------------------------------------------- | ------------------- | | Identify customer | User Login/Register, Newletter signup, Cart checkout | E-mail | | Viewed product | Product clicked, Product page viewed | Product name & ID | | Added to cart | Product added to cart | Product name & ID | | Checkout started | User clicks to checkout cart | Products in cart |
Usage (sign-up forms)
Add a sign-up form to any desired page of your storefront. Either by cms or as a component. Add an id to the component to identify which Klaviyo form to render.Currently only
Embed
type forms are possible. Read here about sign-up forms in KlaviyoComponents
Module adds two components to your storefront.GeinsKlaviyoForm
and GeinsWidgetKlaviyoForm
.GeinsKlaviyoForm
This component is used to show a specific sign-up form from Klaviyo. It is used by theGeinsWidgetKlaviyoForm
component. You can use it directly in your page if you want to add the player directly to your page as a component. If you<GeinsKlaviyoForm formId="your-form-id" />
GeinsWidgetKlaviyoForm
The widget is a wrapper around theGeinsKlaviyoForm
component. It is used to add the component via CMS. It is not needed if you add the component directly to your page.Use with Geins CMS
Add aJSON Widget
to your page in the Geins CMS. Add the following JSON to your widget. Replace your-form-id
with the id of Klaviyo sing-up form you want to register. You can find the id in your Klaviyo dashboard (Sign-up forms).{
"renderWidget": "GeinsWidgetKlaviyoForm",
"data": {
"id": "your-form-id"
}
}
User consent Important!
The Klaviyo module will only track customers activity if all cookies have been allowed. To be compliant add information about Klaviyo's tracking on yourcookies
page.