StackAdapt

Datafly Signal sends events to StackAdapt server-to-server through the Universal Pixel, for conversion tracking, retargeting and lookalike audiences.

Prerequisites

Find your Universal Pixel ID

In StackAdapt open Pixels and copy the Universal Pixel ID.

Create conversion events

Define conversion events and audiences on the event name, which Signal sends as args.action (for example purchase).

Configure in Signal

Configuration Fields

Field	Required	Description
`universal_pixel_id`	Yes	Your StackAdapt Universal Pixel ID (Pixels > Universal Pixel in StackAdapt). Every event is sent to the universal pixel with its event name in args.action; define conversion events and audiences on that action in StackAdapt.

Management UI Setup

Go to Integrations > Add Integration > StackAdapt.
Choose a preset: Default (default), Retail (ecommerce), Lead Generation (lead_gen), Insurance (insurance).
Fill in the fields above and click Save.

Request format

GET https://tags.srv.stackadapt.com/saq_pxl?args=%7B%22action%22%3A%22purchase%22%2C%22currency%22%3A%22GBP%22%2C%22email%22%3A%2286e0b9e56c17cc4d12387e1949b85053fbe73bc3ce5a1188713a9d300cc6133d%22%2C%22order_id%22%3A%22ORD-1001%22%2C%22products%22%3A%5B%7B%22product_category%22%3A%22Jackets%22%2C%22product_id%22%3A%22SKU_1%22%2C%22product_name%22%3A%22Parka%22%2C%22product_price%22%3A120%2C%22product_quantity%22%3A2%7D%2C%7B%22product_category%22%3A%22Accessories%22%2C%22product_id%22%3A%22SKU_2%22%2C%22product_name%22%3A%22Gloves%22%2C%22product_price%22%3A19.99%2C%22product_quantity%22%3A1%7D%5D%2C%22revenue%22%3A259.99%2C%22user_id%22%3A%22crm-user-9%22%7D&event_type=track&ip_fwd=203.0.113.9&ref=https%3A%2F%2Fwww.example.com%2F&title=Order+complete&ua_fwd=Mozilla%2F5.0+%28Macintosh%3B+Intel+Mac+OS+X+10_15_7%29&uid=SAUID123&url=https%3A%2F%2Fshop.example.co.uk%2Fcheckout%2Fdone%3Fx%3D1
X-Forwarded-For: 203.0.113.9
User-Agent: <visitor user agent>

Everything travels on the query string: uid, event_type, url, ref, title, ip_fwd, ua_fwd and args, a URL-encoded JSON object with action, revenue, currency, order_id, products, user_id and email. The visitor’s IP and user agent also go in the X-Forwarded-For and User-Agent headers.

Event Mapping

Signal event	Vendor event	Presets
`page`	`page_view`	Default, Retail, Lead Generation, Insurance
`view_item`	`view_item`	Default, Retail
`add_to_cart`	`add_to_cart`	Default, Retail
`begin_checkout`	`begin_checkout`	Default, Retail
`purchase`	`purchase`	Default, Retail, Insurance
`generate_lead`	`generate_lead`	Default, Retail, Lead Generation
`sign_up`	`sign_up`	Default, Retail, Lead Generation
`add_to_wishlist`	`add_to_wishlist`	Retail
`add_payment_info`	`add_payment_info`	Retail
`demo_requested`	`demo_requested`	Lead Generation
`content_downloaded`	`content_downloaded`	Lead Generation
`quote_started`	`quote_started`	Insurance
`quote_requested`	`quote_requested`	Insurance
`quote_completed`	`quote_completed`	Insurance

Signal forwards properties the preset does not map unless the integration’s strict output contract is on. Turn on strict_output_contract for this integration so only the documented fields are sent.

An integration installed before blueprint 0.4.1 keeps firing the conversion pixel (/conv?cid=) with its Conversion Pixel ID until you apply the new version. Applying it asks for the Universal Pixel ID; move your StackAdapt conversion rules onto args.action at the same time.

Identity

args.user_id is your user ID (or the Datafly anonymous ID). Email is sent only as a normalised SHA-256 hash; StackAdapt’s own integrations send email, name and phone in plain text, which Signal does not, so confirm email matching with StackAdapt.

StackAdapt is an advertising destination and requires marketing consent by default.

Troubleshooting

Problem	Solution
Conversions not counted	The StackAdapt conversion rule must match the `args.action` value exactly.

Blueprint

The StackAdapt blueprint version is 0.4.1. It was last reviewed against the vendor’s documentation on 2026-09-22.