!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
Open your terminal and run the following command:
To add the module to your Geins PWA Storefront Ralph, open your
The Tiktok module will then track the following ralph events:
| Type of activity | Event tracked | Information sent | | ----------------- | ------------------------------------------------| ------------------- | | Add to cart | User adds a product to the cart | Sku ID, quantity, product name | | Favorited product | User adds a product to their Favorites | Product ID | | Checkout started | User clicks on "go to checkout" | Sku ID, quantity, product name for all items in the cart | | Viewed product | User navigates to a product page | Product ID, product name | | Purchase completed | User checks out their cart and pays | -- | | Newsletter subscribed | User subscribes to newsletter | -- | | User registers | User registers new account | -- |
!Start Geins Free Trialgeins-tiral-imggeins-tiral-url !Geins Docsgeins-docs-imggeins-docs-url
Tiktok module for Geins PWA Storefront
The Tiktok module is an extension for Geins PWA Storefront Ralph that integrates TikTok Pixel event tracking into your storefront. By leveraging the power of TikTok's advertising platform, you can track and optimize user interactions on your online store.Pre-requisites
Before using the Tiktok module, make sure you have the following:- Geins Account and PWA Storefront Ralph. Get a free trial here
- TikTok Ads Manager Account. Get account here
Description
The Tiktok module allows you to easily integrate TikTok Pixel event tracking into your Geins PWA Storefront Ralph. It provides a seamless integration that enables you to track various user actions on your online store and optimize your advertising campaigns on TikTok.Installation
To install the Tiktok module, follow these steps:- Install the module
Open your terminal and run the following command:npm i @geins/ralph-module-tiktok
- Add the module to your Geins PWA Storefront Ralph
To add the module to your Geins PWA Storefront Ralph, open your nuxt.config.js
file and add the following code snippet:...
modules: [
[
'@geins/ralph-module-tiktok',
{
enabled: true,
debug: true,
pixelId: 'your tiktok pixel ID',
trackEvents: false
}
]
]
Event tracking with TikTok Pixel
To track various user events on your online store, such as add to cart, favorited product, checkout started, viewed product, purchase completed, newsletter subscribed, and user registration, you need to set up event tracking with TikTok Pixel. Here's how you can do it:- If you don't already have a TikTok Pixel ID, you need to obtain one through your TikTok Ads Manager account. You can find detailed instructions on how to get started with the TikTok Pixel here
- Once you have your TikTok Pixel ID, add it to the
pixelId
option in the module configuration - If you want to track ralph-events, set the
trackEvents
option totrue
in the module configuration.
The Tiktok module will then track the following ralph events:
| Type of activity | Event tracked | Information sent | | ----------------- | ------------------------------------------------| ------------------- | | Add to cart | User adds a product to the cart | Sku ID, quantity, product name | | Favorited product | User adds a product to their Favorites | Product ID | | Checkout started | User clicks on "go to checkout" | Sku ID, quantity, product name for all items in the cart | | Viewed product | User navigates to a product page | Product ID, product name | | Purchase completed | User checks out their cart and pays | -- | | Newsletter subscribed | User subscribes to newsletter | -- | | User registers | User registers new account | -- |
Module Options
Add extra options to module configuration innuxt.config.js
file.
| Parameter | Default | Required | Example |
|-|-|-|-|
| enabled | true
| No | Enables the module |
| debug | true
| No | Enables debug info to console |
| pixelId | none | No | Your company's Tiktok Pixel ID TikTok Ads Manager |
| trackEvents | false
| No | If set to true
, ralph events will be tracked |