Stape/Documentation

[Klaviyo] Stape Conversion Tracking App

Updated Jul 28, 2025

Stape created the Conversion Tracking app to simplify the process of reporting your users' progress as conversion events to your CAPI Gateway, Signals Gateway, or server GTM container.

Once configured, the app monitors the user’s interactions. It automatically sends the appropriate conversion events to your chosen destination (CAPI Gateway, Signals Gateway, or server GTM container), ensuring accurate lead conversion tracking.

App installation

Install the Stape Conversion Tracking app by following the link on the Klaviyo platform.

Give the app the scopes it requires:

Allow Stape Conversion Tracking to access your account's information
Allow Stape Conversion Tracking to access your account's information

Integration methods: CAPI Gateway, Signals Gateway, or server GTM

Choose the integration method
Choose the integration method

You can select the method you currently use or would like to install:

App configuration | CAPI Gateway

Before starting

You will need to have an active Stape account with the Meta Conversions API Gateway installed.

Create a Stape account or log in if you already have one. In the main menu, click “More Gateways” → “Meta CAPIG” → “Create CAPIG” on the top right if you need to add Meta CAPIG.

Create Meta CAPIG
Create Meta CAPIG

Enter the name, email, and server location for the new CAPIG. Next, select a subscription plan and provide billing information.

Once the Meta Conversions API Gateway is created in your Stape account, connect your Meta Dataset (Pixel) by clicking “Add data source” → log in to Meta → choose Business Manager, and the Dataset (Pixel) you want to link.

Add data source in Meta
Add data source in Meta

To improve event match quality, please enable “Automatic Advanced Matching.”

Automatic Advanced Matching
Automatic Advanced Matching
For the detailed instructions on how to set up Meta CAPI Gateway, please check Stape’s guide.

App setup

The app configuration process can be divided into two parts:

  • Meta and Stape accounts data
  • Klaviyo related fields
Meta CAPIG configuration method
Meta CAPIG configuration method

Meta and Stape accounts data

Fill the fields:

  • Meta Dataset ID - unique identifier used to set up integrations and monitor events in Events Manager. You can find it in your Facebook Business Manager in the “All tools” menu section → "Event Manager" → "Data Sources". For step-by-step instructions on how to find your Meta Dataset (Pixel) ID, check Stape’s guide.
Dataset ID
Dataset ID
  • CAPIG API Key - an alphanumeric string used to identify your app. It can be found in the CAPIG settings section of your Stape account. For detailed instructions on how to find your CAPIG API Key, see Stape’s article.
CAPIG API Key
CAPIG API Key

Map your Klaviyo CRM fields to the conversion event parameters.

  • (Optional) Select the field where the Meta Lead ID is stored. Note: The dropdown will only display custom fields.
  • To send additional user data to Meta, choose a parameter from the left dropdown and match it with the corresponding CRM field using the right dropdown.
Add user data in Meta CAPIG
Add user data in Meta CAPIG
  • The application sends conversion events based on the user's interactions. Whenever a user performs a specified action, a corresponding event is triggered and sent to your Meta Dataset (Pixel). To set this up, choose one of the following configuration methods:

- In the left dropdown, select the user action that should trigger the event. Then, in the box on the right, enter the event name you want to send to Meta.

Send events to Meta
Send events to Meta

- Enable “Send all statuses” if you want to send all user interactions as events to Meta. In this case, events will be automatically named using the Pipeline and user stage names. You can also choose specific statuses to exclude from being sent.

Send all events
Send all events

When you've finished the configuration, click “Save and Connect.” After the success message appears, the installation is complete, and the application will begin sending conversion events in the background according to your configured settings.

Example of configuration with Meta CAPIG
Example of configuration with Meta CAPIG

App configuration | Signals Gateway

Before starting

You will need to have an active Stape account with the Signals Gateway installed.

Create a Stape account or log in if you already have one. In the main menu, click “Signals Gateways” → “Create Signals Gateway” on the top right if you need to create a Signals Gateway.

Create Signals Gateway
Create Signals Gateway

