Skip to content
adscapi

Bing (Microsoft Ads) CAPI Payload Preview

The server-side request adscapi builds when you track() a purchase and Bing (Microsoft Ads) is configured. Secrets and hashed values show as placeholders.

Request

GET
Endpoint
https://bat.bing.com/action/0?ti={BING_UET_TAG_ID}&ver=2.3&mid=order_1001&rn=<random-6-digit-cache-buster>&evt=custom&ea=purchase&ec=adscapi&el=order_1001&ev=49.99&gv=49.99&gc=USD&msclkid=msclkid-example-123

No request body — every parameter travels in the endpoint URL.

Verified against the library dispatcher (src/dispatchers/bing.ts). See the Bing (Microsoft Ads) setup guide for where to get each secret.

Required secrets

BING_UET_TAG_ID

Bing (Microsoft Ads) activates when every secret is present. One missing key and the platform no-ops — the rest still receive the event.

Event-name mapping

Canonical eventBing (Microsoft Ads) receives
page_viewpage_view (custom event passthrough)
leadlead (custom event passthrough)
signup_startsignup_start (custom event passthrough)
signupsignup (custom event passthrough)
checkout_createdcheckout_created (custom event passthrough)
purchasepurchase (custom event passthrough)
reply_generatedreply_generated (custom event passthrough)
upgrade_clickedupgrade_clicked (custom event passthrough)

Good to know

  • Unauthenticated GET to the same bat.bing.com endpoint the browser UET tag uses; keyed by the ti tag id. No token, no hashed PII.
  • evt is pageLoad for page_view and custom for everything else; the ea action label must match a custom conversion goal name in Microsoft Advertising.
  • Revenue rides as ev/gv with an uppercased gc currency; el carries the transaction id and mid is the unique message id.
  • The event-name map is intentionally empty: the canonical name passes through as ea. msclkid is optional; UET still records the event without it.

Frequently Asked Questions

Related Tools

Discover more free tools to fix your tracking

Event Payload Playground

Pick a canonical conversion event, fill the fields, and see the exact JSON payload adscapi builds — before you write a line of code.

Try it now

PII Hash Previewer

Type a raw email or phone number and see the normalized value plus its SHA-256 hash — the exact rules adscapi applies per platform. Nothing leaves the browser.

Try it now

Platform Coverage Explorer

Search all 26 ad platforms adscapi dispatches to — support level, required secrets, and setup docs, always in sync with the library registry.

Try it now

Ready to track Bing (Microsoft Ads) conversions server-side?

adscapi is free and open source. Set your platform tokens, call track() once, and every configured Conversions API receives the event — hashed the way each platform expects.