Real Conversions API

Tencent Ads setup

Set Tencent Ads’s tokens once. Then every ads.conversions.track() call fans the event out to Tencent Ads server-side — no per-platform code.

1. Install adscapi

shell

npm install adscapi
# or run without installing:
npx adscapi platforms

2. Get Tencent Ads's tokens

Tencent Ads activates once all of these are set. Run npx adscapi platforms to see them, then get each value from Tencent Ads’s ads or events dashboard.

TENCENT_PIXEL_IDTENCENT_ADS_TOKEN

3. Set them for adscapi

Export the tokens in the environment that runs your server or the adscapi CLI.

shell

export TENCENT_PIXEL_ID="…"
export TENCENT_ADS_TOKEN="…"

4. Verify

check confirms the secrets are present; verify calls Tencent Ads’s API to confirm they are valid.

shell

npx adscapi check
npx adscapi verify --platform tencent

5. Track a conversion

One call, sent to Tencent Ads and every other configured platform. Pass raw email — adscapi hashes per platform. Consent is required.

import { createAdscapi } from 'adscapi';

const ads = createAdscapi();

const results = await ads.conversions.track({
  name: 'purchase',
  value: 49,
  currency: 'USD',
  user: { email: 'buyer@example.com' },
  consent: { adUserData: true, adPersonalization: true },
});

See the exact request on the Tencent Ads payload preview.