Skip to main content

X Pixel & Conversions API

SonoTrix add-on for CS-Cart that loads the X (Twitter) Universal Website Tag and sends conversions through the Web Conversions API using OAuth 1.0a credentials.

What you need from X Ads​

  1. X Pixel ID (Universal Website Tag / pixel ID)
  2. Purchase Event UUID (required for purchase tracking)
  3. Optional: Page View Event UUID and Add to Cart Event UUID
  4. OAuth app credentials:
    • OAuth Consumer Key
    • OAuth Consumer Secret
    • OAuth Access Token
    • OAuth Access Token Secret

Install the add-on​

  1. Download the X Pixel & Conversions API package.
  2. Go to Add-ons → Manage add-ons.
  3. Upload, install, and enable the add-on.

See also: How to Install CS-Cart Add-ons.

Part A — X Ads Manager setup​

Step 1: Create the website pixel / Universal Website Tag​

  1. Sign in to X Ads Manager.
  2. Open Tools → Events Manager (or Conversion tracking / Pixel, depending on UI).
  3. Create a website pixel / Universal Website Tag if needed.
  4. Copy the Pixel ID into the add-on X Pixel ID field.

Step 2: Create conversion events and copy Event UUIDs​

  1. In Events Manager, create conversion events for your funnel (at least Purchase).
  2. Open each event and copy its Event UUID.
  3. You will paste:
    • Purchase Event UUID (required for purchase browser + CAPI)
    • Optional Page View Event UUID
    • Optional Add to Cart Event UUID

Without the Purchase Event UUID, purchase events will not fire.

Step 3: Create Ads API OAuth credentials​

  1. In the X developer / Ads API area linked to your ads account, create or open an app with Ads API access.
  2. Generate or copy:
    • Consumer Key
    • Consumer Secret
    • Access Token
    • Access Token Secret
  3. Use credentials that can call the Web Conversions API for your ad account.
note

OAuth screens are account-specific and often behind login. Keep secrets out of tickets and chat logs. Leave secret fields blank in the add-on when saving if you only want to keep existing values.

Part B — Configure the CS-Cart add-on​

Go to Add-ons → Manage add-ons → X Pixel & Conversions API → Settings.

Pixel Credentials​

Fill in:

  1. X Pixel ID
  2. OAuth Consumer Key
  3. OAuth Consumer Secret
  4. OAuth Access Token
  5. OAuth Access Token Secret
  6. Purchase Event UUID (required)
  7. Optional Page View Event UUID / Add to Cart Event UUID

Save.

Pixel Events (browser)​

Enable:

  • Page View
  • Add to Cart
  • Purchase

Conversion API Events (server)​

Enable:

  • Purchase
  • Add to Cart

Storefronts Pixels​

Per storefront: Disabled, Default, or Custom (full credential override).

Verify​

  1. Complete a test purchase on the storefront.
  2. In X Ads Events Manager, confirm purchase conversions.
  3. If purchases are missing, re-check the Purchase Event UUID and OAuth secrets.

Official X help​