Enter the name, email, and server location for the new CAPIG. Next, select a subscription plan and provide billing information.

Signals Gateway configured
Signals Gateway configured
For the detailed instructions on how to configure Signals Gateway, check Stape’s article.

App setup

The app configuration process can be divided into two parts:

  • Signals and Stape accounts data
  • Klaviyo relanted fields
Signals Gateway as configuration method
Signals Gateway as configuration method

Signals and Stape accounts data

You’ll need to fill the following fields:

  • Signals Gateway Pixel – a unique identifier used to set up integrations and track events within Signals Gateway. You can find it in your Signals Gateway account under the Data Sources tab. For detailed instructions on finding the Pixel ID, check a quick guide on Signals Gateway Pixel ID.
Signals Gateway Pixel ID
Signals Gateway Pixel ID
  • Signals Gateway API Key – an alphanumeric string required to identify your app. This can be found in the Gateway settings section of your Stape account. Click here for step-by-step instructions on where to find your Gateway API Key.
Gateway API Key
Gateway API Key

Map your Klaviyo CRM fields to the conversion event parameters.

  • (Optional) Select the field where the Meta Lead ID is stored. Note: The dropdown will only display custom fields.
  • To send additional user data to Meta, choose a parameter from the left dropdown and match it with the corresponding CRM field using the right dropdown.
Add user data in Signals Gateway
Add user data in Signals Gateway
  • The application sends conversion events based on the user's interactions. Whenever a user performs a specified action, a corresponding event is triggered and sent to your Meta Dataset (Pixel). To set this up, choose one of the following configuration methods:

- In the left dropdown, select the user action that should trigger the event. Then, in the box on the right, enter the event name you want to send to Meta.

Send events to Meta
Send events to Meta

- Enable “Send all statuses” if you want to send all user interactions as events to Meta. In this case, events will be automatically named using the Pipeline and user stage names. You can also choose specific statuses to exclude from being sent.

Send all events
Send all events

When you've finished the configuration, click “Save and Connect.” After the success message appears, the installation is complete, and the application will begin sending conversion events in the background according to your configured settings.

Example of configuration with Signals Gateway
Example of configuration with Signals Gateway

App configuration | Server GTM

Before starting

You will need to have an active Stape account with server GTM container hosted on Stape.

Create a Stape account or log in if you already have one. In the main menu click “sGTM” → “Create container” on the top right.

Create sGTM container
Create sGTM container

Add your container name, paste the Container Configuration you copied from your Google Tag Manager Server container, and choose a server location. Then, click Create Container.

App set up

The app configuration process can be divided into two parts:

  • Stape account data
  • Klaviyo related fields
sGTM as configuration method
sGTM as configuration method

Stape account data

Fill in the following field:

  • Container API Key - an alphanumeric string used to identify your app. You can find the Container API Key in the Container Settings section of your Stape account. For step-by-step guidance, check to the detailed instructions on how to find the Container API Key.
Container API Key
Container API Key

Map your Klaviyo CRM fields to the conversion event parameters.

  • (Optional) Select the field where the Meta Lead ID is stored. Note: The dropdown will only display custom fields.
  • To send additional user data to Meta, choose a parameter from the left dropdown and match it with the corresponding CRM field using the right dropdown.
Add user data in Signals Gateway
Add user data in Signals Gateway
  • The application sends conversion events based on the user's interactions. Whenever a user performs a specified action, a corresponding event is triggered and sent to your Meta Dataset (Pixel). To set this up, choose one of the following configuration methods:

- In the left dropdown, select the user action that should trigger the event. Then, in the box on the right, enter the event name you want to send to Meta.

Send events to Meta
Send events to Meta

- Enable “Send all statuses” if you want to send all user interactions as events to Meta. In this case, events will be automatically named using the Pipeline and user stage names. You can also choose specific statuses to exclude from being sent.

Send all events
Send all events

When you've finished the configuration, click “Save and Connect.” After the success message appears, the installation is complete, and the application will begin sending conversion events in the background according to your configured settings.

Example of configuration with sGTM
Example of configuration with sGTM

Comments

Can’t find what you are looking for?