ARBook a Demo
Developer documentation

KePixel for Shopify

Use the installation control shown by the exact Shopify Source Setup page. KePixel keeps the source, managed container/runtime and downstream destinations isolated; the store developer should not guess a GTM/runtime method that KePixel has not exposed for that source.

Implementation flow

Create or open the Shopify source

Use the exact Shopify store HTTPS URL and then open KePixel → Sources → your Shopify store → Setup.

Wait for KePixel's managed setup state

Do not create a random Web GTM container, Server GTM endpoint or custom pixel on KePixel's behalf. The Setup page is the source of truth for the install method assigned to that source.

Follow only the control exposed in Setup

If KePixel shows an installation snippet, app/pixel handoff, or managed container value, use that exact value in the matching Shopify surface. If Setup still shows Preparing/Waiting, refresh the source instead of inventing missing values.

Verify real storefront outcomes

Test product, cart, checkout and purchase flows supported by the installed integration and verify the source in KePixel.

KePixel → Sources → your Shopify store → Setup

Source Setup is authoritative

Why this guide does not hard-code a Shopify installer

Shopify installation surfaces and checkout capabilities can vary. KePixel must expose the supported install method for the specific source rather than asking a developer to place an unsupported tag in a theme or checkout surface.

If Setup does not expose an install control, stop

The source is not ready for self-serve installation yet. Do not copy another source's GTM ID, Server URL, credentials, custom pixel code or destination token.

Event quality target

view_item — stable product/item ID and accurate product context.
add_to_cart — only after the cart mutation succeeds.
begin_checkout — when checkout actually starts, with accurate items/value/currency when available.
purchase — only from a confirmed order outcome, with stable transaction ID, currency, value and items.

Do not create purchase from a generic thank-you page view or button click when a confirmed Shopify order signal is available through the approved source integration.

Privacy and credentials

Never place destination access tokens, Server GTM credentials, private API credentials, payment details or arbitrary customer PII in client-side Shopify code for KePixel. Use only the public/source-specific configuration exposed by KePixel Setup.

Testing

  1. Confirm the source URL and store are correct.
  2. Confirm Setup shows an approved installation method before editing Shopify.
  3. Install exactly once using that method.
  4. Test a real product/cart/checkout path.
  5. Use a safe test order when validating purchase.
  6. Return to KePixel and refresh source status.