X Ads
Platform Summary
X Ads web conversion and audience contract candidates.
Scope
Primary execution surface: hybrid.
Developer Source Map
| Source | Reason |
|---|---|
| X Ads Web Conversions | Event Contracts; Transport / Payload Rules; User Data Contracts; events, payload, transport |
RudderStack Cross-Check
RudderStack is used here only as secondary engineering evidence for discovery and cross-check.
| Destination | Type | Link |
|---|---|---|
twitter_ads | Discovery lead | source |
x_audience | Discovery lead | source |
Verified Contracts
Event Contracts
| Object / Event | Field | Applies To | Type | Requirement | Exact Format | Normalization | Hashing | Examples | Caveat | Primary Source | Status | Confidence |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
conversion | conversion_time | server | string | Required | Required ISO-8601 timestamp for conversion event. | Not clearly specified | Do not hash | - | Conversion object required field. | X Ads Web Conversions | Verified | High |
conversion | event_id | server | string | Required | Required event identifier for each conversion object. | Not clearly specified | Do not hash | evt-12345 | Conversion object required field. | X Ads Web Conversions | Verified | High |
User Data Contracts
| Object / Event | Field | Applies To | Type | Requirement | Exact Format | Normalization | Hashing | Examples | Caveat | Primary Source | Status | Confidence |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
identifiers | hashed_email | server | string | Conditional | Lowercase and trim email before SHA-256 (unsalted). | lowercase; trim whitespace | SHA-256 required | <sha256(alice@example.com)> | Identifier hashing requirement. | X Ads Web Conversions | Verified | High |
identifiers | hashed_phone_number | server | string | Conditional | Normalize phone to E.164 before SHA-256 (unsalted). | E.164 | SHA-256 required | <sha256(16505551234)> | Identifier hashing requirement. | X Ads Web Conversions | Verified | High |
identifiers | identifiers (minimum set) | server | object | Required | At least one identifier is required. If sending ip_address or user_agent, provide a second identifier for matching. | Not clearly specified | Depends on identifier field | - | Matching rule for identifiers object. | X Ads Web Conversions | Verified | High |
identifiers | twclid | server | string | Conditional | Click identifier accepted without hashing. | Not clearly specified | Do not hash | - | Non-hashed identifier. | X Ads Web Conversions | Verified | High |
Transport / Payload Rules
| Object / Event | Field | Applies To | Type | Requirement | Exact Format | Normalization | Hashing | Examples | Caveat | Primary Source | Status | Confidence |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
web_conversions_api | POST /measurement/conversions/:pixel_id | hybrid | string | Required | Endpoint requires path parameter pixel_id and request body with top-level conversions array. Up to 500 conversion events per request. | Not clearly specified | Not applicable | - | X Ads Web Conversions API endpoint contract. | X Ads Web Conversions | Verified | High |
Candidate / Needs Review Items
No candidate rows currently tracked.
Excluded Items
No excluded rows in this revision.
Last Reviewed
2026-03-30