Skip to content
adscapi
← Platforms
Real Conversions API

Bing (Microsoft Ads) setup

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

1. Install adscapi

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

2. Get Bing (Microsoft Ads)'s tokens

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

BING_UET_TAG_ID

3. Set them for adscapi

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

shell
export BING_UET_TAG_ID="…"

4. Verify

check confirms the secrets are present; verify calls Bing (Microsoft Ads)’s API to confirm they are valid.

shell
npx adscapi check
npx adscapi verify --platform bing

5. Track a conversion

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

ts
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 Bing (Microsoft Ads) payload preview.