X Ads Web Conversions

Send web conversion events to X (formerly Twitter) Ads via the Conversions API for campaign measurement and optimisation.

Configuration

Field	Type	Required	Description
`pixel_id`	string	Yes	Your X Pixel ID (also called Universal Website Tag ID). Found in X Ads Manager under Tools > Conversion Tracking.
`access_token`	secret	Yes	OAuth2 access token with ads_management permissions. Generate via the X developer portal.
`event_id`	string	No	Optional specific conversion event ID. If not set, events are routed based on event type mapping.

Quick Setup

Navigate to Integrations in the sidebar.
Open the Integration Library tab.
Find X Ads Web Conversions or filter by Advertising.
Click Install, select a variant if available, and fill in the required fields.
Click Install Integration to create the integration with a ready-to-use default configuration.

API Setup

curl -X POST http://localhost:8084/v1/admin/integration-catalog/x_ads/install \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "X Ads Web Conversions",
    "variant": "default",
    "config": {
      "pixel_id": "abcde",
      "access_token": "AAAA%2FAAA..."
    },
    "delivery_mode": "server_side"
  }'

Variants

X Ads Web Conversions is available in multiple pre-configured variants to match your industry:

Variant	Description
Default	Standard X Ads conversion tracking for general campaign measurement and audience optimisation.
Retail	E-commerce focused with purchase, cart, and product engagement events for X Shopping and Dynamic Product Ads.
Travel	Travel and hospitality focused with booking, search, and itinerary engagement events.
Media	Media and subscription focused with sign-up, subscription, and content engagement events.

Each variant provides a tuned default configuration. You can customise any setting after installation.

Delivery

Events are delivered server-side from your Datafly Signal infrastructure directly to the X Ads API. No client-side scripts are loaded for this integration.

Visit X Ads Web Conversions documentation for full API documentation and credential setup instructions.

VideoAmp Xandr