Skip to main content

What it is

The Attributed conversions dataset runs your conversions through the same attribution engine the report builder uses, and unloads the un-aggregated result: each row is a conversion joined to a touchpoint that earned credit toward it.
  • Grain: the attribution model decides. Single-touch models (first/last/platform/non-direct) emit exactly the winning touchpoint — one row per conversion. Multi-touch models (linear, u-shaped) emit one row per touchpoint with its fractional credit, so a conversion’s rows sum to its full value.
  • Windowed on: the conversion’s event_time_utc (UTC timestamp).
  • Path segment: attributed_conversions.
Two independent windows apply. The export window bounds which conversions are included. The separate attribution window (a setting below) bounds how far back a touchpoint may sit before its conversion to still earn credit.

Settings

Configured once at creation (immutable, like the rest of the export):
Attribution model
enum
required
first_touch, last_touch, first_platform_touch, last_platform_touch, last_non_direct_touch, linear, linear_paid, or u_shaped. Determines the row grain (see above).
Attribution window
enum
required
How far back a touchpoint may sit before its conversion: 1, 7, 14, 28, 30, 60, or 90 days, or LTV (no limit).
Type
enum
required
Attribute by profile (the contact) or by company.
Sources
array
Optional source filter. Empty means all sources (the report-builder default).

Columns

Attributed conversion fields

ColumnStatusDescription
conversion_idLockedThe conversion’s ID.
touchpoint_idLockedThe attributed touchpoint’s ID.
touchpoint_count_contributionLockedThe fractional conversion count credited to this touchpoint.
touchpoint_amount_contributionLockedThe fractional conversion value credited to this touchpoint.
event_time_utcLockedWhen the conversion occurred (UTC).
event_nameOptionalThe raw conversion event name.
configured_nameOptionalThe event’s display name as configured for your space (falls back to the raw name).
amountOptionalFull monetary value of the conversion.
profile_idOptionalThe contact the conversion belongs to.
company_idOptionalThe company the contact belongs to.
sourceOptionalTraffic source of the attributed touchpoint.
cometly_account_idOptionalCometly’s internal ad-account ID.
platform_account_idOptionalThe platform’s own ad-account ID.
cometly_campaign_idOptionalCometly’s internal campaign ID.
platform_campaign_idOptionalThe platform’s own campaign ID.
cometly_adset_idOptionalCometly’s internal ad set ID.
platform_adset_idOptionalThe platform’s own ad set ID.
cometly_ad_idOptionalCometly’s internal ad ID.
platform_ad_idOptionalThe platform’s own ad ID.

Conversion metadata

The visit-context record for the conversion. Each column is prefixed conversion_. All optional.
ColumnStatusDescription
conversion_order_idOptionalOrder ID from the conversion event.
conversion_order_nameOptionalOrder name or number.
conversion_idempotency_keyOptionalIdempotency key of the event.
conversion_event_urlOptionalFull event URL, assembled from host, path, and query.
conversion_referrer_urlOptionalFull referrer URL.
conversion_fbclidOptionalFacebook click ID.
conversion_fbpOptionalFacebook browser ID (fbp).
conversion_gclidOptionalGoogle click ID.
conversion_ttclidOptionalTikTok click ID.
conversion_lnclidOptionalLinkedIn click ID.
conversion_msclkidOptionalMicrosoft click ID.
conversion_rdt_cidOptionalReddit click ID.
conversion_tblciOptionalTaboola click ID.
conversion_device_typeOptionalDevice type.
conversion_osOptionalOperating system.
conversion_browserOptionalBrowser.
conversion_languageOptionalBrowser language.

Touchpoint metadata

The visit-context record for the attributed touchpoint (the ad-click visit). Each column is prefixed touchpoint_. All optional.
ColumnStatusDescription
touchpoint_order_idOptionalOrder ID from the touchpoint event.
touchpoint_order_nameOptionalOrder name or number.
touchpoint_idempotency_keyOptionalIdempotency key of the event.
touchpoint_event_urlOptionalFull event URL, assembled from host, path, and query.
touchpoint_referrer_urlOptionalFull referrer URL.
touchpoint_fbclidOptionalFacebook click ID.
touchpoint_fbpOptionalFacebook browser ID (fbp).
touchpoint_gclidOptionalGoogle click ID.
touchpoint_ttclidOptionalTikTok click ID.
touchpoint_lnclidOptionalLinkedIn click ID.
touchpoint_msclkidOptionalMicrosoft click ID.
touchpoint_rdt_cidOptionalReddit click ID.
touchpoint_tblciOptionalTaboola click ID.
touchpoint_device_typeOptionalDevice type.
touchpoint_osOptionalOperating system.
touchpoint_browserOptionalBrowser.
touchpoint_languageOptionalBrowser language.
For a multi-touch conversion, the conversion metadata repeats across that conversion’s touchpoint rows, while the touchpoint metadata differs per row.