Pixel Custom Conversions Table
The Pixel Custom Conversions table attributes custom events marked as conversions to marketing channels, campaigns, and ads, with attribution models and a monetary event value. One row per conversion event per attributed touchpoint; events can have multiple rows under multi-touch attribution models. Learn more about tracking custom conversions with Triple Pixel.
Table GuideWhat You Can Answer With This Table
- How many of a specific custom conversion fired, and what was the total value? — use
event_name,event_value; count rows withCOUNT(*)- Which channels or campaigns drive the most conversions and conversion value? — use
channel,campaign_id,event_value- How does custom conversion attribution differ across models? — use
modelwithevent_valueorCOUNT(*)(see caveats below)Before You Query
- Required field:
event_date- Default attribution model: Triple Attribution. Filter
modelto query other models, or group bymodelto compare.- The Total Impact model is not supported on the Pixel Custom Conversions table. Queries using
model = 'Total Impact'will return an error.- Default attribution window:
lifetime. Filterattribution_windowto narrow to shorter windows (1_day,7_days,14_days,28_days).- Pre-multiplied values:
event_valueis already multiplied bylinear_weight; do not multiply again.- Conversion events only: Only events marked as conversion events in the Custom Events Builder appear in this table. The same events also appear in Pixel Custom Events as raw fires (without attribution).
Key Relationships
Table Join Key Use This Join To Customers email_addressSegment custom conversions by customer history, marketing consent, or LTV When to Use a Different Table
- Use Pixel Custom Events table when you need raw custom event data, including non-conversion events and the full
datapayload. The Pixel Custom Conversions table is the attribution-enriched view of conversion-marked events only.
Dimensions
Dimensions are immutable properties that can be used for grouping data.
| Title | ID | Type | Description |
|---|---|---|---|
| Event Hour | event_hour | string | The hour of the day the pixel custom conversion event occurred, according to a 24-hour clock. Based on the shop time zone at the moment of the event (or the user time zone, if no sales platform is connected). Example values: |
| Event Date | event_date | date | The date the pixel custom conversion event occurred. Based on the shop time zone at the moment of the event (or the user time zone, if no sales platform is connected). |
| Event Day | event_date.day | date | The day on which the event occurred. Derived from event_date. |
| Event Week | event_date.week | date | The Sunday of the week during which the event occurred. Derived from event_date. |
| Event Month | event_date.month | date | The month during which the event occurred. Derived from event_date. |
| Event Quarter | event_date.quarter | date | The first month of the quarter during which the event occurred. Derived from event_date. |
| Event Year | event_date.year | date | The year during which the event occurred. Derived from event_date. |
| Ad ID | ad_id | string | The unique ad ID. Assigned by the ad platform. Example value: |
| Ad Set ID | adset_id | string | The unique ID for the ad set associated with the ad click. Assigned by the ad platform. Example value: |
| Attribution Window | attribution_window | string | The time frame for attributing conversions to the ad. By default Example values: |
| Campaign ID | campaign_id | string | The unique ID for the marketing campaign associated with the ad. Assigned by the ad platform. Example values: |
| Channel | channel | string | The platform through which the ad was delivered. Example values: |
| Customer Email | email | string | The customer's email address. Example value: |
| Pixel Custom Conversion Event Data | event_body | JSON | The full data payload in raw JSON format, including all event properties defined for the custom conversion event. Learn more about querying pixel custom conversion event data |
| Event ID | event_id | string | The unique ID assigned by Triple Pixel to the custom conversion event. Example value: |
| Event Name | event_name | string | The name assigned to the custom conversion event. Example values: |
| Event Timestamp | event_timestamp | timestamp | The time the custom conversion event occurred. Formatted according to the ISO 8601 international standard. Example value: |
| Attribution Model | model | string | The attribution model used. By default Possible values: |
| Session ID | session_id | string | The unique session ID assigned by Triple Pixel. Example value: |
| Triple Pixel ID | triple_id | string | The unique ID assigned by Triple Pixel to track visitors across sessions. Example value: |
Measures
Measures are numeric fields that can be aggregated and/or combined to calculate new metrics.
| Title | ID | Type | Description |
|---|---|---|---|
| Event Conversion Value | event_value | numeric | The monetary conversion value assigned to the custom conversion event. |
| Linear Weight | linear_weight | numeric | The fraction of credit this row receives toward its event under the active attribution model. Multi-touch models split credit across touchpoints (values sum to 1 per event); single-touch models emit 1. |
Updated 7 days ago