Skai Server-to-Server Connector Setup Guide

API information

This connector uses the following vendor API:

API Name: Skai API
API Version: v1
API Endpoint: https://{subdomain}.xg4ken.com

Configuration

Navigate to the Connector Marketplace and add a new connector. For general instructions on how to add a connector, see About Connectors.

After adding the connector, configure the following settings:

Subdomain: The Skai subdomain provided during onboarding, used to build the request host https://{subdomain}.xg4ken.com/... (for example, 1234).
Token: The Skai secure token from onboarding. The connector sends this value as the token query parameter. To override this value per event, add an event-level mapping.

Actions

Action Name	AudienceStream	EventStream
Send Conversion	✓	✓
Send Click	✓	✓

Enter a name for the action and select the action type from the drop-down menu.

The following section describes how to set up parameters and options for each action.

Send Conversion

Event Data

Parameter	Description
Conversion Type	String up to 100 chars (for example, `sale`, `purchase`, `signup`).
Revenue	Numeric (integer or decimal), no currency symbol.
Currency	Currency code such as `USD`.
Order ID	String up to 64 chars. Used by Skai for deduplication of duplicate `orderId + conversionType` combinations within 24 hours.
Promo Code	Optional. Free text up to 1024 chars.
Skai UUID	UUID string (`k_user_id`). May be empty if user ID is unavailable. Takes precedence over User ID when both are mapped.
User ID	A raw user identifier the connector converts into a Skai-compatible UUID (MD5 hash formatted as `8-4-4-4-12`) for `k_user_id`. Use this value when you do not already produce a UUID.
Token	Skai secure token. Defaults to the connector configuration value. Override this value per event with an event-level mapping.

Additional Parameters

Parameter	Description
ken_gclid	Google Click ID (`gclid`). A unique tracking parameter Google Ads appends to a URL when a user clicks an ad. Automapped from `gclid` query parameter or cookie parameter when available.
ken_msclkid	Microsoft Click ID (`msclkid`). A unique 32-character tracking parameter Microsoft Advertising appends to landing page URLs. Automapped from `msclkid` query parameter or cookie parameter when available.

SKU Details

Map product SKU arrays to send per-product quantity and revenue data. For each SKU in an order, the connector sends quantity_[sku] and revenue_[sku] as separate query parameters. For example, quantity_56549611915=3&revenue_56549611915=149.97.

Category Aggregations

Optional. Map category names to item counts (for example, cameras=3, accessories=3) to send category-level data in the conversion request. The connector flattens these values into the query string.

Automapping

Parameter	Description
Disable Ecommerce Automapping	When enabled, the standard ecommerce attributes `tealium_event`, `_csubtotal`, `_ccurrency`, `_corder`, and `_cpromo` are not automapped to the Skai conversion parameters `conversionType`, `revenue`, `currency`, `orderId`, and `promoCode`.
Disable Identifier Automapping	When enabled, the identifier attributes `skai_k_user_id`, `gclid`, and `msclkid` are not automapped to the Skai parameters `k_user_id`, `ken_gclid`, and `ken_msclkid`.

Send Click

Event Data

Parameter	Description
Skai UUID	UUID string (`k_user_id`) consistent with conversions. Takes precedence over User ID when both are mapped.
User ID	A raw user identifier the connector converts into a Skai-compatible UUID (MD5 hash formatted as `8-4-4-4-12`) for `k_user_id`. Use this value when you do not already produce a UUID.
Redirect URL	Redirect URL, appended as the last query parameter. Defaults to `http://dummyfortracking.skai.com`.
prof	Skai profile ID.
camp	Skai campaign ID.
kct	Skai channel type.
kchid	Skai channel ID.
criteriaid	Keyword ID, Audience ID, or Product Group ID.
campaignid	Publisher campaign ID.
locphy	User physical location, from the publisher.
adgroupid	Ad group ID.
adpos	Ad position.
cid	Ad ID.
networkType	Network type: `Search` or `Content`.
kdv	Device type: `mobile`, `desktop`, or `tablet`.
kext	Ad extension ID.
kpg	Product Group ID. Microsoft only.
kadtype	Ad type.
kmc	Merchant ID for Shopping campaigns.
kpid	Product ID for Shopping campaigns.
queryStr	Search term. Microsoft only.
npclid	Optional publisher click ID (for example, `gclid` or `msclkid`). Use this to pass conversion data back to publishers for publisher-side optimization such as Smart Bidding.
Additional Parameters	Optional. Pass through any extra query parameters for the click event.

Automapping

Parameter	Description
Disable Identifier Automapping	When enabled, the derived `skai_k_user_id` attribute is not automapped to the Skai `k_user_id` parameter.