Skip to content

Kilkaya (Server-Side)

Sesamy integrates with Kilkaya by sending a server-side tracking pixel request when a purchase is completed, enabling conversion tracking with campaign attribution.

Built-in integration

This is a built-in integration. See Integration Concepts for shared concepts like event types and error handling.

Browser-side tracking

This page covers the server-side tracking pixel integration. For browser-side JavaScript tracking with Kilkaya, see Kilkaya (Browser-side).

Overview

The Kilkaya server-side integration sends an HTTP GET request (tracking pixel) to your Kilkaya subdomain every time a purchase is confirmed. The request carries purchase option details and UTM campaign parameters as tags, giving you conversion data tied to specific marketing efforts.

Getting Started

Prerequisites

You need the following credentials from your Kilkaya account:

FieldDescription
subdomainYour Kilkaya subdomain
keyYour Kilkaya tracking key
defaultDomainFallback redirect URL when no redirect is present on the checkout
version(Optional) API version, either 1 or 2. Defaults to 1

Setup Process

  1. Locate your credentials in your Kilkaya account settings.
  2. Provide them to Sesamy Support. Your account manager will configure the integration for you.

Events and Data

Purchase Event

Sesamy sends a tracking pixel request when a checkout.1#confirm event occurs. This is the only event type handled by this integration.

Data Sent

FieldDescription
Tracking keyYour Kilkaya tracking key
subdomainYour Kilkaya subdomain
versionAPI version (1 or 2, defaults to 1)
TagsPipe-separated string of purchase option title and UTM parameters
Redirect URLFrom the checkout query parameter, falls back to defaultDomain
User agentBuyer's browser user agent string
ReferrerHTTP referrer from the checkout

How Tags Work

Tags are sent as a single pipe-separated string containing the purchase option title followed by any UTM parameters captured during checkout (campaign, source, medium).

Example tag string:

text
Monthly Premium|spring_sale|newsletter|email

In this example:

  • Monthly Premium is the purchase option title
  • spring_sale is the UTM campaign
  • newsletter is the UTM source
  • email is the UTM medium

Verifying Your Integration

After Sesamy has configured the integration:

  1. Make a test purchase on your platform.
  2. Log in to your Kilkaya dashboard.
  3. Check for incoming tracking events. Look for the purchase option title in the tag data.
  4. Verify that UTM parameters are being captured correctly if you are running campaigns.

Next Steps

Released under the MIT License.