shapes
type: ShapeGeneration
shape reference chain limit: 5
omitted shape reference count: 0

ActivityShape
type: NodeShape
target class: Activity
property:
  path: eventDate
  name: event date
  description: Event Date - The date the activity occurred. Based on the shop time zone at the moment of the event (or the user time zone, if no sales platform is connected).
  datatype: date
  max count: 1
property:
  path: eventDateDay
  name: event date day
  description: Event Day - The day the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateWeek
  name: event date week
  description: Event Week - The Sunday of the week during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateMonth
  name: event date month
  description: Event Month - The month during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateQuarter
  name: event date quarter
  description: Event Quarter - The first month of the quarter during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateYear
  name: event date year
  description: Event Year - The year during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: accountId
  name: account id
  description: Account ID - The unique ID for the platform or channel account associated with the activity. Example values: act_2168791943307744 , 18ce55770zl , 1986494684391480
  datatype: string
  max count: 1
property:
  path: actionSource
  name: action source
  description: Action Source - The source or interface from which the action was initiated. Example values: Moby
  datatype: string
  max count: 1
property:
  path: adChangedNameFrom
  name: ad changed name from
  description: Ad Changed Name From - The previous name of the ad before it was updated. Example value: Spring Campaign A
  datatype: string
  max count: 1
property:
  path: adChangedNameTo
  name: ad changed name to
  description: Ad Changed Name To - The updated name of the ad. Example value: Spring Campaign A v2
  datatype: string
  max count: 1
property:
  path: adCreated
  name: ad created
  description: Ad Created - Indicates whether a new ad was created. Possible values: true , false
  datatype: boolean
  max count: 1
property:
  path: adStatusChangedFrom
  name: ad status changed from
  description: Ad Status Changed From - The prior status of the ad before the change. Example values: PAUSED , ACTIVE , IN_PROCESS , PENDING_REVIEW
  datatype: string
  max count: 1
property:
  path: adStatusChangedTo
  name: ad status changed to
  description: Ad Status Changed To - The new status of the ad. Example values: PAUSED , ACTIVE , IN_PROCESS , PENDING_REVIEW
  datatype: string
  max count: 1
property:
  path: adsetBidAmountChangedFrom
  name: adset bid amount changed from
  description: Ad Set Bid Amount Changed From - The previous bid amount (in cents) for the ad set, before the most recent change. By default shown in the shop's currency.
  datatype: string
  max count: 1
property:
  path: adsetBidAmountChangedTo
  name: adset bid amount changed to
  description: Ad Set Bid Amount Changed To - The updated bid amount (in cents) for the ad set, after the most recent change. By default shown in the shop's currency.
  datatype: string
  max count: 1
property:
  path: adsetChangedNameFrom
  name: adset changed name from
  description: Ad Set Changed Name From - The previous name of the ad set. Example values: Interest - Teens
  datatype: string
  max count: 1
property:
  path: adsetChangedNameTo
  name: adset changed name to
  description: Ad Set Changed Name To - The updated name of the ad set. Example: Interest - Teen Girls
  datatype: string
  max count: 1
property:
  path: adsetCreated
  name: adset created
  description: Ad Set Created - Indicates whether a new ad set was created. Possible values: true , false
  datatype: boolean
  max count: 1
property:
  path: adsetDailyBudgetChangedFrom
  name: adset daily budget changed from
  description: Ad Set Daily Budget Changed From - The previous daily budget (in cents) set for the ad set, before the most recent change. By default shown in the shop's currency.
  datatype: string
  max count: 1
property:
  path: adsetDailyBudgetChangedTo
  name: adset daily budget changed to
  description: Ad Set Daily Budget Changed To - The updated daily budget (in cents) set for the ad set, after the most recent change. By default shown in the shop's currency.
  datatype: string
  max count: 1
property:
  path: adsetStatusChangedFrom
  name: adset status changed from
  description: Ad Set Status Changed From - The prior status of the ad set before the change. Example values: PAUSED , ACTIVE , IN_PROCESS
  datatype: string
  max count: 1
property:
  path: adsetStatusChangedTo
  name: adset status changed to
  description: Ad Set Status Changed To - The updated status of the ad set. Example values: PAUSED , ACTIVE , IN_PROCESS
  datatype: string
  max count: 1
property:
  path: adsetTargetRoasChangedFrom
  name: adset target roas changed from
  description: Ad Set Target ROAS Changed From - The previous target ROAS for the ad set, before the most recent change. By default shown in the shop's currency.
  datatype: string
  max count: 1
property:
  path: adsetTargetRoasChangedTo
  name: adset target roas changed to
  description: Ad Set Target ROAS Changed To - The updated target ROAS for the ad set, after the most recent change. By default shown in the shop's currency.
  datatype: string
  max count: 1
property:
  path: annotationAuthor
  name: annotation author
  description: Annotation Author - The user who created the annotation.
  datatype: string
  max count: 1
property:
  path: annotationDescription
  name: annotation description
  description: Annotation Description - The message content of the annotation.
  datatype: string
  max count: 1
property:
  path: annotationTitle
  name: annotation title
  description: Annotation Title - The title of the annotation.
  datatype: string
  max count: 1
property:
  path: campaignBidAmountChangedFrom
  name: campaign bid amount changed from
  description: Campaign Bid Amount Changed From - The previous bid amount (in cents) for the campaign, before the most recent change. By default shown in the shop's currency.
  datatype: string
  max count: 1
property:
  path: campaignBidAmountChangedTo
  name: campaign bid amount changed to
  description: Campaign Bid Amount Changed To - The updated bid amount (in cents) for the campaign, after the most recent change. By default shown in the shop's currency.
  datatype: string
  max count: 1
property:
  path: campaignChangedNameFrom
  name: campaign changed name from
  description: Campaign Changed Name From - The prior campaign name. Example value: June Evergreen
  datatype: string
  max count: 1
property:
  path: campaignChangedNameTo
  name: campaign changed name to
  description: Campaign Changed Name To - The updated campaign name. Example value: June Evergreen V2
  datatype: string
  max count: 1
property:
  path: campaignCreated
  name: campaign created
  description: Campaign Created - Indicates whether a new campaign was created. Possible values: true , false
  datatype: boolean
  max count: 1
property:
  path: campaignDailyBudgetChangedFrom
  name: campaign daily budget changed from
  description: Campaign Daily Budget Changed From - The previous daily budget in cents) for the campaign, before the most recent change. By default shown in the shop's currency.
  datatype: string
  max count: 1

AdShape
type: NodeShape
target class: Ad
property:
  path: eventHour
  name: event hour
  description: Event Hour - The hour of the day the ad was run, 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: 07 , 16 , 21
  datatype: string
  max count: 1
property:
  path: eventDate
  name: event date
  description: Event Date - The date the ad was run. Based on the shop time zone at the moment of the event (or the user time zone, if no sales platform is connected).
  datatype: date
  max count: 1
property:
  path: eventDateDay
  name: event date day
  description: Event Day - The day on which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateWeek
  name: event date week
  description: Event Week - The Sunday of the week during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateMonth
  name: event date month
  description: Event Month - The month during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateQuarter
  name: event date quarter
  description: Event Quarter - The first month of the quarter during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateYear
  name: event date year
  description: Event Year - The year during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: accountId
  name: account id
  description: Ad Account ID - The unique ID for the ad account associated with the ad. Assigned by the ad platform. Example values: act_2168791943307744 , 18ce55770zl , 1986494684391480
  datatype: string
  max count: 1
property:
  path: accountName
  name: account name
  description: Ad Account Name - The name of the advertiser's account as defined in the ad platform. Example values: Example Shop , example_shop , ES - International
  datatype: string
  max count: 1
property:
  path: actions
  name: actions
  description: Actions - Actions tracked and reported by Facebook in response to an ad interaction (click or view), such as leads, checkouts, or game plays.
  node: AdsActionShape
  class: AdsAction
  node kind: BlankNodeOrIRI
property:
  path: adBidAmount
  name: ad bid amount
  description: Ad Bid Amount - The bid amount for the ad. Example values: 15 , 28 , 30
  datatype: string
  max count: 1
property:
  path: adCopies
  name: ad copies
  description: Ad Copies - Array of all unique ad copy texts.
  datatype: string
property:
  path: adCopy
  name: ad copy
  description: Ad Copy - The full text (copy) of the ad.
  datatype: string
  max count: 1
property:
  path: adId
  name: ad id
  description: Ad ID - The unique ad ID. Assigned by the ad platform. Example value: 120210439891110007
  datatype: string
  max count: 1
property:
  path: adImageUrl
  name: ad image url
  description: Ad Image URL - The URL of the ad image. Example value: https://www.example.com/ad-image.jpg
  datatype: anyURI
  max count: 1
property:
  path: adName
  name: ad name
  description: Ad Name - The internal name of the ad within the ad platform. Example values: Kids Ad 1 , Blog 03/12/2023 , 10460_video_black_#5
  datatype: string
  max count: 1
property:
  path: adPostId
  name: ad post id
  description: Ad Post ID - The ID of the ad post. Example value: 123456789012345_987654321098765
  datatype: string
  max count: 1
property:
  path: adStatus
  name: ad status
  description: Ad Status - The status of the ad. Example values: ACTIVE , PAUSED
  datatype: string
  max count: 1
property:
  path: adTitle
  name: ad title
  description: Ad Title - The external, published title that viewers see when the ad is served. Example values: UP TO 50% OFF , The Hype Is Real , Trusted by 4 Million+ Women Worldwide
  datatype: string
  max count: 1
property:
  path: adTitles
  name: ad titles
  description: Ad Titles - Array of all unique ad titles.
  datatype: string
property:
  path: adType
  name: ad type
  description: Ad Type - The format of the ad. Example values: video , image , carousel , link , VIDEO , GRAPHIC Currently available for Meta and Axon.
  datatype: string
  max count: 1
property:
  path: adsetBidAmount
  name: adset bid amount
  description: Ad Set Bid Amount - The bid amount for the ad set. Example values: 25 , 35 , 40
  datatype: string
  max count: 1
property:
  path: adsetBidStrategy
  name: adset bid strategy
  description: Ad Set Bid Strategy - The bidding strategy for the ad set. Example values: LOWEST_COST_WITHOUT_CAP , LOWEST_COST_WITH_BID_CAP , COST_CAP , LOWEST_COST_WITH_MIN_ROAS
  datatype: string
  max count: 1
property:
  path: adsetId
  name: adset id
  description: Ad Set ID - The unique ID for the ad set associated with the ad click. Assigned by the ad platform. Example value: 120210439890740003
  datatype: string
  max count: 1
property:
  path: adsetName
  name: adset name
  description: Ad Set Name - The name of the ad set within a campaign. Example values: Broad Audience , Bracelets , Wellness
  datatype: string
  max count: 1
property:
  path: adsetStatus
  name: adset status
  description: Ad Set Status - The status of the ad set. Example values: ACTIVE , PAUSED
  datatype: string
  max count: 1
property:
  path: adsetTargeting
  name: adset targeting
  description: Ad Set Targeting - Details on targeting parameters for the ad set, including specific audience segments. Learn more about ad set targeting data
  node: AdsAdsetTargetingShape
  class: AdsAdsetTargeting
  node kind: BlankNodeOrIRI
property:
  path: amazonMarketplaceId
  name: amazon marketplace id
  description: Amazon Marketplace ID - The Amazon marketplace ID for the marketplace associated with the order. See list of marketplace IDs .
  datatype: string
  max count: 1
property:
  path: amazonReportType
  name: amazon report type
  description: Amazon Report Type - The type of report generated for Amazon advertising activities (e.g. sponsored products, sponsored brands, sponsored display).
  datatype: string
  max count: 1
property:
  path: asin
  name: asin
  description: Amazon Standard Identification Number - The 10-character alphanumeric code that uniquely identifies a product on Amazon (unique per marketplace). Shows which specific product an Amazon ad or search keyword performance metric is associated with. Example values: B08N5WRWNW , B0CXYZ1234
  datatype: string
  max count: 1
property:
  path: breakdownDimension
  name: breakdown dimension
  description: Breakdown Dimension - The dimension used to break down the data. Example values: age — Audience age bucket. gender — Audience gender category. ageGender — Combination of age bucket and gender. country — Audience or delivery country. region — Sub-country region. dma — U.S. Nielsen Designated Market Area (media market). frequency — How many times a person saw the ad (bucketed). publisherPlatform — App or network where delivery occurred. platformPosition — Specific placement/slot within a platform surface. publisherPlatformPosition — Combination of platform and placement.
  datatype: string
  max count: 1
property:
  path: breakdownValue
  name: breakdown value
  description: Breakdown Value - The value of the selected breakdown_dimension . Values differ by dimension and platform. Example values by dimension: age — 25-34 , 35-44 , 45-54 , 55-64 , 65+ gender — female , male , unknown ageGender — 25-34|female , 35-44|male , 65+|unknown country — US , CA , GB (The breakdown_country_name column provides the corresponding full country name. See list of countries .) region — California , New York , Washington, District of Columbia dma — Boston (Manchester) , Albany-Schenectady-Troy , Dallas-Ft. Worth frequency — 1 , 6-10 , 31+ publisherPlatform — facebook , instagram , messenger , audience_network , threads , unknown platformPosition — feed , facebook_stories , instagram_stories , messenger_stories , facebook_reels , instagram_reels , marketplace , right_hand_column , instream_video , search , video_feeds publisherPlatformPosition — facebook|feed , instagram|feed , facebook|facebook_stories , instagram|instagram_reels , facebook|right_hand_column
  datatype: string
  max count: 1
property:
  path: breakdownCountryName
  name: breakdown country name
  description: Breakdown Country Name - The country name for the ad breakdown. Only populated when breakdown_dimension is set to country . When no breakdown is set, or when a different breakdown dimension is selected, this column returns NULL. See list of countries . Example values: United States , Canada , United Kingdom
  datatype: string
  max count: 1

AdsActionShape
type: NodeShape
target class: AdsAction
property:
  path: actionType
  name: action type
  description: Action Type - The specific type of action tracked by Facebook Ads. This includes raw action names reported by various Facebook data sources, such as pixel events, app events, and unified totals. Example values: lead , omni_add_to_cart , offsite_conversion. fb_pixel_initiate_checkout ).
  datatype: string
  max count: 1
property:
  path: displayName
  name: display name
  description: Action Display Name - The user-friendly name for the action, standardized across Facebook's reporting sources. Example values: achievements_unlocked , add_payment_info , add_to_cart , add_to_wishlist , app_activations , app_installs , applications_submitted , checkouts_initiated , contacts , donations , game_plays , leads , subscriptions , trials_started , tutorials_completed
  datatype: string
  max count: 1
property:
  path: oneDayView
  name: one day view
  description: One-Day View Actions - Number of times the action occurred within 1 day of viewing the ad. Example values: 2 , 5 , 14
  datatype: double
  max count: 1
property:
  path: sevenDayView
  name: seven day view
  description: Seven-Day View Actions - Number of times the action occurred within 7 days of viewing the ad. Example values: 3 , 8 , 21
  datatype: double
  max count: 1
property:
  path: twentyEightDayView
  name: twenty eight day view
  description: Twenty-Eight-Day View Actions - Number of times the action occurred within 28 days of viewing the ad. Example values: 4 , 12 , 30
  datatype: double
  max count: 1
property:
  path: oneDayClick
  name: one day click
  description: One-Day Click Actions - Number of times the action occurred within 1 day of clicking the ad. Example values: 2 , 5 , 14
  datatype: double
  max count: 1
property:
  path: sevenDayClick
  name: seven day click
  description: Seven-Day Click Actions - Number of times the action occurred within 7 days of clicking the ad. Example values: 3 , 8 , 21
  datatype: double
  max count: 1
property:
  path: twentyEightDayClick
  name: twenty eight day click
  description: Twenty-Eight-Day Click Actions - Number of times the action occurred within 28 days of clicking the ad. Example values: 4 , 12 , 30
  datatype: double
  max count: 1
property:
  path: oneDayViewValue
  name: one day view value
  description: One-Day View Value Actions - Total monetary value attributed to the action when it occurred within 1 day of viewing the ad. Example values: 4500 , 12999 , 17500
  datatype: double
  max count: 1
property:
  path: sevenDayViewValue
  name: seven day view value
  description: Seven-Day View Value Actions - Total monetary value attributed to the action when it occurred within 7 days of viewing the ad. Example values: 6000 , 17000 , 22350
  datatype: double
  max count: 1
property:
  path: twentyEightDayViewValue
  name: twenty eight day view value
  description: Twenty-Eight-Day View Value Actions - Total monetary value attributed to the action when it occurred within 28 days of viewing the ad. Example values: 9000 , 25000 , 31500
  datatype: double
  max count: 1
property:
  path: oneDayClickValue
  name: one day click value
  description: One-Day Click Value Actions - Total monetary value attributed to the action when it occurred within 1 day of clicking the ad. Example values: 4500 , 12999 , 17500
  datatype: double
  max count: 1
property:
  path: sevenDayClickValue
  name: seven day click value
  description: Seven-Day Click Value Actions - Total monetary value attributed to the action when it occurred within 7 days of clicking the ad. Example values: 6000 , 17000 , 22350
  datatype: double
  max count: 1
property:
  path: twentyEightDayClickValue
  name: twenty eight day click value
  description: Twenty-Eight-Day Click Value Actions - Total monetary value attributed to the action when it occurred within 28 days of clicking the ad. Example values: 9000 , 25000 , 31500
  datatype: double
  max count: 1

AdsAdsetTargetingShape
type: NodeShape
target class: AdsAdsetTargeting
property:
  path: targetKey
  name: target key
  description: Target Key - The targeting category key within the ad set (e.g., location, age, gender). Learn more about ad set targeting data Example values: age_min , age_max , geo_locations_countries , device_platforms , genders
  datatype: string
  max count: 1
property:
  path: targetValues
  name: target values
  description: Target Values - The specific values associated with the targeting category key, returned as an array. Learn more about ad set targeting data
  node: ContainerShape
  class: Container
  node kind: BlankNodeOrIRI

AdsCustomConversionShape
type: NodeShape
target class: AdsCustomConversion
property:
  path: customConversionName
  name: custom conversion name
  description: Custom Conversion Name - The name of the custom conversion event, defined by the user in the ad platform. Example values: $65+ Purchase , NC Purchase , Over60Value
  datatype: string
  max count: 1
property:
  path: customConversionId
  name: custom conversion id
  description: Custom Conversion ID - The unique ID of the custom conversion event, assigned by the ad platform. Example value: 358833132159405
  datatype: string
  max count: 1
property:
  path: oneDayClick
  name: one day click
  description: One-Day Click Custom Conversions - Number of conversions (for the custom conversion event) within one day of clicking the ad.
  datatype: double
  max count: 1
property:
  path: sevenDayClick
  name: seven day click
  description: Seven-Day Click Custom Conversions - Number of conversions (for the custom conversion event) within seven days of clicking the ad.
  datatype: double
  max count: 1
property:
  path: twentyEightDayClick
  name: twenty eight day click
  description: Twenty-Eight-Day Click Custom Conversions - Number of conversions (for the custom conversion event) within twenty-eight days of clicking the ad.
  datatype: double
  max count: 1
property:
  path: oneDayView
  name: one day view
  description: One-Day View Custom Conversions - Number of conversions (for the custom conversion event) within one day of viewing the ad.
  datatype: double
  max count: 1
property:
  path: sevenDayView
  name: seven day view
  description: Seven-Day View Custom Conversions - Number of conversions (for the custom conversion event) within seven days of viewing the ad.
  datatype: double
  max count: 1
property:
  path: twentyEightDayView
  name: twenty eight day view
  description: Twenty-Eight-Day View Custom Conversions - Number of conversions (for the custom conversion event) within twenty-eight days of viewing the ad.
  datatype: double
  max count: 1
property:
  path: oneDayClickValue
  name: one day click value
  description: One-Day Click Custom Conversion Value - The total value of conversions (for the custom conversion event) within one day of clicking the ad.
  datatype: double
  max count: 1
property:
  path: sevenDayClickValue
  name: seven day click value
  description: Seven-Day Click Custom Conversion Value - The total value of conversions (for the custom conversion event) within seven days of clicking the ad.
  datatype: double
  max count: 1
property:
  path: twentyEightDayClickValue
  name: twenty eight day click value
  description: Twenty-Eight-Day Click Custom Conversion Value - The total value of conversions (for the custom conversion event) within twenty-eight days of clicking the ad.
  datatype: double
  max count: 1
property:
  path: oneDayViewValue
  name: one day view value
  description: One-Day View Custom Conversion Value - The total value of conversions (for the custom conversion event) within one day of viewing the ad.
  datatype: double
  max count: 1
property:
  path: sevenDayViewValue
  name: seven day view value
  description: Seven-Day View Custom Conversion Value - The total value of conversions (for the custom conversion event) within seven days of viewing the ad.
  datatype: double
  max count: 1
property:
  path: twentyEightDayViewValue
  name: twenty eight day view value
  description: Twenty-Eight-Day View Custom Conversion Value - The total value of conversions (for the custom conversion event) within twenty-eight days of viewing the ad.
  datatype: double
  max count: 1

AffiliateShape
type: NodeShape
target class: Affiliate
property:
  path: eventDate
  name: event date
  description: Event Date - The date the affiliate 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).
  datatype: date
  max count: 1
property:
  path: eventDateDay
  name: event date day
  description: Event Day - The day the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateWeek
  name: event date week
  description: Event Week - The Sunday of the week during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateMonth
  name: event date month
  description: Event Month - The month during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateQuarter
  name: event date quarter
  description: Event Quarter - The first month of the quarter during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateYear
  name: event date year
  description: Event Year - The year during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: adId
  name: ad id
  description: Ad ID - The unique identifier of the tracking link under the campaign. Example values: link_abc123 , tracking_xyz789
  datatype: string
  max count: 1
property:
  path: adName
  name: ad name
  description: Ad Name - The name of the tracking link under the campaign. Example values: homepage-banner , product-page-link , email-cta
  datatype: string
  max count: 1
property:
  path: adStatus
  name: ad status
  description: Ad Status - Indicates whether this tracking link is active or inactive. Example values: active , inactive
  datatype: string
  max count: 1
property:
  path: campaignId
  name: campaign id
  description: Campaign ID - The unique identifier of the campaign or offer under the publisher. Example values: camp_12345 , offer_67890
  datatype: string
  max count: 1
property:
  path: campaignName
  name: campaign name
  description: Campaign Name - The name of the campaign or offer under the publisher. Example values: summer-promo-10% , holiday-sale-2024 , winter-clearance
  datatype: string
  max count: 1
property:
  path: campaignStatus
  name: campaign status
  description: Campaign Status - Indicates whether this campaign or offer is active or inactive. Example values: active , inactive
  datatype: string
  max count: 1
property:
  path: publisherId
  name: publisher id
  description: Publisher ID - The unique identifier of the affiliate partner or influencer. Example value: 208997
  datatype: string
  max count: 1
property:
  path: publisherName
  name: publisher name
  description: Publisher Name - The name of the affiliate partner or influencer. Example values: Karma Shopping LTD , NextGen Shopping, Inc. , tenere_team
  datatype: string
  max count: 1
property:
  path: publisherStatus
  name: publisher status
  description: Publisher Status - Indicates whether the partnership with this affiliate is active or inactive. Example values: active , inactive
  datatype: string
  max count: 1
property:
  path: clicks
  name: clicks
  description: Clicks - Number of clicks on the affiliate tracking link.
  datatype: double
  max count: 1
property:
  path: conversionValue
  name: conversion value
  description: Conversion Value - Total revenue generated from purchases attributed to the affiliate.
  datatype: double
  max count: 1
property:
  path: impressions
  name: impressions
  description: Impressions - Number of times the affiliate tracking link was displayed or viewed.
  datatype: double
  max count: 1
property:
  path: purchases
  name: purchases
  description: Purchases - Number of purchases attributed to the affiliate.
  datatype: double
  max count: 1
property:
  path: spend
  name: spend
  description: Spend - Total amount spent on the affiliate partnership, including commissions, fees, or other costs.
  datatype: double
  max count: 1

AffluencerHubShape
type: NodeShape
target class: AffluencerHub
property:
  path: eventDate
  name: event date
  description: Event Date - The date the order was placed. Based on the shop time zone at the moment of the event (or user time zone when no sales platform is connected).
  datatype: date
  max count: 1
property:
  path: eventDateDay
  name: event date day
  description: Event Day - The day on which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateWeek
  name: event date week
  description: Event Week - The Sunday of the week during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateMonth
  name: event date month
  description: Event Month - The month during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateQuarter
  name: event date quarter
  description: Event Quarter - The first month of the quarter during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateYear
  name: event date year
  description: Event Year - The year during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: affluencerSource
  name: affluencer source
  description: Affluencer Source - How the affluencer profile was created. Example values: upload , client , auto_create , backfill
  datatype: string
  max count: 1
property:
  path: discountCodes
  name: discount codes
  description: Discount Codes - A list of the discount codes associated with the affluencer.
  node: AffluencerDiscountCodeShape
  class: AffluencerDiscountCode
  node kind: BlankNodeOrIRI
property:
  path: expenses
  name: expenses
  description: Expenses - A list of expense records assigned to the affluencer.
  node: AffluencerExpenseShape
  class: AffluencerExpense
  node kind: BlankNodeOrIRI
property:
  path: links
  name: links
  description: Affluencer Links - A list of destination URLs tied to the affluencer, used for traffic and attribution.
  node: AffluencerLinkShape
  class: AffluencerLink
  node kind: BlankNodeOrIRI
property:
  path: name
  name: name
  description: Affluencer Name - The name of the affluencer. Example value: Jane Smith
  datatype: string
  max count: 1
property:
  path: spend
  name: spend
  description: Spend - The total amount of expenses.
  datatype: string
  max count: 1

AffluencerDiscountCodeShape
type: NodeShape
target class: AffluencerDiscountCode
property:
  path: code
  name: code
  description: Discount Code - The actual code used to attribute orders to the affluencer. Example values: JEN20 , UMICH , ARKNUTRITION
  datatype: string
  max count: 1
property:
  path: startDate
  name: start date
  description: Discount Code Start Date - The start date the discount code is valid. Example value: 2024-08-02 00:00:00
  datatype: date
  max count: 1
property:
  path: endDate
  name: end date
  description: Discount Code End Date - The end date the discount code is valid. Example value: 2025-08-02 00:00:00
  datatype: date
  max count: 1

AffluencerExpenseShape
type: NodeShape
target class: AffluencerExpense
property:
  path: id
  name: id
  description: Expense ID - A unique identifier for the expense. Example value: 37f1ad60-2ce9-4733-b6d9-4b3d13307e42
  datatype: string
  max count: 1
property:
  path: spendType
  name: spend type
  description: Expense Type - Indicates the category of the expense. Example values: per_order , fixed
  datatype: string
  max count: 1
property:
  path: amountType
  name: amount type
  description: Expense Amount Type - Indicates whether the expense is a percentage of sales or a fixed amount (currency). Example values: percentage , currency
  datatype: string
  max count: 1
property:
  path: isRecurring
  name: is recurring
  description: Expense Is Recurring - Indicates whether this expense recurs on a regular cadence (e.g. monthly) or is a one-time expense. Possible values: true , false
  datatype: boolean
  max count: 1
property:
  path: recurringCadence
  name: recurring cadence
  description: Expense Recurring Cadence - Frequency of the recurring expense. Example values: one_time , week , month
  datatype: string
  max count: 1
property:
  path: startDate
  name: start date
  description: Expense Start Date - The date the expense starts. Example value: 2023-07-22
  datatype: date
  max count: 1
property:
  path: endDate
  name: end date
  description: Expense End Date - The date the expense ends (if applicable). Example value: 2025-01-01
  datatype: date
  max count: 1
property:
  path: amount
  name: amount
  description: Expense Amount - The value of the expense.
  datatype: double
  max count: 1
property:
  path: recurringIntervalLength
  name: recurring interval length
  description: Expense Recurring Interval Length - Number of intervals between each recurring payment. For example, if recurring_cadence = week and recurring_interval_length = 2 , the expense recurs every two weeks.
  datatype: double
  max count: 1

AffluencerLinkShape
type: NodeShape
target class: AffluencerLink
property:
  path: id
  name: id
  description: Link ID - Unique identifier for the link, formatted: ${name}*${links.campaign}*${links.source}
  datatype: string
  max count: 1
property:
  path: campaign
  name: campaign
  description: Link Campaign - The name of the campaign the link is associated with (e.g. summer-launch , holiday-sale ).
  datatype: string
  max count: 1
property:
  path: source
  name: source
  description: Link Source - The traffic source where this link is shared. Example values: instagram , default
  datatype: string
  max count: 1
property:
  path: storefrontUrl
  name: storefront url
  description: Link Storefront URL - The public-facing URL the affluencer is promoting Example value: https://www.instagram.com/example
  datatype: anyURI
  max count: 1
property:
  path: url
  name: url
  description: Link URL - The fully generated tracking URL that includes affluencer and link identifiers. Example value: https://www.instagram.com/example?linkId=example_instagram&affluencerId=example
  datatype: anyURI
  max count: 1

AiVisibilityShape
type: NodeShape
target class: AiVisibility
property:
  path: eventDate
  name: event date
  description: Event Date - The date the AI visibility prompt execution ran. Based on the shop time zone at the moment of the event (or the user time zone, if no sales platform is connected).
  datatype: date
  max count: 1
property:
  path: eventDateDay
  name: event date day
  description: Event Day - The day the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateWeek
  name: event date week
  description: Event Week - The Sunday of the week during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateMonth
  name: event date month
  description: Event Month - The month during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateQuarter
  name: event date quarter
  description: Event Quarter - The first month of the quarter during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateYear
  name: event date year
  description: Event Year - The year during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: competitorsVisibility
  name: competitors visibility
  description: Competitors Visibility - Competitor visibility data for the prompt execution. Each record represents a competitor and whether they were mentioned in the LLM response.
  node: CompetitorsVisibilityShape
  class: CompetitorsVisibility
  node kind: BlankNodeOrIRI
property:
  path: eventTimestamp
  name: event timestamp
  description: Prompt Execution Timestamp - Timestamp of when the prompt execution ran (UTC). Example value: 2026-01-10 10:04:06
  datatype: dateTime
  max count: 1
property:
  path: executionId
  name: execution id
  description: Prompt Execution ID - Unique identifier for a single prompt execution. Example value: 985c7f1d-0f6e-4ae5-bbbc-50f5b3c8353e
  datatype: string
  max count: 1
property:
  path: isMentioned
  name: is mentioned
  description: Is Mentioned - Whether the shop was mentioned in the response. Possible values: true , false
  datatype: boolean
  max count: 1
property:
  path: llm
  name: llm
  description: LLM - The LLM that was used for the prompt execution. Example values: chatgpt , gemini
  datatype: string
  max count: 1
property:
  path: promptId
  name: prompt id
  description: Prompt ID - The prompt identifier associated with the execution. Example value: 29431f0b8fb1900972f8f121
  datatype: string
  max count: 1
property:
  path: promptText
  name: prompt text
  description: Prompt Text - The prompt text used for the execution. Example values: What’s the best heritage flour for everyday baking? , What makes seed oil free bars better? , What features should I look for in skis for moderate skill level?
  datatype: string
  max count: 1
property:
  path: responsePreview
  name: response preview
  description: Response Preview - Preview of the LLM response (first 200 characters). Example value: Here are some of the best heritage flours you can use for everyday baking…
  datatype: string
  max count: 1
property:
  path: shopId
  name: shop id
  description: Shop ID - The unique ID of the shop (often corresponds to the shop domain). Can be used to group or filter data by shop in multi-store reports. Example values: example-US.myshopify.com , example-EU.myshopify.com
  datatype: string
  max count: 1
property:
  path: shopName
  name: shop name
  description: Shop Name - The name of the shop. Can be used to group or filter data by shop in multi-store reports. Example values: example-US , example-EU
  datatype: string
  max count: 1
property:
  path: sources
  name: sources
  description: Cited Sources - Citations/sources returned by the LLM for the prompt execution. Each record represents one cited source.
  node: SourceShape
  class: Source
  node kind: BlankNodeOrIRI
property:
  path: topicId
  name: topic id
  description: Topic ID - The topic identifier associated with the prompt execution. Example value: 495be1b1787a86e9ae3dadd3
  datatype: string
  max count: 1
property:
  path: topicName
  name: topic name
  description: Topic Name - The topic name associated with the prompt execution. Example value: Flour , Seed Oil Free , Skis
  datatype: string
  max count: 1
property:
  path: visibilityPercentage
  name: visibility percentage
  description: Visibility Percentage - Percentage of prompt executions where the shop was mentioned in the LLM response. Visibility % = Number of Mentions / Number of Prompt Executions
  datatype: string
  max count: 1

CompetitorsVisibilityShape
type: NodeShape
target class: CompetitorsVisibility
property:
  path: competitorId
  name: competitor id
  description: Competitor ID - Unique identifier for the competitor. Example value: 6801a2f3c9e7b54d1023ef89
  datatype: string
  max count: 1
property:
  path: competitorName
  name: competitor name
  description: Competitor Name - Display name of the competitor. Example value: Acme Co
  datatype: string
  max count: 1
property:
  path: competitorUrl
  name: competitor url
  description: Competitor URL - URL of the competitor. Example value: https://acmeco.com
  datatype: anyURI
  max count: 1
property:
  path: isMentioned
  name: is mentioned
  description: Competitor Is Mentioned - Whether this competitor was mentioned in the LLM response. Possible values: true , false
  datatype: boolean
  max count: 1

SourceShape
type: NodeShape
target class: Source
property:
  path: sourceDomain
  name: source domain
  description: Cited Source Domain - Domain of a cited source. Example value: exampleshop.com
  datatype: string
  max count: 1
property:
  path: sourceUrl
  name: source url
  description: Cited Source URL - URL of a cited source. Example value: https://exampleshop.com/products/heritage-bread-blend-flour?utm_source=chatgpt.com
  datatype: anyURI
  max count: 1
property:
  path: citationOrder
  name: citation order
  description: Citation Order - Order of the citation in the response (lower numbers appear earlier). Example value: 2
  datatype: double
  max count: 1

BlendedStatsShape
type: NodeShape
target class: BlendedStats
property:
  path: includeAmazon
  name: include amazon
  description: Include Amazon - Includes Amazon sales data in the results, in addition to the main sales platform. Possible values: true , false Defaults to false .
  datatype: string
  max count: 1
property:
  path: eventHour
  name: event hour
  description: Event Hour - The hour of the day on which the order was placed, 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: 07 , 16 , 21
  datatype: string
  max count: 1
property:
  path: eventDate
  name: event date
  description: Event Date - The date the order was placed. Based on the shop time zone at the moment of the event (or the user time zone, if no sales platform is connected).
  datatype: date
  max count: 1
property:
  path: eventDateDay
  name: event date day
  description: Event Day - The day on which the ad was run or the order was placed. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateWeek
  name: event date week
  description: Event Week - The Sunday of the week during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateMonth
  name: event date month
  description: Event Month - The month during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateQuarter
  name: event date quarter
  description: Event Quarter - The first month of the quarter during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateYear
  name: event date year
  description: Event Year - The year during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: shopId
  name: shop id
  description: Shop ID - The unique ID of the shop (often corresponds to the shop domain). Can be used to group or filter data by shop in multi-store reports. Example values: example-US.myshopify.com , example-EU.myshopify.com
  datatype: string
  max count: 1
property:
  path: shopName
  name: shop name
  description: Shop Name - The name of the shop. Can be used to group or filter data by shop in multi-store reports. Example values: example-US , example-EU
  datatype: string
  max count: 1
property:
  path: channelReportedConversionValue
  name: channel reported conversion value
  description: Blended Channel-Reported Conversion Value - Channel-reported conversion value across all marketing channels connected to Triple Whale.
  datatype: double
  max count: 1
property:
  path: cogs
  name: cogs
  description: Cost of Goods (COGS) - The cost of goods sold within the selected time frame (before refunds). Imported from the main sales platform, or edit these in Cost Settings > Cost of Goods.
  datatype: double
  max count: 1
property:
  path: cogsAdjusted
  name: cogs adjusted
  description: Adjusted Cost of Goods (Adjusted COGS) - The cost of goods sold within the selected time frame, minus the cost of goods of refunded items in the selected time frame. Imported from the main sales platform, or edit these in Cost Settings > Cost of Goods.
  datatype: double
  max count: 1
property:
  path: discounts
  name: discounts
  description: Discounts - The total discount amount applied to the order, including shipping discounts.
  datatype: double
  max count: 1
property:
  path: grossProductSales
  name: gross product sales
  description: Gross Sales - Gross sales revenue (before shipping, taxes, discounts, or refunds). Gross Sales = Product Price x Units Sold
  datatype: double
  max count: 1
property:
  path: handlingFees
  name: handling fees
  description: Handling Fees - Handling fees (e.g. boxing, packaging, or “pick & pack” services) paid by the seller for orders in the selected time frame. Edit these in Cost Settings > Cost of Goods.
  datatype: double
  max count: 1
property:
  path: newCustomerOrders
  name: new customer orders
  description: New Customer Orders - The total number of orders placed by new customers. Learn how Triple Whale classifies new/returning customers .
  datatype: double
  max count: 1
property:
  path: newCustomerRevenue
  name: new customer revenue
  description: New Customer Revenue - The total revenue derived from orders by new customers. Learn how Triple Whale classifies new/returning customers .
  datatype: double
  max count: 1
property:
  path: orderRevenue
  name: order revenue
  description: Order Revenue - Revenue earned after shipping, taxes, and discounts (before refunds). Order Revenue = Gross Sales + Shipping + Taxes − Discounts
  datatype: double
  max count: 1
property:
  path: ordersCount
  name: orders count
  description: Orders - The total number of orders placed within the selected timeframe.
  datatype: double
  max count: 1
property:
  path: ordersCustomExpenses
  name: orders custom expenses
  description: Order-Level Custom Expenses - Additional custom expenses associated with individual orders. Import these using the Enrich Orders Data API endpoint.
  datatype: double
  max count: 1
property:
  path: ordersWithAmount
  name: orders with amount
  description: Orders > $0 - The total number of orders with a revenue greater than zero.
  datatype: double
  max count: 1
property:
  path: paymentGatewayCosts
  name: payment gateway costs
  description: Payment Gateway Costs - Payment processing fees (not including currency conversion fees) paid by the seller. Edit these in Cost Settings > Gateway Costs.
  datatype: double
  max count: 1
property:
  path: refundMoney
  name: refund money
  description: Refunded Sales - Refunded sales amount for the selected time period. Calculated based on the refund date. Note that Triple Whale does not track refunds from third-party return management apps (e.g., Loop), so totals may vary from the sales platform.
  datatype: double
  max count: 1
property:
  path: refundedOrders
  name: refunded orders
  description: Refunded Orders - The total number of orders refunded in the selected time frame.
  datatype: double
  max count: 1
property:
  path: sessions
  name: sessions
  description: Sessions - Total number of online store sessions. Note that Triple Whale defines and tracks sessions differently from the main sales platform so there may be variance between the two. Learn how Triple Whale defines and tracks sessions.
  datatype: double
  max count: 1
property:
  path: shippingCosts
  name: shipping costs
  description: Shipping Costs - Shipping costs paid by the seller for orders within the select timeframe. Edit these in Cost Settings > Shipping.
  datatype: double
  max count: 1
property:
  path: shippingPrice
  name: shipping price
  description: Shipping Price - The total shipping price of the order (paid by the buyer), after shipping taxes and shipping discounts.
  datatype: double
  max count: 1
property:
  path: spend
  name: spend
  description: Blended Ad Spend - The reported ad spend of all marketing channels connected to Triple Whale, plus any Custom Expenses marked as Ad Spend.
  datatype: double
  max count: 1
property:
  path: taxes
  name: taxes
  description: Taxes - Amount customers paid in taxes (excluding refunded taxes).
  datatype: double
  max count: 1
property:
  path: totalCosts
  name: total costs
  description: Total Costs - The total cost to the seller, including COGS, fees, shipping, custom spend, handling, taxes, and order-level custom expenses, adjusted for refunds. Total Costs = COGS - Refunded COGS + Payment Gateway Costs + Shipping Costs + Custom Spend (excl. Custom Ad Spend) + Handling Fees + Taxes + Order-Level Custom Expenses
  datatype: double
  max count: 1
property:
  path: totalSales
  name: total sales
  description: Total Sales - Total sales revenue kept by the business after shipping, taxes, discounts, refunded sales, refunded shipping, and refunded taxes. Revenue values are based on the order date; refund values are based on the refund date. Total Sales = Gross Sales + Shipping + Taxes − Discounts − Refunded Sales − Refunded Shipping − Refunded Taxes
  datatype: double
  max count: 1
property:
  path: amazonTacos
  name: amazon tacos
  description: Amazon Total Advertising Cost of Sale (Amazon TACoS) - Percentage of Amazon sales revenue spent on ads. Amazon TACoS = Amazon Ad Spend / Amazon Order Revenue
  datatype: string
  max count: 1

CreativeShape
type: NodeShape
target class: Creative
property:
  path: eventDate
  name: event date
  description: Event Date - The date the ad was run. Based on the shop time zone at the moment of the event (or the user time zone, if no sales platform is connected).
  datatype: date
  max count: 1
property:
  path: eventDateDay
  name: event date day
  description: Event Day - The day on which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateWeek
  name: event date week
  description: Event Week - The Sunday of the week during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateMonth
  name: event date month
  description: Event Month - The month during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateQuarter
  name: event date quarter
  description: Event Quarter - The first month of the quarter during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateYear
  name: event date year
  description: Event Year - The year during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: adCopy
  name: ad copy
  description: Ad Copy - The full text (copy) of the ad.
  datatype: string
  max count: 1
property:
  path: adId
  name: ad id
  description: Ad ID - The unique ID of the ad associated with the creative asset. Example value: 220227808044480670
  datatype: string
  max count: 1
property:
  path: adImageUrl
  name: ad image url
  description: Ad Image URL - The URL of the ad image. Example value: https://www.example.com/ad-image.jpg
  datatype: anyURI
  max count: 1
property:
  path: adTitle
  name: ad title
  description: Ad Title - The external, published title that viewers see when the ad is served. Example values: UP TO 50% OFF , The Hype Is Real , Trusted by 4 Million+ Women Worldwide
  datatype: string
  max count: 1
property:
  path: adType
  name: ad type
  description: Ad Type - The format of the ad. Example values: video , image , carousel , link , VIDEO , GRAPHIC Currently available for Meta and Axon.
  datatype: string
  max count: 1
property:
  path: assetId
  name: asset id
  description: Asset ID - The unique ID of the asset used in the ad.
  datatype: string
  max count: 1
property:
  path: assetType
  name: asset type
  description: Asset Type - The type of asset used in the ad. Must be set to exactly one of: image , video , copy
  datatype: string
  max count: 1
property:
  path: attributionWindow
  name: attribution window
  description: Attribution Window - The time frame for attributing conversions to the ad. By default lifetime . Example values: 1_day , 7_days , 14_days , 28_days , lifetime
  datatype: string
  max count: 1
property:
  path: channel
  name: channel
  description: Channel - The platform through which the ad was delivered. Example values: facebook-ads , google-ads , tiktok-ads
  datatype: string
  max count: 1
property:
  path: creativeCtaType
  name: creative cta type
  description: Creative CTA Type - The type of call-to-action (CTA) used in the ad. Example values: Shop Now , Learn More , Sign Up
  datatype: string
  max count: 1
property:
  path: creativeDistributionFormat
  name: creative distribution format
  description: Creative Distribution Format - The ad creative distribution format. Example values: Standard Ad , Dynamic Creative Ad , Unknown
  datatype: string
  max count: 1
property:
  path: creativeFormat
  name: creative format
  description: Creative Format - The format of the ad creative. Example values: SHARE , VIDEO
  datatype: string
  max count: 1
property:
  path: creativeId
  name: creative id
  description: Creative ID - The unique identifier assigned to the creative asset by the ad platform. Example value: 1326015151986179
  datatype: string
  max count: 1
property:
  path: attributionModel
  name: attribution model
  description: Attribution Model - The attribution model used. By default Triple Attribution . Possible values: Total Impact , Triple Attribution , Triple Attribution + Views , Clicks & Views , Linear All , Linear Paid , First Click , Last Click
  datatype: string
  max count: 1
property:
  path: shopId
  name: shop id
  description: Shop ID - The unique ID of the shop (often corresponds to the shop domain). Can be used to group or filter data by shop in multi-store reports. Example values: example-US.myshopify.com , example-EU.myshopify.com
  datatype: string
  max count: 1
property:
  path: shopName
  name: shop name
  description: Shop Name - The name of the shop. Can be used to group or filter data by shop in multi-store reports. Example values: example-US , example-EU
  datatype: string
  max count: 1
property:
  path: videoDuration
  name: video duration
  description: Video Duration - The length of the video ad.
  datatype: string
  max count: 1
property:
  path: videoUrl
  name: video url
  description: Video URL - The URL of the ad video. Example value: https://www.youtube.com/embed/example
  datatype: anyURI
  max count: 1
property:
  path: videoUrlIframe
  name: video url iframe
  description: Video URL Iframe - The iframe embed code for displaying the video ad within a web page or app. Example value: https://www.facebook.com/plugins/ video.phpwidth=1080&href=https:// www.facebook.com/123456789/videos/987654321
  datatype: string
  max count: 1
property:
  path: channelReportedConversionValue
  name: channel reported conversion value
  description: Channel-Reported Conversion Value - Revenue generated from channel-reported conversions (purchases).
  datatype: double
  max count: 1
property:
  path: channelReportedConversions
  name: channel reported conversions
  description: Channel-Reported Conversions (Purchases) - Number of channel-reported conversions (purchases).
  datatype: double
  max count: 1
property:
  path: clicks
  name: clicks
  description: Clicks - Number of channel-reported clicks.
  datatype: double
  max count: 1
property:
  path: cogs
  name: cogs
  description: Pixel Cost of Goods - The cost of goods for Pixel-reported purchases within the selected time frame (before refunds). Imported from the main sales platform, or edit these in Cost Settings > Cost of Goods. Note that COGS for Pixel data is set at attribution time and does not get updated subsequently, so may vary from COGS data in the Orders table.
  datatype: double
  max count: 1
property:
  path: impressions
  name: impressions
  description: Impressions - Number of channel-reported impressions.
  datatype: double
  max count: 1
property:
  path: newCustomerCogs
  name: new customer cogs
  description: Pixel New Customer Cost of Goods - The cost of goods for Pixel-reported purchases by new customers within the selected time frame (before refunds). Imported from the main sales platform, or edit these in Cost Settings > Cost of Goods. Note that COGS for Pixel data is set at attribution time and does not get updated subsequently, so may vary from COGS data in the Orders table. Learn how Triple Whale classifies new/returning customers .
  datatype: double
  max count: 1
property:
  path: newCustomerOrderRevenue
  name: new customer order revenue
  description: Pixel New Customer Conversion Value - Pixel-reported conversion value (order revenue) derived from New Customers. Learn how Triple Whale classifies new/returning customers .
  datatype: double
  max count: 1
property:
  path: newCustomerOrders
  name: new customer orders
  description: Pixel New Customer Purchases - Number of Pixel-reported orders placed by New Customers. Learn how Triple Whale classifies new/returning customers .
  datatype: double
  max count: 1

CsEventShape
type: NodeShape
target class: CsEvent
property:
  path: eventDate
  name: event date
  description: Event Date - The date the CS 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).
  datatype: date
  max count: 1
property:
  path: eventDateDay
  name: event date day
  description: Event Day - The day the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateWeek
  name: event date week
  description: Event Week - The Sunday of the week during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateMonth
  name: event date month
  description: Event Month - The month during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateQuarter
  name: event date quarter
  description: Event Quarter - The first month of the quarter during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateYear
  name: event date year
  description: Event Year - The year during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: shopId
  name: shop id
  description: Shop ID - The unique ID of the shop (often corresponds to the shop domain). Can be used to group or filter data by shop in multi-store reports. Example values: example-US.myshopify.com , example-EU.myshopify.com
  datatype: string
  max count: 1
property:
  path: shopName
  name: shop name
  description: Shop Name - The name of the shop. Can be used to group or filter data by shop in multi-store reports. Example values: example-US , example-EU
  datatype: string
  max count: 1
property:
  path: platform
  name: platform
  description: Platform - The customer support platform through which the event was generated. Example value: gorgias
  datatype: string
  max count: 1
property:
  path: createdAt
  name: created at
  description: Event Created Date - The time the event was created, in UTC. Formatted according to the ISO 8601 international standard . Example value: 2026-02-28 22:25:32
  datatype: dateTime
  max count: 1
property:
  path: eventId
  name: event id
  description: Event ID - The unique identifier for the event, assigned by the CS provider. Example value: 15715626681
  datatype: string
  max count: 1
property:
  path: eventType
  name: event type
  description: Event Type - The type of CS event. Example values: ticket-created , ticket-closed , ticket-reopened , ticket-message-created , ticket-updated , ticket-assigned , ticket-unassigned
  datatype: string
  max count: 1
property:
  path: objectId
  name: object id
  description: Object ID - The ID of the object this event relates to (e.g., a ticket or message). Example value: 380365041
  datatype: string
  max count: 1
property:
  path: objectType
  name: object type
  description: Object Type - The type of object this event relates to. Ticket for ticket lifecycle events (e.g., created, closed, reopened); TicketMessage for message events (e.g., a new message on a ticket). Example values: Ticket , TicketMessage
  datatype: string
  max count: 1
property:
  path: userId
  name: user id
  description: User ID - The ID of the user (agent) who triggered this event. NULL when the event was triggered automatically (e.g., by an automation rule). Example value: 416121112
  datatype: string
  max count: 1

CsMessageShape
type: NodeShape
target class: CsMessage
property:
  path: eventDate
  name: event date
  description: Event Date - The date the CS message was received. Based on the shop time zone at the moment of the event (or the user time zone, if no sales platform is connected).
  datatype: date
  max count: 1
property:
  path: eventDateDay
  name: event date day
  description: Event Day - The day the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateWeek
  name: event date week
  description: Event Week - The Sunday of the week during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateMonth
  name: event date month
  description: Event Month - The month during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateQuarter
  name: event date quarter
  description: Event Quarter - The first month of the quarter during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateYear
  name: event date year
  description: Event Year - The year during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: body
  name: body
  description: Message Body - The content of the message. Example value: Thank you for my shipment! Super happy with your product!
  datatype: string
  max count: 1
property:
  path: channel
  name: channel
  description: Channel - The channel through which the message was delivered. Example values: facebook-comment , instagram-mention , email , chat
  datatype: string
  max count: 1
property:
  path: createdAt
  name: created at
  description: Message Created Date - The time the message was created. Formatted according to the ISO 8601 international standard . Example value: 2019-04-15 08:26:00
  datatype: dateTime
  max count: 1
property:
  path: deletedAt
  name: deleted at
  description: Message Deleted Date - The time the message was deleted. Formatted according to the ISO 8601 international standard . Example value: 2019-04-15 08:26:00
  datatype: dateTime
  max count: 1
property:
  path: isFromAgent
  name: is from agent
  description: Is From Agent - True if the message was sent by a customer support agent. Possible values: true , false
  datatype: boolean
  max count: 1
property:
  path: isPublic
  name: is public
  description: Is Public - True if the message is visible to customers (not just the support team). Possible values: true , false
  datatype: boolean
  max count: 1
property:
  path: messageId
  name: message id
  description: Message ID - The unique message ID. Example value: 435397561
  datatype: string
  max count: 1
property:
  path: orders
  name: orders
  description: Attributed Orders - A list of order IDs associated with the message. Returned as an array of strings. Example value: ["3797121360046", "3797258330286"]
  datatype: string
property:
  path: productsNames
  name: products names
  description: Attributed Product Names - The names of products mentioned in the message. Returned as an array of strings. Example value: ["Green Soft Socks 3-Pack", "Paring Knife Travel Case", "Gift Subscription"]
  datatype: string
property:
  path: receiverEmail
  name: receiver email
  description: Receiver Email - The email address of the recipient of the message. Example value: [email protected]
  datatype: string
  max count: 1
property:
  path: receiverId
  name: receiver id
  description: Receiver ID - The unique identifier assigned to the message recipient. Example value: 123456789
  datatype: string
  max count: 1
property:
  path: receiverName
  name: receiver name
  description: Receiver Name - The full name of the recipient of the message. Example value: Jane Doe
  datatype: string
  max count: 1
property:
  path: senderEmail
  name: sender email
  description: Sender Email - The email address of the sender of the message. Example value: [email protected]
  datatype: string
  max count: 1
property:
  path: senderId
  name: sender id
  description: Sender ID - The unique identifier assigned to the message sender. Example value: 987654321
  datatype: string
  max count: 1
property:
  path: senderName
  name: sender name
  description: Sender Name - The full name of the sender of the message. Example value: John Smith
  datatype: string
  max count: 1
property:
  path: sentAt
  name: sent at
  description: Message Sent Date - The time the message was sent. Formatted according to the ISO 8601 international standard . Example value: 2019-09-20 04:03:22
  datatype: dateTime
  max count: 1
property:
  path: skus
  name: skus
  description: Attributed SKUs - The SKU identifiers of products mentioned in the message. Returned as an array of strings. Example value: ["GP-BACK-02", "A02630", "POP200NAVY"]
  datatype: string
property:
  path: subject
  name: subject
  description: Message Subject - The subject line of the message. Example value: Wholesale Account Inquiry
  datatype: string
  max count: 1
property:
  path: ticketId
  name: ticket id
  description: Ticket ID - The unique identifier for the customer support ticket associated with the message. Example value: 68845382
  datatype: string
  max count: 1
property:
  path: via
  name: via
  description: Message Sent Via - The communication platform or method used to send the message. Example value: rule , helpdesk , email
  datatype: string
  max count: 1

CsTicketShape
type: NodeShape
target class: CsTicket
property:
  path: eventDate
  name: event date
  description: Event Date - The date the CS ticket event occurred (e.g. the creation date for ticket-created events, the closed date for ticket-closed events). Based on the shop time zone at the moment of the event (or the user time zone, if no sales platform is connected).
  datatype: date
  max count: 1
property:
  path: eventDateDay
  name: event date day
  description: Event Day - The day the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateWeek
  name: event date week
  description: Event Week - The Sunday of the week during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateMonth
  name: event date month
  description: Event Month - The month during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateQuarter
  name: event date quarter
  description: Event Quarter - The first month of the quarter during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateYear
  name: event date year
  description: Event Year - The year during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: assigneeUserId
  name: assignee user id
  description: Assigned Agent ID - The unique identifier of the assigned support agent. Example value: 161343771
  datatype: string
  max count: 1
property:
  path: assigneeUserName
  name: assignee user name
  description: Assigned Agent Name - The full name of the assigned support agent. Example value: Jane Doe
  datatype: string
  max count: 1
property:
  path: channel
  name: channel
  description: Channel - The channel through which the ticket was created. Example values: facebook-comment , instagram-mention , email , chat
  datatype: string
  max count: 1
property:
  path: closedAt
  name: closed at
  description: Ticket Closed Date - The time the ticket was closed. Formatted according to the ISO 8601 international standard . Example value: 2019-04-15 08:26:00
  datatype: dateTime
  max count: 1
property:
  path: createdAt
  name: created at
  description: Ticket Created Date - The time the ticket was created. Formatted according to the ISO 8601 international standard . Example value: 2019-04-15 08:26:00
  datatype: dateTime
  max count: 1
property:
  path: customerEmail
  name: customer email
  description: Customer Email - The email address of the customer. Example value: [email protected]
  datatype: string
  max count: 1
property:
  path: customerId
  name: customer id
  description: Customer ID - The unique identifier assigned to the customer. Example value: 123456789
  datatype: string
  max count: 1
property:
  path: eventType
  name: event type
  description: Event Type - The type of event related to the ticket. Example values: ticket-closed , ticket-reopened
  datatype: string
  max count: 1
property:
  path: fromAgent
  name: from agent
  description: From Agent - True if the event was initiated by a support agent. Possible values: true , false
  datatype: boolean
  max count: 1
property:
  path: language
  name: language
  description: Language - The language used in the ticket. Example values: en , it , ru
  datatype: string
  max count: 1
property:
  path: priority
  name: priority
  description: Ticket Priority - The priority level of the ticket. Example values: normal , high
  datatype: string
  max count: 1
property:
  path: status
  name: status
  description: Ticket Status - The current status of the ticket. Example values: open , closed
  datatype: string
  max count: 1
property:
  path: subject
  name: subject
  description: Subject - The subject line of the first message in the ticket. Example values: 4 native ways to sell on TikTok Shop , Re: Thanks For Reaching Out To Us!
  datatype: string
  max count: 1
property:
  path: surveyComment
  name: survey comment
  description: Survey Comment - The customer's feedback from the post-resolution survey. Example value: Excellent and quick customer service!
  datatype: string
  max count: 1
property:
  path: surveyScore
  name: survey score
  description: Survey Score - The rating score given by the customer in a post-resolution survey. Example values: 1 , 3 , 5
  datatype: string
  max count: 1
property:
  path: surveyScoredAt
  name: survey scored at
  description: Survey Scored Date - The time the survey was scored. Formatted according to the ISO 8601 international standard . Example value: 2019-04-15 08:26:00
  datatype: dateTime
  max count: 1
property:
  path: surveySentAt
  name: survey sent at
  description: Survey Sent Date - The time the survey was sent to the customer. Formatted according to the ISO 8601 international standard . Example value: 2019-04-15 08:26:00
  datatype: dateTime
  max count: 1
property:
  path: tags
  name: tags
  description: Tags - Tags associated with the ticket, used for categorization. Example value: [{"id":"174296","name":"GMAIL-PROMOTIONS"},{"id":"585614","name":"auto-close"},{"id":"585616","name":"non-support-related"}]
  node: ContainerShape
  class: Container
  node kind: BlankNodeOrIRI
property:
  path: updatedAt
  name: updated at
  description: Ticket Updated Date - The time the ticket was last updated. Formatted according to the ISO 8601 international standard . Example value: 2019-04-15 08:26:00
  datatype: dateTime
  max count: 1

CustomCategoryShape
type: NodeShape
target class: CustomCategory
property:
  path: aiRule
  name: ai rule
  description: AI Rule - The AI rule used to classify campaigns into subcategories. Example values: customers aged 18-24 , campaigns targeting South America , branded search ads , influencer collaborations
  datatype: string
  max count: 1
property:
  path: categoryId
  name: category id
  description: Category ID - The ID of the category (grouping dimension, e.g., Tactic, Geography, Product). Example value: 09f58489-713a-4866-bce4-1040c9a1ee71
  datatype: string
  max count: 1
property:
  path: categoryName
  name: category name
  description: Category Name - The name of the category (grouping dimension). Example values: Geography , Tactic , Funnel
  datatype: string
  max count: 1
property:
  path: createdAt
  name: created at
  description: Subcategory Created Date - The date the subcategory was created. Example value: 2025-09-08
  datatype: date
  max count: 1
property:
  path: excludeProviders
  name: exclude providers
  description: Exclude Providers - The providers excluded from the subcategory. Example values: facebook-ads , google-ads , tiktok-ads
  datatype: string
property:
  path: includeProviders
  name: include providers
  description: Include Providers - The providers included in the subcategory. Example values: facebook-ads , google-ads , tiktok-ads
  datatype: string
property:
  path: subCategoryId
  name: sub category id
  description: Subcategory ID - The ID of the subcategory. Example value: 46c71065-5bbb-4ab6-81ee-39078b23cca0
  datatype: string
  max count: 1
property:
  path: subCategoryName
  name: sub category name
  description: Subcategory Name - The name of the subcategory (specific group within a category). Example values: 18-24 , Peru , Meta Prospecting , Google PMAX
  datatype: string
  max count: 1

CustomCategoryMappingShape
type: NodeShape
target class: CustomCategoryMapping
property:
  path: campaignId
  name: campaign id
  description: Campaign ID - The ID of the campaign. Example value: 1234567890
  datatype: string
  max count: 1
property:
  path: campaignName
  name: campaign name
  description: Campaign Name - The name of the campaign. Example values: Catalog Retargeting , US Generic Search , Breakfast of Champions Campaign
  datatype: string
  max count: 1
property:
  path: categoryId
  name: category id
  description: Category ID - The ID of the category (grouping dimension, e.g., Tactic, Geography, Product). Example value: 09f58489-713a-4866-bce4-1040c9a1ee71
  datatype: string
  max count: 1
property:
  path: createdAt
  name: created at
  description: Mapping Created Date - The date the campaign was mapped to the subcategory. Example value: 2025-09-08
  datatype: date
  max count: 1
property:
  path: providerId
  name: provider id
  description: Channel - The channel or platform where the campaign runs. Example values: facebook-ads , google-ads , tiktok-ads
  datatype: string
  max count: 1
property:
  path: subCategoryId
  name: sub category id
  description: Subcategory ID - The ID of the subcategory assigned to the campaign. Example value: 46c71065-5bbb-4ab6-81ee-39078b23cca0
  datatype: string
  max count: 1

CustomSpendShape
type: NodeShape
target class: CustomSpend
property:
  path: eventHour
  name: event hour
  description: Event Hour - The hour of the day the custom expense was incurred, 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: 07 , 16 , 21
  datatype: string
  max count: 1
property:
  path: eventDate
  name: event date
  description: Event Date - The date the custom expense was incurred. Based on the shop time zone at the moment of the event (or the user time zone, if no sales platform is connected).
  datatype: date
  max count: 1
property:
  path: eventDateDay
  name: event date day
  description: Event Day - The day the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateWeek
  name: event date week
  description: Event Week - The Sunday of the week during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateMonth
  name: event date month
  description: Event Month - The month during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateQuarter
  name: event date quarter
  description: Event Quarter - The first month of the quarter during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateYear
  name: event date year
  description: Event Year - The year during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: campaignId
  name: campaign id
  description: Campaign ID - The name or ID of the campaign the custom expense is associated with. Note: This may match an existing campaign ID in an integrated ad platform. Edit in Cost Settings > Custom Expenses. Example values: 23852438666180053 , 531011533 , 20620285829
  datatype: string
  max count: 1
property:
  path: category
  name: category
  description: Custom Expense Category - The category of the custom expense. Edit in Cost Settings > Custom Expenses. Example values: Ad Spend , Cashback Booked , Returns Estimate
  datatype: string
  max count: 1
property:
  path: channel
  name: channel
  description: Channel - The channel or platform related to the custom expense. Note: This may match an existing integrated ad channel. Edit in Cost Settings > Custom Expenses. Example values: facebook , social , microsoft
  datatype: string
  max count: 1
property:
  path: isAdSpend
  name: is ad spend
  description: Is Ad Spend - True if the custom expense is considered an advertising expenditure. Edit in Cost Settings Custom Expenses.
  datatype: boolean
  max count: 1
property:
  path: isRecurring
  name: is recurring
  description: Is Recurring - True if the custom expense is recurring. Edit in Cost Settings > Custom Expenses. Note: Only relevant for fixed expenses. NULL for variable expenses.
  datatype: boolean
  max count: 1
property:
  path: metric
  name: metric
  description: Variable Expense Base Metric - The metric upon which the variable custom expense will be based. Edit in Cost Settings > Custom Expenses. Note: Only relevant for variable expenses. NULL for fixed expenses. Example values: Blended Ads , COGS , Orders
  datatype: string
  max count: 1
property:
  path: rate
  name: rate
  description: Variable Expense Rate - The rate applied to the base metric to calculate the custom expense. Edit in Cost Settings > Custom Expenses, in the percent field. Note: Only relevant for variable expenses. NULL for fixed expenses. Example value: 0.02
  datatype: string
  max count: 1
property:
  path: shopId
  name: shop id
  description: Shop ID - The unique ID of the shop (often corresponds to the shop domain). Can be used to group or filter data by shop in multi-store reports. Example values: example-US.myshopify.com , example-EU.myshopify.com
  datatype: string
  max count: 1
property:
  path: shopName
  name: shop name
  description: Shop Name - The name of the shop. Can be used to group or filter data by shop in multi-store reports. Example values: example-US , example-EU
  datatype: string
  max count: 1
property:
  path: title
  name: title
  description: Custom Expense Title - The title of the custom expense. Edit in Cost Settings > Custom Expenses. Example values: Podcast , Influencer
  datatype: string
  max count: 1
property:
  path: amount
  name: amount
  description: Custom Expense Amount - The amount of the expense. By default shown in the shop's currency. Note: For fixed expenses, the amount is set directly by the seller; for variable expenses, the amount is calculated based on the base metric and rate set by the seller, combined with shop prices from the sales, ad, or email/SMS platform (e.g. Shopify, Facebook, Klaviyo). Edit in Cost Settings > Custom Expenses.
  datatype: double
  max count: 1
property:
  path: customAdSpend
  name: custom ad spend
  description: Custom Ad Spend - The total amount of custom expenses marked as ad spend.
  datatype: string
  max count: 1
property:
  path: customExclAdSpend
  name: custom excl ad spend
  description: Custom Expenses Excluding Ad Spend - The total amount of custom expenses, excluding those marked as ad spend.
  datatype: string
  max count: 1

CustomerJourneyShape
type: NodeShape
target class: CustomerJourney
property:
  path: eventDate
  name: event date
  description: Event Date - The date the customer journey 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).
  datatype: date
  max count: 1
property:
  path: eventDateDay
  name: event date day
  description: Event Day - The day on which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateWeek
  name: event date week
  description: Event Week - The Sunday of the week during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateMonth
  name: event date month
  description: Event Month - The month during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateQuarter
  name: event date quarter
  description: Event Quarter - The first month of the quarter during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateYear
  name: event date year
  description: Event Year - The year during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: adId
  name: ad id
  description: Ad ID - The ID of the ad associated with the customer journey event. Example value: 643742158069
  datatype: date
  max count: 1
property:
  path: adImageUrl
  name: ad image url
  description: Ad Image URL - The thumbnail image URL of the ad associated with the customer journey event. Example value: https://www.example.com/ad-image.jpg
  datatype: anyURI
  max count: 1
property:
  path: adName
  name: ad name
  description: Ad Name - The name of the ad associated with the customer journey event. Example values: Kids Ad 1 , Read Our Latest Blog 03/12/2023 , 8 best fall looks
  datatype: string
  max count: 1
property:
  path: adsetName
  name: adset name
  description: Ad Set Name - The name of the ad set associated with the customer journey event. Example values: Broad Audience , Bracelets , Wellness
  datatype: string
  max count: 1
property:
  path: attributionWindow
  name: attribution window
  description: Attribution Window - The time frame for attributing conversions to the ad. By default lifetime . Example values: 1_day , 7_days , 14_days , 28_days , lifetime
  datatype: string
  max count: 1
property:
  path: browser
  name: browser
  description: Web Browser - The web browser of the session where the customer journey event originated. Example values: Chrome , Firefox , Safari
  datatype: string
  max count: 1
property:
  path: campaignId
  name: campaign id
  description: Campaign ID - The unique ID of the campaign associated with the customer journey event. Example value: 1234567890
  datatype: string
  max count: 1
property:
  path: campaignName
  name: campaign name
  description: Campaign Name - The name of the campaign associated with the customer journey event. Example values: Catalog Retargeting , US Generic Search , Breakfast of Champions Campaign
  datatype: string
  max count: 1
property:
  path: checkoutEventType
  name: checkout event type
  description: Checkout Event Type - The event type recorded by Triple Pixel, corresponding to the step of the checkout funnel. Example values: payment , address , checkout , contact , shipping
  datatype: string
  max count: 1
property:
  path: country
  name: country
  description: Customer Country - The country associated with the customer journey event. For orders and subscriptions, this is the shipping address country. For page visits, add-to-carts, and conversions, this is the visitor's country based on geolocation. See list of countries . Example values: United States , Canada , United Kingdom
  datatype: string
  max count: 1
property:
  path: customerId
  name: customer id
  description: Customer ID - The unique customer ID associated with the customer journey event. Assigned by the main sales platform. Example value: 5209503793328
  datatype: string
  max count: 1
property:
  path: device
  name: device
  description: Device - The type of device used by the customer during their website session. Example values: mobile , desktop , tablet , wearable
  datatype: string
  max count: 1
property:
  path: discountCode
  name: discount code
  description: Discount Code - The discount code for the order associated with the customer journey event. Assigned by the seller in the main sales platform. Example values: WELCOME10 , Replacement for defective item , 807QRWMNK2
  datatype: string
  max count: 1
property:
  path: email
  name: email
  description: Customer Email - The customer’s email address. Example value: [email protected]
  datatype: string
  max count: 1
property:
  path: eventName
  name: event name
  description: Event Name - The name assigned to the custom conversion event. Example values: form_fill , start_quiz , quiz_complete , order_sample , answer_question , request_consultation
  datatype: string
  max count: 1
property:
  path: eventTime
  name: event time
  description: Event Timestamp - The exact timestamp when the customer journey event occurred. Formatted according to the ISO 8601 international standard . Example value: 2024-03-16T00:13:03
  datatype: dateTime
  max count: 1
property:
  path: fulfillmentStatus
  name: fulfillment status
  description: Fulfillment Status - The order fulfillment status for the order associated with the customer journey event. Example values: fulfilled , partial , restocked
  datatype: string
  max count: 1
property:
  path: isNewCustomer
  name: is new customer
  description: Is New Customer - True if the order associated with the customer journey event is the customer's first. Possible values: true , false Learn how Triple Whale classifies new/returning customers .
  datatype: boolean
  max count: 1
property:
  path: itemsPurchased
  name: items purchased
  description: Items Purchased - Information about items purchased by the customer in the order associated with the customer journey event.
  node: ItemsPurchasedShape
  class: ItemsPurchased
  node kind: BlankNodeOrIRI
property:
  path: leadClickTs
  name: lead click ts
  description: Lead Click Timestamp - The time of the ad click that led to the customer journey event. Formatted according to the ISO 8601 international standard . Example value: 2024-10-26 20:03:48
  datatype: dateTime
  max count: 1
property:
  path: attributionModel
  name: attribution model
  description: Attribution Model - The attribution model used. By default Triple Attribution . Possible values: Total Impact , Triple Attribution , Triple Attribution + Views , Clicks & Views , Linear All , Linear Paid , First Click , Last Click
  datatype: string
  max count: 1
property:
  path: orderId
  name: order id
  description: Order ID - The unique order ID associated with the customer journey event. Assigned by the main sales platform. Example value: 4930225799243
  datatype: string
  max count: 1
property:
  path: orderName
  name: order name
  description: Order Name - The name of the order associated with the customer journey event. Assigned by the main sales platform. Example values: #2188464 , Ex-2163819-9
  datatype: string
  max count: 1
property:
  path: pageType
  name: page type
  description: Page Type - The type of page the customer interacted with during the customer journey event. Example values: product , collection , cart
  datatype: string
  max count: 1
property:
  path: pageViewEventId
  name: page view event id
  description: Page View Event ID - A unique ID that links to the parent page view associated with the customer journey event. This allows tracking of custom events as child actions within the context of the page they occurred on. Example value: 0m3uyt4g11owByF1cQ
  datatype: string
  max count: 1
property:
  path: phone
  name: phone
  description: Customer Phone - The customer's phone number. Example value: 18005550199
  datatype: string
  max count: 1
property:
  path: productId
  name: product id
  description: Product ID - The unique ID of the product in the order associated with the customer journey event. Example value: 7760518986312
  datatype: string
  max count: 1

ItemsPurchasedShape
type: NodeShape
target class: ItemsPurchased
property:
  path: price
  name: price
  description: Price - The price of the purchased item in the order associated with the customer journey event. Example values: 40.59 , 10.99 , 24.50
  datatype: string
  max count: 1
property:
  path: productName
  name: product name
  description: Product Name - The name (or title) of the product purchased in the order associated with the customer journey event. Example values: $20 USD Gift Card , Unisex Hoodie
  datatype: string
  max count: 1
property:
  path: variantName
  name: variant name
  description: Variant Name - The name (or title) of the product variant purchased in the order associated with the customer journey event. Example values: Forest Green , M , iPhone 14 Pro
  datatype: string
  max count: 1
property:
  path: sku
  name: sku
  description: Stock Keeping Unit (SKU) - The stock keeping unit (SKU) of the product or variant purchased in the order associated with the customer journey event. Example values: SIL-RING-4445 , NVDPROTECTION03
  datatype: string
  max count: 1
property:
  path: quantity
  name: quantity
  description: Quantity - The quantity of items purchased in the order associated with the customer journey event. Example values: 1 , 5 , 200
  datatype: string
  max count: 1

QuestionShape
type: NodeShape
target class: Question
property:
  path: question
  name: question
  description: Survey Question - The question asked during the customer journey event. Example value: Which of the following led you to purchase today?
  datatype: string
  max count: 1
property:
  path: answer
  name: answer
  description: Survey Answer - The answer provided during the customer journey event. Example values: Exchange for a prior purchase , Youtube , QVC , Just decided to try them
  datatype: string
  max count: 1

CustomerSegmentationAnalyticsShape
type: NodeShape
target class: CustomerSegmentationAnalytics
property:
  path: instanceEventDateEnd
  name: instance event date end
  description: Instance Event Date End - End of the segment instance window. Filters which segment instances (runs/snapshots) to include when building the customer list. Use with instance_event_date_start . Example value: 2025-08-31
  datatype: string
  max count: 1
property:
  path: instanceEventDateStart
  name: instance event date start
  description: Instance Event Date Start - Start of the segment instance window. Filters which segment instances (runs/snapshots) to include when building the customer list. Use with instance_event_date_end . Example value: 2025-08-01
  datatype: string
  max count: 1
property:
  path: pinnedEventDate
  name: pinned event date
  description: Pinned Event Date - The anchor date used to compare before/after segment instance windows. Example value: 2025-08-25
  datatype: string
  max count: 1
property:
  path: secondaryEventDateEnd
  name: secondary event date end
  description: Secondary Event Date End - End of the joined activity window. Filters joined activity pulled from tables other than the Customer Segmentation table (e.g. Orders, Pixel Orders). Use with secondary_event_date_start . Example value: 2025-09-01
  datatype: string
  max count: 1
property:
  path: secondaryEventDateStart
  name: secondary event date start
  description: Secondary Event Date Start - Start of the joined activity window. Filters joined activity pulled from tables other than the Customer Segmentation table (e.g. Orders, Pixel Orders). Use with secondary_event_date_end . Example value: 2025-08-01
  datatype: string
  max count: 1
property:
  path: segmentId
  name: segment id
  description: Segment ID - The unique identifier for a segment. Example value: 64b8f144256b30501b2ea1e0
  datatype: string
  max count: 1
property:
  path: customerIdentity
  name: customer identity
  description: Customer Identity - The identity of the customer in the segment (can be email or customer_id ). Example values: 67b076c419252e53fbc0841g , [email protected]
  datatype: string
  max count: 1
property:
  path: customerIdentityType
  name: customer identity type
  description: Customer Identity Type - The type of identity the segment uses for this customer. Example values: email , customer_id
  datatype: string
  max count: 1
property:
  path: instanceEventDate
  name: instance event date
  description: Instance Event Date - The event date used for data from tables other than the Customer Segmentation table (e.g., Orders table, Pixel Orders table). Used in membership/instance joins. Formatted according to the ISO 8601 international standard. Example value: 2025-01-19 22:21:04
  datatype: date
  max count: 1
property:
  path: segmentName
  name: segment name
  description: Segment Name - The human-readable name of the segment. Example values: Fourth of July Sale , At least 3 orders , Jan Non Recent Active
  datatype: string
  max count: 1
property:
  path: shopId
  name: shop id
  description: Shop ID - The unique ID of the shop (often corresponds to the shop domain). Can be used to group or filter data by shop in multi-store reports. Example values: example-US.myshopify.com , example-EU.myshopify.com
  datatype: string
  max count: 1
property:
  path: shopName
  name: shop name
  description: Shop Name - The name of the shop. Can be used to group or filter data by shop in multi-store reports. Example values: example-US , example-EU
  datatype: string
  max count: 1
property:
  path: 30DayListAttrition
  name: 30day list attrition
  description: 30-Day List Attrition - Number of customers who were in the segment 30 days before the pinned_event_date , and left the segment on the pinned_event_date .
  datatype: string
  max count: 1
property:
  path: 30DayListGrowth
  name: 30day list growth
  description: 30-Day List Growth - Number of customers who were not in the segment 30 days before the pinned_event_date , and joined the segment on the pinned_event_date .
  datatype: string
  max count: 1
property:
  path: 30DayListPersistence
  name: 30day list persistence
  description: 30-Day List Persistence - Count of customers who remained in the segment for at least 30 days (were active both 30 days before the pinned_event_date and on the pinned_event_date ).
  datatype: string
  max count: 1
property:
  path: 30DayLoyalCustomers
  name: 30day loyal customers
  description: 30-Day Loyal Customers - Number of highly engaged customers who were active on both the start and end dates of a 31-day period and maintained 95% activity frequency (active on at least 29 out of 31 days)
  datatype: string
  max count: 1
property:
  path: 30DayRecentJoiners
  name: 30day recent joiners
  description: 30-Day Recent Joiners - Number of customers who were not in the segment 30 days before the pinned_event_date but joined the segment within the last 29 days leading up to the pinned_event_date .
  datatype: string
  max count: 1
property:
  path: adIdsLast7Days
  name: ad ids last7days
  description: Ad IDs (Last 7 Days) - Ad IDs for customers from the selected segment instances in the 7 days prior to the pinned_event_date .
  datatype: string
  max count: 1
property:
  path: adIdsNext7Days
  name: ad ids next7days
  description: Ad IDs (Next 7 Days) - Ad IDs for customers from the selected segment instances in the 7 days after the pinned_event_date .
  datatype: string
  max count: 1
property:
  path: aovLast7Days
  name: aov last7days
  description: AOV (Last 7 Days) - Average order value for customers from the selected segment instances in the 7 days prior to the pinned_event_date .
  datatype: string
  max count: 1
property:
  path: aovNext7Days
  name: aov next7days
  description: AOV (Next 7 Days) - Average order value for customers from the selected segment instances in the 7 days after the pinned_event_date .
  datatype: string
  max count: 1
property:
  path: campaignIdsLast7Days
  name: campaign ids last7days
  description: Campaign IDs (Last 7 Days) - Campaign IDs for customers from the selected segment instances in the 7 days prior to the pinned_event_date .
  datatype: string
  max count: 1
property:
  path: campaignIdsNext7Days
  name: campaign ids next7days
  description: Campaign IDs (Next 7 Days) - Campaign IDs for customers from the selected segment instances in the 7 days after the pinned_event_date .
  datatype: string
  max count: 1
property:
  path: channelsLast7Days
  name: channels last7days
  description: Channels (Last 7 Days) - Pixel-attributed channels for customers from the selected segment instances in the 7 days prior to the pinned_event_date .
  datatype: string
  max count: 1
property:
  path: channelsNext7Days
  name: channels next7days
  description: Channels (Next 7 Days) - Pixel-attributed channels for customers from the selected segment instances in the 7 days after the pinned_event_date .
  datatype: string
  max count: 1
property:
  path: citiesLast7Days
  name: cities last7days
  description: Cities (Last 7 Days) - Shipping cities for customers from the selected segment instances in the 7 days prior to the pinned_event_date .
  datatype: string
  max count: 1
property:
  path: citiesNext7Days
  name: cities next7days
  description: Cities (Next 7 Days) - Shipping cities for customers from the selected segment instances in the 7 days after the pinned_event_date .
  datatype: string
  max count: 1
property:
  path: countriesLast7Days
  name: countries last7days
  description: Countries (Last 7 Days) - Shipping countries for customers from the selected segment instances in the 7 days prior to the pinned_event_date .
  datatype: string
  max count: 1
property:
  path: countriesNext7Days
  name: countries next7days
  description: Countries (Next 7 Days) - Shipping countries for customers from the selected segment instances in the 7 days after the pinned_event_date .
  datatype: string
  max count: 1
property:
  path: orderTagsLast7Days
  name: order tags last7days
  description: Order Tags (Last 7 Days) - Order tags for customers from the selected segment instances in the 7 days prior to the pinned_event_date .
  datatype: string
  max count: 1
property:
  path: orderTagsNext7Days
  name: order tags next7days
  description: Order Tags (Next 7 Days) - Order tags for customers from the selected segment instances in the 7 days after the pinned_event_date .
  datatype: string
  max count: 1
property:
  path: productIdsLast7Days
  name: product ids last7days
  description: Product IDs (Last 7 Days) - Product IDs purchased by customers from the selected segment instances in the 7 days prior to the pinned_event_date .
  datatype: string
  max count: 1
property:
  path: productIdsNext7Days
  name: product ids next7days
  description: Product IDs (Next 7 Days) - Product IDs purchased by customers from the selected segment instances in the 7 days after the pinned_event_date .
  datatype: string
  max count: 1

CustomerSegmentationShape
type: NodeShape
target class: CustomerSegmentation
property:
  path: customerIdentity
  name: customer identity
  description: Customer Identity - The identity of the customer in the segment. Can be either email or customer_id type. Example values: [email protected] , 5209503793328
  datatype: string
  max count: 1
property:
  path: instanceCreatedDate
  name: instance created date
  description: Instance Created Date - The timestamp when the segment instance (run/snapshot) was generated. Example value: 2025-08-25 11:08:39
  datatype: date
  max count: 1
property:
  path: schedule
  name: schedule
  description: Schedule - The recurring schedule for running the segment. Example values: once_a_day , once_every_other_day
  datatype: string
  max count: 1
property:
  path: segmentBy
  name: segment by
  description: Segment By - The audience type used to group customers in the segment. Example value: customer_id , email
  datatype: string
  max count: 1
property:
  path: segmentCreatedDate
  name: segment created date
  description: Segment Created Date - The date when the segment was originally created. Example value: 2023-07-20 08:33:08
  datatype: date
  max count: 1
property:
  path: segmentId
  name: segment id
  description: Segment ID - The unique identifier for a segment. Example value: 64b8f144256b30501b2ea1e0
  datatype: string
  max count: 1
property:
  path: segmentInstanceId
  name: segment instance id
  description: Segment Instance ID - The unique identifier for a specific segment instance (run/snapshot). Example value: 64b8f144256b30501b2ea1e0_2025_08_25
  datatype: string
  max count: 1
property:
  path: segmentName
  name: segment name
  description: Segment Name - The human-readable name of the segment, Example values: Fourth of July Sale , At least 3 orders , Jan Non Recent Active
  datatype: string
  max count: 1
property:
  path: shopId
  name: shop id
  description: Shop ID - The unique ID of the shop (often corresponds to the shop domain). Can be used to group or filter data by shop in multi-store reports. Example values: example-US.myshopify.com , example-EU.myshopify.com
  datatype: string
  max count: 1
property:
  path: shopName
  name: shop name
  description: Shop Name - The name of the shop. Can be used to group or filter data by shop in multi-store reports. Example values: example-US , example-EU
  datatype: string
  max count: 1
property:
  path: numOfCustomers
  name: num of customers
  description: Number of Customers - The total number of unique customers included in the segment instance.
  datatype: double
  max count: 1
property:
  path: numOfOrders
  name: num of orders
  description: Number of Orders - The total number of orders placed by customers in the segment during the relevant time window.
  datatype: double
  max count: 1
property:
  path: totalRevenue
  name: total revenue
  description: Total Revenue - The total revenue generated by customers in the segment during the relevant time window.
  datatype: double
  max count: 1

CustomerSupportAggMetricsShape
type: NodeShape
target class: CustomerSupportAggMetrics
property:
  path: eventDate
  name: event date
  description: Event Date - The date of the customer support event. Based on the shop time zone at the moment of the event (or the user time zone, if no sales platform is connected).
  datatype: date
  max count: 1
property:
  path: eventDateDay
  name: event date day
  description: Event Day - The day the customer support event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateWeek
  name: event date week
  description: Event Week - The Sunday of the week during which the customer support event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateMonth
  name: event date month
  description: Event Month - The month during which the customer support event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateQuarter
  name: event date quarter
  description: Event Quarter - The first month of the quarter during which the customer support event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateYear
  name: event date year
  description: Event Year - The year during which the customer support event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: medianFirstResponseTime
  name: median first response time
  description: Median First Response Time - The median time taken for the first response to a customer support ticket during the period selected.
  datatype: double
  max count: 1
property:
  path: medianResolutionTime
  name: median resolution time
  description: Median Resolution Time - The median time taken to resolve a customer support ticket during the period selected.
  datatype: double
  max count: 1
property:
  path: ticketsClosed
  name: tickets closed
  description: Tickets Closed - The total number of tickets closed during the period selected.
  datatype: double
  max count: 1
property:
  path: ticketsCreated
  name: tickets created
  description: Tickets Created - The total number of new tickets created during the period selected.
  datatype: double
  max count: 1
property:
  path: ticketsReplied
  name: tickets replied
  description: Tickets Replied - The total number of tickets with at least one reply during the period selected.
  datatype: double
  max count: 1

CustomerShape
type: NodeShape
target class: Customer
property:
  path: address1
  name: address1
  description: Address Line 1 - The first line of the customer's default address. Example value: 764 Example Dr.
  datatype: string
  max count: 1
property:
  path: address2
  name: address2
  description: Address Line 2 - The second line of the customer's default address. Example value: Apt. 603
  datatype: string
  max count: 1
property:
  path: city
  name: city
  description: City - The city of the customer's default address. Example value: San Francisco
  datatype: string
  max count: 1
property:
  path: coordinatesValidated
  name: coordinates validated
  description: Coordinates Validated - Indicates whether the customer coordinates were successfully validated. Possible values: true , false
  datatype: boolean
  max count: 1
property:
  path: country
  name: country
  description: Country - The country of the customer's default address. See list of countries . Example values: United States , Canada , United Kingdom
  datatype: string
  max count: 1
property:
  path: countryCode
  name: country code
  description: Country Code - The country code of the customer's default address. See list of countries . Example values: US , CA , GB
  datatype: string
  max count: 1
property:
  path: createdAt
  name: created at
  description: Customer Created Date - The time at which the customer record was created. Formatted according to the ISO 8601 international standard . Example value: 2019-05-22 21:01:29
  datatype: dateTime
  max count: 1
property:
  path: customerId
  name: customer id
  description: Customer ID - The unique identifier for the customer, assigned by the main sales platform. Example value: 5209503793328
  datatype: string
  max count: 1
property:
  path: customerIdKey
  name: customer id key
  description: Customer ID Key - Join key for connecting this table to other tables (e.g. Orders or Pixel Orders tables). Contains customer_id for Shopify shops and email_address for non-Shopify shops (e.g., Amazon, BigCommerce, WooCommerce). Example values: 5209503793328 , [email protected]
  datatype: string
  max count: 1
property:
  path: customerTags
  name: customer tags
  description: Customer Tags - Tags associated with the customer, set in the main sales platform. Example values: Active Subscriber , PayPal_user , Login with FB
  datatype: string
property:
  path: displayName
  name: display name
  description: Display Name - The display name of the customer. Example value: John Doe
  datatype: string
  max count: 1
property:
  path: emailAddress
  name: email address
  description: Email Address - The primary email address associated with the customer’s account. Example value: [email protected]
  datatype: string
  max count: 1
property:
  path: emailMarketingConsentCollectedFrom
  name: email marketing consent collected from
  description: Email Marketing Consent Collected From - The source from which the customer's email marketing consent was collected.
  datatype: string
  max count: 1
property:
  path: emailMarketingConsentOptInLevel
  name: email marketing consent opt in level
  description: Email Marketing Consent Opt-In Level - The level of consent provided by the customer for email marketing. Example values: SINGLE_OPT_IN , UNKNOWN
  datatype: string
  max count: 1
property:
  path: emailMarketingConsentStatus
  name: email marketing consent status
  description: Email Marketing Consent Status - The current status of the customer's email marketing consent. Example values: NEVER_SUBSCRIBED , NOT_SUBSCRIBED , UNSUBSCRIBED , SUBSCRIBED
  datatype: string
  max count: 1
property:
  path: emailMarketingConsentUpdatedAt
  name: email marketing consent updated at
  description: Email Marketing Consent Updated Date - The time at which the email marketing consent was updated. Formatted according to the ISO 8601 international standard . Example value: 2019-05-22 21:01:29
  datatype: dateTime
  max count: 1
property:
  path: firstName
  name: first name
  description: First Name - The customer's first name. Example value: John
  datatype: string
  max count: 1
property:
  path: lastName
  name: last name
  description: Last Name - The customer's last name. Example value: Doe
  datatype: string
  max count: 1
property:
  path: lastOrderId
  name: last order id
  description: Last Order ID - The ID of the most recent order from the customer, according to the main sales platform. Example value: 4930225799243
  datatype: string
  max count: 1
property:
  path: latitude
  name: latitude
  description: Latitude - The latitude associated with the customer's location. Example value: 34.1413713
  datatype: decimal
  max count: 1
property:
  path: locale
  name: locale
  description: Locale - The locale setting associated with the customer's account. Example values: en-US , en_GB , de
  datatype: string
  max count: 1
property:
  path: longitude
  name: longitude
  description: Longitude - The longitude associated with the customer's location. Example value: -118.8639169
  datatype: decimal
  max count: 1
property:
  path: metafields
  name: metafields
  description: Metafields - Custom key–value pairs attached to each customer record, used to store additional structured or unstructured data beyond standard fields.
  node: CustomerMetafieldShape
  class: CustomerMetafield
  node kind: BlankNodeOrIRI
property:
  path: note
  name: note
  description: Note - Note attached to the customer profile.
  datatype: string
  max count: 1
property:
  path: phone
  name: phone
  description: Phone - The customer's phone number. Example value: 18005550199
  datatype: string
  max count: 1
property:
  path: platform
  name: platform
  description: Platform - The platform associated with the customer record. Example values: shopify , klaviyo
  datatype: string
  max count: 1
property:
  path: productSubscriberStatus
  name: product subscriber status
  description: Product Subscriber Status - The customer's subscription status for products. Example values: ACTIVE , PAUSED , CANCELLED , NEVER_SUBSCRIBED
  datatype: string
  max count: 1
property:
  path: smsMarketingConsentCollectedFrom
  name: sms marketing consent collected from
  description: SMS Marketing Consent Collected From - The source from which the customer's SMS marketing consent was collected.
  datatype: string
  max count: 1
property:
  path: smsMarketingConsentOptInLevel
  name: sms marketing consent opt in level
  description: SMS Marketing Consent Opt-In Level - The level of consent provided by the customer for SMS marketing. Example values: SINGLE_OPT_IN , CONFIRMED_OPT_IN
  datatype: string
  max count: 1
property:
  path: smsMarketingConsentUpdatedAt
  name: sms marketing consent updated at
  description: SMS Marketing Consent Updated Date - The time at which the sms marketing consent was updated. Formatted according to the ISO 8601 international standard . Example value: 2019-05-22 21:01:29
  datatype: dateTime
  max count: 1
property:
  path: state
  name: state
  description: State - The state or province of the customer's default address. Example values: Oregon , British Colombia , Michigan
  datatype: string
  max count: 1
property:
  path: stateCode
  name: state code
  description: State Code - The state or province code of the customer's default address. Example values: OR , BC , MI
  datatype: string
  max count: 1
property:
  path: statisticPredictedSpendTier
  name: statistic predicted spend tier
  description: Predicted Spend Tier - A predicted tier for how much the customer is likely to spend. Example values: LOW , MEDIUM , HIGH
  datatype: string
  max count: 1

CustomerMetafieldShape
type: NodeShape
target class: CustomerMetafield
property:
  path: metafieldId
  name: metafield id
  description: Metafield ID - The unique identifier of the metafield record. Example values: 44187839136031
  datatype: string
  max count: 1
property:
  path: key
  name: key
  description: Metafield Key - The unique key of the metafield within its namespace, indicating what data it holds. Example values: promised_delivery_date , zone , agree_to_terms
  datatype: string
  max count: 1
property:
  path: value
  name: value
  description: Metafield Value - The raw stored value of the metafield. Format depends on the metafield type (e.g., text, date, boolean, JSON). Example values: 2025-11-10 , true , #241194 , 5a
  datatype: string
  max count: 1
property:
  path: metafieldNamespace
  name: metafield namespace
  description: Metafield Namespace - Logical grouping used to organize metafields by source or purpose. Example values: custom , klaviyo , checkoutblocks
  datatype: string
  max count: 1
property:
  path: metafieldType
  name: metafield type
  description: Metafield Type - The data type of the metafield value (e.g., text, date, boolean, JSON, reference). Example values: date , boolean , json , single_line_text_field , customer_reference
  datatype: string
  max count: 1
property:
  path: updatedAt
  name: updated at
  description: Metafield Updated Date - When the metafield was last updated, in shop time zone. Example value: 2025-10-21 07:08:01
  datatype: dateTime
  max count: 1
property:
  path: createdAt
  name: created at
  description: Metafield Created Date - When the metafield was first created, in shop time zone. Example value: 2025-10-21 07:08:01
  datatype: dateTime
  max count: 1

EmailsmsSettingShape
type: NodeShape
target class: EmailsmsSetting
property:
  path: campaignArchived
  name: campaign archived
  description: Is Campaign Archived - True if the campaign has been archived. Possible values: true , false
  datatype: boolean
  max count: 1
property:
  path: campaignCreatedAt
  name: campaign created at
  description: Campaign Creation Date - The time the campaign was created. Formatted according to the ISO 8601 international standard . Example value: 2019-04-15 08:26:00
  datatype: date
  max count: 1
property:
  path: campaignId
  name: campaign id
  description: Campaign ID - The unique ID of the email/SMS campaign, assigned by the email/SMS platform. Example value: 01G2MRY5AF2A4QFJMS5EF8X2MW
  datatype: string
  max count: 1
property:
  path: campaignName
  name: campaign name
  description: Campaign Name - The name of the email/SMS campaign. Example values: Fall Colors Launch , Father's Day Sale 50% Off
  datatype: string
  max count: 1
property:
  path: campaignScheduledAt
  name: campaign scheduled at
  description: Campaign Scheduled Date - The time the campaign was scheduled to be sent. Formatted according to the ISO 8601 international standard . Example value: 2019-04-15 08:26:00
  datatype: date
  max count: 1
property:
  path: campaignSendDate
  name: campaign send date
  description: campaign_send_date
  datatype: string
  max count: 1
property:
  path: campaignSendTime
  name: campaign send time
  description: Campaign Sent Date - The time the campaign was sent to recipients. Formatted according to the ISO 8601 international standard . Example value: 2019-04-15 08:26:00
  datatype: date
  max count: 1
property:
  path: campaignStatus
  name: campaign status
  description: Campaign Status - The status of the campaign associated with the email/SMS. Example values: Sent , Cancelled
  datatype: string
  max count: 1
property:
  path: campaignUpdatedAt
  name: campaign updated at
  description: Campaign Updated Date - The time the campaign was last updated. Formatted according to the ISO 8601 international standard . Example value: 2019-04-15 08:26:00
  datatype: date
  max count: 1
property:
  path: channel
  name: channel
  description: Channel - The platform used to send email/SMS. Example values: klaviyo , smsbump
  datatype: string
  max count: 1
property:
  path: channelType
  name: channel type
  description: Messaging Channel Type - The messaging channel used to deliver the communication. Example values: email , sms , push
  datatype: string
  max count: 1
property:
  path: flowActionArchived
  name: flow action archived
  description: Is Flow Action Archived - True if the specific action within an automation flow has been archived. Possible values: true , false
  datatype: boolean
  max count: 1
property:
  path: flowActionId
  name: flow action id
  description: Flow Action ID - The unique ID for a specific action within an automation flow. Assigned by the email/SMS platform. Example value: 51670312
  datatype: string
  max count: 1
property:
  path: flowActionName
  name: flow action name
  description: Flow Action Name - The name of the specific action within an automation flow. Example values: SEND_EMAIL , SEND_SMS , AB_TEST , TIME_DELAY , WEBHOOK
  datatype: string
  max count: 1
property:
  path: flowActionStatus
  name: flow action status
  description: Flow Action Status - The status of a specific action within an automation flow. Example values: draft , live , manual
  datatype: string
  max count: 1
property:
  path: flowActionUpdatedAt
  name: flow action updated at
  description: Flow Action Updated Date - The time the flow action was updated. Formatted according to the ISO 8601 international standard . Example value: 2019-04-15 08:26:00
  datatype: date
  max count: 1
property:
  path: flowArchived
  name: flow archived
  description: Is Flow Archived - True if the automation flow has been archived. Possible values: true , false
  datatype: boolean
  max count: 1
property:
  path: flowCreatedAt
  name: flow created at
  description: Flow Created Date - The time the automation flow was created. Formatted according to the ISO 8601 international standard . Example value: 2019-04-15 08:26:00
  datatype: date
  max count: 1
property:
  path: flowId
  name: flow id
  description: Flow ID - The unique ID for the automation flow. Assigned by the email/SMS platform. Example value: YuNWdc
  datatype: string
  max count: 1
property:
  path: flowName
  name: flow name
  description: Flow Name - The name of the automation flow. Example value: Abandoned cart reminder: 1-3 days , Joined Membership
  datatype: string
  max count: 1
property:
  path: flowStatus
  name: flow status
  description: Flow Status - The status of the automation flow. Example values: draft , live , manual
  datatype: string
  max count: 1
property:
  path: flowTriggerIsTw
  name: flow trigger is tw
  description: Flow Trigger Is Triple Whale - True if the flow was triggered by a Triple Whale (Sonar) metric or event. Possible values: true , false
  datatype: boolean
  max count: 1
property:
  path: flowTriggerMetricId
  name: flow trigger metric id
  description: Flow Trigger Metric ID - The ID of the metric or event that triggered the flow. Example value: Lm72Qs
  datatype: string
  max count: 1
property:
  path: flowTriggerMetricName
  name: flow trigger metric name
  description: Flow Trigger Metric Name - The name of the metric or event that triggered the flow. Example values: Checkout Started , Added to Cart , Abandoned Cart , Fulfilled Order
  datatype: string
  max count: 1
property:
  path: flowTriggerOrganization
  name: flow trigger organization
  description: Flow Trigger Organization - The platform where the flow trigger originated. Example values: Shopify , API , Klaviyo , Triple Whale
  datatype: string
  max count: 1
property:
  path: flowTriggerSonarEnabled
  name: flow trigger sonar enabled
  description: Flow Trigger Sonar Enabled - True if Sonar is enabled for this flow trigger. Possible values: true , false
  datatype: boolean
  max count: 1
property:
  path: flowUpdatedAt
  name: flow updated at
  description: Flow Updated Date - The time the automation flow was last updated. Formatted according to the ISO 8601 international standard . Example value: 2019-04-15 08:26:00
  datatype: date
  max count: 1
property:
  path: messageCopy
  name: message copy
  description: Message Copy - The full text content of the email message body, including dynamic variables and template tags used for personalization, embedded links, images, and call-to-action buttons. Example value: 'Can't view this email? {% web_view %} Shop our latest collection! [https://example.com/new-arrivals] Get 20% off your first order with code WELCOME20. {% unsubscribe %}'
  datatype: string
  max count: 1
property:
  path: messageId
  name: message id
  description: Message ID - The unique ID for the individual message sent as part of a campaign or flow. Assigned by the email/SMS platform. Example value: SDiqmK
  datatype: string
  max count: 1
property:
  path: messageName
  name: message name
  description: Message Name - The name of the individual message sent. Example value: Welcome Series: Email 2
  datatype: string
  max count: 1
property:
  path: messagePreviewText
  name: message preview text
  description: Message Preview Text - The short snippet of text shown alongside the subject line in the recipient’s inbox, offering a preview of the message content. Example value: Get 20% off your first order – limited time only!
  datatype: string
  max count: 1
property:
  path: messageSubject
  name: message subject
  description: Message Subject - The subject line of the email message, as displayed in the recipient's inbox. Example value: New Fall Collection Just Dropped
  datatype: string
  max count: 1
property:
  path: messageTemplateHtmlUrl
  name: message template html url
  description: Message Template HTML URL - The URL of the hosted HTML template for the email message, fully formatted as rendered for recipients. Example value: https://storage.googleapis.com/email-templates/klaviyo/12345/template.html
  datatype: anyURI
  max count: 1

EmailsmShape
type: NodeShape
target class: Emailsm
property:
  path: eventHour
  name: event hour
  description: Event Hour - The hour of the day the email/SMS action (e.g. sent, opened, received) 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: 07 , 16 , 21
  datatype: string
  max count: 1
property:
  path: eventDate
  name: event date
  description: Event Date - The date the email/SMS action (e.g. sent, opened, received) occurred. Based on the shop time zone at the moment of the event (or the user time zone, if no sales platform is connected).
  datatype: date
  max count: 1
property:
  path: eventDateDay
  name: event date day
  description: Event Day - The day the email/SMS action occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateWeek
  name: event date week
  description: Event Week - The Sunday of the week during which the email/SMS action occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateMonth
  name: event date month
  description: Event Month - The month during which the email/SMS action occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateQuarter
  name: event date quarter
  description: Event Quarter - The first month of the quarter during which the email/SMS action occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateYear
  name: event date year
  description: Event Year - The year during which the email/SMS action occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: campaignId
  name: campaign id
  description: Campaign ID - The unique ID of the email/SMS campaign, assigned by the email/SMS platform. Example value: 01G2MRY5AF2A4QFJMS5EF8X2MW
  datatype: string
  max count: 1
property:
  path: campaignName
  name: campaign name
  description: Campaign Name - The name of the email/SMS campaign. Example values: Fall Colors Launch , Father's Day Sale 50% Off
  datatype: string
  max count: 1
property:
  path: campaignStatus
  name: campaign status
  description: Campaign Status - The status of the campaign associated with the email/SMS. Example value: Sent , Cancelled
  datatype: string
  max count: 1
property:
  path: channel
  name: channel
  description: Channel - The platform used to send email/SMS. Example values: klaviyo , Smsbump
  datatype: string
  max count: 1
property:
  path: channelType
  name: channel type
  description: Messaging Channel Type - The messaging channel used to deliver the communication. Example values: email , sms , push
  datatype: string
  max count: 1
property:
  path: flowActionId
  name: flow action id
  description: Flow Action ID - The unique ID for a specific action within an automation flow. Assigned by the email/SMS platform. Example value: 49497165
  datatype: string
  max count: 1
property:
  path: flowActionName
  name: flow action name
  description: Flow Action Name - The name of the specific action within an automation flow. Example values: SEND_EMAIL , SEND_SMS , AB_TEST , TIME_DELAY , WEBHOOK
  datatype: string
  max count: 1
property:
  path: flowActionStatus
  name: flow action status
  description: Flow Action Status - The status of a specific action within an automation flow. Example values: draft , live , manual
  datatype: string
  max count: 1
property:
  path: flowId
  name: flow id
  description: Flow ID - The unique ID for the automation flow. Assigned by the email/SMS platform. Example value: 726935
  datatype: string
  max count: 1
property:
  path: flowName
  name: flow name
  description: Flow Name - The name of the automation flow. Example value: Abandoned cart reminder: 1-3 days , Joined Membership
  datatype: string
  max count: 1
property:
  path: flowStatus
  name: flow status
  description: Flow Status - The status of the automation flow. Example values: draft , live
  datatype: string
  max count: 1
property:
  path: flowTriggerIsTw
  name: flow trigger is tw
  description: Flow Trigger Is Triple Whale - True if the flow was triggered by a Triple Whale (Sonar) metric or event. Possible values: true , false
  datatype: boolean
  max count: 1
property:
  path: flowTriggerMetricId
  name: flow trigger metric id
  description: Flow Trigger Metric ID - The ID of the metric or event that triggered the flow. Example value: Lm72Qs
  datatype: string
  max count: 1
property:
  path: flowTriggerMetricName
  name: flow trigger metric name
  description: Flow Trigger Metric Name - The name of the metric or event that triggered the flow. Example values: Checkout Started , Added to Cart , Abandoned Cart , Fulfilled Order
  datatype: string
  max count: 1
property:
  path: flowTriggerOrganization
  name: flow trigger organization
  description: Flow Trigger Organization - The platform where the flow trigger originated. Example values: Shopify , API , Klaviyo , Triple Whale
  datatype: string
  max count: 1
property:
  path: flowTriggerSonarEnabled
  name: flow trigger sonar enabled
  description: Flow Trigger Sonar Enabled - True if Sonar is enabled for this flow trigger. Possible values: true , false
  datatype: boolean
  max count: 1
property:
  path: messageId
  name: message id
  description: Message ID - The unique ID for the individual message sent as part of a campaign or flow. Assigned by the email/SMS platform. Example value: UKDRM6
  datatype: string
  max count: 1
property:
  path: messageName
  name: message name
  description: Message Name - The name of the individual message sent. Example value: Welcome Series: Email 2
  datatype: string
  max count: 1
property:
  path: reportType
  name: report type
  description: Report Type - The type of report generated. Example values: flow , campaign
  datatype: string
  max count: 1
property:
  path: shopId
  name: shop id
  description: Shop ID - The unique ID of the shop (often corresponds to the shop domain). Can be used to group or filter data by shop in multi-store reports. Example values: example-US.myshopify.com , example-EU.myshopify.com
  datatype: string
  max count: 1
property:
  path: shopName
  name: shop name
  description: Shop Name - The name of the shop. Can be used to group or filter data by shop in multi-store reports. Example values: example-US , example-EU
  datatype: string
  max count: 1
property:
  path: clicks
  name: clicks
  description: Clicks - The total number of unique clicks on links within the email/SMS.
  datatype: double
  max count: 1
property:
  path: conversionValue
  name: conversion value
  description: Channel-Reported Conversion Value - Revenue generated from channel-reported conversions (purchases).
  datatype: double
  max count: 1
property:
  path: delivered
  name: delivered
  description: Delivered Messages - The total number of messages successfully delivered to the targeted recipient.
  datatype: double
  max count: 1
property:
  path: opened
  name: opened
  description: Opens - The total number of unique email opens.
  datatype: double
  max count: 1
property:
  path: purchases
  name: purchases
  description: Channel-Reported Conversions (Purchases) - Number of channel-reported conversions (purchases).
  datatype: double
  max count: 1

ExternalRevenueShape
type: NodeShape
target class: ExternalRevenue
property:
  path: eventDate
  name: event date
  description: Event Date - The date the external revenue was generated. Based on the shop time zone at the moment of the event (or the user time zone, if no sales platform is connected). Note: Each uploaded row can represent either a single date of revenue, or a start and end date. For rows containing a date range, Triple Whale will amortize the amount over the time range.
  datatype: date
  max count: 1
property:
  path: eventDateDay
  name: event date day
  description: Event Day - The day the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateWeek
  name: event date week
  description: Event Week - The Sunday of the week during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateMonth
  name: event date month
  description: Event Month - The month during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateQuarter
  name: event date quarter
  description: Event Quarter - The first month of the quarter during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateYear
  name: event date year
  description: Event Year - The year during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: breakdown
  name: breakdown
  description: Breakdown - A JSON array containing product-level details for the revenue. Each element in the array is an object with the following properties: sku (string): The SKU (Stock Keeping Unit) for the product. product_id (string): The unique product ID. amount (number): The quantity of the product sold. revenue (number): The revenue amount for this specific product. This value is automatically converted to your shop's selected currency for display.
  node: ContainerShape
  class: Container
  node kind: BlankNodeOrIRI
  max count: 1
property:
  path: channel
  name: channel
  description: Channel - The marketing or sales channel through which the revenue was generated. Example values: online , retail , wholesale , in-store
  datatype: string
  max count: 1
property:
  path: city
  name: city
  description: City - The city where the revenue was generated. Example values: New York , Los Angeles , Chicago
  datatype: string
  max count: 1
property:
  path: createdAt
  name: created at
  description: Created At - The timestamp when the revenue record was created in Triple Whale (when the CSV was uploaded and processed). Example value: 2025-01-15T10:30:00.000Z
  datatype: dateTime
  max count: 1
property:
  path: currency
  name: currency
  description: Source Currency - The original currency in which the revenue was recorded, before conversion to the shop's currency. All monetary values are automatically converted to the shop's selected currency for display. Example values: USD , GBP , EUR Note: All revenue metrics are automatically converted to your shop's selected currency for display.
  datatype: string
  max count: 1
property:
  path: location
  name: location
  description: Location - The physical location or store where the revenue was generated. Example values: Downtown Store , Mall Location , Warehouse A
  datatype: string
  max count: 1
property:
  path: sourceName
  name: source name
  description: Source Name - Free-text identifier to name the specific revenue source. Example values: Downtown Store , Amazon B2B , Popup Shop )
  datatype: string
  max count: 1
property:
  path: sourceType
  name: source type
  description: Source Type - The type of revenue source. Possible values: retail : Retail revenue wholesale : Wholesale revenue pos : Point of Sale revenue offline : Offline revenue
  datatype: string
  max count: 1
property:
  path: state
  name: state
  description: State - The full state name where the revenue was generated. Example values: California , New York , Texas
  datatype: string
  max count: 1
property:
  path: stateCode
  name: state code
  description: State Code - The two-letter state code where the revenue was generated. Example values: CA , NY , TX
  datatype: string
  max count: 1
property:
  path: https://relay.inferal.com/ontology/triplewhale/property/TripleWhale.ExternalRevenue/zip
  name: zip
  description: ZIP Code - The ZIP or postal code where the revenue was generated. Example values: 10001 , 90210 , 60601
  datatype: string
  max count: 1
property:
  path: amountTotal
  name: amount total
  description: Amount Total - The total revenue amount for the record.
  datatype: double
  max count: 1

Ga4ProductAnalyticsShape
type: NodeShape
target class: Ga4ProductAnalytics
property:
  path: eventHour
  name: event hour
  description: Event Hour - The hour of the day on which the purchase 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: 07 , 16 , 21
  datatype: string
  max count: 1
property:
  path: eventDate
  name: event date
  description: Event Date - The date the purchase 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).
  datatype: date
  max count: 1
property:
  path: eventDateDay
  name: event date day
  description: Event Day - The day the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateWeek
  name: event date week
  description: Event Week - The Sunday of the week during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateMonth
  name: event date month
  description: Event Month - The month during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateQuarter
  name: event date quarter
  description: Event Quarter - The first month of the quarter during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateYear
  name: event date year
  description: Event Year - The year during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: itemId
  name: item id
  description: Item ID - The unique identifier for the product, as reported by GA4. Typically maps to the product or variant SKU. Example values: 57404707913 , sku123
  datatype: string
  max count: 1
property:
  path: grossItemRevenue
  name: gross item revenue
  description: Gross Item Revenue - The total revenue from items only, before any discounts, tax, shipping, or refunds. Gross Item Revenue = Item Price x Item Quantity
  datatype: double
  max count: 1
property:
  path: itemRevenue
  name: item revenue
  description: Item Revenue - The total revenue from items only, before tax and shipping (but after refunds). Item Revenue = Item Price x Item Quantity - Refunds
  datatype: double
  max count: 1
property:
  path: itemsAddedToCart
  name: items added to cart
  description: Items Added to Cart - The number of items added to a cart. Each unit counts separately.
  datatype: double
  max count: 1
property:
  path: itemsCheckedOut
  name: items checked out
  description: Items Checked Out - The number of items in the cart when the checkout process was initiated. Each unit counts separately.
  datatype: double
  max count: 1
property:
  path: itemsPurchased
  name: items purchased
  description: Items Purchased - The number of items included in purchase events. Each unit counts separately.
  datatype: double
  max count: 1
property:
  path: itemsViewed
  name: items viewed
  description: Items Viewed - The number of items that the customer viewed.
  datatype: double
  max count: 1

Ga4SessionsAggShape
type: NodeShape
target class: Ga4SessionsAgg
property:
  path: eventHour
  name: event hour
  description: Event Hour - The hour of the day on which the GA4 session started, 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: 07 , 16 , 21
  datatype: string
  max count: 1
property:
  path: eventDate
  name: event date
  description: Event Date - The date the GA4 session started. Based on the shop time zone at the moment of the event (or the user time zone, if no sales platform is connected).
  datatype: date
  max count: 1
property:
  path: eventDateDay
  name: event date day
  description: Event Day - The day the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateWeek
  name: event date week
  description: Event Week - The Sunday of the week during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateMonth
  name: event date month
  description: Event Month - The month during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateQuarter
  name: event date quarter
  description: Event Quarter - The first month of the quarter during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateYear
  name: event date year
  description: Event Year - The year during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: firstUserPrimaryChannelGroup
  name: first user primary channel group
  description: First User Primary Channel Group - The Primary Channel Group attributed to the user's first session. Example values: Organic Search , Affiliates , SMS , Cross-network , Paid Other
  datatype: string
  max count: 1
property:
  path: sessionDefaultChannelGroup
  name: session default channel group
  description: Session Default Channel Group - The Default Channel Group assigned to the session. Example values: Organic Search , Referral , Direct , Paid Social , Unassigned
  datatype: string
  max count: 1
property:
  path: sessionSource
  name: session source
  description: Session Source - The raw traffic source that initiated the session, derived from UTM parameters or the referring domain. Example values: facebook , klaviyo-email-flow , awin
  datatype: string
  max count: 1
property:
  path: sessionSourceMedium
  name: session source medium
  description: Session Source / Medium - A combined representation of the session's traffic source and medium, used by GA4 to assign the session to a channel group. Example values: facebook / cpc , klaviyo-email-flow / email , awin / affiliate
  datatype: string
  max count: 1
property:
  path: activeUsers
  name: active users
  description: Active Users - The number of distinct users who had at least one engaged session during the selected time range. GA4 defines an engaged session as one that lasted at least 10 seconds, had a conversion event, or had 2 or more screen/page views.
  datatype: double
  max count: 1
property:
  path: newUsers
  name: new users
  description: New Users - The number of users who interacted with your site or app for the first time.
  datatype: double
  max count: 1
property:
  path: promotionViews
  name: promotion views
  description: Promotion Views - The number of times users viewed on-site or in-app promotions, such as banners or product carousels.
  datatype: double
  max count: 1
property:
  path: screenPageViews
  name: screen page views
  description: Screen / Page Views - The total number of page views (for web) and screen views (for app) that occurred during sessions in the selected time range.
  datatype: double
  max count: 1
property:
  path: sessions
  name: sessions
  description: Sessions - The total number of sessions that started during the selected date range. GA4 defines a session as beginning with a session_start event and ending after 30 minutes of inactivity by default.
  datatype: double
  max count: 1
property:
  path: totalRevenue
  name: total revenue
  description: Total Revenue - The total revenue (after refunds) from purchases, in-app transactions, subscriptions and ads, during sessions in the selected time range. Total Revenue = Purchases + In-App Purchases + Subscriptions + Ad Revenue - Refunds
  datatype: double
  max count: 1
property:
  path: totalUsers
  name: total users
  description: Total Users - The number of distinct users who initiated at least one session during the selected time range, including both new and returning users.
  datatype: double
  max count: 1

Ga4WebAnalyticsShape
type: NodeShape
target class: Ga4WebAnalytics
property:
  path: eventHour
  name: event hour
  description: Event Hour - The hour of the day on which the GA4 session started, 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: 07 , 16 , 21
  datatype: string
  max count: 1
property:
  path: eventDate
  name: event date
  description: Event Date - The date the GA4 session started. Based on the shop time zone at the moment of the event (or the user time zone, if no sales platform is connected).
  datatype: date
  max count: 1
property:
  path: eventDateDay
  name: event date day
  description: Event Day - The day the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateWeek
  name: event date week
  description: Event Week - The Sunday of the week during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateMonth
  name: event date month
  description: Event Month - The month during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateQuarter
  name: event date quarter
  description: Event Quarter - The first month of the quarter during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateYear
  name: event date year
  description: Event Year - The year during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: browser
  name: browser
  description: Web Browser - The web browser of the session where the order originated. Example values: Chrome , Firefox , Safari
  datatype: string
  max count: 1
property:
  path: city
  name: city
  description: Session City - The city of the session where the order originated. Example values: San Francisco , Tel Aviv , Kyiv
  datatype: string
  max count: 1
property:
  path: country
  name: country
  description: Session Country - The country of the session. See list of countries . Example values: United States , Canada , United Kingdom
  datatype: string
  max count: 1
property:
  path: device
  name: device
  description: Device - The type of device used by the visitor for the session. Example values: mobile , desktop , tablet , wearable
  datatype: string
  max count: 1
property:
  path: landingPage
  name: landing page
  description: Landing Page - The URL path (without query parameters) of the page the visitor landed after clicking on an ad or link, indicating the first page viewed in a session. Example value: /myshop/collections/green_sweater
  datatype: string
  max count: 1
property:
  path: shopId
  name: shop id
  description: Shop ID - The unique ID of the shop (often corresponds to the shop domain). Can be used to group or filter data by shop in multi-store reports. Example values: example-US.myshopify.com , example-EU.myshopify.com
  datatype: string
  max count: 1
property:
  path: shopName
  name: shop name
  description: Shop Name - The name of the shop. Can be used to group or filter data by shop in multi-store reports. Example values: example-US , example-EU
  datatype: string
  max count: 1
property:
  path: addToCarts
  name: add to carts
  description: Add To Carts - The number of Add To Cart events during sessions in the selected time range.
  datatype: double
  max count: 1
property:
  path: orderRevenue
  name: order revenue
  description: Purchase Revenue - The total revenue (after refunds) from purchases and subscriptions, during sessions in the selected time range. Purchase Revenue = Purchases + Subscriptions - Refunds
  datatype: double
  max count: 1
property:
  path: ordersQuantity
  name: orders quantity
  description: Purchases - The total number of website and app purchases (orders) during sessions in the selected time range.
  datatype: double
  max count: 1
property:
  path: sessions
  name: sessions
  description: Sessions - The total number of sessions that started during the selected date range. GA4 defines a session as beginning with a session_start event and ending after 30 minutes of inactivity by default.
  datatype: double
  max count: 1
property:
  path: addToCartPercent
  name: add to cart percent
  description: Add To Cart Percent - The percentage of add-to-carts out of total sessions. Add To Cart Percent = Number of Add To Carts / Number of Sessions
  datatype: string
  max count: 1

IdGraphShape
type: NodeShape
target class: IdGraph
property:
  path: customerIds
  name: customer ids
  description: Customer IDs - A list of customer identifiers collected from connected platforms (e.g., Shopify, Meta, Klaviyo) that have been matched as belonging to the same individual and associated with a single global_id . Example value: [5209503793328, 1308703745320]
  datatype: string
property:
  path: emails
  name: emails
  description: Customer Emails - All email addresses collected across platforms and touchpoints (e.g., checkout, marketing platforms, forms, aliases, historical emails) that have been matched as belonging to the same individual and associated with a single global_id . Example value: [ [email protected] , [email protected] , [email protected] ]
  datatype: string
property:
  path: globalId
  name: global id
  description: Global ID - The identifier assigned by Triple Whale to represent a single individual after probabilistically matching related customer IDs, emails, and Pixel triple_ids across platforms and devices. This is the primary identifier used for identity-level analysis. Example value: er74f7ca-34bd-4u70-mn90-2a7slh385e19
  datatype: string
  max count: 1
property:
  path: primaryEmail
  name: primary email
  description: Primary Customer Email - A single selected email address associated with the global_id , representing the most preferred or consistent email for that individual. Useful for deduplicated outreach and identity-based grouping. Example value: [email protected]
  datatype: string
  max count: 1
property:
  path: tripleIds
  name: triple ids
  description: Triple Pixel IDs - A list of identifiers generated by the Triple Pixel that represent visits, sessions, or devices that have been matched as belonging to the same individual and associated with a single global_id . Example value: [eltlok4y634IRw62AZ, olthkk4y294WNw62PL]
  datatype: string

KeywordShape
type: NodeShape
target class: Keyword
property:
  path: eventDate
  name: event date
  description: Event Date - The date the keyword triggered an ad. Based on the shop time zone at the moment of the event (or the user time zone, if no sales platform is connected).
  datatype: date
  max count: 1
property:
  path: eventDateDay
  name: event date day
  description: Event Day - The day on which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateWeek
  name: event date week
  description: Event Week - The Sunday of the week during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateMonth
  name: event date month
  description: Event Month - The month during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateQuarter
  name: event date quarter
  description: Event Quarter - The first month of the quarter during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateYear
  name: event date year
  description: Event Year - The year during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: accountId
  name: account id
  description: Ad Account ID - The unique ID for the ad account associated with the ad. Assigned by the ad platform. Example values: act_2168791943307744 , 18ce55770zl , 1986494684391480
  datatype: string
  max count: 1
property:
  path: accountName
  name: account name
  description: Ad Account Name - The name of the advertiser’s account as defined in the ad platform. Example values: Example Shop , example_shop , ES - International
  datatype: string
  max count: 1
property:
  path: adsetId
  name: adset id
  description: Ad Set ID - The unique ID for the ad set associated with the ad click. Assigned by the ad platform. Example value: 120210439890740003
  datatype: string
  max count: 1
property:
  path: adsetName
  name: adset name
  description: Ad Set Name - The name of the ad set within a campaign. Example values: Broad Audience , Bracelets , Wellness
  datatype: string
  max count: 1
property:
  path: campaignId
  name: campaign id
  description: Campaign ID - The unique ID for the marketing campaign associated with the ad. Assigned by the ad platform. Example values: 23852438666180053 , 531011533 , 20620285829
  datatype: string
  max count: 1
property:
  path: campaignName
  name: campaign name
  description: Campaign Name - The name of the marketing campaign associated with the ad. Example values: Catalog Retargeting , US Generic Search , Breakfast of Champions Campaign
  datatype: string
  max count: 1
property:
  path: channel
  name: channel
  description: Channel - The platform through which the ad was delivered. Example value: google-ads
  datatype: string
  max count: 1
property:
  path: currency
  name: currency
  description: Ad Platform Currency - The original currency used in the ad platform, before conversion to the shop's currency. All monetary values are automatically converted to the shop's selected currency for display. Example values: USD , GBP , EUR
  datatype: string
  max count: 1
property:
  path: keywordId
  name: keyword id
  description: Keyword ID - The unique ID assigned to the keyword by the ad platform. Example value: 313990984637674
  datatype: string
  max count: 1
property:
  path: keywordStatus
  name: keyword status
  description: Keyword Status - The status of the keyword. Example values: ENABLED , PAUSED , REMOVED
  datatype: string
  max count: 1
property:
  path: keywordText
  name: keyword text
  description: Keyword Text - The text of the keyword as entered in the ad platform. Example values: running shoes , cheap flights , best coffee
  datatype: string
  max count: 1
property:
  path: matchType
  name: match type
  description: Match Type - How closely a user’s search query must match the keyword in order to trigger an ad. Example values: EXACT , PHRASE , BROAD
  datatype: string
  max count: 1
property:
  path: systemServingStatus
  name: system serving status
  description: System Serving Status - Indicates whether the keyword is currently eligible to serve ads. Example values: ELIGIBLE , RARELY_SERVED
  datatype: string
  max count: 1
property:
  path: allConversionValue
  name: all conversion value
  description: All Conversion Value - Revenue generated from channel-reported conversions of all types (e.g. purchases, registrations, add-to-carts).
  datatype: double
  max count: 1
property:
  path: allConversions
  name: all conversions
  description: All Conversions - The total number of channel-reported conversions of all types (e.g. purchases, registrations, add-to-carts).
  datatype: double
  max count: 1
property:
  path: clicks
  name: clicks
  description: Clicks - Number of channel-reported clicks.
  datatype: double
  max count: 1
property:
  path: conversionValue
  name: conversion value
  description: Channel-Reported Conversion Value - Revenue generated from channel-reported conversions (purchases).
  datatype: double
  max count: 1
property:
  path: cpcBid
  name: cpc bid
  description: CPC Bid - The bid amount set for the keyword (cost-per-click). By default shown in the shop's currency.
  datatype: double
  max count: 1
property:
  path: effectiveCpcBid
  name: effective cpc bid
  description: Effective CPC Bid - The effective CPC bid after platform bid adjustments are applied. By default shown in the shop's currency.
  datatype: double
  max count: 1
property:
  path: impressions
  name: impressions
  description: Impressions - Number of channel-reported impressions.
  datatype: double
  max count: 1
property:
  path: qualityScore
  name: quality score
  description: Quality Score - The quality score assigned to the keyword by the ad platform (0 – 10, higher is better).
  datatype: double
  max count: 1
property:
  path: searchAbsoluteTopImpressions
  name: search absolute top impressions
  description: Search Absolute Top Impressions - The number of impressions your ads received in the absolute top position (the very first ad above organic results).
  datatype: double
  max count: 1
property:
  path: searchBudgetLostAbsoluteTopImpressions
  name: search budget lost absolute top impressions
  description: Search Budget Lost Absolute Top Impressions - The estimated number of absolute top impressions your ads missed due to low budget.
  datatype: double
  max count: 1
property:
  path: searchBudgetLostTopImpressions
  name: search budget lost top impressions
  description: Search Budget Lost Top Impressions - The estimated number of top impressions your ads missed due to low budget.
  datatype: double
  max count: 1
property:
  path: searchImpressions
  name: search impressions
  description: Search Impressions - The total number of impressions your ads received on the Search Network.
  datatype: double
  max count: 1
property:
  path: searchRankLostImpressions
  name: search rank lost impressions
  description: Search Rank Lost Impressions - The estimated number of impressions your ads did not receive because Ad Rank was too low.
  datatype: double
  max count: 1
property:
  path: searchRankLostTopImpressions
  name: search rank lost top impressions
  description: Search Rank Lost Top Impressions - The estimated number of top impressions your ads missed due to poor Ad Rank.
  datatype: double
  max count: 1

OrderShape
type: NodeShape
target class: Order
property:
  path: eventHour
  name: event hour
  description: Event Hour - The hour of the day the order was placed, 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: 07 , 16 , 21
  datatype: string
  max count: 1
property:
  path: eventDate
  name: event date
  description: Event Date - The date the order was placed. Based on the shop time zone at the moment of the event (or the user time zone, if no sales platform is connected).
  datatype: date
  max count: 1
property:
  path: eventDateDay
  name: event date day
  description: Event Day - The day on which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateWeek
  name: event date week
  description: Event Week - The Sunday of the week during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateMonth
  name: event date month
  description: Event Month - The month during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateQuarter
  name: event date quarter
  description: Event Quarter - The first month of the quarter during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateYear
  name: event date year
  description: Event Year - The year during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: amazonFulfillmentChannel
  name: amazon fulfillment channel
  description: Amazon Fulfillment Channel - The fulfillment channel of the Amazon order. Example values: FBA , FBM
  datatype: string
  max count: 1
property:
  path: amazonFulfillmentStatus
  name: amazon fulfillment status
  description: Amazon Fulfillment Status - The fulfillment status of the Amazon order. Example values: Pending , Unshipped , PartiallyShipped , Shipped , Canceled , Unfulfillable , InvoiceUnconfirmed , PendingAvailability
  datatype: string
  max count: 1
property:
  path: amazonIsBusinessOrder
  name: amazon is business order
  description: Amazon Is Business Order - Indicates if the order is a business order on Amazon. Possible values: true , false
  datatype: boolean
  max count: 1
property:
  path: amazonMarketplaceId
  name: amazon marketplace id
  description: Amazon Marketplace ID - The Amazon marketplace ID for the marketplace associated with the order. See list of marketplace IDs .
  datatype: string
  max count: 1
property:
  path: amazonMarketplaceName
  name: amazon marketplace name
  description: Amazon Marketplace Name - The human-readable name of the Amazon marketplace associated with the order (e.g., "United States of America", "United Kingdom").
  datatype: string
  max count: 1
property:
  path: amazonRegion
  name: amazon region
  description: Amazon Region - The Amazon region for the marketplace associated with the order (e.g., "North America", "Europe", "Far East").
  datatype: string
  max count: 1
property:
  path: billingCity
  name: billing city
  description: Billing City - The city of the customer's billing address. Example value: San Francisco
  datatype: string
  max count: 1
property:
  path: billingCountry
  name: billing country
  description: Billing Country - The full name of the customer's billing country. See list of countries . Example values: United States , Canada , United Kingdom
  datatype: string
  max count: 1
property:
  path: billingCountryCode
  name: billing country code
  description: Billing Country Code - The country code of the customer's billing address. See list of countries . Example values: US , CA , GB
  datatype: string
  max count: 1
property:
  path: billingProvince
  name: billing province
  description: Billing State - The state or province of the customer's billing address. Example values: Oregon , British Columbia , Michigan
  datatype: string
  max count: 1
property:
  path: cancelledAt
  name: cancelled at
  description: Canceled Date - The time at which the order was canceled. Formatted according to the ISO 8601 international standard . NULL if the order was not canceled. Example value: 2023-06-15T19:26:30.000Z
  datatype: dateTime
  max count: 1
property:
  path: createdAt
  name: created at
  description: Order Created Date - The time at which the order record was created. Formatted according to the ISO 8601 international standard . Example value: 2022-06-15T19:26:30.000Z
  datatype: dateTime
  max count: 1
property:
  path: currency
  name: currency
  description: Order Currency - The original currency of the order, before conversion to the shop's currency. All monetary values are automatically converted to the shop's selected currency for display. Example values: USD , GBP , EUR
  datatype: string
  max count: 1
property:
  path: customerEmail
  name: customer email
  description: Customer Email - The customer's email address. Example value: [email protected]
  datatype: string
  max count: 1
property:
  path: customerFirstName
  name: customer first name
  description: Customer First Name - The customer's first name. Example value: John
  datatype: string
  max count: 1
property:
  path: customerFromCity
  name: customer from city
  description: Customer City - The city of the customer's default address. Example value: San Francisco
  datatype: string
  max count: 1
property:
  path: customerFromCountryCode
  name: customer from country code
  description: Customer Country Code - The country code of the customer's default address. See list of countries . Example values: US , CA , GB
  datatype: string
  max count: 1
property:
  path: customerFromCountryName
  name: customer from country name
  description: Customer Country Name - The full name of the customer's country. See list of countries . Example values: United States , Canada , United Kingdom
  datatype: string
  max count: 1
property:
  path: customerFromStateCode
  name: customer from state code
  description: Customer State Code - The state or province code of the customer's default address. Example value: CA
  datatype: string
  max count: 1
property:
  path: customerId
  name: customer id
  description: Customer ID - The unique identifier for the customer, assigned by the main sales platform. Example value: 5209503793328
  datatype: string
  max count: 1
property:
  path: customerIdKey
  name: customer id key
  description: Customer ID Key - Join key for connecting this table to the Customers table. Contains customer_id for Shopify shops and customer_email for non-Shopify shops (e.g., Amazon, BigCommerce, WooCommerce). Example values: 5209503793328 , [email protected]
  datatype: string
  max count: 1
property:
  path: customerLastName
  name: customer last name
  description: Customer Last Name - The last name of the customer. Example value: Doe
  datatype: string
  max count: 1
property:
  path: customerTags
  name: customer tags
  description: Customer Tags - Tags associated with the customer, set in the main sales platform. Example values: Active Subscriber , PayPal_user , Login with FB
  datatype: string
property:
  path: discountCode
  name: discount code
  description: Discount Code - The discount code or promotion name used in the order. Set by the seller in the main sales platform. Example values: WELCOME10 , Replacement for defective item , 807QRWMNK2
  datatype: string
  max count: 1
property:
  path: discountType
  name: discount type
  description: Discount Type - The type of discount received by the customer in the order. Example values: fixed_amount , percentage
  datatype: string
  max count: 1
property:
  path: fulfillmentStatus
  name: fulfillment status
  description: Fulfillment Status - The fulfillment status of the order. Example values: fulfilled , partial , restocked
  datatype: string
  max count: 1
property:
  path: integrationShippingStatus
  name: integration shipping status
  description: Integration Shipping Status - The shipping status of the order, according to the integrated shipping provider. Example values: LabeledCreated , Completed
  datatype: string
  max count: 1

OrderMetafieldShape
type: NodeShape
target class: OrderMetafield
property:
  path: metafieldId
  name: metafield id
  description: Metafield ID - The unique identifier of the metafield record. Example value: 44187839136031
  datatype: string
  max count: 1
property:
  path: key
  name: key
  description: Metafield Key - The unique key of the metafield within its namespace, indicating what data it holds. Example values: promised_delivery_date , zone , agree_to_terms
  datatype: string
  max count: 1
property:
  path: value
  name: value
  description: Metafield Value - The raw stored value of the metafield. Format depends on the metafield type (e.g., text, date, boolean, JSON). Example values: 2025-11-10 , true , #241194 , 5a
  datatype: string
  max count: 1
property:
  path: metafieldNamespace
  name: metafield namespace
  description: Metafield Namespace - Logical grouping used to organize metafields by source or purpose. Example values: custom , klaviyo , checkoutblocks
  datatype: string
  max count: 1
property:
  path: metafieldType
  name: metafield type
  description: Metafield Type - The data type of the metafield value (e.g., text, date, boolean, JSON, reference). Example values: date , boolean , json , single_line_text_field , customer_reference
  datatype: string
  max count: 1
property:
  path: updatedAt
  name: updated at
  description: Metafield Updated Date - When the metafield was last updated, in shop time zone. Example value: 2025-10-21 07:08:01
  datatype: dateTime
  max count: 1
property:
  path: createdAt
  name: created at
  description: Metafield Created Date - When the metafield was first created, in shop time zone. Example value: 2025-10-21 07:08:01
  datatype: dateTime
  max count: 1

OrderProductsInfoShape
type: NodeShape
target class: OrderProductsInfo
property:
  path: productId
  name: product id
  description: Product ID - The unique ID of the product as set within the main sales platform. Example value: 3891505496131
  datatype: string
  max count: 1
property:
  path: productName
  name: product name
  description: Product Name - The name of the product as set within the main sales platform. Example values: Green Soft Socks 3-Pack , Paring Knife Travel Case , Gift Subscription
  datatype: string
  max count: 1
property:
  path: vendor
  name: vendor
  description: Product Vendor - The vendor of the product as set within the main sales platform. Example values: Acme , XYZ Corp , Brandless
  datatype: string
  max count: 1
property:
  path: productType
  name: product type
  description: Product Type - The product type as set within the main sales platform. Example values: Jackets , Coffee Mugs , Books
  datatype: string
  max count: 1
property:
  path: productTags
  name: product tags
  description: Product Tags - Tags associated with the product, set in the main sales platform. Example values: Upsell , Order Credits , discount_eligible
  datatype: string
property:
  path: productSku
  name: product sku
  description: Product SKU - The SKU (Stock Keeping Unit) for the product as set within the main sales platform. Example values: GP-BACK-02 , A02630 , POP200NAVY
  datatype: string
  max count: 1
property:
  path: variantId
  name: variant id
  description: Product Variant ID - The unique identifier for a specific variant of a product as set within the main sales platform. Example value: 29275946877001
  datatype: string
  max count: 1
property:
  path: isGiftCard
  name: is gift card
  description: Is Gift Card - True if the product purchased is a gift card. Possible values: true , false
  datatype: boolean
  max count: 1
property:
  path: properties
  name: properties
  description: Product Properties - Custom key–value properties attached to the product line item (e.g., personalization details, bundle metadata, app-specific fields).
  node: ContainerShape
  class: Container
  node kind: BlankNodeOrIRI
property:
  path: propertiesName
  name: properties name
  description: Product Property Name - The name or key of the product property.
  datatype: string
  max count: 1
property:
  path: propertiesValue
  name: properties value
  description: Product Property Value - The value assigned to the product property.
  datatype: string
  max count: 1
property:
  path: duties
  name: duties
  description: Product Duties - Import duties or tariffs applied to the product.
  node: ContainerShape
  class: Container
  node kind: BlankNodeOrIRI
property:
  path: dutiesDutyId
  name: duties duty id
  description: Product Duty ID - The unique identifier of the duty applied to the product.
  datatype: string
  max count: 1
property:
  path: dutiesTaxLines
  name: duties tax lines
  description: Product Duty Tax Lines - Tax lines charged on the product duty.
  node: ContainerShape
  class: Container
  node kind: BlankNodeOrIRI
property:
  path: dutiesTaxLinesPrice
  name: duties tax lines price
  description: Product Duty Tax Line Amount - The tax amount charged on the product duty per tax line.
  datatype: double
  max count: 1
property:
  path: dutiesPrice
  name: duties price
  description: Product Duty Amount - The monetary amount of duty charged for the product.'
  datatype: double
  max count: 1
property:
  path: productNamePrice
  name: product name price
  description: Product Price - The price of a single product (to the buyer), before discounts. By default shown in the shop's currency. Note: Tax will be included in the product price if the seller has configured the sale to require taxes in the main sales platform.
  datatype: double
  max count: 1
property:
  path: discountAmountForProduct
  name: discount amount for product
  description: Total Product Discount - The amount discounted from the product price, before taxes. By default shown in the shop's currency.
  datatype: double
  max count: 1
property:
  path: netDiscountAmountForProduct
  name: net discount amount for product
  description: Net Product Discount - The amount discounted from the product price, after taxes. By default shown in the shop's currency.
  datatype: double
  max count: 1
property:
  path: productNameQuantitySold
  name: product name quantity sold
  description: Product Units Sold - The total number of individual units sold for the product.
  datatype: double
  max count: 1
property:
  path: singleProductCost
  name: single product cost
  description: Product Cost - The cost of a single product (to the seller). By default shown in the shop's currency.
  datatype: double
  max count: 1

OrderTransactionShape
type: NodeShape
target class: OrderTransaction
property:
  path: createdAt
  name: created at
  description: Transaction Created Date - The time at which the transaction record was created. Formatted according to the ISO 8601 international standard . Example value: 2024-12-25 11:30:09
  datatype: dateTime
  max count: 1
property:
  path: processedAt
  name: processed at
  description: Transaction Processed Date - The time at which the transaction was processed. Formatted according to the ISO 8601 international standard . Example value: 2024-12-25 11:30:09
  datatype: dateTime
  max count: 1
property:
  path: paymentGatewayName
  name: payment gateway name
  description: Transaction Payment Gateway - The payment gateway used for the transaction. Example values: shopify_payments , paypal , gift_card
  datatype: string
  max count: 1
property:
  path: currency
  name: currency
  description: Transaction Currency - The currency in which the transaction was processed. Example values: USD , EUR
  datatype: string
  max count: 1
property:
  path: status
  name: status
  description: Transaction Status - The status of the transaction. Example values: SUCCESS , FAILURE , AWAITING_RESPONSE , PENDING , ERROR
  datatype: string
  max count: 1
property:
  path: amount
  name: amount
  description: Transaction Amount - The amount of the transaction.
  datatype: double
  max count: 1
property:
  path: fees
  name: fees
  description: Transaction Fees - The fees associated with the transaction.
  datatype: double
  max count: 1

PixelCustomConversionShape
type: NodeShape
target class: PixelCustomConversion
property:
  path: eventHour
  name: event hour
  description: Event Hour - 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: 07 , 16 , 21
  datatype: string
  max count: 1
property:
  path: eventDate
  name: event date
  description: Event 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).
  datatype: date
  max count: 1
property:
  path: eventDateDay
  name: event date day
  description: Event Day - The day on which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateWeek
  name: event date week
  description: Event Week - The Sunday of the week during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateMonth
  name: event date month
  description: Event Month - The month during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateQuarter
  name: event date quarter
  description: Event Quarter - The first month of the quarter during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateYear
  name: event date year
  description: Event Year - The year during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: adId
  name: ad id
  description: Ad ID - The unique ad ID. Assigned by the ad platform. Example value: 120210439891110007
  datatype: string
  max count: 1
property:
  path: adsetId
  name: adset id
  description: Ad Set ID - The unique ID for the ad set associated with the ad click. Assigned by the ad platform. Example value: 120210439890740003
  datatype: string
  max count: 1
property:
  path: attributionWindow
  name: attribution window
  description: Attribution Window - The time frame for attributing conversions to the ad. By default lifetime . Example values: 1_day , 7_days , 14_days , 28_days , lifetime
  datatype: string
  max count: 1
property:
  path: campaignId
  name: campaign id
  description: Campaign ID - The unique ID for the marketing campaign associated with the ad. Assigned by the ad platform. Example values: 23852438666180053 , 531011533 , 20620285829
  datatype: string
  max count: 1
property:
  path: channel
  name: channel
  description: Channel - The platform through which the ad was delivered. Example values: facebook-ads , google-ads , Direct
  datatype: string
  max count: 1
property:
  path: email
  name: email
  description: Customer Email - The customer's email address. Example value: [email protected]
  datatype: string
  max count: 1
property:
  path: eventBody
  name: event body
  description: Pixel Custom Conversion Event Data - 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
  node: ContainerShape
  class: Container
  node kind: BlankNodeOrIRI
  max count: 1
property:
  path: eventId
  name: event id
  description: Event ID - The unique ID assigned by Triple Pixel to the custom conversion event. Example value: 9m4rs48lg2elVB52xU
  datatype: string
  max count: 1
property:
  path: eventName
  name: event name
  description: Event Name - The name assigned to the custom conversion event. Example values: form_fill , start_quiz , quiz_complete , order_sample , answer_question , request_consultation
  datatype: string
  max count: 1
property:
  path: eventTimestamp
  name: event timestamp
  description: Event Timestamp - The time the custom conversion event occurred. Formatted according to the ISO 8601 international standard . Example value: 2022-06-15T19:26:30.000Z
  datatype: dateTime
  max count: 1
property:
  path: attributionModel
  name: attribution model
  description: Attribution Model - The attribution model used. By default Triple Attribution . Possible values: Total Impact , Triple Attribution , Triple Attribution + Views , Clicks & Views , Linear All , Linear Paid , First Click , Last Click
  datatype: string
  max count: 1
property:
  path: sessionId
  name: session id
  description: Session ID - The unique session ID assigned by Triple Pixel. Example value: cltlok4y634IRw62AZ_1710700966152
  datatype: string
  max count: 1
property:
  path: tripleId
  name: triple id
  description: Triple Pixel ID - The unique ID assigned by Triple Pixel to track visitors across sessions. Example value: eltlok4y634IRw62AZ
  datatype: string
  max count: 1
property:
  path: eventValue
  name: event value
  description: Event Conversion Value - The monetary conversion value assigned to the custom conversion event.
  datatype: double
  max count: 1
property:
  path: linearWeight
  name: linear weight
  description: Linear Weight - The weight assigned to the event when using linear attribution models.
  datatype: double
  max count: 1

PixelCustomEventShape
type: NodeShape
target class: PixelCustomEvent
property:
  path: eventHour
  name: event hour
  description: Event Hour - The hour of the day the pixel custom 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: 07 , 16 , 21
  datatype: string
  max count: 1
property:
  path: eventDate
  name: event date
  description: Event Date - The date the pixel custom 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).
  datatype: date
  max count: 1
property:
  path: eventDateDay
  name: event date day
  description: Event Day - The day on which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateWeek
  name: event date week
  description: Event Week - The Sunday of the week during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateMonth
  name: event date month
  description: Event Month - The month during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateQuarter
  name: event date quarter
  description: Event Quarter - The first month of the quarter during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateYear
  name: event date year
  description: Event Year - The year during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: data
  name: data
  description: Pixel Custom Event Data - The full data payload in raw JSON format, including all event properties defined for the custom event. Learn more about querying pixel custom event data
  node: ContainerShape
  class: Container
  node kind: BlankNodeOrIRI
  max count: 1
property:
  path: eventName
  name: event name
  description: Event Name - The name assigned to the custom event. Example values: form_fill , start_quiz , quiz_complete , order_sample , answer_question , request_consultation
  datatype: string
  max count: 1
property:
  path: eventTimestamp
  name: event timestamp
  description: Event Timestamp - The time the custom event occurred. Formatted according to the ISO 8601 international standard . Example value: 2022-06-15T19:26:30.000Z
  datatype: dateTime
  max count: 1
property:
  path: pageViewEventId
  name: page view event id
  description: Page View Event ID - The unique ID for the page view event during which the custom event occurred. Assigned by Triple Pixel. Example value: 9m4rs48lg2elVB52xU
  datatype: string
  max count: 1
property:
  path: tripleId
  name: triple id
  description: Triple Pixel ID - The unique ID assigned by Triple Pixel to track visitors across sessions. Example value: eltlok4y634IRw62AZ
  datatype: string
  max count: 1
property:
  path: count
  name: count
  description: Pixel Custom Events - The total number of pixel custom events recorded within the selected timeframe.
  datatype: string
  max count: 1

PixelJoinedShape
type: NodeShape
target class: PixelJoined
property:
  path: cityFilter
  name: city filter
  description: City Filter - Filters results by city.
  datatype: string
  max count: 1
property:
  path: countryFilter
  name: country filter
  description: Country Filter - Filters results by country.
  datatype: string
  max count: 1
property:
  path: includeCustomAdSpend
  name: include custom ad spend
  description: Include Custom Ad Spend - Includes custom ad spend in the spend column. Possible: true , false
  datatype: string
  max count: 1
property:
  path: orderTagsFilter
  name: order tags filter
  description: Order Tags Filter - Filters orders by tags. Matches any order containing the specified comma-separated tags.
  datatype: string
  max count: 1
property:
  path: salesPlatformFilter
  name: sales platform filter
  description: Sales Platform Filter - Filter results by sales platform. Possible values: shopify , amazon , woocommerce , bigcommerce , walmart , tiktok-shops
  datatype: string
  max count: 1
property:
  path: subscriptionFilter
  name: subscription filter
  description: Subscription Filter - Filters results by subscription type. Possible values: subscription_first_order : Subscription First Order subscription_recurring_order : Subscription Recurring Order subscription_order : Subscription First Order + Subscription Recurring Order non_subscription_order : Non-Subscription Purchases non_subscription_recurring_order : Subscription First Order + Non-Subscription Purchases
  datatype: string
  max count: 1
property:
  path: useClickDate
  name: use click date
  description: Use Click Date - Uses click date instead of purchase date for event_date . Possible values: true , false
  datatype: date
  max count: 1
property:
  path: eventHour
  name: event hour
  description: Event Hour - The hour of the day on which the ad was run or the order was placed, 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: 07 , 16 , 21
  datatype: string
  max count: 1
property:
  path: eventDate
  name: event date
  description: Event Date - The date the ad was run or the order was placed. Based on the shop time zone at the moment of the event (or the user time zone, if no sales platform is connected).
  datatype: date
  max count: 1
property:
  path: eventDateDay
  name: event date day
  description: Event Day - The day on which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateWeek
  name: event date week
  description: Event Week - The Sunday of the week during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateMonth
  name: event date month
  description: Event Month - The month during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateQuarter
  name: event date quarter
  description: Event Quarter - The first month of the quarter during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateYear
  name: event date year
  description: Event Year - The year during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: accountId
  name: account id
  description: Ad Account ID - The unique ID for the ad account associated with the ad. Assigned by the ad platform. Example values: act_2168791943307744 , 18ce55770zl , 1986494684391480
  datatype: string
  max count: 1
property:
  path: adBidAmount
  name: ad bid amount
  description: Ad Bid Amount - The bid amount for the ad. Example values: 15 , 28 , 30
  datatype: string
  max count: 1
property:
  path: adCopy
  name: ad copy
  description: Ad Copy - The full text (copy) of the ad.
  datatype: string
  max count: 1
property:
  path: adId
  name: ad id
  description: Ad ID - The unique ad ID. Assigned by the ad platform. Example value: 120210439891110007
  datatype: string
  max count: 1
property:
  path: adImageUrl
  name: ad image url
  description: Ad Image URL - The URL of the ad image. Example value: https://www.example.com/ad-image.jpg
  datatype: anyURI
  max count: 1
property:
  path: adManagerUrl
  name: ad manager url
  description: Ad Manager URL - Direct link to this ad in the advertising platform (Facebook, Google Ads, etc.) for quick access to campaign management and performance data. Example value: https://adwords.google.com/aw/overview?campaignId=9117023204
  datatype: anyURI
  max count: 1
property:
  path: adName
  name: ad name
  description: Ad Name - The internal name of the ad within the ad platform. Example values: Kids Ad 1 , Blog 03/12/2023 , 10460_video_black_#5
  datatype: string
  max count: 1
property:
  path: adStatus
  name: ad status
  description: Ad Status - The status of the ad. Example values: ACTIVE , PAUSED
  datatype: string
  max count: 1
property:
  path: adTitle
  name: ad title
  description: Ad Title - The external, published title that viewers see when the ad is served. Example values: UP TO 50% OFF , The Hype Is Real , Trusted by 4 Million+ Women Worldwide
  datatype: string
  max count: 1
property:
  path: adType
  name: ad type
  description: Ad Type - The format of the ad. Example values: video , image , carousel , link , VIDEO , GRAPHIC Currently available for Meta and Axon.
  datatype: string
  max count: 1
property:
  path: adsetBidAmount
  name: adset bid amount
  description: Ad Set Bid Amount - The bid amount for the ad set. Example values: 25 , 35 , 40
  datatype: string
  max count: 1
property:
  path: adsetBidStrategy
  name: adset bid strategy
  description: Ad Set Bid Strategy - The bidding strategy for the ad set. Example values: LOWEST_COST_WITHOUT_CAP , LOWEST_COST_WITH_BID_CAP , COST_CAP , LOWEST_COST_WITH_MIN_ROAS
  datatype: string
  max count: 1
property:
  path: adsetId
  name: adset id
  description: Ad Set ID - The unique ID for the ad set associated with the ad click. Assigned by the ad platform. Example value: 120210439890740003
  datatype: string
  max count: 1
property:
  path: adsetName
  name: adset name
  description: Ad Set Name - The name of the ad set within a campaign. Example values: Broad Audience , Bracelets , Wellness
  datatype: string
  max count: 1
property:
  path: adsetStatus
  name: adset status
  description: Ad Set Status - The status of the ad set. Example values: ACTIVE , PAUSED
  datatype: string
  max count: 1
property:
  path: attributionWindow
  name: attribution window
  description: Attribution Window - The time frame for attributing conversions to the ad. By default lifetime . Example values: 1_day , 7_days , 14_days , 28_days , lifetime
  datatype: string
  max count: 1
property:
  path: campaignBidStrategy
  name: campaign bid strategy
  description: Campaign Bid Strategy - The bidding strategy for the campaign. Example values: LOWEST_COST_WITHOUT_CAP , LOWEST_COST_WITH_BID_CAP , COST_CAP , LOWEST_COST_WITH_MIN_ROAS
  datatype: string
  max count: 1
property:
  path: campaignId
  name: campaign id
  description: Campaign ID - The unique ID for the marketing campaign associated with the ad. Assigned by the ad platform. Example values: 23852438666180053 , 531011533 , 20620285829
  datatype: string
  max count: 1
property:
  path: campaignName
  name: campaign name
  description: Campaign Name - The name of the marketing campaign associated with the ad. Example values: Catalog Retargeting , US Generic Search , Breakfast of Champions Campaign
  datatype: string
  max count: 1

PixelKeywordsJoinedShape
type: NodeShape
target class: PixelKeywordsJoined
property:
  path: eventHour
  name: event hour
  description: Event Hour - The hour of the day on which the ad was run or the order was placed, 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: 07 , 16 , 21
  datatype: string
  max count: 1
property:
  path: eventDate
  name: event date
  description: Event Date - The date the ad was run or the order was placed. Based on the shop time zone at the moment of the event (or the user time zone, if no sales platform is connected).
  datatype: date
  max count: 1
property:
  path: eventDateDay
  name: event date day
  description: Event Day - The day on which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateWeek
  name: event date week
  description: Event Week - The Sunday of the week during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateMonth
  name: event date month
  description: Event Month - The month during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateQuarter
  name: event date quarter
  description: Event Quarter - The first month of the quarter during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateYear
  name: event date year
  description: Event Year - The year during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: accountId
  name: account id
  description: Ad Account ID - The unique ID for the ad account associated with the ad. Assigned by the ad platform. Example values: act_2168791943307744 , 18ce55770zl , 1986494684391480
  datatype: string
  max count: 1
property:
  path: adsetBidAmount
  name: adset bid amount
  description: Ad Set Bid Amount - The bid amount for the ad set. Example values: 25 , 35 , 40
  datatype: string
  max count: 1
property:
  path: adsetBidStrategy
  name: adset bid strategy
  description: Ad Set Bid Strategy - The bidding strategy for the ad set. Example values: LOWEST_COST_WITHOUT_CAP , LOWEST_COST_WITH_BID_CAP , COST_CAP , LOWEST_COST_WITH_MIN_ROAS
  datatype: string
  max count: 1
property:
  path: adsetId
  name: adset id
  description: Ad Set ID - The unique ID for the ad set associated with the ad click. Assigned by the ad platform. Example value: 120210439890740003
  datatype: string
  max count: 1
property:
  path: adsetName
  name: adset name
  description: Ad Set Name - The name of the ad set within a campaign. Example values: Broad Audience , Bracelets , Wellness
  datatype: string
  max count: 1
property:
  path: adsetStatus
  name: adset status
  description: Ad Set Status - The status of the ad set. Example values: ACTIVE , PAUSED
  datatype: string
  max count: 1
property:
  path: attributionWindow
  name: attribution window
  description: Attribution Window - The time frame for attributing conversions to the ad. By default lifetime . Example values: 1_day , 7_days , 14_days , 28_days , lifetime
  datatype: string
  max count: 1
property:
  path: campaignBidStrategy
  name: campaign bid strategy
  description: Campaign Bid Strategy - The bidding strategy for the campaign. Example values: LOWEST_COST_WITHOUT_CAP , LOWEST_COST_WITH_BID_CAP , COST_CAP , LOWEST_COST_WITH_MIN_ROAS
  datatype: string
  max count: 1
property:
  path: campaignId
  name: campaign id
  description: Campaign ID - The unique ID for the marketing campaign associated with the ad. Assigned by the ad platform. Example values: 23852438666180053 , 531011533 , 20620285829
  datatype: string
  max count: 1
property:
  path: campaignName
  name: campaign name
  description: Campaign Name - The name of the marketing campaign associated with the ad. Example values: Catalog Retargeting , US Generic Search , Breakfast of Champions Campaign
  datatype: string
  max count: 1
property:
  path: campaignStatus
  name: campaign status
  description: Campaign Status - The status of the campaign. Example values: ACTIVE , PAUSED
  datatype: string
  max count: 1
property:
  path: campaignType
  name: campaign type
  description: Campaign Type - The type of campaign. For Email/SMS data, this maps to report_type . Example values: PERFORMANCE_MAX , SEARCH , flow , campaign
  datatype: string
  max count: 1
property:
  path: channel
  name: channel
  description: Channel - The platform through which the ad was delivered. Example values: facebook-ads , google-ads , Direct
  datatype: string
  max count: 1
property:
  path: country
  name: country
  description: Session Country - The country of the session where the order originated. See list of countries . Example values: United States , Canada , United Kingdom
  datatype: string
  max count: 1
property:
  path: msCountry
  name: ms country
  description: MS Session Country - The marketplace country code of the session. See list of countries . Example values: US , CA , GB
  datatype: string
  max count: 1
property:
  path: keywordId
  name: keyword id
  description: Keyword ID - The unique ID assigned to the keyword by the ad platform, captured by Triple Pixel from the ad URL. Example value: 313990984637674
  datatype: string
  max count: 1
property:
  path: keywordMatchType
  name: keyword match type
  description: Keyword Match Type - How closely a user’s search query must match the keyword. Possible values: EXACT , PHRASE , BROAD
  datatype: string
  max count: 1
property:
  path: keywordStatus
  name: keyword status
  description: Keyword Status - The status of the keyword. Possible values: ENABLED , PAUSED , REMOVED
  datatype: string
  max count: 1
property:
  path: keywordSystemServingStatus
  name: keyword system serving status
  description: Keyword System Serving Status - Indicates whether the keyword is currently eligible to serve. Possible values: ELIGIBLE , RARELY_SERVED
  datatype: string
  max count: 1
property:
  path: keywordText
  name: keyword text
  description: Keyword Text - The text of the keyword as entered in the ad platform. Example values: running shoes , cheap flights , best coffee
  datatype: string
  max count: 1
property:
  path: attributionModel
  name: attribution model
  description: Attribution Model - The attribution model used. By default Triple Attribution . Possible values: Total Impact , Triple Attribution , Triple Attribution + Views , Clicks & Views , Linear All , Linear Paid , First Click , Last Click
  datatype: string
  max count: 1
property:
  path: shopId
  name: shop id
  description: Shop ID - The unique ID of the shop (often corresponds to the shop domain). Can be used to group or filter data by shop in multi-store reports. Example values: example-US.myshopify.com , example-EU.myshopify.com
  datatype: string
  max count: 1
property:
  path: shopName
  name: shop name
  description: Shop Name - The name of the shop. Can be used to group or filter data by shop in multi-store reports. Example values: example-US , example-EU
  datatype: string
  max count: 1
property:
  path: addToCarts
  name: add to carts
  description: Pixel Add to Carts - The number of unique users who triggered an Add-to-Cart event, as reported by the Pixel.
  datatype: double
  max count: 1
property:
  path: addresses
  name: addresses
  description: Address Details Submitted - The number of times users submitted address details during checkout.
  datatype: double
  max count: 1
property:
  path: adsetDailyBudget
  name: adset daily budget
  description: Ad Set Daily Budget - The daily budget (in cents) set for the ad set within a campaign. By default shown in the shop's currency. Example values: 1750 , 6000 , 40000
  datatype: long
  max count: 1

PixelOrderShape
type: NodeShape
target class: PixelOrder
property:
  path: eventHour
  name: event hour
  description: Event Hour - The hour of the day the order was placed, 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: 07 , 16 , 21
  datatype: string
  max count: 1
property:
  path: eventDate
  name: event date
  description: Event Date - The date the order was placed. Based on the shop time zone at the moment of the event (or the user time zone, if no sales platform is connected).
  datatype: date
  max count: 1
property:
  path: eventDateDay
  name: event date day
  description: Event Day - The day on which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateWeek
  name: event date week
  description: Event Week - The Sunday of the week during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateMonth
  name: event date month
  description: Event Month - The month during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateQuarter
  name: event date quarter
  description: Event Quarter - The first month of the quarter during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateYear
  name: event date year
  description: Event Year - The year during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: accountId
  name: account id
  description: Ad Account ID - The unique ID for the ad account associated with the ad. Assigned by the ad platform. Example values: act_2168791943307744 , 18ce55770zl , 1986494684391480
  datatype: string
  max count: 1
property:
  path: adId
  name: ad id
  description: Ad ID - The unique ad ID. Assigned by the ad platform. Example value: 120210439891110007
  datatype: string
  max count: 1
property:
  path: adName
  name: ad name
  description: Ad Name - The name of the ad. Example values: Kids Ad 1 , Read Our Latest Blog 03/12/2023 , 8 best fall looks
  datatype: string
  max count: 1
property:
  path: adsetId
  name: adset id
  description: Ad Set ID - The unique ID for the ad set associated with the ad click. Assigned by the ad platform. Example value: 120210439890740003
  datatype: string
  max count: 1
property:
  path: adsetName
  name: adset name
  description: Ad Set Name - The name of the ad set within a campaign. Example values: Broad Audience , Bracelets , Wellness
  datatype: string
  max count: 1
property:
  path: attributionWindow
  name: attribution window
  description: Attribution Window - The time frame for attributing conversions to the ad. By default lifetime . Example values: 1_day , 7_days , 14_days , 28_days , lifetime Note: group by attribution_window is unavailable on the Pixel Orders table.
  datatype: string
  max count: 1
property:
  path: billingCity
  name: billing city
  description: Billing City - The city of the customer's billing address. Example value: San Francisco
  datatype: string
  max count: 1
property:
  path: billingCountry
  name: billing country
  description: Billing Country - The full name of the customer's billing country. See list of countries . Example values: United States , Canada , United Kingdom
  datatype: string
  max count: 1
property:
  path: billingCountryCode
  name: billing country code
  description: Billing Country Code - The country code of the customer's billing address. See list of countries . Example values: US , CA , GB
  datatype: string
  max count: 1
property:
  path: billingProvince
  name: billing province
  description: Billing State - The state or province of the customer's billing address. Example values: Oregon , British Columbia , Michigan
  datatype: string
  max count: 1
property:
  path: browser
  name: browser
  description: Web Browser - The web browser of the session where the order originated. Example values: Chrome , Firefox , Safari
  datatype: string
  max count: 1
property:
  path: campaignId
  name: campaign id
  description: Campaign ID - The unique ID for the marketing campaign associated with the ad. Assigned by the ad platform. Example values: 23852438666180053 , 531011533 , 20620285829
  datatype: string
  max count: 1
property:
  path: campaignName
  name: campaign name
  description: Campaign Name - The name of the marketing campaign associated with the ad. Example values: Catalog Retargeting , US Generic Search , Breakfast of Champions Campaign
  datatype: string
  max count: 1
property:
  path: campaignType
  name: campaign type
  description: Campaign Type - The type of campaign. Example values: PERFORMANCE_MAX , SEARCH , VIDEO , DEMAND_GEN
  datatype: string
  max count: 1
property:
  path: cancelledAt
  name: cancelled at
  description: Cancelled Date - The time at which the order was canceled. Formatted according to the ISO 8601 international standard . NULL if the order was not canceled. \n \nExample value: 2022-06-15T19:26:30.000Z
  datatype: dateTime
  max count: 1
property:
  path: channel
  name: channel
  description: Channel - The platform through which the ad was delivered. Example values: facebook-ads , tiktok-ads , Direct
  datatype: string
  max count: 1
property:
  path: clickDate
  name: click date
  description: Click Date - The date the ad was clicked. Based on the shop time zone at the moment of the click. Example value: 2024-10-26
  datatype: date
  max count: 1
property:
  path: clickTs
  name: click ts
  description: Click Timestamp - The time at which the ad was clicked. Formatted according to the ISO 8601 international standard . Example value: 2024-10-26 20:03:48
  datatype: dateTime
  max count: 1
property:
  path: createdAt
  name: created at
  description: Order Created Date - The time at which the order record was created. Formatted according to the ISO 8601 international standard . Example value: 2022-06-15T19:26:30.000Z
  datatype: dateTime
  max count: 1
property:
  path: currency
  name: currency
  description: Order Currency - The original currency of the order, before conversion to the shop's currency. All monetary values are automatically converted to the shop's selected currency for display. Example values: USD , GBP , EUR
  datatype: string
  max count: 1
property:
  path: customerEmail
  name: customer email
  description: Customer Email - The customer's email address. Example value: [email protected]
  datatype: string
  max count: 1
property:
  path: customerFirstName
  name: customer first name
  description: Customer First Name - The customer's first name. Example value: John
  datatype: string
  max count: 1
property:
  path: customerFromCity
  name: customer from city
  description: Customer City - The city of the customer's shipping address. Example value: San Francisco
  datatype: string
  max count: 1
property:
  path: customerFromCountryCode
  name: customer from country code
  description: Customer Country - The country code of the customer's default address. See list of countries . Example values: US , CA , GB
  datatype: string
  max count: 1
property:
  path: customerFromCountryName
  name: customer from country name
  description: Customer Country Name - The full name of the customer's country. See list of countries . Example values: United States , Canada , United Kingdom
  datatype: string
  max count: 1
property:
  path: customerFromStateCode
  name: customer from state code
  description: Customer State - The state or province of the customer's shipping address. Example value: CA
  datatype: string
  max count: 1

PixelOrderProductsInfoShape
type: NodeShape
target class: PixelOrderProductsInfo
property:
  path: productId
  name: product id
  description: Product ID - The unique ID of the product as set within the main sales platform. Example value: 3891505496131
  datatype: string
  max count: 1
property:
  path: productName
  name: product name
  description: Product Name - The name of the product as set within the main sales platform. Example values: Green Soft Socks 3-Pack , Paring Knife Travel Case , Gift Subscription
  datatype: string
  max count: 1
property:
  path: vendor
  name: vendor
  description: Product Vendor - The vendor of the product as set within the main sales platform. Example values: Acme , XYZ Corp , Brandless
  datatype: string
  max count: 1
property:
  path: productType
  name: product type
  description: Product Type - The product type as set within the main sales platform. Example values: Jackets , Coffee Mugs , Books
  datatype: string
  max count: 1
property:
  path: productTags
  name: product tags
  description: Product Tags - Tags associated with the product, set in the main sales platform. Example values: Upsell , Order Credits , discount_eligible
  datatype: string
property:
  path: productSku
  name: product sku
  description: Product SKU - The SKU (Stock Keeping Unit) for the product as set within the main sales platform. Example values: GP-BACK-02 , A02630 , POP200NAVY
  datatype: string
  max count: 1
property:
  path: variantId
  name: variant id
  description: Product Variant ID - The unique ID for a specific variant of a product as set within the main sales platform. Example value: 29275946877001
  datatype: string
  max count: 1
property:
  path: isGiftCard
  name: is gift card
  description: Is Gift Card - True if the product purchased is a gift card. Possible values: true , false
  datatype: boolean
  max count: 1
property:
  path: properties
  name: properties
  description: Product Properties - Custom key–value properties attached to the product line item (e.g., personalization details, bundle metadata, app-specific fields).
  node: ContainerShape
  class: Container
  node kind: BlankNodeOrIRI
property:
  path: propertiesName
  name: properties name
  description: Product Property Name - The name or key of the product property.
  datatype: string
  max count: 1
property:
  path: propertiesValue
  name: properties value
  description: Product Property Value - The value assigned to the product property.
  datatype: string
  max count: 1
property:
  path: duties
  name: duties
  description: Product Duties - Import duties or tariffs applied to the product.
  node: ContainerShape
  class: Container
  node kind: BlankNodeOrIRI
property:
  path: dutiesDutyId
  name: duties duty id
  description: Product Duty ID - The unique identifier of the duty applied to the product.
  datatype: string
  max count: 1
property:
  path: dutiesTaxLines
  name: duties tax lines
  description: Product Duty Tax Lines - Tax lines charged on the product duty.
  node: ContainerShape
  class: Container
  node kind: BlankNodeOrIRI
property:
  path: dutiesTaxLinesPrice
  name: duties tax lines price
  description: Product Duty Tax Line Amount - The tax amount charged on the product duty per tax line.
  datatype: double
  max count: 1
property:
  path: dutiesPrice
  name: duties price
  description: Product Duty Amount - The monetary amount of duty charged for the product.'
  datatype: double
  max count: 1
property:
  path: productNamePrice
  name: product name price
  description: Product Price - The price of a single product (to the buyer).
  datatype: double
  max count: 1
property:
  path: discountAmountForProduct
  name: discount amount for product
  description: Total Product Discount - The amount discounted from the product price, before taxes. By default shown in the shop's currency.
  datatype: double
  max count: 1
property:
  path: netDiscountAmountForProduct
  name: net discount amount for product
  description: Net Product Discount - The amount discounted from the product price, after taxes. By default shown in the shop's currency.
  datatype: double
  max count: 1
property:
  path: productNameQuantitySold
  name: product name quantity sold
  description: Product Units Sold - The total number of individual units sold for the product.
  datatype: double
  max count: 1
property:
  path: singleProductCost
  name: single product cost
  description: Product Cost - The cost of a single product (to the seller).
  datatype: double
  max count: 1

PostPurchaseSurveyShape
type: NodeShape
target class: PostPurchaseSurvey
property:
  path: eventHour
  name: event hour
  description: Event Hour - The hour of the day the post-purchase survey was submitted, 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: 07 , 16 , 21
  datatype: string
  max count: 1
property:
  path: eventDate
  name: event date
  description: Event Date - The date the post-purchase survey was submitted. Based on the shop time zone at the moment of the event (or the user time zone, if no sales platform is connected).
  datatype: date
  max count: 1
property:
  path: eventDateDay
  name: event date day
  description: Event Day - The day the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateWeek
  name: event date week
  description: Event Week - The Sunday of the week during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateMonth
  name: event date month
  description: Event Month - The month during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateQuarter
  name: event date quarter
  description: Event Quarter - The first month of the quarter during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateYear
  name: event date year
  description: Event Year - The year during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: answer
  name: answer
  description: Answer - The response provided by the customer to the survey question. Example values: Online search , Social media , From a friend
  datatype: string
  max count: 1
property:
  path: customerEmail
  name: customer email
  description: Customer Email - The customer’s email address. Example value: [email protected]
  datatype: string
  max count: 1
property:
  path: customerId
  name: customer id
  description: Customer ID - The unique customer ID. Assigned by the main shop platform. Example value: 5209503793328
  datatype: string
  max count: 1
property:
  path: customerPhone
  name: customer phone
  description: Customer Phone - The customer's phone number. Example value: 18005550199
  datatype: string
  max count: 1
property:
  path: orderId
  name: order id
  description: Order ID - The unique order ID. Assigned by the main shop platform. Example value: 4930225799243
  datatype: string
  max count: 1
property:
  path: question
  name: question
  description: Survey Question - The specific survey question asked to the customer. Example value: How did you first hear about us?
  datatype: string
  max count: 1
property:
  path: questionType
  name: question type
  description: Question Type - The type of the question asked. Example values: standard , custom
  datatype: string
  max count: 1
property:
  path: shopId
  name: shop id
  description: Shop ID - The unique ID of the shop (often corresponds to the shop domain). Can be used to group or filter data by shop in multi-store reports. Example values: example-US.myshopify.com , example-EU.myshopify.com
  datatype: string
  max count: 1
property:
  path: shopName
  name: shop name
  description: Shop Name - The name of the shop. Can be used to group or filter data by shop in multi-store reports. Example values: example-US , example-EU
  datatype: string
  max count: 1
property:
  path: source
  name: source
  description: Source - The traffic source or referral channel that directed the customer to the survey. Example values: google-ads , facebook-ads , snapchat-ads See full list of standardized PPS source IDs
  datatype: string
  max count: 1
property:
  path: surveyType
  name: survey type
  description: Survey Type (Platform) - The post-purchase survey platform used. Example values: KNO , TW-survey , FAIRING
  datatype: string
  max count: 1

ProductAnalyticsShape
type: NodeShape
target class: ProductAnalytics
property:
  path: includeAmazon
  name: include amazon
  description: Include Amazon - Includes Amazon sales data in the results, in addition to the main sales platform. Possible values: true , false Defaults to false .
  datatype: string
  max count: 1
property:
  path: includeFreeProducts
  name: include free products
  description: Include Free Products - Includes products considered "free" based on multi-item discounts. Possible values: true , false Defaults to false . Set to true to match order-based totals with the Summary page. Note: Some discounts are spread across multiple items in an order; if the discount fully covers the price of some of the items, those items are counted as “free".
  datatype: string
  max count: 1
property:
  path: includeNonActiveProducts
  name: include non active products
  description: Include Non-Active Products - Includes non-active (e.g. draft or pending) products. Possible values: true , false Defaults to false . Set to true to match order-based totals with the Summary page.
  datatype: string
  max count: 1
property:
  path: eventDate
  name: event date
  description: Event Date - The date the order was placed. Based on the shop time zone at the moment of the event (or the user time zone, if no sales platform is connected).
  datatype: date
  max count: 1
property:
  path: eventDateDay
  name: event date day
  description: Event Day - The day on which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateWeek
  name: event date week
  description: Event Week - The Sunday of the week during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateMonth
  name: event date month
  description: Event Month - The month during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateQuarter
  name: event date quarter
  description: Event Quarter - The first month of the quarter during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateYear
  name: event date year
  description: Event Year - The year during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: collectionId
  name: collection id
  description: Collection ID - The unique ID of the collection as defined in the sales platform. Example value: 123456789
  datatype: string
  max count: 1
property:
  path: collectionName
  name: collection name
  description: Collection Name - The name of the collection as defined in the sales platform. Example values: Summer Gift Guide , Long-Sleeve Packs , Christmas Collection
  datatype: string
  max count: 1
property:
  path: entity
  name: entity
  description: Entity Type - The entity type of the item. Example values: product , variant , product_collection
  datatype: string
  max count: 1
property:
  path: id
  name: id
  description: ID - The unique ID of the item for the current row. The value depends on the granularity level of the query (variant-level granularity → variant_id ; product-level granularity → product_id ; collection-level granularity → collection_id ). Example value: 3891505496131
  datatype: string
  max count: 1
property:
  path: inventoryQuantity
  name: inventory quantity
  description: Inventory Quantity - The current inventory quantity of the product or variant. Example values: 21749 , 57 , 332
  datatype: string
  max count: 1
property:
  path: name
  name: name
  description: Name - The name of the item for the current row. The value depends on the granularity level of the query (variant-level granularity → variant_name ; product-level granularity → product_name ; collection-level granularity → collection_name ). Example values: Paring Knife Travel Case , Forest Green , Christmas Collection
  datatype: string
  max count: 1
property:
  path: productId
  name: product id
  description: Product ID - The unique ID of the product as defined in the sales platform. Example value: 3891505496131
  datatype: string
  max count: 1
property:
  path: productImageUrl
  name: product image url
  description: Product Image URL - The URL of the product image.
  datatype: anyURI
  max count: 1
property:
  path: productName
  name: product name
  description: Product Name - The name of the product as defined in the sales platform. This value is always product-level (e.g., “T-Shirt”, “Hoodie”) even when querying variant-level granularity, ensuring each variant row also shows the product it belongs to. Example values: Green Soft Socks 3-Pack , Paring Knife Travel Case , Gift Subscription
  datatype: string
  max count: 1
property:
  path: productTags
  name: product tags
  description: Product Tags - Tags associated with the product, assigned by the seller in the sales platform. Example values: 3-pack , Sale , discount_eligible
  datatype: string
property:
  path: shopId
  name: shop id
  description: Shop ID - The unique ID of the shop (often corresponds to the shop domain). Can be used to group or filter data by shop in multi-store reports. Example values: example-US.myshopify.com , example-EU.myshopify.com
  datatype: string
  max count: 1
property:
  path: shopName
  name: shop name
  description: Shop Name - The name of the shop. Can be used to group or filter data by shop in multi-store reports. Example values: example-US , example-EU
  datatype: string
  max count: 1
property:
  path: sku
  name: sku
  description: SKU - The SKU (Stock Keeping Unit) for the product or variant as set within the main sales platform. Example values: GP-BACK-02 , A02630 , POP200NAVY
  datatype: string
  max count: 1
property:
  path: variantId
  name: variant id
  description: Variant ID - The unique ID of the variant as set within the main sales platform. Example value: 33193425920151
  datatype: string
  max count: 1
property:
  path: variantName
  name: variant name
  description: Variant Name - The name of the variant as defined in the main sales platform. Example values: Forest Green , M , iPhone 14 Pro
  datatype: string
  max count: 1
property:
  path: vendor
  name: vendor
  description: Vendor - The vendor of the product or variant. Example values: Route , Canon , Corso , MyShop
  datatype: string
  max count: 1
property:
  path: addedToCartEvents
  name: added to cart events
  description: Added to Cart Events - Number of times the product or variant was added to a cart. Adding multiple units in a single action counts as one event.
  datatype: double
  max count: 1
property:
  path: addedToCartItems
  name: added to cart items
  description: Added to Cart Items - Total quantity of the product or variant added to carts. Each unit counts individually, even when multiple units are added in a single action.
  datatype: double
  max count: 1
property:
  path: clicks
  name: clicks
  description: Clicks - Total number of ad clicks attributed to the product or variant, based on its share of units sold per ad. Clicks for Product = (Units Sold for Product / Units Sold for Ad) × Clicks for Ad, summed across all relevant ads and campaigns.
  datatype: double
  max count: 1
property:
  path: customers
  name: customers
  description: Customers - Total number of unique customers who purchased the product or variant.
  datatype: double
  max count: 1
property:
  path: fulfillmentCosts
  name: fulfillment costs
  description: Fulfillment Costs - Total costs associated with fulfilling orders that include the product or variant. By default shown in the shop's currency. Fulfillment Costs = Cost of Goods + Handling Fees + (Shipping Price + Payment Gateway Costs) / Total Items in Order × Units Sold Cost of Goods, Handling Fees, and Payment Gateway Costs are configured in Cost Settings . Shipping Price is the amount the customer paid at checkout.
  datatype: double
  max count: 1
property:
  path: impressions
  name: impressions
  description: Impressions - Total number of ad impressions attributed to the product or variant, based on its share of units sold per ad. Impressions for Product = (Units Sold for Product / Units Sold for Ad) × Impressions for Ad, summed across all relevant ads and campaigns.
  datatype: double
  max count: 1
property:
  path: newCustomerFulfillmentCosts
  name: new customer fulfillment costs
  description: New Customer Fulfillment Costs - Total costs associated with fulfilling orders that include the product or variant, for orders placed by new customers. By default shown in the shop's currency. Fulfillment Costs = Cost of Goods + Handling Fees + (Shipping Price + Payment Gateway Costs) / Total Items in Order × Units Sold Cost of Goods, Handling Fees, and Payment Gateway Costs are configured in Cost Settings . Shipping Price is the amount the customer paid at checkout. Learn how Triple Whale classifies new/returning customers .
  datatype: double
  max count: 1
property:
  path: newCustomerOrders
  name: new customer orders
  description: New Customer Orders - The total number of orders by new customers that contain the product or variant. Learn how Triple Whale classifies new/returning customers .
  datatype: double
  max count: 1
property:
  path: newCustomerRevenue
  name: new customer revenue
  description: New Customer Revenue - The total revenue derived from orders by new customers that contain the product or variant. Learn how Triple Whale classifies new/returning customers .
  datatype: double
  max count: 1

ProductShape
type: NodeShape
target class: Product
property:
  path: collections
  name: collections
  description: Collections - Collections the product belongs to, as set within the main sales platform. Example values: Summer Gift Guide , Long-Sleeve Packs , Christmas Collection
  datatype: string
property:
  path: images
  name: images
  description: Product Images - Images associated with the product, with details such as image position, dimensions, and source URL.
  node: ProductImageShape
  class: ProductImage
  node kind: BlankNodeOrIRI
property:
  path: integrationId
  name: integration id
  description: Integration ID - The unique identifier for the integration (store connection) that this product belongs to.
  datatype: string
  max count: 1
property:
  path: platform
  name: platform
  description: Platform - The platform or marketplace where the product is listed. Example values: shopify , amazon , custom
  datatype: string
  max count: 1
property:
  path: productDescription
  name: product description
  description: Product Description - The description of the product as written by the seller. Example values: Classic everyday denim designed for comfort and versatility, featuring premium stretch fabric, durable stitching, and a timeless silhouette suitable for any wardrobe.
  datatype: string
  max count: 1
property:
  path: productId
  name: product id
  description: Product ID - The unique ID of the product as set within the main sales platform. Example value: 3891505496131
  datatype: string
  max count: 1
property:
  path: productImageUrl
  name: product image url
  description: Primary Product Image - The URL of the primary product image. Example values: https://cdn.shopify.com/.../product1.jpg , https://m.media-amazon.com/.../image1.jpg
  datatype: anyURI
  max count: 1
property:
  path: productName
  name: product name
  description: Product Name - The name (or title) of the product as set within the main sales platform. Example values: Green Soft Socks 3-Pack , Paring Knife Travel Case , Gift Subscription
  datatype: string
  max count: 1
property:
  path: productStatus
  name: product status
  description: Product Status - The status of the product. Example values: active , draft , archived
  datatype: string
  max count: 1
property:
  path: productTags
  name: product tags
  description: Product Tags - Tags associated with the product, assigned by the seller in the main sales platform. Example values: 3-pack , Sale , discount_eligible
  datatype: string
property:
  path: productType
  name: product type
  description: Product Type - The product type as set within the main sales platform. Example values: Jackets , Coffee Mugs , Books
  datatype: string
  max count: 1
property:
  path: shopId
  name: shop id
  description: Shop ID - The unique ID of the shop (often corresponds to the shop domain). Can be used to group or filter data by shop in multi-store reports. Example values: example-US.myshopify.com , example-EU.myshopify.com
  datatype: string
  max count: 1
property:
  path: shopName
  name: shop name
  description: Shop Name - The name of the shop. Can be used to group or filter data by shop in multi-store reports. Example values: example-US , example-EU
  datatype: string
  max count: 1
property:
  path: variants
  name: variants
  description: Product Variants - Details about the product variants associated with the order.
  node: ProductVariantShape
  class: ProductVariant
  node kind: BlankNodeOrIRI
property:
  path: vendor
  name: vendor
  description: Vendor - The vendor of the product variant. Example values: Route , Canon , Corso , MyShop
  datatype: string
  max count: 1
property:
  path: productInventoryQuantity
  name: product inventory quantity
  description: Product Inventory Quantity - The number of items in stock for the product. Example values: 100 , 50 , 0
  datatype: double
  max count: 1

ProductImageShape
type: NodeShape
target class: ProductImage
property:
  path: imagePosition
  name: image position
  description: Image Position - The position of the image in the product gallery. Example values: 1 , 5 , 19 , 43
  datatype: string
  max count: 1
property:
  path: imageWidth
  name: image width
  description: Image Width - The width of the image in pixels. Example values: 500 , 1080 , 1500 , 2048
  datatype: nonNegativeInteger
  max count: 1
property:
  path: imageHeight
  name: image height
  description: Image Height - The height of the image in pixels. Example values: 500 , 1080 , 1500 , 2048
  datatype: nonNegativeInteger
  max count: 1
property:
  path: imageSrc
  name: image src
  description: Image Source - The URL of the product image. Example values: https://cdn.shopify.com/.../product1.jpg , https://m.media-amazon.com/.../image1.jpg
  datatype: anyURI
  max count: 1

ProductVariantShape
type: NodeShape
target class: ProductVariant
property:
  path: variantId
  name: variant id
  description: Variant ID - The unique ID of the product variant as set within the main sales platform. Example value: 47095335813393
  datatype: string
  max count: 1
property:
  path: variantName
  name: variant name
  description: Variant Name - The name (or title) of the product variant as set within the main sales platform. Example values: 36 S , Titanium / Mild , Black Leather
  datatype: string
  max count: 1
property:
  path: variantDescription
  name: variant description
  description: Variant Description - The description of the product variant. Only supported for Amazon products. Example values: High-rise skinny fit in stretch denim, designed to sit at the natural waist for a flattering, sculpted silhouette.
  datatype: string
  max count: 1
property:
  path: sku
  name: sku
  description: Variant SKU - The SKU (Stock Keeping Unit) for the product variant as set within the main sales platform. Example values: GP-BACK-02 , A02630 , POP200NAVY
  datatype: string
  max count: 1
property:
  path: variantPrice
  name: variant price
  description: Variant Price - The price of a single product variant (to the buyer). Example values: 69.99 , 10 , 1200
  datatype: double
  max count: 1
property:
  path: variantInventoryQuantity
  name: variant inventory quantity
  description: Variant Inventory Quantity - The number of items in stock for the product variant. Example values: 100 , 50 , 0
  datatype: double
  max count: 1

RefundShape
type: NodeShape
target class: Refund
property:
  path: eventHour
  name: event hour
  description: Event Hour - The hour of the day the refund was processed, 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: 07 , 16 , 21
  datatype: string
  max count: 1
property:
  path: eventDate
  name: event date
  description: Event Date - The date the refund was processed. Based on the shop time zone at the moment of the event (or the user time zone, if no sales platform is connected).
  datatype: date
  max count: 1
property:
  path: eventDateDay
  name: event date day
  description: Event Day - The day on which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateWeek
  name: event date week
  description: Event Week - The Sunday of the week during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateMonth
  name: event date month
  description: Event Month - The month during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateQuarter
  name: event date quarter
  description: Event Quarter - The first month of the quarter during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateYear
  name: event date year
  description: Event Year - The year during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: orderDate
  name: order date
  description: Order Date - The date the original order was processed. Example value: 2025-02-12
  datatype: date
  max count: 1
property:
  path: orderId
  name: order id
  description: Order ID - The unique ID for the original order that was issued a refund. Assigned by the shop platform. Example value: 6024492815432
  datatype: string
  max count: 1
property:
  path: platform
  name: platform
  description: Sales Platform - The sales platform where the order was processed. Example values: Shopify , BigCommerce , WooCommerce , Amazon
  datatype: string
  max count: 1
property:
  path: productsInfo
  name: products info
  description: Products - Details about the products associated with the order (at the level of the variant), including name, product ID, variant ID, type, SKU, etc. Returns the latest product information, not necessarily the data at the time the order was placed.
  node: RefundProductsInfoShape
  class: RefundProductsInfo
  node kind: BlankNodeOrIRI
property:
  path: refundOrderAdjustment
  name: refund order adjustment
  description: Refund Order Adjustments - List of refund order adjustments applied to the order. There may be multiple adjustments per order.
  node: RefundOrderAdjustmentShape
  class: RefundOrderAdjustment
  node kind: BlankNodeOrIRI
property:
  path: shopId
  name: shop id
  description: Shop ID - The unique ID of the shop (often corresponds to the shop domain). Can be used to group or filter data by shop in multi-store reports. Example values: example-US.myshopify.com , example-EU.myshopify.com
  datatype: string
  max count: 1
property:
  path: shopName
  name: shop name
  description: Shop Name - The name of the shop. Can be used to group or filter data by shop in multi-store reports. Example values: example-US , example-EU
  datatype: string
  max count: 1
property:
  path: sourceName
  name: source name
  description: Source - The origin of the order as designated by the seller on the main sales platform. Example values: web , pos , tiktok
  datatype: string
  max count: 1
property:
  path: tags
  name: tags
  description: Tags - Tags associated with the order, assigned by the seller on the main sales platform. Example values: Upsell , Order Credits , discount_eligible
  datatype: string
property:
  path: updatedAt
  name: updated at
  description: Updated At - The time at which the refund record was last updated. Formatted according to the ISO 8601 international standard . Example value: 2022-06-15T19:26:30.000Z
  datatype: dateTime
  max count: 1
property:
  path: totalRefundedCogs
  name: total refunded cogs
  description: Refunded COGS - Refunded cost of goods (COGS) amount for the selected time period. Calculated based on the refund date.
  datatype: double
  max count: 1
property:
  path: totalRefundedPrice
  name: total refunded price
  description: Refunded Sales - Refunded sales amount for the selected time period. Calculated based on the refund date. Note that Triple Whale does not track refunds from third-party return management apps (e.g., Loop), so totals may vary from the sales platform.
  datatype: double
  max count: 1
property:
  path: totalRefundedShipping
  name: total refunded shipping
  description: Refunded Shipping - Refunded shipping amount for the selected time period. Calculated based on the refund date.
  datatype: double
  max count: 1
property:
  path: totalRefundedTax
  name: total refunded tax
  description: Refunded Tax - Refunded tax amount for the selected time period. Calculated based on the refund date.
  datatype: double
  max count: 1

RefundProductsInfoShape
type: NodeShape
target class: RefundProductsInfo
property:
  path: productId
  name: product id
  description: Product ID - The unique ID of the product as set within the main sales platform. Example value: 3891505496131
  datatype: string
  max count: 1
property:
  path: productName
  name: product name
  description: Product Name - The name of the product as set within the main sales platform. Example values: Green Soft Socks 3-Pack , Paring Knife Travel Case , Gift Subscription
  datatype: string
  max count: 1
property:
  path: productSku
  name: product sku
  description: Product SKU - The SKU (Stock Keeping Unit) for the product, as set within the main sales platform. Example values: GP-BACK-02 , A02630 , POP200NAVY
  datatype: string
  max count: 1
property:
  path: variantId
  name: variant id
  description: Product Variant ID - The unique identifier for a specific variant of a product as set within the main sales platform. Example value: 29275946877001
  datatype: string
  max count: 1
property:
  path: isGiftCard
  name: is gift card
  description: Is Gift Card - True if the product purchased is a gift card. Possible values: true , false
  datatype: boolean
  max count: 1
property:
  path: properties
  name: properties
  description: Product Properties
  node: ContainerShape
  class: Container
  node kind: BlankNodeOrIRI
property:
  path: propertiesName
  name: properties name
  description: Product Property Name - The name or key of the product property.
  datatype: string
  max count: 1
property:
  path: propertiesValue
  name: properties value
  description: Product Property Value - The value assigned to the product property.
  datatype: string
  max count: 1
property:
  path: duties
  name: duties
  description: Product Duties - Import duties or tariffs applied to the product.
  node: ContainerShape
  class: Container
  node kind: BlankNodeOrIRI
property:
  path: dutiesDutyId
  name: duties duty id
  description: Product Duty ID - The unique identifier of the duty applied to the product.
  datatype: string
  max count: 1
property:
  path: dutiesPrice
  name: duties price
  description: Product Duty Amount - The monetary amount of duty charged for the product.'
  datatype: double
  max count: 1
property:
  path: dutiesTaxLines
  name: duties tax lines
  description: Product Duty Tax Lines - Tax lines charged on the product duty.
  node: ContainerShape
  class: Container
  node kind: BlankNodeOrIRI
property:
  path: dutiesTaxLinesPrice
  name: duties tax lines price
  description: Product Duty Tax Line Amount - The tax amount charged on the product duty per tax line.
  datatype: double
  max count: 1
property:
  path: productNamePrice
  name: product name price
  description: Product Price - The price of a single product (to the buyer), before discounts. By default shown in the shop's currency. Note: Tax will be included in the product price if the seller has configured the sale to require taxes in the main sales platform.
  datatype: double
  max count: 1
property:
  path: discountAmountForProduct
  name: discount amount for product
  description: Total Product Discount - The amount discounted from the product price, before taxes. By default shown in the shop's currency.
  datatype: double
  max count: 1
property:
  path: productNameQuantitySold
  name: product name quantity sold
  description: Product Units Sold - The total number of individual units sold for the product.
  datatype: double
  max count: 1
property:
  path: singleProductCost
  name: single product cost
  description: Product Cost - The cost of a single product (to the seller). By default shown in the shop's currency.
  datatype: double
  max count: 1

RefundOrderAdjustmentShape
type: NodeShape
target class: RefundOrderAdjustment
property:
  path: kind
  name: kind
  description: Order Adjustment Type - The order adjustment type. Valid values: shipping_refund : Refunds related to shipping charges. refund_discrepancy : Discrepancies in the refund amount.
  datatype: string
  max count: 1
property:
  path: orderAdjustmentTaxAmount
  name: order adjustment tax amount
  description: Order Adjustment Tax Amount - The taxes that are added to the order adjustment amount, such as applicable shipping taxes added to a shipping refund.
  datatype: double
  max count: 1
property:
  path: orderAdjustmentAmount
  name: order adjustment amount
  description: Order Adjustment Amount - The value of the discrepancy between the calculated refund and the actual refund. If the kind property's value is shipping_refund , then amount returns the value of shipping charges refunded to the customer.
  datatype: double
  max count: 1

ReviewShape
type: NodeShape
target class: Review
property:
  path: eventDate
  name: event date
  description: Event Date - The date the review was submitted. Based on the shop time zone at the moment of the event (or the user time zone, if no sales platform is connected).
  datatype: date
  max count: 1
property:
  path: eventDateDay
  name: event date day
  description: Event Day - The day on which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateWeek
  name: event date week
  description: Event Week - The Sunday of the week during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateMonth
  name: event date month
  description: Event Month - The month during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateQuarter
  name: event date quarter
  description: Event Quarter - The first month of the quarter during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateYear
  name: event date year
  description: Event Year - The year during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: attributesWithRating
  name: attributes with rating
  description: Attributes with Rating - A list of rating attributes within the review. Set in the reviews platform.
  node: AttributesWithRatingShape
  class: AttributesWithRating
  node kind: BlankNodeOrIRI
property:
  path: containsProfanity
  name: contains profanity
  description: Contains Profanity - True if the review contains profanity. Possible values: true , false
  datatype: boolean
  max count: 1
property:
  path: content
  name: content
  description: Content - The text content of the review. Example values: Fits nicely , Better quality than it looked in the pictures
  datatype: string
  max count: 1
property:
  path: id
  name: id
  description: Review ID - The unique identifier for the review. Example value: 948f450e-5b38-4a2e-ace6-470b7b5535cf
  datatype: string
  max count: 1
property:
  path: isRecommended
  name: is recommended
  description: Is Recommended - True if the product is recommended by the reviewer. Possible values: true , false
  datatype: boolean
  max count: 1
property:
  path: marketplace
  name: marketplace
  description: Marketplace - The marketplace where the review was submitted. Example value: shopify
  datatype: string
  max count: 1
property:
  path: orderId
  name: order id
  description: Order ID - The unique identifier for the order associated with the review. Example value: 4930225799243
  datatype: string
  max count: 1
property:
  path: platform
  name: platform
  description: Platform - The platform through which the review was submitted. Example values: okendo , yotpo
  datatype: string
  max count: 1
property:
  path: productId
  name: product id
  description: Product ID - The unique identifier of the reviewed product. Example value: 3891505496131
  datatype: string
  max count: 1
property:
  path: productName
  name: product name
  description: Product Name - The name of the reviewed product. Example values: Green Soft Socks 3-Pack , Paring Knife Travel Case , Gift Subscription
  datatype: string
  max count: 1
property:
  path: reviewType
  name: review type
  description: Review Type - The type of review submitted. Example value: product
  datatype: string
  max count: 1
property:
  path: reviewerAttributes
  name: reviewer attributes
  description: Reviewer Attributes - Attributes associated with the reviewer.
  node: ReviewerAttributeShape
  class: ReviewerAttribute
  node kind: BlankNodeOrIRI
property:
  path: reviewerCountryCode
  name: reviewer country code
  description: Reviewer Country Code - The country code of the reviewer. See list of countries . Example values: US , CA , GB
  datatype: string
  max count: 1
property:
  path: reviewerCountryName
  name: reviewer country name
  description: Reviewer Country Name - The full name of the reviewer's country. See list of countries . Example values: United States , Canada , United Kingdom
  datatype: string
  max count: 1
property:
  path: reviewerDisplayName
  name: reviewer display name
  description: Reviewer Display Name - The display name of the reviewer.
  datatype: string
  max count: 1
property:
  path: reviewerEmail
  name: reviewer email
  description: Reviewer Email - The email address of the reviewer.
  datatype: string
  max count: 1
property:
  path: reviewerIsVerified
  name: reviewer is verified
  description: Reviewer Is Verified - True if the reviewer is a verified customer. Possible values: true , false
  datatype: boolean
  max count: 1
property:
  path: reviewerName
  name: reviewer name
  description: Reviewer Name - The name of the reviewer.
  datatype: string
  max count: 1
property:
  path: reviewerVerifiedStatus
  name: reviewer verified status
  description: Reviewer Verified Status - The verification status of the reviewer.
  datatype: string
  max count: 1
property:
  path: sentiment
  name: sentiment
  description: Sentiment - The sentiment analysis result for the review content. Example values: positive , mixed , negative
  datatype: string
  max count: 1
property:
  path: status
  name: status
  description: Status - The status of the review. Example values: approved , published , unpublished
  datatype: string
  max count: 1
property:
  path: title
  name: title
  description: Title - The title of the review. Example values: Almost perfect , Would not recommend , Absolutely beautiful!
  datatype: string
  max count: 1
property:
  path: variantId
  name: variant id
  description: Variant ID - The unique identifier of the reviewed product variant. Example value: 29275946877001
  datatype: string
  max count: 1
property:
  path: helpfulCount
  name: helpful count
  description: Helpful Count - The number of helpful votes the review has received.
  datatype: double
  max count: 1
property:
  path: rating
  name: rating
  description: Rating - The rating score assigned by the reviewer.
  datatype: double
  max count: 1
property:
  path: unhelpfulCount
  name: unhelpful count
  description: Unhelpful Count - The number of unhelpful votes the review has received.
  datatype: double
  max count: 1

AttributesWithRatingShape
type: NodeShape
target class: AttributesWithRating
property:
  path: minLabel
  name: min label
  description: Minimum Rating Label - The label for the minimum rating value. Example values: Runs small , Disappointing
  datatype: string
  max count: 1
property:
  path: midLabel
  name: mid label
  description: Mid Label Rating - The label for the midpoint rating value. Example values: True to size , As expected
  datatype: string
  max count: 1
property:
  path: title
  name: title
  description: Title - The title of the rating attribute. Example values: Size Range , Quality
  datatype: string
  max count: 1
property:
  path: typeField
  name: type field
  description: Type - The type of the rating attribute. Example values: range , multi-select , single-select
  datatype: string
  max count: 1
property:
  path: value
  name: value
  description: Value - The rating value for the attribute. Example values: -1 , 0 , 0.5 , 2
  datatype: string
  max count: 1
property:
  path: maxLabel
  name: max label
  description: Maximum Rating Label - The label for the maximum rating value. Example values: Runs large , Exceeds expectations
  datatype: string
  max count: 1

ReviewerAttributeShape
type: NodeShape
target class: ReviewerAttribute
property:
  path: title
  name: title
  description: Reviewer Title - The title of the reviewer.
  datatype: string
  max count: 1
property:
  path: reviewerType
  name: reviewer type
  description: Reviewer Type - The type of the reviewer.
  datatype: string
  max count: 1
property:
  path: value
  name: value
  description: Reviewer Value - The value of the reviewer.
  datatype: string
  max count: 1

SearchTermShape
type: NodeShape
target class: SearchTerm
property:
  path: eventDate
  name: event date
  description: Event Date - The date the search query occurred, in Pacific Time Zone (PT).
  datatype: date
  max count: 1
property:
  path: eventDateDay
  name: event date day
  description: Event Day - The day on which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateWeek
  name: event date week
  description: Event Week - The Sunday of the week during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateMonth
  name: event date month
  description: Event Month - The month during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateQuarter
  name: event date quarter
  description: Event Quarter - The first month of the quarter during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateYear
  name: event date year
  description: Event Year - The year during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: accountId
  name: account id
  description: Account ID - The unique ID of the connected search source, such as a verified domain in Search Console. Example value: sc-domain:myshop.com
  datatype: string
  max count: 1
property:
  path: channel
  name: channel
  description: Channel - The platform where the search query occurred. Example value: google
  datatype: string
  max count: 1
property:
  path: keywordId
  name: keyword id
  description: Keyword ID - The unique ID for the keyword that surfaced the site's content in search results. Example value: 313990984637674
  datatype: string
  max count: 1
property:
  path: query
  name: query
  description: Search Query - The exact search term entered by the user that surfaced the site’s content in search results. Example values: nike running shoes , best camping gear
  datatype: string
  max count: 1
property:
  path: clicks
  name: clicks
  description: Clicks - Number of times users clicked on the site in the search results.
  datatype: double
  max count: 1
property:
  path: impressions
  name: impressions
  description: Impressions - Number of times the site appeared in search results for a query.
  datatype: double
  max count: 1
property:
  path: position
  name: position
  description: Position - The average position where the site appeared in search results for the query.
  datatype: double
  max count: 1

SessionShape
type: NodeShape
target class: Session
property:
  path: eventHour
  name: event hour
  description: Event Hour - The hour of the day the website session started, 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: 07 , 16 , 21
  datatype: string
  max count: 1
property:
  path: eventDate
  name: event date
  description: Event Date - The date the website session started. Based on the shop time zone at the moment of the event (or the user time zone, if no sales platform is connected).
  datatype: date
  max count: 1
property:
  path: eventDateDay
  name: event date day
  description: Event Day - The day on which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateWeek
  name: event date week
  description: Event Week - The Sunday of the week during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateMonth
  name: event date month
  description: Event Month - The month during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateQuarter
  name: event date quarter
  description: Event Quarter - The first month of the quarter during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateYear
  name: event date year
  description: Event Year - The year during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: adId
  name: ad id
  description: Ad ID - The unique ID for the ad associated with the session. Assigned by the ad platform, captured by Triple Pixel in the UTM query parameters. Example value: 120210439891110007
  datatype: string
  max count: 1
property:
  path: adsetId
  name: adset id
  description: Ad Set ID - The unique ID for the ad set associated with the session. Assigned by the ad platform, captured by Triple Pixel in the UTM query parameters. Example value: 120210439890740003
  datatype: string
  max count: 1
property:
  path: browser
  name: browser
  description: Web Browser - The web browser of the session where the order originated. Example values: Chrome , Firefox , Safari
  datatype: string
  max count: 1
property:
  path: campaignId
  name: campaign id
  description: Campaign ID - The unique ID for the marketing campaign associated with the session. Assigned by the ad platform, captured by Triple Pixel in the UTM query parameters. Example values: 23852438666180053 , 531011533 , 20620285829
  datatype: string
  max count: 1
property:
  path: channel
  name: channel
  description: Channel - The platform through which the ad was delivered. Derived from UTM parameters and standardized (e.g. a UTM value of fb is standardized to facebook-ads in Triple Whale). Example values: facebook-ads , tiktok-ads , Direct
  datatype: string
  max count: 1
property:
  path: city
  name: city
  description: Session City - The city of the session where the order originated. Example values: San Francisco , Tel Aviv , Kyiv
  datatype: string
  max count: 1
property:
  path: country
  name: country
  description: Session Country - The country of the session. See list of countries . Example values: United States , Canada , United Kingdom
  datatype: string
  max count: 1
property:
  path: countryCode
  name: country code
  description: Country Code - The country code of the session. See list of countries . Example values: US , CA , GB
  datatype: string
  max count: 1
property:
  path: device
  name: device
  description: Device - The type of device used by the visitor for the session. Example values: mobile , desktop , tablet , wearable
  datatype: string
  max count: 1
property:
  path: deviceModel
  name: device model
  description: Device Model - The device model used by the visitor for the session. Example values: SM-A022M , CPH2305 , Note 12
  datatype: string
  max count: 1
property:
  path: domain
  name: domain
  description: Domain - The domain through which the session was initiated. Example value: exampleshop.com
  datatype: string
  max count: 1
property:
  path: eventDateTimezone
  name: event date timezone
  description: Event Date Timezone - The time zone in which the event_date and event_hour are based. Equivalent to the designated timezone of the shop according to the timezone database .
  datatype: string
  max count: 1
property:
  path: isNewVisitor
  name: is new visitor
  description: Is New Visitor - True if the session was initiated by a first-time visitor. Possible Values: true , false
  datatype: boolean
  max count: 1
property:
  path: keywordId
  name: keyword id
  description: Keyword ID - The unique ID assigned to the keyword by the ad platform, captured by Triple Pixel from the ad URL. Example value: 313990984637674
  datatype: string
  max count: 1
property:
  path: landingPage
  name: landing page
  description: Landing Page - The URL path (without query parameters) of the page the visitor landed after clicking on an ad or link, indicating the first page viewed in a session. Example value: /myshop/collections/green_sweater
  datatype: string
  max count: 1
property:
  path: msCountry
  name: ms country
  description: Marketplace Country - The marketplace country code of the marketplace environment for the session, based on shop settings. See list of countries . Example values: US , CA , GB
  datatype: string
  max count: 1
property:
  path: msCountryName
  name: ms country name
  description: Marketplace Country Name - The marketplace country name of the marketplace environment for the session, based on shop settings. See list of countries . Example values: United States , Canada , United Kingdom
  datatype: string
  max count: 1
property:
  path: sessionId
  name: session id
  description: Session ID - The unique session ID assigned by Triple Pixel. Example value: cltlok4y634IRw62AZ_1710700966152
  datatype: string
  max count: 1
property:
  path: sessionStartTs
  name: session start ts
  description: Session Start Timestamp - The time at which the visitor initiated the session. Formatted according to the ISO 8601 international standard . Example value: 2022-06-15T19:26:30.000Z
  datatype: dateTime
  max count: 1
property:
  path: shopId
  name: shop id
  description: Shop ID - The unique ID of the shop (often corresponds to the shop domain). Can be used to group or filter data by shop in multi-store reports. Example values: example-US.myshopify.com , example-EU.myshopify.com
  datatype: string
  max count: 1
property:
  path: shopName
  name: shop name
  description: Shop Name - The name of the shop. Can be used to group or filter data by shop in multi-store reports. Example values: example-US , example-EU
  datatype: string
  max count: 1
property:
  path: tripleId
  name: triple id
  description: Triple Pixel ID - The unique ID assigned by Triple Pixel to track visitors across sessions. Example value: cltlok4y634IRw62AZ
  datatype: string
  max count: 1
property:
  path: urlQueryParams
  name: url query params
  description: URL Query Parameters - The query parameters contained in the URL of the first page viewed in a session (the page the visitor initially landed after clicking on an ad or link). Example values: {"tw_adid":"83906898178855", "tw_campaign":"103306890", "tw_source":"bing"," utm_campaign":"Bing Shopping", "utm_content":"HERO SKU Summer Book Run", "utm_medium":"cpc", "utm_source":"bing", "utm_term":"1342506080190763", "variant":"44042133111001"}
  datatype: string
  max count: 1
property:
  path: utmMedium
  name: utm medium
  description: UTM Medium - The UTM medium parameter captured by Triple Pixel from the ad URL Example values: sponsored , paid , profile_link
  datatype: string
  max count: 1
property:
  path: utmSource
  name: utm source
  description: UTM Source - The UTM source parameter captured by Triple Pixel from the ad URL. Example values: web , pos , tiktok , facebook , google , newsletter
  datatype: string
  max count: 1
property:
  path: sessionElapsedTime
  name: session elapsed time
  description: Session Duration - The total duration of time elapsed during the session, measured in seconds.
  datatype: double
  max count: 1

ShippingShape
type: NodeShape
target class: Shipping
property:
  path: eventHour
  name: event hour
  description: Event Hour - The hour of the day the shipment was processed, according to a 24-hour clock. Based on the timezone of the shipping platform. Example values: 07 , 16 , 21
  datatype: string
  max count: 1
property:
  path: eventDate
  name: event date
  description: Event Date - The date the shipment label was created. Based on the timezone of the shipping platform.
  datatype: date
  max count: 1
property:
  path: eventDateDay
  name: event date day
  description: Event Day - The day on which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateWeek
  name: event date week
  description: Event Week - The Sunday of the week during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateMonth
  name: event date month
  description: Event Month - The month during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateQuarter
  name: event date quarter
  description: Event Quarter - The first month of the quarter during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateYear
  name: event date year
  description: Event Year - The year during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: createdAt
  name: created at
  description: Shipment Created Date - The time when the shipment record was created in the shipping platform. Formatted according to the ISO 8601 international standard . Example value: 2022-06-15T19:26:30.000Z
  datatype: dateTime
  max count: 1
property:
  path: estimatedFulfillmentDateStatus
  name: estimated fulfillment date status
  description: Estimated Fulfillment Date Status - The status of the shipment's estimated fulfillment date. Example value: FulfilledOnTime
  datatype: string
  max count: 1
property:
  path: isReturn
  name: is return
  description: Is Return Shipment - True if the shipment is a return to the sender. Possible values: true , false
  datatype: boolean
  max count: 1
property:
  path: isVoided
  name: is voided
  description: Is Voided Shipment - True if the shipment is voided. Possible values: true , false
  datatype: boolean
  max count: 1
property:
  path: shipmentDate
  name: shipment date
  description: Shipment Date - The time when the shipment was actually shipped. Formatted according to the ISO 8601 international standard . Example value: 2022-06-15T19:26:30.000Z
  datatype: dateTime
  max count: 1
property:
  path: shipmentStatus
  name: shipment status
  description: Shipment Status - The current status of the shipment. Example values: LabeledCreated , Completed
  datatype: string
  max count: 1
property:
  path: shippingPlatform
  name: shipping platform
  description: Shipping Platform - The platform used to manage and process the shipment. Example values: shipbob , shipstation
  datatype: string
  max count: 1
property:
  path: shopId
  name: shop id
  description: Shop ID - The unique ID of the shop (often corresponds to the shop domain). Can be used to group or filter data by shop in multi-store reports. Example values: example-US.myshopify.com , example-EU.myshopify.com
  datatype: string
  max count: 1
property:
  path: shopName
  name: shop name
  description: Shop Name - The name of the shop. Can be used to group or filter data by shop in multi-store reports. Example values: example-US , example-EU
  datatype: string
  max count: 1
property:
  path: toCity
  name: to city
  description: Destination Ciy - The destination city of the shipment. Example values: MANCHESTER , SAN JOSE , OROVILLE
  datatype: string
  max count: 1
property:
  path: toCountry
  name: to country
  description: Destination Country - The destination country code of the shipment. See list of countries . Example values: US , CA , GB
  datatype: string
  max count: 1
property:
  path: toCountryName
  name: to country name
  description: Destination Country Name - The full name of the destination country of the shipment. See list of countries . Example values: United States , Canada , United Kingdom
  datatype: string
  max count: 1
property:
  path: toState
  name: to state
  description: Destination State - The destination state of the shipment. Example values: WA , FL , ON
  datatype: string
  max count: 1
property:
  path: updatedAt
  name: updated at
  description: Shipment Updated Date - The time when the shipment record was last updated in the shipping platform. Formatted according to the ISO 8601 international standard . Example value: 2022-06-15T19:26:30.000Z
  datatype: dateTime
  max count: 1
property:
  path: numberOfItems
  name: number of items
  description: Number of Items - The number of items contained in the shipment.
  datatype: double
  max count: 1
property:
  path: shopShipmentCost
  name: shop shipment cost
  description: Shipment Cost To Shop - The cost of the shipment to the seller. By default shown in the shop's currency.
  datatype: double
  max count: 1

SocialMediaCommentShape
type: NodeShape
target class: SocialMediaComment
property:
  path: channel
  name: channel
  description: Channel - The channel where the comment was published. Example values: meta-analytics , twitter-social
  datatype: string
  max count: 1
property:
  path: commentId
  name: comment id
  description: Comment ID - The ID of the comment. Example value: 530861436559487_731664866264638
  datatype: string
  max count: 1
property:
  path: commentText
  name: comment text
  description: Comment Text - The text content of the comment. Example value: Love this design! Do you ship internationally?
  datatype: string
  max count: 1
property:
  path: createdAt
  name: created at
  description: Created Date - The time the comment was created. Formatted according to the ISO 8601 international standard. Example value: 2025-07-16 04:32:29
  datatype: string
  max count: 1
property:
  path: pageId
  name: page id
  description: Page ID - The ID of the page. Example value: 123456789012345
  datatype: string
  max count: 1
property:
  path: postId
  name: post id
  description: Post ID - The ID of the post. Example value: 120347795274735_430061436559488
  datatype: string
  max count: 1
property:
  path: risk
  name: risk
  description: The risk level assessment of the comment. Example values: low , medium , high
  datatype: string
  max count: 1
property:
  path: sentiment
  name: sentiment
  description: The sentiment analysis result for the comment. Example values: positive , negative , neutral
  datatype: string
  max count: 1
property:
  path: topic
  name: topic
  description: The topic or category classification of the comment. Example values: product_inquiry , shipping , complaint
  datatype: string
  max count: 1
property:
  path: userId
  name: user id
  description: User ID - The ID of the user that made the comment. Example value: 24237031855927250
  datatype: string
  max count: 1
property:
  path: userName
  name: user name
  description: User Name - The name of the user that made the comment. Example value: Jane Smith
  datatype: string
  max count: 1
property:
  path: visibilityChangedAt
  name: visibility changed at
  description: The timestamp of the last visibility status change. Example value: 2025-07-16 04:32:29
  datatype: string
  max count: 1
property:
  path: visibilityChangedBy
  name: visibility changed by
  description: Who changed the visibility status of the comment. Example values: user , system
  datatype: string
  max count: 1
property:
  path: visibilityStatus
  name: visibility status
  description: The visibility status of the comment. Example values: visible , hidden , deleted
  datatype: string
  max count: 1

SocialMediaMentionShape
type: NodeShape
target class: SocialMediaMention
property:
  path: eventDate
  name: event date
  description: Event Date - The date the post containing the mention was created. Based on the shop time zone at the moment of the event (or the user time zone, if no sales platform is connected).
  datatype: date
  max count: 1
property:
  path: eventDateDay
  name: event date day
  description: Event Day - The day the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateWeek
  name: event date week
  description: Event Week - The Sunday of the week during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateMonth
  name: event date month
  description: Event Month - The month during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateQuarter
  name: event date quarter
  description: Event Quarter - The first month of the quarter during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateYear
  name: event date year
  description: Event Year - The year during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: authorId
  name: author id
  description: Author ID - The ID of the user that made the mention. Example value: 987654321098735
  datatype: string
  max count: 1
property:
  path: authorName
  name: author name
  description: Author Name - The name of the user that made the mention. Example value: John Smith
  datatype: string
  max count: 1
property:
  path: authorUsername
  name: author username
  description: Author Username - The username of the user that made the mention. Example value: example_username
  datatype: string
  max count: 1
property:
  path: channel
  name: channel
  description: Channel - The channel where the post containing the mention was published. Example values: meta-analytics , twitter-social
  datatype: string
  max count: 1
property:
  path: conversationId
  name: conversation id
  description: Conversation ID - The ID of the conversation that the mention is in. Example value: 123456789012345
  datatype: string
  max count: 1
property:
  path: createdAt
  name: created at
  description: Created Date - The time the post containing the mention was created. Formatted according to the ISO 8601 international standard. Example value: 2025-07-16 04:32:29
  datatype: dateTime
  max count: 1
property:
  path: inReplyToUserId
  name: in reply to user id
  description: In Reply to User ID - The ID of the user that the mention is replying to. Example value: 123456789012345
  datatype: string
  max count: 1
property:
  path: isThreadStarter
  name: is thread starter
  description: Is Thread Starter - Indicates whether the post that the mention is in is the first in a thread. Possible values: true , false
  datatype: boolean
  max count: 1
property:
  path: matchedKeyword
  name: matched keyword
  description: Matched Keyword - The keyword that was matched in the mention. Example values: running shoes , cheap flights , best coffee
  datatype: string
  max count: 1
property:
  path: mentionText
  name: mention text
  description: Mention Text - The text content of the mention. Example value: @example_user thanks for the shoutout!
  datatype: string
  max count: 1
property:
  path: mentionType
  name: mention type
  description: Mention Type - The type of mention. Example values: keyword , user , hashtag
  datatype: string
  max count: 1
property:
  path: postId
  name: post id
  description: Mentioned Post ID - The ID of the post that the mention is in. Example value: 123456789012345_987654321098765
  datatype: string
  max count: 1
property:
  path: postPermalink
  name: post permalink
  description: Mentioned Post Permalink - The permanent link to the post containing the mention on the social platform. Example value: https://www.facebook.com/123456789/posts/987654321
  datatype: anyURI
  max count: 1
property:
  path: replyToPostId
  name: reply to post id
  description: Reply to Post ID - The ID of the post that the mention is replying to. Example value: 123456789012345
  datatype: string
  max count: 1
property:
  path: sentiment
  name: sentiment
  description: Sentiment - The sentiment of the mention. Example values: positive , negative , neutral
  datatype: string
  max count: 1
property:
  path: topic
  name: topic
  description: Topic - The topic of the mention. Example value: custom t-shirt
  datatype: string
  max count: 1
property:
  path: userId
  name: user id
  description: Mentioned User ID - The ID of the user who was mentioned. Example value: 123456789012345
  datatype: string
  max count: 1

SocialMediaPageShape
type: NodeShape
target class: SocialMediaPage
property:
  path: eventDate
  name: event date
  description: Event Date - The date the 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).
  datatype: date
  max count: 1
property:
  path: eventDateDay
  name: event date day
  description: Event Day - The day the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateWeek
  name: event date week
  description: Event Week - The Sunday of the week during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateMonth
  name: event date month
  description: Event Month - The month during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateQuarter
  name: event date quarter
  description: Event Quarter - The first month of the quarter during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateYear
  name: event date year
  description: Event Year - The year during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: about
  name: about
  description: About - A short description of the page, often provided by the business or creator. Example value: Custom apparel designed to stand out
  datatype: string
  max count: 1
property:
  path: category
  name: category
  description: Category - The business category assigned to the page. Example values: Marketing Agency , Business service
  datatype: string
  max count: 1
property:
  path: channel
  name: channel
  description: Channel - The channel where the page was published. Example values: meta-analytics , twitter-social
  datatype: string
  max count: 1
property:
  path: coverUrl
  name: cover url
  description: Cover URL - The URL of the page's cover image. Example value: https://scontent-example.fbcdn.net/v/t39.30808-6/cover_image.jpg
  datatype: anyURI
  max count: 1
property:
  path: imageUrl
  name: image url
  description: Image URL - The URL of the page's profile image. Example value: https://scontent-example.fbcdn.net/v/t39.30808-1/profile_image.jpg
  datatype: anyURI
  max count: 1
property:
  path: pageId
  name: page id
  description: Page ID - The ID of the page. Example value: 123456789012345
  datatype: string
  max count: 1
property:
  path: pageName
  name: page name
  description: Page Name - The name of the social media page. Example values: Acme Apparel , Horizon Handcrafted Soaps
  datatype: string
  max count: 1
property:
  path: pagePermalink
  name: page permalink
  description: Page Permalink - The permanent link to the page. Example value: https://www.facebook.com/123456789
  datatype: anyURI
  max count: 1
property:
  path: website
  name: website
  description: Website - The website URL associated with the page. Example values: https://example.com/products/sample-product , https://www.example.com/
  datatype: anyURI
  max count: 1
property:
  path: fanAdds
  name: fan adds
  description: Fan Adds - The number of new fans (followers) who followed the page during the selected period.
  datatype: double
  max count: 1
property:
  path: fanRemoves
  name: fan removes
  description: Fan Removes - The number of fans (followers) who unfollowed the page during the selected period.
  datatype: double
  max count: 1
property:
  path: impressions
  name: impressions
  description: Impressions - The total number of times any content from or about the page was shown on a user's screen, including posts, ads, stories, mentions, and shares. Includes repeat exposures.
  datatype: double
  max count: 1
property:
  path: impressionsPaid
  name: impressions paid
  description: Paid Impressions - The total number of times paid content from the page, such as ads or boosted posts, was shown on a user's screen. Includes repeat exposures.
  datatype: double
  max count: 1
property:
  path: impressionsUnique
  name: impressions unique
  description: Unique Impressions - The number of unique users who saw any content from or about the page during the selected period.
  datatype: double
  max count: 1
property:
  path: impressionsViral
  name: impressions viral
  description: Viral Impressions - The number of times content from the page was displayed to users through social interactions, such as shares, mentions, or recommendations.
  datatype: double
  max count: 1
property:
  path: videoViews
  name: video views
  description: Video Views - The number of times videos were viewed on the page during the selected period.
  datatype: double
  max count: 1
property:
  path: viewsTotal
  name: views total
  description: Total Views - The total number of times users visited the page itself during the selected period, including repeat visits.
  datatype: double
  max count: 1

SocialMediaPostShape
type: NodeShape
target class: SocialMediaPost
property:
  path: channel
  name: channel
  description: Channel - The channel where the post was published. Example values: meta-analytics , twitter-social
  datatype: string
  max count: 1
property:
  path: createdAt
  name: created at
  description: Created Date - The time the post was created. Formatted according to the ISO 8601 international standard. Example value: 2025-07-16 04:32:29
  datatype: dateTime
  max count: 1
property:
  path: ctaType
  name: cta type
  description: Call-to-Action Type - The type of call-to-action configured for the post. Example values: SHOP_NOW , SIGN_UP , LEARN_MORE
  datatype: string
  max count: 1
property:
  path: ctaUrl
  name: cta url
  description: Call-to-Action URL - The URL linked to the call-to-action button on the post. Example value: https://example.com/products/summer-collection
  datatype: anyURI
  max count: 1
property:
  path: event
  name: event
  description: Event - A platform-generated text string providing extra context about the post, such as page updates or location check-ins. Example values: BlueWave Apparel updated their cover photo. , EcoLoom Studio is in Barcelona, Spain.
  datatype: string
  max count: 1
property:
  path: isPublished
  name: is published
  description: Is Published - Indicates whether the post is currently published and visible on the page. Possible values: true , false
  datatype: boolean
  max count: 1
property:
  path: pageId
  name: page id
  description: Page ID - The ID of the page. Example value: 123456789012345
  datatype: string
  max count: 1
property:
  path: postId
  name: post id
  description: Post ID - The ID of the post. Example value: 123456789012345_987654321098765
  datatype: string
  max count: 1
property:
  path: postPermalink
  name: post permalink
  description: Post Permalink - The permanent link to the post on the social platform. Example value: https://www.facebook.com/123456789/posts/987654321
  datatype: anyURI
  max count: 1
property:
  path: postText
  name: post text
  description: Post Text - The text content of the post. Example value: Show your love story on a custom T-shirt!
  datatype: string
  max count: 1
property:
  path: publisherId
  name: publisher id
  description: Publisher ID - The ID of the user, page, group, or event that published the post. Example value: 987654321098735
  datatype: string
  max count: 1
property:
  path: publisherName
  name: publisher name
  description: Publisher Name - The name of the user, page, group, or event that published the post. Example values: BrightThreads , Urban Tee Co.
  datatype: string
  max count: 1
property:
  path: postType
  name: post type
  description: Post Type - The format of the post, indicating what kind of media or action it includes. Example values: added_photos , added_video
  datatype: string
  max count: 1
property:
  path: updatedAt
  name: updated at
  description: Updated Date - The time the post was last updated. Formatted according to the ISO 8601 international standard. Example value: 2025-07-20 10:14:05
  datatype: dateTime
  max count: 1

SubscriptionMetricsShape
type: NodeShape
target class: SubscriptionMetrics
property:
  path: eventDate
  name: event date
  description: Event Date - The date the subscription 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).
  datatype: date
  max count: 1
property:
  path: eventDateDay
  name: event date day
  description: Event Day - The day on which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateWeek
  name: event date week
  description: Event Week - The Sunday of the week during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateMonth
  name: event date month
  description: Event Month - The month during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateQuarter
  name: event date quarter
  description: Event Quarter - The first month of the quarter during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateYear
  name: event date year
  description: Event Year - The year during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: platform
  name: platform
  description: Subscription Platform - The subscription platform through which the subscription is managed. Example values: recharge , stripe
  datatype: string
  max count: 1
property:
  path: shopId
  name: shop id
  description: Shop ID - The unique ID of the shop (often corresponds to the shop domain). Can be used to group or filter data by shop in multi-store reports. Example values: example-US.myshopify.com , example-EU.myshopify.com
  datatype: string
  max count: 1
property:
  path: shopName
  name: shop name
  description: Shop Name - The name of the shop. Can be used to group or filter data by shop in multi-store reports. Example values: example-US , example-EU
  datatype: string
  max count: 1
property:
  path: activeSubscribers
  name: active subscribers
  description: Active Subscribers - The number of subscribers with an active subscription in the specified time range.
  datatype: double
  max count: 1
property:
  path: activeSubscriptions
  name: active subscriptions
  description: Active Subscriptions - The total number of active subscriptions. Each subscription is counted separately, even if multiple belong to the same customer.
  datatype: double
  max count: 1
property:
  path: netRevenue
  name: net revenue
  description: Net Revenue - The total order revenue minus discounts from subscription orders.
  datatype: double
  max count: 1
property:
  path: newNeverSeenSubscribers
  name: new never seen subscribers
  description: New Never-Seen Subscribers - The number of new subscribers who have never had a subscription before and started their first subscription in the specified time range.
  datatype: double
  max count: 1
property:
  path: reactivatedSubscribers
  name: reactivated subscribers
  description: Reactivated Subscribers - The number of subscribers who had previously cancelled but have started a new subscription again in the specified time range.
  datatype: double
  max count: 1
property:
  path: totalCancelledSubscriptions
  name: total cancelled subscriptions
  description: Cancelled Subscriptions - The total number of subscriptions that were cancelled in the specified time range.
  datatype: double
  max count: 1
property:
  path: totalChurnedSubscribers
  name: total churned subscribers
  description: Churned Subscribers - The total number of customers who have cancelled all subscriptions in the specified time range.
  datatype: double
  max count: 1
property:
  path: totalNewSubscribers
  name: total new subscribers
  description: New Subscribers - The total number of new subscribers acquired in the specified time range.
  datatype: double
  max count: 1
property:
  path: totalNewSubscriptions
  name: total new subscriptions
  description: New Subscriptions - The total number of new subscriptions started in the specified time range.
  datatype: double
  max count: 1
property:
  path: totalRevenue
  name: total revenue
  description: Subscription Order Revenue - Revenue from all subscription orders in the specified time range, after shipping, taxes, and discounts (before refunds).
  datatype: double
  max count: 1
property:
  path: totalRevenueFirstOrder
  name: total revenue first order
  description: First Order Revenue - Revenue from first orders in each subscription in the specified time range, after shipping, taxes, and discounts (before refunds).
  datatype: double
  max count: 1
property:
  path: totalRevenueRecurring
  name: total revenue recurring
  description: Recurring Order Revenue - Revenue from recurring (non-first) subscription orders in the specified time range, after shipping, taxes, and discounts (before refunds).
  datatype: double
  max count: 1

SubscriptionShape
type: NodeShape
target class: Subscription
property:
  path: cancellationComments
  name: cancellation comments
  description: Cancellation Comments - Additional comments given by the customer at the time of cancellation. Example values: No longer interested , Ordered two by mistake , Just taking a break
  datatype: string
  max count: 1
property:
  path: cancellationReason
  name: cancellation reason
  description: Cancellation Reason - The reason for cancellation of the subscription, provided by the customer. Example values: Not the right fit , Issue with shipping , Other
  datatype: string
  max count: 1
property:
  path: createdAt
  name: created at
  description: Subscription Created Date - The time when the subscription was created. Formatted according to the ISO 8601 international standard . Example value: 2022-06-15T19:26:30.000Z
  datatype: dateTime
  max count: 1
property:
  path: customerId
  name: customer id
  description: Customer ID - The unique ID for the customer associated with the subscription. Example value: 6784521634029
  datatype: string
  max count: 1
property:
  path: endedAt
  name: ended at
  description: Subscription Ended Date - The time when the subscription was canceled or expired. Formatted according to the ISO 8601 international standard . Example value: 2023-07-11T19:21:30.000Z
  datatype: dateTime
  max count: 1
property:
  path: firstOrderDate
  name: first order date
  description: Subscription First Order Date - The date when the first order within this subscription was placed. Example value: 2023-04-09
  datatype: date
  max count: 1
property:
  path: firstOrderId
  name: first order id
  description: Subscription First Order ID - The unique ID for the first order placed within this subscription. Example value: 5246165483756
  datatype: string
  max count: 1
property:
  path: productId
  name: product id
  description: Product ID - The unique ID for each product within the subscription. Example value: 7809254686953
  datatype: string
  max count: 1
property:
  path: shopId
  name: shop id
  description: Shop ID - The unique ID of the shop (often corresponds to the shop domain). Can be used to group or filter data by shop in multi-store reports. Example values: example-US.myshopify.com , example-EU.myshopify.com
  datatype: string
  max count: 1
property:
  path: shopName
  name: shop name
  description: Shop Name - The name of the shop. Can be used to group or filter data by shop in multi-store reports. Example values: example-US , example-EU
  datatype: string
  max count: 1
property:
  path: status
  name: status
  description: Subscription Status - The status of the subscription. Example values: active , cancelled , expired
  datatype: string
  max count: 1
property:
  path: subscriptionId
  name: subscription id
  description: Subscription ID - The unique ID for the subscription. Example value: 352106812
  datatype: string
  max count: 1
property:
  path: subscriptionInterval
  name: subscription interval
  description: Subscription Interval - The time unit that defines how often the subscription renews. This indicates the frequency of fulfillment cycles for the subscription. Used in combination with the Subscription Interval Count to determine the exact frequency of fulfillment (e.g., a value of week with an interval count of 2 means the subscription renews every two weeks). Example values: day , week , month
  datatype: string
  max count: 1
property:
  path: variantId
  name: variant id
  description: Variant ID - The unique ID for each variant within the subscription. Example value: 43151194915045
  datatype: string
  max count: 1
property:
  path: price
  name: price
  description: Product Price - The price of each product in the subscription.
  datatype: double
  max count: 1
property:
  path: quantity
  name: quantity
  description: Product Quantity - The number of products included in the subscription.
  datatype: double
  max count: 1
property:
  path: subscriptionIntervalCount
  name: subscription interval count
  description: Subscription Interval Count - The number of intervals between each subscription renewal. Used in combination with the Subscription Interval to determine the exact frequency of fulfillment (e.g., a value of 2 with an interval of week means the subscription renews every two weeks). Example values: 1 , 2 , 4
  datatype: double
  max count: 1

WebAnalyticsShape
type: NodeShape
target class: WebAnalytics
property:
  path: eventHour
  name: event hour
  description: Event Hour - The hour of the day the website session started, 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: 07 , 16 , 21
  datatype: string
  max count: 1
property:
  path: eventDate
  name: event date
  description: Event Date - The date the website session started. Based on the shop time zone at the moment of the event (or the user time zone, if no sales platform is connected).
  datatype: date
  max count: 1
property:
  path: eventDateDay
  name: event date day
  description: Event Day - The day on which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateWeek
  name: event date week
  description: Event Week - The Sunday of the week during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateMonth
  name: event date month
  description: Event Month - The month during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateQuarter
  name: event date quarter
  description: Event Quarter - The first month of the quarter during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: eventDateYear
  name: event date year
  description: Event Year - The year during which the event occurred. Derived from event_date .
  datatype: date
  max count: 1
property:
  path: browser
  name: browser
  description: Web Browser - The web browser of the session where the order originated. Example values: Chrome , Firefox , Safari
  datatype: string
  max count: 1
property:
  path: city
  name: city
  description: Session City - The city of the session where the order originated. Example values: San Francisco , Tel Aviv , Kyiv
  datatype: string
  max count: 1
property:
  path: country
  name: country
  description: Session Country - The country of the session. See list of countries . Example values: United States , Canada , United Kingdom
  datatype: string
  max count: 1
property:
  path: device
  name: device
  description: Device - The type of device used by the visitor for the session. Example values: mobile , desktop , tablet , wearable
  datatype: string
  max count: 1
property:
  path: landingPage
  name: landing page
  description: Landing Page - The URL path (without query parameters) of the page the visitor landed after clicking on an ad or link, indicating the first page viewed in a session. Example value: /myshop/collections/green_sweater
  datatype: string
  max count: 1
property:
  path: shopId
  name: shop id
  description: Shop ID - The unique ID of the shop (often corresponds to the shop domain). Can be used to group or filter data by shop in multi-store reports. Example values: example-US.myshopify.com , example-EU.myshopify.com
  datatype: string
  max count: 1
property:
  path: shopName
  name: shop name
  description: Shop Name - The name of the shop. Can be used to group or filter data by shop in multi-store reports. Example values: example-US , example-EU
  datatype: string
  max count: 1
property:
  path: addToCarts
  name: add to carts
  description: Add to Carts - The total number of website sessions that include Pixel-reported Add-to-Cart events.
  datatype: double
  max count: 1
property:
  path: arr
  name: arr
  description: Annual Recurring Revenue (ARR) - The Pixel-reported annual recurring revenue (ARR) from new subscriptions during a website session.
  datatype: double
  max count: 1
property:
  path: bounces
  name: bounces
  description: Bounces - The Pixel-reported number of single-page sessions where the visitor left the site after a single page view.
  datatype: double
  max count: 1
property:
  path: mrr
  name: mrr
  description: Monthly Recurring Revenue (MRR) - The Pixel-reported monthly recurring revenue (MRR) from new subscriptions during a website session.
  datatype: double
  max count: 1
property:
  path: newSubscriptions
  name: new subscriptions
  description: New Subscriptions - The Pixel-reported number of new subscriptions during a website session.
  datatype: double
  max count: 1
property:
  path: newVisitors
  name: new visitors
  description: New Visitors - The Pixel-reported number of first-time visitors to the site.
  datatype: double
  max count: 1
property:
  path: orderRevenue
  name: order revenue
  description: Order Revenue - Pixel-reported conversion value (order revenue) after shipping, taxes, and discounts (before refunds). Order Revenue = Gross Sales + Shipping + Taxes − Discounts
  datatype: double
  max count: 1
property:
  path: ordersQuantity
  name: orders quantity
  description: Website Purchases - The total number of Pixel-reported purchases (orders) during a website session. Excludes recurring subscription purchases.
  datatype: double
  max count: 1
property:
  path: sessionPageViews
  name: session page views
  description: Session Page Views - The Pixel-reported number of pages viewed during a website session.
  datatype: double
  max count: 1
property:
  path: sessions
  name: sessions
  description: Pixel Sessions - The Pixel-reported number of online store sessions. Note that Triple Whale defines and tracks sessions differently from the main sales platform so there may be variance between the two. Learn how Triple Whale defines and tracks sessions.
  datatype: double
  max count: 1
property:
  path: timeOnSite
  name: time on site
  description: Time on Site - The Pixel-reported time spent by users on the site during a session, measured in seconds.
  datatype: double
  max count: 1
property:
  path: uniqueVisitors
  name: unique visitors
  description: Unique Visitors - The Pixel-reported number of unique visitors to the site.
  datatype: double
  max count: 1
property:
  path: addToCartPercent
  name: add to cart percent
  description: Add To Cart Percent - The percentage of add-to-carts out of total sessions. Add To Cart Percent = Number of Add To Carts / Number of Sessions
  datatype: string
  max count: 1
property:
  path: averagePagesPerSessions
  name: average pages per sessions
  description: Average Page Views Per Session - The average number of pages viewed by users during each session. Average Page Views Per Session = Session Page Views / Number of Sessions
  datatype: string
  max count: 1
property:
  path: averageSessionDuration
  name: average session duration
  description: Average Session Duration - The average time users spend on your site per session. Average Session Duration (in seconds) = Time on Site / (Number of Sessions - Number of Bounces)
  datatype: string
  max count: 1
property:
  path: bounceRate
  name: bounce rate
  description: Bounce Rate - The percentage of single-page visits (bounces) out of total sessions. Bounce Rate = Number of Bounces / Number of Sessions
  datatype: string
  max count: 1
property:
  path: conversionRate
  name: conversion rate
  description: Conversion Rate - The percentage of website sessions that result in purchases, as reported by Pixel. Conversion Rate = Number of Website Purchases / Number of Sessions
  datatype: string
  max count: 1

SqlQueryPeriodShape
type: NodeShape
target class: SqlQueryPeriod
property:
  path: startDate
  name: start date
  description: Inclusive start date (YYYY-MM-DD). Substituted for `@startDate` placeholders in the query.
  datatype: string
  min count: 1
  max count: 1
property:
  path: endDate
  name: end date
  description: Inclusive end date (YYYY-MM-DD). Substituted for `@endDate` placeholders in the query.
  datatype: string
  min count: 1
  max count: 1

SqlQueryErrorShape
type: NodeShape
target class: SqlQueryError
property:
  path: message
  name: message
  description: Human-readable error description, often including ClickHouse diagnostics.
  datatype: string
  min count: 1
  max count: 1

ContainerShape
type: NodeShape
target class: Container
property:
  path:
    inverse path: targetValues
  class: AdsAdsetTargeting
  min count: 1
  max count: 1
property:
  path: entry
  node: EntryShape
  class: Entry
  node kind: BlankNodeOrIRI
sparql: SPARQLConstraint
  message: Record entry keys must be unique
  select: SELECT $this ?key WHERE { $this <https://relay.inferal.com/ontology/triplewhale/record/TripleWhale.Ads.AdsetTargeting/targetValues/entry> ?left, ?right . FILTER(?left != ?right) ?left <https://relay.inferal.com/ontology/triplewhale/record/TripleWhale.Ads.AdsetTargeting/targetValues/key> ?key . ?right <https://relay.inferal.com/ontology/triplewhale/record/TripleWhale.Ads.AdsetTargeting/targetValues/key> ?key . }

EntryShape
type: NodeShape
target class: Entry
property:
  path:
    inverse path: entry
  class: Container
  min count: 1
  max count: 1
property:
  path: key
  datatype: string
  min count: 1
  max count: 1
property:
  path: value
  datatype: JSON
  min count: 1
  max count: 1

ContainerShape
type: NodeShape
target class: Container
property:
  path:
    inverse path: tags
  class: CsTicket
  min count: 1
  max count: 1
property:
  path: entry
  node: EntryShape
  class: Entry
  node kind: BlankNodeOrIRI
sparql: SPARQLConstraint
  message: Record entry keys must be unique
  select: SELECT $this ?key WHERE { $this <https://relay.inferal.com/ontology/triplewhale/record/TripleWhale.CsTicket/tags/entry> ?left, ?right . FILTER(?left != ?right) ?left <https://relay.inferal.com/ontology/triplewhale/record/TripleWhale.CsTicket/tags/key> ?key . ?right <https://relay.inferal.com/ontology/triplewhale/record/TripleWhale.CsTicket/tags/key> ?key . }

EntryShape
type: NodeShape
target class: Entry
property:
  path:
    inverse path: entry
  class: Container
  min count: 1
  max count: 1
property:
  path: key
  datatype: string
  min count: 1
  max count: 1
property:
  path: value
  datatype: JSON
  min count: 1
  max count: 1

ContainerShape
type: NodeShape
target class: Container
property:
  path:
    inverse path: breakdown
  class: ExternalRevenue
  min count: 1
  max count: 1
property:
  path: entry
  node: EntryShape
  class: Entry
  node kind: BlankNodeOrIRI
sparql: SPARQLConstraint
  message: Record entry keys must be unique
  select: SELECT $this ?key WHERE { $this <https://relay.inferal.com/ontology/triplewhale/record/TripleWhale.ExternalRevenue/breakdown/entry> ?left, ?right . FILTER(?left != ?right) ?left <https://relay.inferal.com/ontology/triplewhale/record/TripleWhale.ExternalRevenue/breakdown/key> ?key . ?right <https://relay.inferal.com/ontology/triplewhale/record/TripleWhale.ExternalRevenue/breakdown/key> ?key . }

EntryShape
type: NodeShape
target class: Entry
property:
  path:
    inverse path: entry
  class: Container
  min count: 1
  max count: 1
property:
  path: key
  datatype: string
  min count: 1
  max count: 1
property:
  path: value
  datatype: JSON
  min count: 1
  max count: 1

ContainerShape
type: NodeShape
target class: Container
property:
  path:
    inverse path: duties
  class: OrderProductsInfo
  min count: 1
  max count: 1
property:
  path: entry
  node: EntryShape
  class: Entry
  node kind: BlankNodeOrIRI
sparql: SPARQLConstraint
  message: Record entry keys must be unique
  select: SELECT $this ?key WHERE { $this <https://relay.inferal.com/ontology/triplewhale/record/TripleWhale.Orders.ProductsInfo/duties/entry> ?left, ?right . FILTER(?left != ?right) ?left <https://relay.inferal.com/ontology/triplewhale/record/TripleWhale.Orders.ProductsInfo/duties/key> ?key . ?right <https://relay.inferal.com/ontology/triplewhale/record/TripleWhale.Orders.ProductsInfo/duties/key> ?key . }

EntryShape
type: NodeShape
target class: Entry
property:
  path:
    inverse path: entry
  class: Container
  min count: 1
  max count: 1
property:
  path: key
  datatype: string
  min count: 1
  max count: 1
property:
  path: value
  datatype: JSON
  min count: 1
  max count: 1

ContainerShape
type: NodeShape
target class: Container
property:
  path:
    inverse path: dutiesTaxLines
  class: OrderProductsInfo
  min count: 1
  max count: 1
property:
  path: entry
  node: EntryShape
  class: Entry
  node kind: BlankNodeOrIRI
sparql: SPARQLConstraint
  message: Record entry keys must be unique
  select: SELECT $this ?key WHERE { $this <https://relay.inferal.com/ontology/triplewhale/record/TripleWhale.Orders.ProductsInfo/dutiesTaxLines/entry> ?left, ?right . FILTER(?left != ?right) ?left <https://relay.inferal.com/ontology/triplewhale/record/TripleWhale.Orders.ProductsInfo/dutiesTaxLines/key> ?key . ?right <https://relay.inferal.com/ontology/triplewhale/record/TripleWhale.Orders.ProductsInfo/dutiesTaxLines/key> ?key . }

EntryShape
type: NodeShape
target class: Entry
property:
  path:
    inverse path: entry
  class: Container
  min count: 1
  max count: 1
property:
  path: key
  datatype: string
  min count: 1
  max count: 1
property:
  path: value
  datatype: JSON
  min count: 1
  max count: 1

ContainerShape
type: NodeShape
target class: Container
property:
  path:
    inverse path: properties
  class: OrderProductsInfo
  min count: 1
  max count: 1
property:
  path: entry
  node: EntryShape
  class: Entry
  node kind: BlankNodeOrIRI
sparql: SPARQLConstraint
  message: Record entry keys must be unique
  select: SELECT $this ?key WHERE { $this <https://relay.inferal.com/ontology/triplewhale/record/TripleWhale.Orders.ProductsInfo/properties/entry> ?left, ?right . FILTER(?left != ?right) ?left <https://relay.inferal.com/ontology/triplewhale/record/TripleWhale.Orders.ProductsInfo/properties/key> ?key . ?right <https://relay.inferal.com/ontology/triplewhale/record/TripleWhale.Orders.ProductsInfo/properties/key> ?key . }

EntryShape
type: NodeShape
target class: Entry
property:
  path:
    inverse path: entry
  class: Container
  min count: 1
  max count: 1
property:
  path: key
  datatype: string
  min count: 1
  max count: 1
property:
  path: value
  datatype: JSON
  min count: 1
  max count: 1

ContainerShape
type: NodeShape
target class: Container
property:
  path:
    inverse path: eventBody
  class: PixelCustomConversion
  min count: 1
  max count: 1
property:
  path: entry
  node: EntryShape
  class: Entry
  node kind: BlankNodeOrIRI
sparql: SPARQLConstraint
  message: Record entry keys must be unique
  select: SELECT $this ?key WHERE { $this <https://relay.inferal.com/ontology/triplewhale/record/TripleWhale.PixelCustomConversion/eventBody/entry> ?left, ?right . FILTER(?left != ?right) ?left <https://relay.inferal.com/ontology/triplewhale/record/TripleWhale.PixelCustomConversion/eventBody/key> ?key . ?right <https://relay.inferal.com/ontology/triplewhale/record/TripleWhale.PixelCustomConversion/eventBody/key> ?key . }

EntryShape
type: NodeShape
target class: Entry
property:
  path:
    inverse path: entry
  class: Container
  min count: 1
  max count: 1
property:
  path: key
  datatype: string
  min count: 1
  max count: 1
property:
  path: value
  datatype: JSON
  min count: 1
  max count: 1

ContainerShape
type: NodeShape
target class: Container
property:
  path:
    inverse path: data
  class: PixelCustomEvent
  min count: 1
  max count: 1
property:
  path: entry
  node: EntryShape
  class: Entry
  node kind: BlankNodeOrIRI
sparql: SPARQLConstraint
  message: Record entry keys must be unique
  select: SELECT $this ?key WHERE { $this <https://relay.inferal.com/ontology/triplewhale/record/TripleWhale.PixelCustomEvent/data/entry> ?left, ?right . FILTER(?left != ?right) ?left <https://relay.inferal.com/ontology/triplewhale/record/TripleWhale.PixelCustomEvent/data/key> ?key . ?right <https://relay.inferal.com/ontology/triplewhale/record/TripleWhale.PixelCustomEvent/data/key> ?key . }

EntryShape
type: NodeShape
target class: Entry
property:
  path:
    inverse path: entry
  class: Container
  min count: 1
  max count: 1
property:
  path: key
  datatype: string
  min count: 1
  max count: 1
property:
  path: value
  datatype: JSON
  min count: 1
  max count: 1

ContainerShape
type: NodeShape
target class: Container
property:
  path:
    inverse path: duties
  class: PixelOrderProductsInfo
  min count: 1
  max count: 1
property:
  path: entry
  node: EntryShape
  class: Entry
  node kind: BlankNodeOrIRI
sparql: SPARQLConstraint
  message: Record entry keys must be unique
  select: SELECT $this ?key WHERE { $this <https://relay.inferal.com/ontology/triplewhale/record/TripleWhale.PixelOrders.ProductsInfo/duties/entry> ?left, ?right . FILTER(?left != ?right) ?left <https://relay.inferal.com/ontology/triplewhale/record/TripleWhale.PixelOrders.ProductsInfo/duties/key> ?key . ?right <https://relay.inferal.com/ontology/triplewhale/record/TripleWhale.PixelOrders.ProductsInfo/duties/key> ?key . }

EntryShape
type: NodeShape
target class: Entry
property:
  path:
    inverse path: entry
  class: Container
  min count: 1
  max count: 1
property:
  path: key
  datatype: string
  min count: 1
  max count: 1
property:
  path: value
  datatype: JSON
  min count: 1
  max count: 1

ContainerShape
type: NodeShape
target class: Container
property:
  path:
    inverse path: dutiesTaxLines
  class: PixelOrderProductsInfo
  min count: 1
  max count: 1
property:
  path: entry
  node: EntryShape
  class: Entry
  node kind: BlankNodeOrIRI
sparql: SPARQLConstraint
  message: Record entry keys must be unique
  select: SELECT $this ?key WHERE { $this <https://relay.inferal.com/ontology/triplewhale/record/TripleWhale.PixelOrders.ProductsInfo/dutiesTaxLines/entry> ?left, ?right . FILTER(?left != ?right) ?left <https://relay.inferal.com/ontology/triplewhale/record/TripleWhale.PixelOrders.ProductsInfo/dutiesTaxLines/key> ?key . ?right <https://relay.inferal.com/ontology/triplewhale/record/TripleWhale.PixelOrders.ProductsInfo/dutiesTaxLines/key> ?key . }

EntryShape
type: NodeShape
target class: Entry
property:
  path:
    inverse path: entry
  class: Container
  min count: 1
  max count: 1
property:
  path: key
  datatype: string
  min count: 1
  max count: 1
property:
  path: value
  datatype: JSON
  min count: 1
  max count: 1

ContainerShape
type: NodeShape
target class: Container
property:
  path:
    inverse path: properties
  class: PixelOrderProductsInfo
  min count: 1
  max count: 1
property:
  path: entry
  node: EntryShape
  class: Entry
  node kind: BlankNodeOrIRI
sparql: SPARQLConstraint
  message: Record entry keys must be unique
  select: SELECT $this ?key WHERE { $this <https://relay.inferal.com/ontology/triplewhale/record/TripleWhale.PixelOrders.ProductsInfo/properties/entry> ?left, ?right . FILTER(?left != ?right) ?left <https://relay.inferal.com/ontology/triplewhale/record/TripleWhale.PixelOrders.ProductsInfo/properties/key> ?key . ?right <https://relay.inferal.com/ontology/triplewhale/record/TripleWhale.PixelOrders.ProductsInfo/properties/key> ?key . }

EntryShape
type: NodeShape
target class: Entry
property:
  path:
    inverse path: entry
  class: Container
  min count: 1
  max count: 1
property:
  path: key
  datatype: string
  min count: 1
  max count: 1
property:
  path: value
  datatype: JSON
  min count: 1
  max count: 1

ContainerShape
type: NodeShape
target class: Container
property:
  path:
    inverse path: duties
  class: RefundProductsInfo
  min count: 1
  max count: 1
property:
  path: entry
  node: EntryShape
  class: Entry
  node kind: BlankNodeOrIRI
sparql: SPARQLConstraint
  message: Record entry keys must be unique
  select: SELECT $this ?key WHERE { $this <https://relay.inferal.com/ontology/triplewhale/record/TripleWhale.Refunds.ProductsInfo/duties/entry> ?left, ?right . FILTER(?left != ?right) ?left <https://relay.inferal.com/ontology/triplewhale/record/TripleWhale.Refunds.ProductsInfo/duties/key> ?key . ?right <https://relay.inferal.com/ontology/triplewhale/record/TripleWhale.Refunds.ProductsInfo/duties/key> ?key . }

EntryShape
type: NodeShape
target class: Entry
property:
  path:
    inverse path: entry
  class: Container
  min count: 1
  max count: 1
property:
  path: key
  datatype: string
  min count: 1
  max count: 1
property:
  path: value
  datatype: JSON
  min count: 1
  max count: 1

ContainerShape
type: NodeShape
target class: Container
property:
  path:
    inverse path: dutiesTaxLines
  class: RefundProductsInfo
  min count: 1
  max count: 1
property:
  path: entry
  node: EntryShape
  class: Entry
  node kind: BlankNodeOrIRI
sparql: SPARQLConstraint
  message: Record entry keys must be unique
  select: SELECT $this ?key WHERE { $this <https://relay.inferal.com/ontology/triplewhale/record/TripleWhale.Refunds.ProductsInfo/dutiesTaxLines/entry> ?left, ?right . FILTER(?left != ?right) ?left <https://relay.inferal.com/ontology/triplewhale/record/TripleWhale.Refunds.ProductsInfo/dutiesTaxLines/key> ?key . ?right <https://relay.inferal.com/ontology/triplewhale/record/TripleWhale.Refunds.ProductsInfo/dutiesTaxLines/key> ?key . }

EntryShape
type: NodeShape
target class: Entry
property:
  path:
    inverse path: entry
  class: Container
  min count: 1
  max count: 1
property:
  path: key
  datatype: string
  min count: 1
  max count: 1
property:
  path: value
  datatype: JSON
  min count: 1
  max count: 1

ContainerShape
type: NodeShape
target class: Container
property:
  path:
    inverse path: properties
  class: RefundProductsInfo
  min count: 1
  max count: 1
property:
  path: entry
  node: EntryShape
  class: Entry
  node kind: BlankNodeOrIRI
sparql: SPARQLConstraint
  message: Record entry keys must be unique
  select: SELECT $this ?key WHERE { $this <https://relay.inferal.com/ontology/triplewhale/record/TripleWhale.Refunds.ProductsInfo/properties/entry> ?left, ?right . FILTER(?left != ?right) ?left <https://relay.inferal.com/ontology/triplewhale/record/TripleWhale.Refunds.ProductsInfo/properties/key> ?key . ?right <https://relay.inferal.com/ontology/triplewhale/record/TripleWhale.Refunds.ProductsInfo/properties/key> ?key . }

EntryShape
type: NodeShape
target class: Entry
property:
  path:
    inverse path: entry
  class: Container
  min count: 1
  max count: 1
property:
  path: key
  datatype: string
  min count: 1
  max count: 1
property:
  path: value
  datatype: JSON
  min count: 1
  max count: 1

path: campaignDailyBudgetChangedTo
name: campaign daily budget changed to
description: Campaign Daily Budget Changed To - The updated daily budget in cents) for the campaign, after the most recent change. By default shown in the shop's currency.
datatype: string
max count: 1

path: campaignLifetimeBudgetChangedFrom
name: campaign lifetime budget changed from
description: Campaign Lifetime Budget Changed From - The previous lifetime budget in cents) for the campaign, before the most recent change. By default shown in the shop's currency.
datatype: string
max count: 1

path: campaignLifetimeBudgetChangedTo
name: campaign lifetime budget changed to
description: Campaign Lifetime Budget Changed To - The updated lifetime budget in cents) for the campaign, after the most recent change. By default shown in the shop's currency.
datatype: string
max count: 1

path: campaignStatusChangedFrom
name: campaign status changed from
description: Campaign Status Changed From - The prior status of the campaign. Example values: Draft , ACTIVE , Sending , IN_PROCESS , Queued without Recipients
datatype: string
max count: 1

path: campaignStatusChangedTo
name: campaign status changed to
description: Campaign Status Changed To - The new status of the campaign. Example values: Draft , ACTIVE , Sending , IN_PROCESS , Queued without Recipients
datatype: string
max count: 1

path: campaignTargetRoasChangedFrom
name: campaign target roas changed from
description: Campaign Target ROAS Changed From - The previous target ROAS for the campaign, before the most recent change. By default shown in the shop's currency.
datatype: string
max count: 1

path: campaignTargetRoasChangedTo
name: campaign target roas changed to
description: Campaign Target ROAS Changed To - The updated target ROAS for the campaign, after the most recent change. By default shown in the shop's currency.
datatype: string
max count: 1

path: cdpSegmentSyncToFacebookStatus
name: cdp segment sync to facebook status
description: CDP Sync to Facebook Status - The result of syncing the CDP segment to Facebook. Example values: disconnect_sync_to_facebook , sync_to_facebook
datatype: string
max count: 1

path: cdpSegmentSyncToKlaviyoStatus
name: cdp segment sync to klaviyo status
description: CDP Sync to Klaviyo Status - The result of syncing the CDP segment to Klaviyo. Example values: disconnect_sync_to_klaviyo , sync_to_klaviyo
datatype: string
max count: 1

path: channel
name: channel
description: Channel - The platform or channel that the activity occurred in. Example values: facebook-ads , shopify , triple-whale
datatype: string
max count: 1

path: createdAt
name: created at
description: Created At - The timestamp when the activity occurred. Example: 2025-05-28 17:17:34
datatype: dateTime
max count: 1

path: createdCdpSegment
name: created cdp segment
description: Created CDP Segment - Indicates whether a CDP segment was created. Possible values: true , false
datatype: boolean
max count: 1

path: createdPostPurchaseSurveyDescription
name: created post purchase survey description
description: Created Survey Description - A message indicating that a post-purchase survey was created. Example value: Post Purchase Survey Created
datatype: string
max count: 1

path: deletedPostPurchaseSurveyDescription
name: deleted post purchase survey description
description: Deleted Survey Description - A message indicating that a post-purchase survey was deleted. Example value: Post Purchase Survey Deleted
datatype: string
max count: 1

path: entity
name: entity
description: Entity Type - The type of entity that the activity occurred on. Example values: adset , ad , campaign , variant , cdp_segment
datatype: string
max count: 1

path: entityId
name: entity id
description: Entity ID - Unique identifier for the activity log entry. Example value: 23844267499760291
datatype: string
max count: 1

path: entityName
name: entity name
description: Entity Name - Name of the entity that the activity occurred on. Example values: Natural Woven Bundle , Meta Monday , BFCM Lost
datatype: string
max count: 1

path: shopId
name: shop id
description: Shop ID - The unique ID of the shop (often corresponds to the shop domain). Can be used to group or filter data by shop in multi-store reports. Example values: example-US.myshopify.com , example-EU.myshopify.com
datatype: string
max count: 1

path: shopName
name: shop name
description: Shop Name - The name of the shop. Can be used to group or filter data by shop in multi-store reports. Example values: example-US , example-EU
datatype: string
max count: 1

path: updatedIntegrationDescription
name: updated integration description
description: Updated Integration Description - A message indicating that an integration was updated. Example value: Facebook Ads Disconnected
datatype: string
max count: 1

path: updatedIntegrationSource
name: updated integration source
description: Updated Integration Source - The integration source that was updated. Example value: facebook-ads
datatype: string
max count: 1

path: updatedIntegrationTitle
name: updated integration title
description: Updated Integration Title - The title of the message indicating that an integration was updated. Example: Integrations Updated
datatype: string
max count: 1

path: updatedNewUserDescription
name: updated new user description
description: Updated New User Description - A message indicating that a user was updated.
datatype: string
max count: 1

path: updatedPostPurchaseSurveyDescription
name: updated post purchase survey description
description: Updated Survey Description - A message indicating that a post-purchase survey was updated. Example value: Post Purchase Survey Updated
datatype: string
max count: 1

path: variantPriceChangedFrom
name: variant price changed from
description: Variant Price Changed From - The previous price of the product variant, before the most recent change. By default shown in the shop's currency.
datatype: string
max count: 1

path: variantPriceChangedTo
name: variant price changed to
description: Variant Price Changed To - The updated price of the product variant, after the most recent change. By default shown in the shop's currency.
datatype: string
max count: 1

path: variantStockStatus
name: variant stock status
description: Variant Stock Status - The inventory status of a product variant. Example values: out of stock , back in stock
datatype: string
max count: 1

path: campaignBidStrategy
name: campaign bid strategy
description: Campaign Bid Strategy - The bidding strategy for the campaign. Example values: LOWEST_COST_WITHOUT_CAP , LOWEST_COST_WITH_BID_CAP , COST_CAP , LOWEST_COST_WITH_MIN_ROAS
datatype: string
max count: 1

path: campaignCreatedAt
name: campaign created at
description: Campaign Created Date - The time the campaign was created. Formatted according to the ISO 8601 international standard. Example value: 2019-04-15 08:26:00 Currently available for Meta only.
datatype: date
max count: 1

path: campaignId
name: campaign id
description: Campaign ID - The unique ID for the marketing campaign associated with the ad. Assigned by the ad platform. Example values: 23852438666180053 , 531011533 , 20620285829
datatype: string
max count: 1

path: campaignName
name: campaign name
description: Campaign Name - The name of the marketing campaign associated with the ad. Example values: Catalog Retargeting , US Generic Search , Breakfast of Champions Campaign
datatype: string
max count: 1

path: campaignStatus
name: campaign status
description: Campaign Status - The status of the campaign. Example values: ACTIVE , PAUSED
datatype: string
max count: 1

path: campaignType
name: campaign type
description: Campaign Type - The type of campaign. Example values: PERFORMANCE_MAX , SEARCH , VIDEO , DEMAND_GEN
datatype: string
max count: 1

path: channel
name: channel
description: Channel - The platform through which the ad was delivered. Example values: facebook-ads , google-ads , tiktok-ads See full list of standardized ad channel IDs
datatype: string
max count: 1

path: creativeCtaType
name: creative cta type
description: Creative CTA Type - The type of call-to-action button displayed on the ad, indicating the action the advertiser wants users to take. Example values: SHOP_NOW , LEARN_MORE
datatype: string
max count: 1

path: creativeDistributionFormat
name: creative distribution format
description: Creative Distribution Format - The ad distribution format. Example values: Standard Ad , Dynamic Creative Ad , Unknown
datatype: string
max count: 1

path: creativeFormat
name: creative format
description: Creative Format - The format of the ad creative. Example values: SHARE , VIDEO
datatype: string
max count: 1

path: creativeId
name: creative id
description: Creative ID - The unique identifier assigned to the creative asset by the ad platform. Example value: 1326015151986179
datatype: string
max count: 1

path: currency
name: currency
description: Ad Platform Currency - The original currency used in the ad platform, before conversion to the shop's currency. All monetary values are automatically converted to the shop's selected currency for display. Example values: USD , GBP , EUR
datatype: string
max count: 1

path: customConversions
name: custom conversions
description: Custom Conversions - Custom conversions defined by the user in the ad platform.
node: AdsCustomConversionShape
class: AdsCustomConversion
node kind: BlankNodeOrIRI

path: destinationUrl
name: destination url
description: Destination URL - The destination URL where users land after clicking the ad. Currently available for Meta, Google, and Pinterest. Example value: https://www.myshop.com/products/ productA
datatype: anyURI
max count: 1

path: isUtmValid
name: is utm valid
description: Is UTM Valid - Indicates whether the UTM setup in the platform is valid. Possible values: true , false
datatype: boolean
max count: 1

path: shopId
name: shop id
description: Shop ID - The unique ID of the shop (often corresponds to the shop domain). Can be used to group or filter data by shop in multi-store reports. Example values: example-US.myshopify.com , example-EU.myshopify.com
datatype: string
max count: 1

path: shopName
name: shop name
description: Shop Name - The name of the shop. Can be used to group or filter data by shop in multi-store reports. Example values: example-US , example-EU
datatype: string
max count: 1

path: urlTemplate
name: url template
description: URL Template - A template URL used to dynamically populate ad URLs with relevant tracking parameters. Example value: utm_source=facebook&utm_campaign={{campaign.name}}
datatype: string
max count: 1

path: videoUrl
name: video url
description: Video URL - The direct link to the video ad hosted on the ad platform. Example value: https://www.youtube.com/embed/ abcdef12345
datatype: anyURI
max count: 1

path: videoUrlIframe
name: video url iframe
description: Video URL Iframe - The iframe embed code for displaying the video ad within a web page or app. Example value: https://www.facebook.com/plugins/ video.phpwidth=1080&href=https:// www.facebook.com/ 123456789/videos/987654321
datatype: string
max count: 1

path: videoUrlSource
name: video url source
description: Video URL Source - The direct file path to the hosted video source, typically used for playback. Example value: https://video-ord5-2.xx.fbcdn.net/o1/v/t2/f2/m69/example-video.mp4?_nc_ht=video-ord5-2.xx.fbcdn.net&_nc_cat=111& oh=1234567890abcdef&oe=67C3D77F
datatype: string
max count: 1

path: adsetDailyBudget
name: adset daily budget
description: Ad Set Daily Budget - The daily budget (in cents) set for the ad set within a campaign. By default shown in the shop's currency. Example values: 1750 , 6000 , 40000
datatype: long
max count: 1

path: adsetLifetimeBudget
name: adset lifetime budget
description: Ad Set Lifetime Budget - The total budget (in cents) set for the ad set within a campaign over its lifetime. By default shown in the shop's currency. Example values: 5000 , 10000 , 20000
datatype: long
max count: 1

path: adsetTargetCpa
name: adset target cpa
description: Ad Set Target CPA - The cost per acquisition (CPA) goal defined at the ad set level. Represents the maximum amount the advertiser is willing to spend to generate a single conversion within this ad set. Currently available for Google Ads only.
datatype: double
max count: 1

path: adsetTargetRoas
name: adset target roas
description: Ad Set Target ROAS - The return on ad spend (ROAS) goal defined at the ad set level. Indicates the minimum amount of revenue the advertiser aims to generate for each dollar spent within this specific ad set. Currently available for Google Ads only.
datatype: double
max count: 1

path: allConversionValue
name: all conversion value
description: All Conversion Value - Revenue generated from channel-reported conversions of all types (e.g. purchases, registrations, add-to-carts).
datatype: double
max count: 1

path: allConversions
name: all conversions
description: All Conversions - The total number of channel-reported conversions of all types (e.g. purchases, registrations, add-to-carts).
datatype: double
max count: 1

path: campaignDailyBudget
name: campaign daily budget
description: Campaign Daily Budget - The daily budget (in cents) for the campaign. Example values: 8000 , 10000 , 15000
datatype: long
max count: 1

path: campaignLifetimeBudget
name: campaign lifetime budget
description: Campaign Lifetime Budget - The lifetime budget (in cents) for the campaign. Example values: 5000 , 10000 , 20000
datatype: long
max count: 1

path: campaignTargetCpa
name: campaign target cpa
description: Campaign Target CPA - The cost per acquisition (CPA) goal defined at the campaign level. Represents the maximum amount the advertiser is willing to spend to generate a single conversion across the campaign. Currently available for Google Ads only.
datatype: double
max count: 1

path: campaignTargetRoas
name: campaign target roas
description: Campaign Target ROAS - The return on ad spend (ROAS) goal defined at the campaign level. Indicates the minimum amount of revenue the advertiser aims to generate for each dollar spent across the entire campaign. Currently available for Google Ads only.
datatype: double
max count: 1

path: clicks
name: clicks
description: Clicks - Number of channel-reported clicks.
datatype: double
max count: 1

path: currencyRate
name: currency rate
description: Currency Rate - The rate used to convert monetary values to the shop's currency. If no conversion was applied, the value is 1 . To convert back to the original currency, divide by this rate.
datatype: double
max count: 1

path: conversionValue
name: conversion value
description: Channel-Reported Conversion Value - Revenue generated from channel-reported conversions (purchases).
datatype: double
max count: 1

path: conversions
name: conversions
description: Channel-Reported Conversions (Purchases) - Number of channel-reported conversions (purchases).
datatype: double
max count: 1

path: engagements
name: engagements
description: Engagements - Number of interactions with the ad (likes, shares, etc).
datatype: double
max count: 1

path: follows
name: follows
description: Follows - Number of new follows attributed to the ad.
datatype: double
max count: 1

path: impressions
name: impressions
description: Impressions - Number of channel-reported impressions.
datatype: double
max count: 1

path: inlinePostEngagement
name: inline post engagement
description: Inline Post Engagement - Number of inline engagement (likes, shares, comments) with the ad.
datatype: double
max count: 1

path: oneDayClickComments
name: one day click comments
description: One-Day Click Comments - Number of comments within one day of clicking the ad.
datatype: double
max count: 1

path: oneDayClickConversionValue
name: one day click conversion value
description: One-Day Click Conversion Value - The total value of channel-reported conversions (purchases) made within one day of clicking the ad.
datatype: double
max count: 1

path: oneDayClickLikes
name: one day click likes
description: One-Day Click Likes - Number of likes within one day of clicking the ad.
datatype: double
max count: 1

path: oneDayClickLinkClicks
name: one day click link clicks
description: One-Day Click Link Clicks - Number of link clicks within one day of clicking the ad.
datatype: double
max count: 1

path: oneDayClickPurchases
name: one day click purchases
description: One-Day Click Conversions (Purchases) - Number of channel-reported conversions (purchases) made within one day of clicking the ad.
datatype: double
max count: 1

path: oneDayClickReactions
name: one day click reactions
description: One-Day Click Reactions - Number of reactions within one day of clicking the ad.
datatype: double
max count: 1

path: oneDayClickShares
name: one day click shares
description: One-Day Click Shares - Number of shares within one day of clicking the ad.
datatype: double
max count: 1

path: oneDayViewConversionValue
name: one day view conversion value
description: One-Day View Conversion Value - The total value of channel-reported conversions (purchases) made within one day of viewing the ad.
datatype: double
max count: 1

path: oneDayViewPurchases
name: one day view purchases
description: One-Day View Conversions (Purchases) - The total number of channel-reported conversions (purchases) made within one day of viewing the ad.
datatype: double
max count: 1

path: onsiteConversionValue
name: onsite conversion value
description: Onsite Conversion Value - Revenue from channel-reported conversions (purchases) made on the ad channel shop (e.g. Meta Shop, TikTok Shop).
datatype: double
max count: 1

path: onsiteOneDayClickConversionValue
name: onsite one day click conversion value
description: Onsite One-Day Click Conversion Value - The total value of channel-reported conversions (purchases) made on the ad channel shop (e.g. Meta Shop, TikTok Shop) within one day of clicking the ad.
datatype: double
max count: 1

path: onsiteOneDayClickPurchases
name: onsite one day click purchases
description: Onsite One-Day Click Conversions (Purchases) - The total number of channel-reported conversions (purchases) made on the ad channel shop (e.g. Meta Shop, TikTok Shop) within one day of clicking the ad.
datatype: double
max count: 1

path: onsiteOneDayViewConversionValue
name: onsite one day view conversion value
description: Onsite One-Day View Conversion Value - The total value of channel-reported conversions (purchases) made on the ad channel shop (e.g. Meta Shop, TikTok Shop) within one day of viewing the ad.
datatype: double
max count: 1

path: onsiteOneDayViewPurchases
name: onsite one day view purchases
description: Onsite One-Day View Conversions (Purchases) - The total number of channel-reported conversions (purchases) made on the ad channel shop (e.g. Meta Shop, TikTok Shop) within one day of viewing the ad.
datatype: double
max count: 1

path: onsitePurchases
name: onsite purchases
description: Onsite Conversions (Purchases) - Number of channel-reported conversions (purchases) made on the ad channel shop (e.g. Meta Shop, TikTok Shop).
datatype: double
max count: 1

path: onsiteSevenDayClickConversionValue
name: onsite seven day click conversion value
description: Onsite Seven-Day Click Conversion Value - The total value of channel-reported conversions (purchases) made on the ad channel shop (e.g. Meta Shop, TikTok Shop) within seven days of clicking the ad.
datatype: double
max count: 1

path: onsiteSevenDayClickPurchases
name: onsite seven day click purchases
description: Onsite Seven-Day Click Conversions (Purchases) - The total number of channel-reported conversions (purchases) made on the ad channel shop (e.g. Meta Shop, TikTok Shop) within seven days of clicking the ad.
datatype: double
max count: 1

path: onsiteSevenDayViewConversionValue
name: onsite seven day view conversion value
description: Onsite Seven-Day View Conversion Value - The total value of channel-reported conversions (purchases) made on the ad channel shop (e.g. Meta Shop, TikTok Shop) within seven days of viewing the ad.
datatype: double
max count: 1

path: onsiteSevenDayViewPurchases
name: onsite seven day view purchases
description: Onsite Seven-Day View Conversions (Purchases) - The total number of channel-reported conversions (purchases) made on the ad channel shop (e.g. Meta Shop, TikTok Shop) within seven days of viewing the ad.
datatype: double
max count: 1

path: onsiteTwentyEightDayClickConversionValue
name: onsite twenty eight day click conversion value
description: Onsite 28-Day Click Conversion Value - The total value of channel-reported conversions (purchases) made on the ad channel shop (e.g. Meta Shop, TikTok Shop) within 28 days of clicking the ad.
datatype: double
max count: 1

path: onsiteTwentyEightDayClickPurchases
name: onsite twenty eight day click purchases
description: Onsite 28-day Click Conversions (Purchases) - The total number of channel-reported conversions (purchases) made on the ad channel shop (e.g. Meta Shop, TikTok Shop) within 28 days of clicking the ad.
datatype: double
max count: 1

path: onsiteTwentyEightDayViewConversionValue
name: onsite twenty eight day view conversion value
description: Onsite 28-Day View Conversion Value - The total value of channel-reported conversions (purchases) made on the ad channel shop (e.g. Meta Shop, TikTok Shop) within 28 days of viewing the ad.
datatype: double
max count: 1

path: onsiteTwentyEightDayViewPurchases
name: onsite twenty eight day view purchases
description: Onsite 28-day View Conversions (Purchases) - The total number of channel-reported conversions (purchases) made on the ad channel shop (e.g. Meta Shop, TikTok Shop) within 28 days of viewing the ad.
datatype: double
max count: 1

path: outboundClicks
name: outbound clicks
description: Outbound Clicks - Number of channel-reported outbound clicks.
datatype: double
max count: 1

path: reach
name: reach
description: Reach - The total number of unique individuals who saw the ad.
datatype: double
max count: 1

path: searchAbsoluteTopImpressions
name: search absolute top impressions
description: Search Absolute Top Impressions - The number of impressions your ads received in the absolute top position (the very first ad above organic results).
datatype: double
max count: 1

path: searchBudgetLostAbsoluteTopImpressions
name: search budget lost absolute top impressions
description: Search Budget Lost Absolute Top Impressions - The estimated number of absolute top impressions your ads missed due to low budget.
datatype: double
max count: 1

path: searchBudgetLostTopImpressions
name: search budget lost top impressions
description: Search Budget Lost Top Impressions - The estimated number of top impressions your ads missed due to low budget.
datatype: double
max count: 1

path: searchImpressions
name: search impressions
description: Search Impressions - The total number of impressions your ads received on the Search Network.
datatype: double
max count: 1

path: searchRankLostImpressions
name: search rank lost impressions
description: Search Rank Lost Impressions - The estimated number of impressions your ads did not receive because Ad Rank was too low.
datatype: double
max count: 1

path: searchRankLostTopImpressions
name: search rank lost top impressions
description: Search Rank Lost Top Impressions - The estimated number of top impressions your ads missed due to poor Ad Rank.
datatype: double
max count: 1

path: searchTopImpressions
name: search top impressions
description: Search Top Impressions - The number of impressions your ads received in the top position (any position above organic results).
datatype: double
max count: 1

path: sevenDayClickComments
name: seven day click comments
description: Seven-Day Click Comments - Number of comments within seven days of clicking the ad.
datatype: double
max count: 1

path: sevenDayClickConversionValue
name: seven day click conversion value
description: Seven-Day Click Conversion Value - The total value of channel-reported conversions (purchases) made within seven days of clicking the ad.
datatype: double
max count: 1

path: sevenDayClickLikes
name: seven day click likes
description: Seven-Day Click Likes - Number of likes within seven days of clicking the ad.
datatype: double
max count: 1

path: sevenDayClickLinkClicks
name: seven day click link clicks
description: Seven-Day Click Link Clicks - Number of link clicks within seven days of clicking the ad.
datatype: double
max count: 1

path: sevenDayClickPurchases
name: seven day click purchases
description: Seven-Day Click Conversions (Purchases) - Number of channel-reported conversions (purchases) made within seven days of clicking the ad.
datatype: double
max count: 1

path: sevenDayClickReactions
name: seven day click reactions
description: Seven-Day Click Reactions - Number of reactions within seven days of clicking the ad.
datatype: double
max count: 1

path: sevenDayClickShares
name: seven day click shares
description: Seven-Day Click Shares - Number of shares within seven days of clicking the ad.
datatype: double
max count: 1

path: sevenDayViewConversionValue
name: seven day view conversion value
description: Seven-Day View Conversion Value - The total value of channel-reported conversions (purchases) made within seven days of viewing the ad.
datatype: double
max count: 1

path: sevenDayViewPurchases
name: seven day view purchases
description: Seven-Day View Conversions (Purchases) - The total number of channel-reported conversions (purchases) made within seven days of viewing the ad.
datatype: double
max count: 1

path: spend
name: spend
description: Ad Spend - Channel-reported ad spend, excluding any custom expenses marked as ad spend.
datatype: double
max count: 1

path: threeSecondVideoView
name: three second video view
description: Three-Second Video View - The number of times a video ad was viewed for at least 3 seconds (thumbstop ratio).
datatype: double
max count: 1

path: thruplays
name: thruplays
description: Thruplays - The number of times a video ad was played to completion or for at least 15 seconds.
datatype: double
max count: 1

path: twentyEightDayClickConversionValue
name: twenty eight day click conversion value
description: Twenty-Eight-Day Click Conversion Value - The total value of channel-reported conversions (purchases) made within 28 days of clicking the ad.
datatype: double
max count: 1

path: twentyEightDayClickLinkClicks
name: twenty eight day click link clicks
description: Twenty-Eight-Day Click Link Clicks - Number of link clicks within 28 days of clicking the ad.
datatype: double
max count: 1

path: twentyEightDayClickPurchases
name: twenty eight day click purchases
description: Twenty-Eight-Day Click Conversions (Purchases) - Number of channel-reported conversions (purchases) made within 28 days of clicking the ad.
datatype: double
max count: 1

path: twentyEightDayViewConversionValue
name: twenty eight day view conversion value
description: Twenty-Eight-Day View Conversion Value - The total value of channel-reported conversions (purchases) made within 28 days of viewing the ad.
datatype: double
max count: 1

path: twentyEightDayViewPurchases
name: twenty eight day view purchases
description: Twenty-Eight-Day View Conversions (Purchases) - The total number of channel-reported conversions (purchases) made within 28 days of viewing the ad.
datatype: double
max count: 1

path: videoP100Watched
name: video p100watched
description: Video 100% Watched - The number of times a video ad was watched for 100% of the video.
datatype: double
max count: 1

path: videoP25Watched
name: video p25watched
description: Video 25% Watched - The number of times a video ad was watched for 25% of the video.
datatype: double
max count: 1

path: videoP50Watched
name: video p50watched
description: Video 50% Watched - The number of times a video ad was watched for 50% of the video.
datatype: double
max count: 1

path: videoP75Watched
name: video p75watched
description: Video 75% Watched - The number of times a video ad was watched for 75% of the video.
datatype: double
max count: 1

path: videoP95Watched
name: video p95watched
description: Video 95% Watched - The number of times a video ad was watched for 95% of the video.
datatype: double
max count: 1

path: visits
name: visits
description: Visits - Number of channel-reported visits. Currently available for Criteo only.
datatype: double
max count: 1

path: allCpa
name: all cpa
description: All Cost Per Acquisition (All CPA) - Cost per conversion of all types (e.g. purchases, registrations, subscriptions, applications). All CPA = Ad Spend / All Conversions
datatype: string
max count: 1

path: allRoas
name: all roas
description: All Return on Ad Spend - Revenue generated per dollar spent on ads, for channel-reported conversions of all types (e.g. purchases, registrations, subscriptions, applications). All ROAS = All Conversion Value / Ad Spend
datatype: string
max count: 1

path: aov
name: aov
description: Average Order Value - The average order value as reported by the ad channel. Channel-Reported AOV = Channel-Reported Conversion Value / Number of Channel-Reported Conversions
datatype: string
max count: 1

path: conversionRate
name: conversion rate
description: Conversion Rate - The percentage of visits that convert into orders, as reported by the channel. Channel-Reported Conversion Rate = Number of Channel-Reported Conversions / Number of Visits
datatype: string
max count: 1

path: cpa
name: cpa
description: Cost Per Acquisition - The cost to acquire a single conversion, as reported by the channel. Channel-Reported CPA = Ad Spend / Number of Channel-Reported Conversions
datatype: string
max count: 1

path: cpc
name: cpc
description: Cost Per Click - The average cost for each ad click. CPC = Ad Spend / Clicks
datatype: string
max count: 1

path: cpm
name: cpm
description: Cost Per Mille - The cost for 1,000 ad impressions. CPM = Ad Spend / Impressions x 1000
datatype: string
max count: 1

path: cpoc
name: cpoc
description: Cost Per Outbound Click - Cost for each click leading out from the ad platform to an external website. CPOC = Ad Spend / Outbound Clicks
datatype: string
max count: 1

path: cpv
name: cpv
description: Cost Per Visit - The cost for each visit driven by ads. CPV = Ad Spend / Number of Visits
datatype: string
max count: 1

path: ctr
name: ctr
description: Click-Through Rate - The percentage of impressions that result in a click. Click-Through Rate (CTR) = Clicks / Impressions
datatype: string
max count: 1

path: revenuePerLinkClick
name: revenue per link click
description: Revenue Per Link Click - Average revenue generated from each outbound click on the ad. Revenue Per Link Click = Conversion Value / Outbound Clicks
datatype: string
max count: 1

path: roas
name: roas
description: Channel-Reported Return on Ad Spend - Revenue generated per dollar spent on ads, as reported by the channel. Channel-Reported ROAS = Channel-Reported Conversion Value / Ad Spend
datatype: string
max count: 1

path: searchAbsoluteTopImpressionShare
name: search absolute top impression share
description: Search Absolute Top Impression Share - The percentage of impressions your ads received in the absolute top location (the very first ad above organic results). Search Absolute Top Impression Share = Search Absolute Top Impressions / Impressions Note: Accurate only when grouping by ad set (ad group).
datatype: double
max count: 1

path: searchBudgetLostAbsoluteTopImpressionShare
name: search budget lost absolute top impression share
description: Search Budget Lost Absolute Top Impression Share - The percentage of absolute top impressions your ads did not receive because the campaign budget was limited. Search Budget Lost Absolute Top Impression Share = Search Budget Lost Absolute Top Impressions / Impressions Note: Accurate only when grouping by ad set (ad group).
datatype: double
max count: 1

path: searchBudgetLostTopImpressionShare
name: search budget lost top impression share
description: Search Budget Lost Top Impression Share - The percentage of top impressions your ads did not receive because the campaign budget was limited. Search Budget Lost Top Impression Share = Search Budget Lost Top Impressions / Impressions Note: Accurate only when grouping by ad set (ad group).
datatype: double
max count: 1

path: searchImpressionShare
name: search impression share
description: Search Impression Share - The percentage of impressions your ads received on the Search Network out of the total impressions they were eligible to receive. Search Impression Share = Search Impressions / Impressions Note: Accurate only when grouping by ad set (ad group).
datatype: double
max count: 1

path: searchRankLostImpressionShare
name: search rank lost impression share
description: Search Rank Lost Impression Share - The percentage of impressions your ads did not receive because Ad Rank was too low. Search Rank Lost Impression Share = Search Rank Lost Impressions / Impressions Note: Accurate only when grouping by ad set (ad group).
datatype: double
max count: 1

path: searchRankLostTopImpressionShare
name: search rank lost top impression share
description: Search Rank Lost Top Impression Share - The percentage of top impressions your ads did not receive because Ad Rank was too low. Search Rank Lost Top Impression Share = Search Rank Lost Top Impressions / Impressions Note: Accurate only when grouping by ad set (ad group).
datatype: double
max count: 1

path: searchTopImpressionShare
name: search top impression share
description: Search Top Impression Share - The percentage of impressions your ads received in the top location (any position above organic results). Search Top Impression Share = Search Top Impressions / Impressions Note: Accurate only when grouping by ad set (ad group).
datatype: double
max count: 1

path: baRoas
name: ba roas
description: Blended Attributed Return on Ad Spend (BA ROAS) - Revenue attributed to ads relative to ad spend across all channels. Blended-Attributed ROAS = Blended Channel-Reported Conversion Value / Blended Ad Spend
datatype: string
max count: 1

path: blendedCpa
name: blended cpa
description: Blended Cost per Acquisition (Blended CPA) - Average ad cost per non-zero order across all channels. Blended CPA = Blended Ad Spend / Number of Orders > $0
datatype: string
max count: 1

path: cashTurnover
name: cash turnover
description: Cash Turnover - Cash generated after deducting key expenses from order revenue. Cash Turnover = Order Revenue - Shipping Costs - Payment Gateway Costs - Taxes - Blended Ad Spend - Refunds - Order-Level Custom Expenses
datatype: string
max count: 1

path: costPerSession
name: cost per session
description: Cost per Session - Average ad cost per customer session. Cost Per Session = Blended Ad Spend / Number of Sessions
datatype: string
max count: 1

path: grossProfit
name: gross profit
description: Gross Profit - Profit after deducting all costs to the seller. Gross Profit = Total Sales - Total Costs
datatype: string
max count: 1

path: grossRevenue
name: gross revenue
description: Gross Revenue - Gross revenue kept by the business after shipping, taxes, discounts, and refunded sales (before refunded shipping or refunded taxes). Revenue values are based on the order date; refund values are based on the refund date. Total Sales = Gross Sales + Shipping + Taxes − Discounts − Refunded Sales
datatype: string
max count: 1

path: klaviyoSalesPercentage
name: klaviyo sales percentage
description: Klaviyo Sales Percentage - Share of total revenue attributed to Klaviyo. Klaviyo Sales Percentage = Klaviyo CV / Total Order Revenue
datatype: string
max count: 1

path: mer
name: mer
description: Marketing Efficiency Ratio (MER) - Ratio of ad spend to total revenue. MER = Blended Ad Spend / Order Revenue Note: For the inverse ratio (Order Revenue / Blended Ad Spend), see Blended ROAS.
datatype: string
max count: 1

path: ncpa
name: ncpa
description: New Customer Cost Per Acquisition (NCPA) - Average ad cost to acquire a new customer. NCPA = Blended Ad Spend / Number of New Customer Orders Learn how Triple Whale classifies new/returning customers .
datatype: string
max count: 1

path: netMargin
name: net margin
description: Net Margin - Percentage of revenue remaining as profit. Net Margin = Net Profit / Order Revenue
datatype: string
max count: 1

path: netProfit
name: net profit
description: Net Profit - Remaining revenue after deducting refunds, ad spend, and costs. Net Profit = Main Sales Platform Order Revenue (+ Amazon Product Sales) − Refunds − Ad Spend − Total Costs
datatype: string
max count: 1

path: netSales
name: net sales
description: Net Sales - Net sales revenue after discounts and refunded sales (before shipping or taxes). Net Sales = Gross Sales − Discounts − Refunded Sales
datatype: string
max count: 1

path: newCustomerRoas
name: new customer roas
description: New Customer Return on Ad Spend (NC ROAS) - Revenue from new customers relative to ad spend. New Customer ROAS = New Customer Revenue / Blended Ad Spend Learn how Triple Whale classifies new/returning customers .
datatype: string
max count: 1

path: poas
name: poas
description: Profit on Ad Spend (POAS) - Profit generated per dollar of ad spend. POAS = (Total Sales - Total Costs) / Ad Spend
datatype: string
max count: 1

path: roas
name: roas
description: Blended Return on Ad Spend (Blended ROAS) - Revenue generated per dollar spent on ads. Blended ROAS = Order Revenue / Blended Ad Spend Note: For the inverse ratio (Blended Ad Spend / Order Revenue), see MER.
datatype: string
max count: 1

path: numberOfAds
name: number of ads
description: Ads - Total number of ads containing the creative asset.
datatype: double
max count: 1

path: oneDayClickComments
name: one day click comments
description: One-Day Click Comments - Number of comments within one day of clicking the ad.
datatype: double
max count: 1

path: oneDayClickLikes
name: one day click likes
description: One-Day Click Likes - Number of likes within one day of clicking the ad.
datatype: double
max count: 1

path: oneDayClickReactions
name: one day click reactions
description: One-Day Click Reactions - Number of reactions within one day of clicking the ad.
datatype: double
max count: 1

path: oneDayClickShares
name: one day click shares
description: One-Day Click Shares - Number of shares within one day of clicking the ad.
datatype: double
max count: 1

path: oneDayViewConversionValue
name: one day view conversion value
description: One-Day View Conversion Value - The total value of channel-reported conversions (purchases) made within one day of viewing the ad.
datatype: double
max count: 1

path: oneDayViewPurchases
name: one day view purchases
description: One-Day View Conversions (Purchases) - The total number of channel-reported conversions (purchases) made within one day of viewing the ad.
datatype: double
max count: 1

path: onsitePurchases
name: onsite purchases
description: Onsite Conversions (Purchases) - Number of channel-reported conversions (purchases) made on the ad channel shop (e.g. Meta Shop, TikTok Shop).
datatype: double
max count: 1

path: orderRevenue
name: order revenue
description: Pixel Conversion Value (CV) - Pixel-reported conversion value (order revenue) after shipping, taxes, and discounts (before refunds). Order Revenue = Gross Sales + Shipping + Taxes − Discounts
datatype: double
max count: 1

path: ordersQuantity
name: orders quantity
description: Pixel Purchases - The total number of Pixel-reported purchases (orders) within the selected timeframe. Note: This value is calculated based on the attribution model, and may be a fractional number.
datatype: double
max count: 1

path: outboundClicks
name: outbound clicks
description: Outbound Clicks - Number of channel-reported outbound clicks.
datatype: double
max count: 1

path: sevenDayClickComments
name: seven day click comments
description: Seven-Day Click Comments - Number of comments within seven days of clicking the ad.
datatype: double
max count: 1

path: sevenDayClickLikes
name: seven day click likes
description: Seven-Day Click Likes - Number of likes within seven days of clicking the ad.
datatype: double
max count: 1

path: sevenDayClickReactions
name: seven day click reactions
description: Seven-Day Click Reactions - Number of reactions within seven days of clicking the ad.
datatype: double
max count: 1

path: sevenDayClickShares
name: seven day click shares
description: Seven-Day Click Shares - Number of shares within seven days of clicking the ad.
datatype: double
max count: 1

path: spend
name: spend
description: Ad Spend - Channel-reported ad spend, excluding any custom expenses marked as ad spend.
datatype: double
max count: 1

path: totalVideoView
name: total video view
description: Total Video View - The number of times a video ad was viewed for any amount of time.
datatype: double
max count: 1

path: videoP100Watched
name: video p100watched
description: Video 100% Watched - The number of times a video ad was watched for 100% of the video.
datatype: double
max count: 1

path: videoP25Watched
name: video p25watched
description: Video 25% Watched - The number of times a video ad was watched for 25% of the video.
datatype: double
max count: 1

path: videoP50Watched
name: video p50watched
description: Video 50% Watched - The number of times a video ad was watched for 50% of the video.
datatype: double
max count: 1

path: videoP75Watched
name: video p75watched
description: Video 75% Watched - The number of times a video ad was watched for 75% of the video.
datatype: double
max count: 1

path: videoP95Watched
name: video p95watched
description: Video 95% Watched - The number of times a video ad was watched for 95% of the video.
datatype: double
max count: 1

path: channelReportedAov
name: channel reported aov
description: Channel-Reported AOV - The average order value as reported by the advertising channel. Channel-Reported AOV = Channel-Reported Conversion Value / Number of Channel-Reported Conversions
datatype: string
max count: 1

path: channelReportedCpa
name: channel reported cpa
description: Channel-Reported Cost Per Acquisition - The cost to acquire a single conversion, as reported by the channel. Channel-Reported CPA = Ad Spend / Number of Channel-Reported Conversions
datatype: string
max count: 1

path: channelReportedRoas
name: channel reported roas
description: Channel-Reported Return on Ad Spend - Revenue generated per dollar spent on ads, as reported by the channel. Channel-Reported ROAS = Channel-Reported Conversion Value / Ad Spend
datatype: string
max count: 1

path: cpc
name: cpc
description: Cost Per Click (CPC) - The average cost for each ad click. Cost Per Click (CPC) = Ad Spend / Clicks
datatype: string
max count: 1

path: cpm
name: cpm
description: Cost Per Mille (CPM) - The cost for 1,000 ad impressions. Cost Per Mille (CPM) = Ad Spend / Impressions x 1000
datatype: string
max count: 1

path: ctr
name: ctr
description: Click-Through Rate - The percentage of impressions that result in a click. Click-Through Rate (CTR) = Clicks / Impressions
datatype: string
max count: 1

path: ncpa
name: ncpa
description: Pixel New Customer Cost Per Acquisition - The cost to acquire a new customer, as reported by Pixel. Pixel NCPA = Blended Ad Spend / Number of New Customer Orders Learn how Triple Whale classifies new/returning customers .
datatype: string
max count: 1

path: newCustomerRoas
name: new customer roas
description: Pixel New Customer ROAS - Revenue from new customers relative to ad spend. Pixel NC ROAS = New Customer Pixel Conversion Value / Ad Spend Learn how Triple Whale classifies new/returning customers .
datatype: string
max count: 1

path: newCustomersPercent
name: new customers percent
description: Pixel New Customers Percent - The percentage of Pixel-reported purchases made by new customers. Pixel New Customers % = Number of New Customer Pixel Purchases / Total Pixel Purchases Learn how Triple Whale classifies new/returning customers .
datatype: string
max count: 1

path: outboundCtr
name: outbound ctr
description: Outbound Click-Through Rate - The percentage of impressions that result in outbound clicks. Outbound CTR = Outbound Clicks / Impressions
datatype: string
max count: 1

path: pixelAov
name: pixel aov
description: Pixel AOV - The Pixel-reported average order value. Pixel AOV = Pixel Conversion Value / Number of Pixel Purchases
datatype: string
max count: 1

path: pixelCpa
name: pixel cpa
description: Pixel Cost Per Acquisition - The cost to acquire a purchase as reported by Pixel. Pixel CPA = Ad Spend / Number of Pixel Purchases
datatype: string
max count: 1

path: pixelNcAov
name: pixel nc aov
description: Pixel New Customer Average Order Value - The average order value for new customers as reported by Pixel. Pixel NC AOV = New Customer Pixel Conversion Value / Number of New Customer Pixel Purchases Learn how Triple Whale classifies new/returning customers .
datatype: string
max count: 1

path: pixelProfit
name: pixel profit
description: Pixel Profit - The profit calculated as conversion value (order revenue) minus ad spend and cost of goods, as reported by Pixel. Pixel Profit = Pixel Conversion Value - Ad Spend - Pixel COGS
datatype: string
max count: 1

path: pixelRoas
name: pixel roas
description: Pixel Return on Ad Spend - Pixel-reported revenue relative to ad spend. Pixel ROAS = Pixel Conversion Value / Ad Spend
datatype: string
max count: 1

path: returningCustomerOrders
name: returning customer orders
description: Pixel Returning Customer Purchases - Number of Pixel-reported orders placed by Returning Customers. Learn how Triple Whale classifies new/returning customers .
datatype: string
max count: 1

path: returningCustomerRevenue
name: returning customer revenue
description: Pixel Returning Customer Revenue - Pixel-reported conversion value (order revenue) derived from Returning Customers. Learn how Triple Whale classifies new/returning customers .
datatype: string
max count: 1

path: returningCustomersPercent
name: returning customers percent
description: Pixel Returning Customers Percent - The percentage of Pixel-reported purchases made by Returning Customers. Pixel New Customers % = Number of Returning Customer Pixel Purchases / Total Pixel Purchases Learn how Triple Whale classifies new/returning customers .
datatype: string
max count: 1

path: productImage
name: product image
description: Product Image URL - The image URL of the product in the order associated with the customer journey event. Example value: https://cdn.shopify.com/s/files/1/prod1
datatype: anyURI
max count: 1

path: productName
name: product name
description: Product Name - The name (or title) of the product in the order associated with the customer journey event. Example values: $20 USD Gift Card , Unisex Hoodie
datatype: string
max count: 1

path: queryParams
name: query params
description: URL Query Parameters - The query parameters contained in the URL associated with the customer journey event. Example values: {"tw_adid":"83906898178855", "tw_campaign":"103306890", "tw_source":"bing"," utm_campaign":"Bing Shopping", "utm_content":"HERO SKU Summer Book Run", "utm_medium":"cpc", "utm_source":"bing", "utm_term":"1342506080190763", "variant":"44042133111001"}
datatype: string
max count: 1

path: questions
name: questions
description: Survey Questions - Survey questions asked during the customer journey.
node: QuestionShape
class: Question
node kind: BlankNodeOrIRI

path: referrer
name: referrer
description: Referrer - The referrer platform of the ad associated with the customer journey event. Example values: shop.example.com , tiktok , google
datatype: string
max count: 1

path: sessionId
name: session id
description: Session ID - The unique session ID associated with the customer journey event. Assigned by Triple Pixel. Example value: cltlok4y634IRw62AZ_1710700966152
datatype: string
max count: 1

path: shopId
name: shop id
description: Shop ID - The unique ID of the shop (often corresponds to the shop domain). Can be used to group or filter data by shop in multi-store reports. Example values: example-US.myshopify.com , example-EU.myshopify.com
datatype: string
max count: 1

path: shopName
name: shop name
description: Shop Name - The name of the shop. Can be used to group or filter data by shop in multi-store reports. Example values: example-US , example-EU
datatype: string
max count: 1

path: source
name: source
description: Source - The source of the customer journey event. Example values: snapchat-ads , klaviyo , google-ads , Direct
datatype: string
max count: 1

path: subscriptionId
name: subscription id
description: Subscription ID - The unique ID of the subscription associated with the customer journey event. Example value: 3521068
datatype: string
max count: 1

path: tags
name: tags
description: Tags - Tags for the order associated with the customer journey event. Assigned by the seller in the main sales platform. Example values: Upsell , Order Credits , discount_eligible
datatype: string

path: tripleId
name: triple id
description: Triple Pixel ID - The unique ID assigned by Triple Pixel event to track visitors across sessions, for the visitor associated with the customer journey event. Example value: cltlok4y634IRw62AZ
datatype: string
max count: 1

path: customerJourneyEventType
name: customer journey event type
description: Customer Journey Event Type - The customer journey event type. Example values: viewed_page , added_to_cart , placed_order , post_purchase_survey_submitted
datatype: string
max count: 1

path: url
name: url
description: URL - The URL the customer interacted with during the customer journey event. Example values: myshop.com/cart , myshop.com/products/my_product_07
datatype: anyURI
max count: 1

path: discount
name: discount
description: Discount - The total discount applied to the order associated with the customer journey event. Example values: 41.99 , 7.49 , 71042.30
datatype: double
max count: 1

path: orderRevenue
name: order revenue
description: Order Revenue - The revenue from the order associated with the customer journey event. Example values: 25 , 253850.59
datatype: double
max count: 1

path: pageViewNumber
name: page view number
description: Page Views - The number of pages viewed during the customer journey event. Example values: 1 , 5 , 12
datatype: double
max count: 1

path: quantity
name: quantity
description: Quantity - The number of products added to the cart (for added_to_cart events) or the number of orders (for placed_order events). Example values: 1 , 3 , 15
datatype: double
max count: 1

path: totalPrice
name: total price
description: Total Price - The total price of the order associated with the customer journey event. Example value: 247.22
datatype: double
max count: 1

path: eventCount
name: event count
description: Customer Journey Events - The total number of customer journey events within the selected timeframe. Example values: 13 , 452 , 225,897
datatype: string
max count: 1

path: purchaseFrequencyLast7Days
name: purchase frequency last7days
description: Purchase Frequency (Last 7 Days) - Average number of orders per customer from the selected segment instances in the 7 days prior to the pinned_event_date .
datatype: string
max count: 1

path: purchaseFrequencyNext7Days
name: purchase frequency next7days
description: Purchase Frequency (Next 7 Days) - Average number of orders per customer from the selected segment instances in the 7 days after the pinned_event_date .
datatype: string
max count: 1

path: revenueLast7Days
name: revenue last7days
description: Revenue (Last 7 Days) - Total order revenue generated by customers from the selected segment instances in the 7 days prior to the pinned_event_date .
datatype: string
max count: 1

path: revenueNext7Days
name: revenue next7days
description: Revenue (Next 7 Days) - Total order revenue generated by customers from the selected segment instances in the 7 days after the pinned_event_date .
datatype: string
max count: 1

path: status
name: status
description: Customer Status - The current status of the customer in the system. Example values: INVITED , ENABLED , DISABLED , UNSUBSCRIBED , NEVER_SUBSCRIBED , DECLINED
datatype: string
max count: 1

path: taxExempt
name: tax exempt
description: Tax Exempt - Indicates whether the customer is exempt from tax. Possible values: true , false
datatype: boolean
max count: 1

path: validEmailAddress
name: valid email address
description: Valid Email Address - Whether the email address has passed a validation check. Possible values: true , false
datatype: boolean
max count: 1

path: verifiedEmailAddress
name: verified email address
description: Verified Email Address - Whether the email address has been verified by the platform. Possible values: true , false
datatype: boolean
max count: 1

path: https://relay.inferal.com/ontology/triplewhale/property/TripleWhale.Customer/zip
name: zip
description: Zip/Postal Code - The zip or postal code of the customer's defaults address. Example values: 48104 , 18235-2239 , CH25 9BH
datatype: string
max count: 1

path: amountSpent
name: amount spent
description: Amount Spent - The total amount spent by the customer.
datatype: double
max count: 1

path: numberOfOrders
name: number of orders
description: Number of Orders - The total number of orders placed by the customer.
datatype: double
max count: 1

path: reportType
name: report type
description: Report Type - The type of report generated. Example values: flow , campaign
datatype: string
max count: 1

path: shopId
name: shop id
description: Shop ID - The unique ID of the shop (often corresponds to the shop domain). Can be used to group or filter data by shop in multi-store reports. Example values: example-US.myshopify.com , example-EU.myshopify.com
datatype: string
max count: 1

path: shopName
name: shop name
description: Shop Name - The name of the shop. Can be used to group or filter data by shop in multi-store reports. Example values: example-US , example-EU
datatype: string
max count: 1

path: clicksUnique
name: clicks unique
description: Clicks - The total number of unique clicks on links within the email/SMS.
datatype: double
max count: 1

path: conversionValue
name: conversion value
description: Conversion Value - The total value of conversions for the email/SMS campaign / flow.
datatype: double
max count: 1

path: conversions
name: conversions
description: Conversions - The total number of conversions for the email/SMS campaign / flow.
datatype: double
max count: 1

path: delivered
name: delivered
description: Delivered Messages - The total number of messages successfully delivered to the targeted recipient.
datatype: double
max count: 1

path: opensUnique
name: opens unique
description: Opens - The total number of unique email opens.
datatype: double
max count: 1

path: recipients
name: recipients
description: Recipients - The total number of intended recipients for the email/SMS campaign.
datatype: double
max count: 1

path: received
name: received
description: Received Messages - The total number of email messages successfully received by the target audience.
datatype: double
max count: 1

path: sent
name: sent
description: Sent Messages - The total number of messages sent. Note: Applicable to Klaviyo SMS, Yotpo Email, and Yotpo SMS; does not include data for Klaviyo email.
datatype: double
max count: 1

path: spend
name: spend
description: Ad Spend - Channel-reported ad spend, excluding any custom expenses marked as ad spend.
datatype: double
max count: 1

path: subscribedToList
name: subscribed to list
description: Subscribed Recipients - The total number of recipients subscribed to any email/sms list. Not associated with a specific campaign ( campaign_id will be null).
datatype: double
max count: 1

path: unsubscribed
name: unsubscribed
description: Unsubscribed Recipients - The total number of recipients who unsubscribed from any email/sms list as a result of the campaign.
datatype: double
max count: 1

path: searchTopImpressions
name: search top impressions
description: Search Top Impressions - The number of impressions your ads received in the top position (any position above organic results).
datatype: double
max count: 1

path: spend
name: spend
description: Ad Spend - Channel-reported ad spend, excluding any custom expenses marked as ad spend.
datatype: double
max count: 1

path: searchAbsoluteTopImpressionShare
name: search absolute top impression share
description: Search Absolute Top Impression Share - The percentage of impressions your ads received in the absolute top location (the very first ad above organic results). Search Absolute Top Impression Share = Search Absolute Top Impressions / Impressions Note: Accurate only when grouping by keyword.
datatype: double
max count: 1

path: searchBudgetLostAbsoluteTopImpressionShare
name: search budget lost absolute top impression share
description: Search Budget Lost Absolute Top Impression Share - The percentage of absolute top impressions your ads did not receive because the campaign budget was limited. Search Budget Lost Absolute Top Impression Share = Search Budget Lost Absolute Top Impressions / Impressions Note: Accurate only when grouping by keyword.
datatype: double
max count: 1

path: searchBudgetLostTopImpressionShare
name: search budget lost top impression share
description: Search Budget Lost Top Impression Share - The percentage of top impressions your ads did not receive because the campaign budget was limited. Search Budget Lost Top Impression Share = Search Budget Lost Top Impressions / Impressions Note: Accurate only when grouping by keyword.
datatype: double
max count: 1

path: searchImpressionShare
name: search impression share
description: Search Impression Share - The percentage of impressions your ads received on the Search Network out of the total impressions they were eligible to receive. Search Impression Share = Search Impressions / Impressions Note: Accurate only when grouping by keyword.
datatype: double
max count: 1

path: searchRankLostImpressionShare
name: search rank lost impression share
description: Search Rank Lost Impression Share - The percentage of impressions your ads did not receive because Ad Rank was too low. Search Rank Lost Impression Share = Search Rank Lost Impressions / Impressions Note: Accurate only when grouping by keyword.
datatype: double
max count: 1

path: searchRankLostTopImpressionShare
name: search rank lost top impression share
description: Search Rank Lost Top Impression Share - The percentage of top impressions your ads did not receive because Ad Rank was too low. Search Rank Lost Top Impression Share = Search Rank Lost Top Impressions / Impressions Note: Accurate only when grouping by keyword.
datatype: double
max count: 1

path: searchTopImpressionShare
name: search top impression share
description: Search Top Impression Share - The percentage of impressions your ads received in the top location (any position above organic results). Search Top Impression Share = Search Top Impressions / Impressions Note: Accurate only when grouping by keyword.
datatype: double
max count: 1

path: isFirstOrderInSubscription
name: is first order in subscription
description: Is First Order in Subscription - True if the order is the first in a subscription series. Possible values: true , false
datatype: boolean
max count: 1

path: isNewCustomer
name: is new customer
description: Is New Customer - True if this is the customer's first order. Possible values: true , false Learn how Triple Whale classifies new/returning customers .
datatype: boolean
max count: 1

path: isSubscriptionOrder
name: is subscription order
description: Is Subscription Order - True if the order is part of a subscription. Possible values: true , false
datatype: boolean
max count: 1

path: metafields
name: metafields
description: Metafields - Custom key–value pairs attached to each order record, used to store additional structured or unstructured data beyond standard fields.
node: OrderMetafieldShape
class: OrderMetafield
node kind: BlankNodeOrIRI

path: orderId
name: order id
description: Order ID - The unique order ID, assigned by the main sales platform. Example value: 4930225799243
datatype: string
max count: 1

path: orderName
name: order name
description: Order Name - The name of the order as assigned by the seller on the main sales platform. Example values: #2188464 , Ex-2163819-9
datatype: string
max count: 1

path: platform
name: platform
description: Sales Platform - The sales platform where the order was processed. Example values: Shopify , BigCommerce , WooCommerce , Amazon
datatype: string
max count: 1

path: productsInfo
name: products info
description: Products - Details about the products associated with the order (at the level of the variant), including name, product ID, variant ID, type, SKU, etc. Returns the latest product information, not necessarily the data at the time the order was placed.
node: OrderProductsInfoShape
class: OrderProductsInfo
node kind: BlankNodeOrIRI

path: shippingCity
name: shipping city
description: Shipping City - The city of the shipping address. Example value: San Francisco
datatype: string
max count: 1

path: shippingCountryCode
name: shipping country code
description: Shipping Country Code - The country code of the shipping address. See list of countries . Example values: US , CA , GB
datatype: string
max count: 1

path: shippingCountryName
name: shipping country name
description: Shipping Country Name - The full name of the shipping country. See list of countries . Example values: United States , Canada , United Kingdom
datatype: string
max count: 1

path: shippingDate
name: shipping date
description: Shipping Date - The most recent shipping-related date (in case of multiple shipments for the same order), selected from fields supported by the connected shipping platform (e.g., shipped, fulfilled, or shipping label created). Example value: 2024-12-25
datatype: date
max count: 1

path: shippingProviderId
name: shipping provider id
description: Shipping Provider - The integrated shipping provider that manages and processes the order's shipment. Example values: shipbob , shipstation
datatype: string
max count: 1

path: shippingState
name: shipping state
description: Shipping State - The province or state of the shipping address. Example value: California
datatype: string
max count: 1

path: shippingStateCode
name: shipping state code
description: Shipping State Code - The province or state code of the shipping address. Example value: CA
datatype: string
max count: 1

path: shippingZip
name: shipping zip
description: Shipping Zip Code - The zip/postal code of the customer's shipping address. Example values: 48104 , 18235-2239 , CH25 9BH
datatype: string
max count: 1

path: shopId
name: shop id
description: Shop ID - The unique ID of the shop (often corresponds to the shop domain). Can be used to group or filter data by shop in multi-store reports. Example values: example-US.myshopify.com , example-EU.myshopify.com
datatype: string
max count: 1

path: shopName
name: shop name
description: Shop Name - The name of the shop. Can be used to group or filter data by shop in multi-store reports. Example values: example-US , example-EU
datatype: string
max count: 1

path: shopTimezone
name: shop timezone
description: Shop Timezone - The designated timezone of the shop according to the timezone database .
datatype: string
max count: 1

path: sourceName
name: source name
description: Source - The origin of the order as designated by the seller on the main sales platform. Example values: web , pos , tiktok
datatype: string
max count: 1

path: tags
name: tags
description: Tags - Tags associated with the order, assigned by the seller on the main sales platform. Example values: Upsell , Order Credits , discount_eligible
datatype: string

path: transactions
name: transactions
description: Transactions - Details about transactions associated with the order, including payment information and status.
node: OrderTransactionShape
class: OrderTransaction
node kind: BlankNodeOrIRI

path: amazonEstimatedFees
name: amazon estimated fees
description: Amazon Estimated Fees - The estimated fees to be charged by Amazon for the order, based on products purchased. Note that this amount is an estimate and is not final until Amazon reports on actual fees.
datatype: double
max count: 1

path: costOfGoods
name: cost of goods
description: Cost of Goods (COGS) - The cost of goods for orders within the selected time frame (before refunds). Imported from the main sales platform, or edit these in Cost Settings > Cost of Goods.
datatype: double
max count: 1

path: currencyRate
name: currency rate
description: Currency Rate - The rate used to convert monetary values to the shop's currency. If no conversion was applied, the value is 1 . To convert back to the original currency, divide by this rate.
datatype: double
max count: 1

path: customExpenses
name: custom expenses
description: Custom Expenses - Additional custom expenses associated with individual orders. Import using the Enrich Orders Data API endpoint.
datatype: double
max count: 1

path: customGrossProfit
name: custom gross profit
description: Custom Gross Profit - Custom gross profit for individual orders. Import using the Enrich Orders Data API endpoint.
datatype: double
max count: 1

path: customGrossSales
name: custom gross sales
description: Custom Gross Sales - Custom gross sales for individual orders. Import using the Enrich Orders Data API endpoint.
datatype: double
max count: 1

path: customNetRevenue
name: custom net revenue
description: Custom Net Revenue - Custom net revenue for individual orders. Import using the Enrich Orders Data API endpoint.
datatype: double
max count: 1

path: customOrdersQuantity
name: custom orders quantity
description: Custom Orders Quantity - The custom-defined quantity of orders to count for the single order_id . Possible values: 0 , 1 Import using the Enrich Orders Data API endpoint.
datatype: double
max count: 1

path: customTotalItemsQuantity
name: custom total items quantity
description: Custom Total Items - The custom-defined total number of items in the order. Import using the Enrich Orders Data API endpoint.
datatype: double
max count: 1

path: discountAmount
name: discount amount
description: Discounts - The total discount amount applied to the order, including shipping discounts.
datatype: double
max count: 1

path: discountAmountForProduct
name: discount amount for product
description: Product Discount Amount - The total product discount amount applied to the order.
datatype: double
max count: 1

path: discountAmountForShipping
name: discount amount for shipping
description: Shipping Discount Amount - The total shipping discount amount applied to the order.
datatype: double
max count: 1

path: estimatedShippingCosts
name: estimated shipping costs
description: Estimated Shipping Costs - Estimated shipping costs paid by the seller for orders within the select timeframe. Edit these in: Cost Settings > Shipping
datatype: double
max count: 1

path: grossProductSales
name: gross product sales
description: Gross Sales - Gross sales revenue (before shipping, taxes, discounts, or refunds). Gross Sales = Product Price x Units Sold
datatype: double
max count: 1

path: handlingFees
name: handling fees
description: Handling Fees - Handling fees (e.g. boxing, packaging, or “pick & pack” services) paid by the seller for orders in the selected time frame. Edit these in Cost Settings > Cost of Goods.
datatype: double
max count: 1

path: orderRevenue
name: order revenue
description: Order Revenue - Revenue earned after shipping, taxes, and discounts (before refunds). Order Revenue = Gross Sales + Shipping + Taxes − Discounts
datatype: double
max count: 1

path: paymentGatewayCosts
name: payment gateway costs
description: Payment Gateway Costs - Payment processing fees (not including currency conversion fees) paid by the seller. Edit these in Cost Settings > Gateway Costs.
datatype: double
max count: 1

path: productQuantitySoldInOrder
name: product quantity sold in order
description: Units Sold - The total number of individual product units sold in the order.
datatype: double
max count: 1

path: refundMoney
name: refund money
description: Refunds - Total amount returned to customers for refunded sales, refunded taxes, and refunded shipping. Calculated based on the order date. Note that Triple Whale does not track refunds from third-party return management apps (e.g., Loop), so totals may vary from the sales platform. Refunds = Refunded Sales + Refunded Shipping + Refunded Tax
datatype: double
max count: 1

path: shippingCosts
name: shipping costs
description: Shipping Costs - Shipping costs paid by the seller for orders within the select timeframe. Edit these in Cost Settings > Shipping.
datatype: double
max count: 1

path: shippingPrice
name: shipping price
description: Shipping Price - The total shipping price of the order (paid by the buyer), including shipping taxes and shipping discounts.
datatype: double
max count: 1

path: taxes
name: taxes
description: Sale Taxes - Total amount customers paid in taxes, before refunds.
datatype: double
max count: 1

path: aov
name: aov
description: Average Order Value - The average order value (before shipping or taxes), as reported by the sales platform. AOV = (Order Revenue - Shipping Price - Taxes) / Number of Orders
datatype: string
max count: 1

path: ltv
name: ltv
description: Lifetime Value - The average order revenue per customer, for orders placed within the selected timeframe. LTV = Order Revenue / Unique Customers
datatype: string
max count: 1

path: newCustomerOrders
name: new customer orders
description: New Customer Orders - The total number of orders placed by new customers within the selected time frame. Learn how Triple Whale classifies new/returning customers .
datatype: string
max count: 1

path: newCustomerRevenue
name: new customer revenue
description: New Customer Revenue - The total revenue derived from orders by new customers. Learn how Triple Whale classifies new/returning customers .
datatype: string
max count: 1

path: newCustomersPercent
name: new customers percent
description: New Customers Percent - The percentage of purchases made by new customers. New Customers % = Number of New Customer Orders / Total Orders Learn how Triple Whale classifies new/returning customers .
datatype: string
max count: 1

path: orders
name: orders
description: Orders - The total number of orders placed within the selected timeframe.
datatype: string
max count: 1

path: ordersWithAmount
name: orders with amount
description: Non-Zero Orders - The total number of orders with a revenue greater than zero. Non-Zero Orders = Count of Orders where Order Revenue > $0
datatype: string
max count: 1

path: returningCustomerOrders
name: returning customer orders
description: Returning Customer Orders - Number of orders placed by Returning Customers. Learn how Triple Whale classifies new/returning customers .
datatype: string
max count: 1

path: returningCustomerRevenue
name: returning customer revenue
description: Returning Customer Revenue - Amount of revenue derived from Returning Customers. Learn how Triple Whale classifies new/returning customers .
datatype: string
max count: 1

path: returningCustomersPercent
name: returning customers percent
description: Returning Customers Percent - Percentage of orders placed by Returning Customers. Returning Customers % = Number of Returning Customer Orders / Total Orders Learn how Triple Whale classifies new/returning customers .
datatype: string
max count: 1

path: trueAov
name: true aov
description: True Average Order Value - The average non-zero order value (before shipping or taxes), as reported by the sales platform. True AOV = (Order Revenue - Shipping Price - Taxes) / Number of Orders > $0
datatype: string
max count: 1

path: uniqueCustomers
name: unique customers
description: Unique Customers - Number of unique customers who placed orders within the selected timeframe.
datatype: string
max count: 1

path: campaignStatus
name: campaign status
description: Campaign Status - The status of the campaign. Example values: ACTIVE , PAUSED
datatype: string
max count: 1

path: campaignType
name: campaign type
description: Campaign Type - The type of campaign. For Email/SMS data, this maps to report_type . Example values: PERFORMANCE_MAX , SEARCH , flow , campaign
datatype: string
max count: 1

path: channel
name: channel
description: Channel - The platform through which the ad was delivered. Example values: facebook-ads , google-ads , Direct
datatype: string
max count: 1

path: channelType
name: channel type
description: Messaging Channel Type - The messaging channel used to deliver the communication. Populated for email/SMS providers only; NULL for ad platforms. Example values: email , sms , push
datatype: string
max count: 1

path: country
name: country
description: Session Country - The country of the session where the order originated. See list of countries . Example values: United States , Canada , United Kingdom
datatype: string
max count: 1

path: msCountry
name: ms country
description: MS Session Country - The marketplace country code of the session. See list of countries . Example values: US , CA , GB
datatype: string
max count: 1

path: creativeCtaType
name: creative cta type
description: Creative CTA Type - The type of call-to-action (CTA) used in the ad. Example values: Shop Now , Learn More , Sign Up
datatype: string
max count: 1

path: creativeDistributionFormat
name: creative distribution format
description: Creative Distribution Format - The ad creative distribution format. Example values: Standard Ad , Dynamic Creative Ad , Unknown
datatype: string
max count: 1

path: creativeFormat
name: creative format
description: Creative Format - The format of the ad creative. Example values: SHARE , VIDEO
datatype: string
max count: 1

path: creativeId
name: creative id
description: Creative ID - The unique identifier assigned to the creative asset by the ad platform. Example value: 1326015151986179
datatype: string
max count: 1

path: destinationUrl
name: destination url
description: Destination URL - The destination URL where users land after clicking the ad. Currently available for Meta, Google, and Pinterest. Example value: https://www.myshop.com/products/productA
datatype: string
max count: 1

path: attributionModel
name: attribution model
description: Attribution Model - The attribution model used. By default Triple Attribution . Possible values: Total Impact , Triple Attribution , Triple Attribution + Views , Clicks & Views , Linear All , Linear Paid , First Click , Last Click
datatype: string
max count: 1

path: shopId
name: shop id
description: Shop ID - The unique ID of the shop (often corresponds to the shop domain). Can be used to group or filter data by shop in multi-store reports. Example values: example-US.myshopify.com , example-EU.myshopify.com
datatype: string
max count: 1

path: shopName
name: shop name
description: Shop Name - The name of the shop. Can be used to group or filter data by shop in multi-store reports. Example values: example-US , example-EU
datatype: string
max count: 1

path: urlTemplate
name: url template
description: URL Template - A template URL used to dynamically populate ad URLs with relevant tracking parameters. Example value: utm_source=facebook&utm_campaign={{campaign.name}}
datatype: string
max count: 1

path: videoUrl
name: video url
description: Video URL - The URL of the ad video. Example value: https://www.youtube.com/embed/example
datatype: anyURI
max count: 1

path: videoUrlIframe
name: video url iframe
description: Video URL Iframe - The iframe embed code for displaying the video ad within a web page or app. Example value: https://www.facebook.com/plugins/ video.phpwidth=1080&href=https:// www.facebook.com/123456789/videos/987654321
datatype: string
max count: 1

path: videoUrlSource
name: video url source
description: Video URL Source - The direct file path to the hosted video source, typically used for playback. Example value: https://video-ord5-2.xx.fbcdn.net/o1/v/t2/f2/m69/example-video.mp4?_nc_ht=video-ord5-2.xx.fbcdn.net&_nc_cat=111& oh=1234567890abcdef&oe=67C3D77F
datatype: string
max count: 1

path: addToCarts
name: add to carts
description: Pixel Add to Carts - The number of unique users who triggered an Add-to-Cart event, as reported by the Pixel.
datatype: double
max count: 1

path: addresses
name: addresses
description: Address Details Submitted - The number of times users submitted address details during checkout.
datatype: double
max count: 1

path: adsetDailyBudget
name: adset daily budget
description: Ad Set Daily Budget - The daily budget (in cents) set for the ad set within a campaign. By default shown in the shop's currency. Example values: 1750 , 6000 , 40000
datatype: long
max count: 1

path: adsetLifetimeBudget
name: adset lifetime budget
description: Ad Set Lifetime Budget - The total budget (in cents) set for the ad set within a campaign over its lifetime. By default shown in the shop's currency. Example values: 5000 , 10000 , 20000
datatype: long
max count: 1

path: bounces
name: bounces
description: Pixel Bounces - The Pixel-reported number of single-page sessions where the visitor left the site after a single page view.
datatype: double
max count: 1

path: campaignDailyBudget
name: campaign daily budget
description: Campaign Daily Budget - The daily budget (in cents) for the campaign. Example values: 8000 , 10000 , 15000
datatype: long
max count: 1

path: campaignLifetimeBudget
name: campaign lifetime budget
description: Campaign Lifetime Budget - The lifetime budget (in cents) for the campaign. Example values: 5000 , 10000 , 20000
datatype: long
max count: 1

path: channelReportedConversionValue
name: channel reported conversion value
description: Channel-Reported Conversion Value - Revenue generated from channel-reported conversions (purchases).
datatype: double
max count: 1

path: channelReportedConversions
name: channel reported conversions
description: Channel-Reported Conversions (Purchases) - Number of channel-reported conversions (purchases).
datatype: double
max count: 1

path: channelReportedOnsiteConversionValue
name: channel reported onsite conversion value
description: Channel-Reported Onsite Conversion Value - Revenue from channel-reported purchases made on the ad channel shop (e.g. Meta Shop, TikTok Shop).
datatype: double
max count: 1

path: channelReportedOnsitePurchases
name: channel reported onsite purchases
description: Channel-Reported Onsite Purchases - Number of channel-reported purchases made on the ad channel shop (e.g. Meta Shop, TikTok Shop).
datatype: double
max count: 1

path: channelReportedVisits
name: channel reported visits
description: Channel-Reported Visits - Number of channel-reported visits. Currently available for Criteo only.
datatype: double
max count: 1

path: checkouts
name: checkouts
description: Checkouts Started - The number of checkout processes started.
datatype: double
max count: 1

path: clicks
name: clicks
description: Clicks - Number of channel-reported clicks.
datatype: double
max count: 1

path: cogs
name: cogs
description: Pixel Cost of Goods - The cost of goods for Pixel-reported purchases within the selected time frame (before refunds). Imported from the main sales platform, or edit these in Cost Settings > Cost of Goods. Note that COGS for Pixel data is set at attribution time and does not get updated subsequently, so may vary from COGS data in the Orders table.
datatype: double
max count: 1

path: contacts
name: contacts
description: Add Contact Info - The number of times users submitted contact details during checkout.
datatype: double
max count: 1

path: delivered
name: delivered
description: SMS Messages Delivered - The channel-reported number of messages that successfully reached the recipients' phones.
datatype: double
max count: 1

path: emailSignups
name: email signups
description: Pixel Email Signups - The Pixel-reported total number of users who signed up for the mailing list during a session.
datatype: double
max count: 1

path: grossProductSales
name: gross product sales
description: Pixel Gross Sales - Pixel-reported gross sales revenue (before shipping, taxes, discounts, or refunds). Gross Sales = Product Price x Units Sold
datatype: double
max count: 1

path: impressions
name: impressions
description: Impressions - Number of channel-reported impressions.
datatype: double
max count: 1

path: newCustomerCogs
name: new customer cogs
description: Pixel New Customer Cost of Goods - The cost of goods for Pixel-reported purchases by new customers within the selected time frame (before refunds). Imported from the main sales platform, or edit these in Cost Settings > Cost of Goods. Note that COGS for Pixel data is set at attribution time and does not get updated subsequently, so may vary from COGS data in the Orders table. Learn how Triple Whale classifies new/returning customers .
datatype: double
max count: 1

path: newCustomerOrderRevenue
name: new customer order revenue
description: Pixel New Customer Conversion Value - Pixel-reported conversion value (order revenue) derived from New Customers. Learn how Triple Whale classifies new/returning customers .
datatype: double
max count: 1

path: newCustomerOrders
name: new customer orders
description: Pixel New Customer Purchases - Number of Pixel-reported orders placed by New Customers. Learn how Triple Whale classifies new/returning customers .
datatype: double
max count: 1

path: newVisitors
name: new visitors
description: Pixel New Visitors - The Pixel-reported number of first-time visitors to the site.
datatype: double
max count: 1

path: oneDayViewConversionValue
name: one day view conversion value
description: One-Day View Conversion Value - The total value of channel-reported purchases made within one day of viewing the ad.
datatype: double
max count: 1

path: oneDayViewPurchases
name: one day view purchases
description: One-Day View Purchases - The total number of channel-reported purchases made within one day of viewing the ad.
datatype: double
max count: 1

path: opened
name: opened
description: Opens - The channel-reported number of times the email/sms was opened by recipients.
datatype: double
max count: 1

path: orderRevenue
name: order revenue
description: Pixel Conversion Value (CV) - Pixel-reported conversion value (order revenue) after shipping, taxes, and discounts (before refunds). Order Revenue = Gross Sales + Shipping + Taxes − Discounts
datatype: double
max count: 1

path: ordersQuantity
name: orders quantity
description: Pixel Purchases - The total number of Pixel-reported purchases (orders) within the selected timeframe. Note: This value is calculated based on the attribution model, and may be a fractional number.
datatype: double
max count: 1

path: outboundClicks
name: outbound clicks
description: Outbound Clicks - Number of channel-reported outbound clicks.
datatype: double
max count: 1

path: payments
name: payments
description: Add Payment Info - The number of times users submitted payment details during checkout.
datatype: double
max count: 1

path: productQuantitySoldInOrder
name: product quantity sold in order
description: Units Sold - The total number of individual product units sold in the order.
datatype: double
max count: 1

path: received
name: received
description: Received Messages - The channel-reported number of email messages successfully received by the target audience.
datatype: double
max count: 1

path: refundMoney
name: refund money
description: Refunds - Total amount returned to customers for refunded sales, refunded taxes, and refunded shipping. Calculated based on the order date. Note that Triple Whale does not track refunds from third-party return management apps (e.g., Loop), so totals may vary from the sales platform. Refunds = Refunded Sales + Refunded Shipping + Refunded Tax
datatype: double
max count: 1

path: sent
name: sent
description: SMS Messages Sent - The channel-reported number of SMS messages sent in the campaign.
datatype: double
max count: 1

path: sessionPageViews
name: session page views
description: Pixel Session Page Views - The Pixel-reported number of pages viewed during a website session.
datatype: double
max count: 1

path: sessions
name: sessions
description: Pixel Sessions - The Pixel-reported number of online store sessions. Note that Triple Whale defines and tracks sessions differently from the main sales platform so there may be variance between the two. Learn how Triple Whale defines and tracks sessions.
datatype: double
max count: 1

path: shipping
name: shipping
description: Shipping Details Submitted - The number of times users submitted shipping details during checkout.
datatype: double
max count: 1

path: spend
name: spend
description: Ad Spend - Channel-reported ad spend, excluding any custom expenses marked as ad spend.
datatype: double
max count: 1

path: subscribedToList
name: subscribed to list
description: Subscribed to Mailing List - The channel-reported number of recipients subscribed to any mailing list.
datatype: double
max count: 1

path: timeOnSite
name: time on site
description: Pixel Time on Site - The Pixel-reported time spent by users on the site during a session, measured in seconds.
datatype: double
max count: 1

path: uniqueVisitors
name: unique visitors
description: Pixel Unique Visitors - The Pixel-reported number of unique visitors to the site.
datatype: double
max count: 1

path: unsubscribed
name: unsubscribed
description: Unsubscribed - The channel-reported number of recipients who unsubscribed from any mailing list.
datatype: double
max count: 1

path: websitePurchases
name: website purchases
description: Website Purchases - The total number of Pixel-reported purchases (orders) during a website session. Excludes recurring subscription purchases.
datatype: double
max count: 1

path: averagePageViewsPerSession
name: average page views per session
description: Pixel Average Page Views Per Session - The average number of pages viewed by users during each session. Pixel Average Page Views Per Session = Session Page Views / Number of Sessions
datatype: string
max count: 1

path: averageSessionDuration
name: average session duration
description: Pixel Average Session Duration - The average time users spend on your site per session. Pixel Average Session Duration (in seconds) = Time on Site / (Number of Sessions - Number of Bounces)
datatype: string
max count: 1

path: bounceRate
name: bounce rate
description: Pixel Bounce Rate - The percentage of single-page visits (bounces) out of total sessions. Pixel Bounce Rate = Number of Bounces / Number of Sessions
datatype: string
max count: 1

path: channelReportedAov
name: channel reported aov
description: Channel-Reported AOV - The average order value as reported by the advertising channel. Channel-Reported AOV = Channel-Reported Conversion Value / Number of Channel-Reported Conversions
datatype: string
max count: 1

path: channelReportedConversionRate
name: channel reported conversion rate
description: Channel-Reported Conversion Rate - The percentage of visits that convert into orders, as reported by the channel. Channel-Reported Conversion Rate = Number of Channel-Reported Conversions / Number of Visits
datatype: string
max count: 1

path: channelReportedCpa
name: channel reported cpa
description: Channel-Reported Cost Per Acquisition - The cost to acquire a single conversion, as reported by the channel. Channel-Reported CPA = Ad Spend / Number of Channel-Reported Conversions
datatype: string
max count: 1

path: channelReportedRoas
name: channel reported roas
description: Channel-Reported Return on Ad Spend - Revenue generated per dollar spent on ads, as reported by the channel. Channel-Reported ROAS = Channel-Reported Conversion Value / Ad Spend
datatype: string
max count: 1

path: cpc
name: cpc
description: Cost Per Click (CPC) - The average cost for each ad click. Cost Per Click (CPC) = Ad Spend / Clicks
datatype: string
max count: 1

path: cpm
name: cpm
description: Cost Per Mille (CPM) - The cost for 1,000 ad impressions. Cost Per Mille (CPM) = Ad Spend / Impressions x 1000
datatype: string
max count: 1

path: cpv
name: cpv
description: Cost Per Visit (CPV) - The cost for each visit driven by ads. Cost Per Visit (CPV) = Ad Spend / Number of Visits
datatype: string
max count: 1

path: ctr
name: ctr
description: Click-Through Rate - The percentage of impressions that result in a click. Click-Through Rate (CTR) = Clicks / Impressions
datatype: string
max count: 1

path: emailSignupRate
name: email signup rate
description: Pixel Email Signup Rate - The percentage of sessions that result in email signups. Pixel Email SUR = Number of Email Signups / Number of Sessions
datatype: string
max count: 1

path: iroas
name: iroas
description: Pixel Incremental Return on Ad Spend - The additional revenue generated per dollar spent on advertising by comparing conversions between an exposed group (audience that sees the ad) and a holdout group (control group that does not see the ad). Isolates the incremental ROAS of an ad campaign on driving purchases.
datatype: string
max count: 1

path: ncpa
name: ncpa
description: Pixel New Customer Cost Per Acquisition - The cost to acquire a new customer, as reported by Pixel. Pixel NCPA = Blended Ad Spend / Number of New Customer Orders Learn how Triple Whale classifies new/returning customers .
datatype: string
max count: 1

path: newCustomerRoas
name: new customer roas
description: Pixel New Customer ROAS - Revenue from new customers relative to ad spend. Pixel NC ROAS = New Customer Pixel Conversion Value / Ad Spend Learn how Triple Whale classifies new/returning customers .
datatype: string
max count: 1

path: newCustomersPercent
name: new customers percent
description: Pixel New Customers Percent - The percentage of Pixel-reported purchases made by new customers. Pixel New Customers % = Number of New Customer Pixel Purchases / Total Pixel Purchases Learn how Triple Whale classifies new/returning customers .
datatype: string
max count: 1

path: outboundCtr
name: outbound ctr
description: Outbound Click-Through Rate - The percentage of impressions that result in outbound clicks. Outbound CTR = Outbound Clicks / Impressions
datatype: string
max count: 1

path: pixelAov
name: pixel aov
description: Pixel AOV - The Pixel-reported average order value. Pixel AOV = Pixel Conversion Value / Number of Pixel Purchases
datatype: string
max count: 1

path: pixelConversionRate
name: pixel conversion rate
description: Pixel Conversion Rate - The percentage of website sessions that result in purchases, as reported by Pixel. Conversion Rate = Number of Website Purchases / Number of Sessions
datatype: string
max count: 1

path: pixelConversionValueDelta
name: pixel conversion value delta
description: Pixel Conversion Value Delta - The difference between Pixel-reported conversion value and channel-reported conversion value. Pixel CV Delta = Pixel Conversion Value - Channel-Reported Conversion Value
datatype: string
max count: 1

path: pixelCostPerAddToCart
name: pixel cost per add to cart
description: Pixel Cost Per Add To Cart - The cost associated with each add-to-cart action as reported by Pixel. Pixel Cost Per ATC = Ad Spend / Number of Add to Carts
datatype: string
max count: 1

path: pixelCostPerEmailSignup
name: pixel cost per email signup
description: Pixel Cost Per Email Signup - The cost associated with each email signup as reported by Pixel. Pixel Cost Per ESU = Ad Spend / Number of Email Signups
datatype: string
max count: 1

path: pixelCostPerNewVisitor
name: pixel cost per new visitor
description: Pixel Cost Per New Visitor - The cost to acquire a new visitor as reported by Pixel. Pixel Cost Per New Visitor = Ad Spend / Number of New Visitors
datatype: string
max count: 1

path: pixelCostPerVisitor
name: pixel cost per visitor
description: Pixel Cost Per Visitor - The cost to acquire a unique visitor as reported by Pixel. Pixel Cost Per Visitor = Ad Spend / Number of Unique Visitors
datatype: string
max count: 1

path: pixelCpa
name: pixel cpa
description: Pixel Cost Per Acquisition - The cost to acquire a purchase as reported by Pixel. Pixel CPA = Ad Spend / Number of Pixel Purchases
datatype: string
max count: 1

path: pixelNcAov
name: pixel nc aov
description: Pixel New Customer Average Order Value - The average order value for new customers as reported by Pixel. Pixel NC AOV = New Customer Pixel Conversion Value / Number of New Customer Pixel Purchases Learn how Triple Whale classifies new/returning customers .
datatype: string
max count: 1

path: pixelNcConversionRate
name: pixel nc conversion rate
description: Pixel New Customer Conversion Rate - The conversion rate for new customers as reported by Pixel. Pixel NC CR = Number of New Customer Pixel Purchases / Number of New Visitors Learn how Triple Whale classifies new/returning customers .
datatype: string
max count: 1

path: pixelNewVisitorPercent
name: pixel new visitor percent
description: Pixel New Visitor Percent - The percentage of all visitors that are new as reported by Pixel. Pixel New Visitor % = Number of New Visitors / Number of Unique Visitors
datatype: string
max count: 1

path: pixelProfit
name: pixel profit
description: Pixel Profit - The profit calculated as conversion value (order revenue) minus ad spend and cost of goods, as reported by Pixel. Pixel Profit = Pixel Conversion Value - Ad Spend - Pixel COGS
datatype: string
max count: 1

path: pixelRoas
name: pixel roas
description: Pixel Return on Ad Spend - Pixel-reported revenue relative to ad spend. Pixel ROAS = Pixel Conversion Value / Ad Spend
datatype: string
max count: 1

path: returningCustomerOrders
name: returning customer orders
description: Pixel Returning Customer Purchases - Number of Pixel-reported orders placed by Returning Customers. Learn how Triple Whale classifies new/returning customers .
datatype: string
max count: 1

path: returningCustomerRevenue
name: returning customer revenue
description: Pixel Returning Customer Revenue - Pixel-reported conversion value (order revenue) derived from Returning Customers. Learn how Triple Whale classifies new/returning customers .
datatype: string
max count: 1

path: returningCustomersPercent
name: returning customers percent
description: Pixel Returning Customers Percent - The percentage of Pixel-reported purchases made by Returning Customers. Pixel New Customers % = Number of Returning Customer Pixel Purchases / Total Pixel Purchases Learn how Triple Whale classifies new/returning customers .
datatype: string
max count: 1

path: adsetLifetimeBudget
name: adset lifetime budget
description: Ad Set Lifetime Budget - The total budget (in cents) set for the ad set within a campaign over its lifetime. By default shown in the shop's currency. Example values: 5000 , 10000 , 20000
datatype: long
max count: 1

path: bounces
name: bounces
description: Pixel Bounces - The Pixel-reported number of single-page sessions where the visitor left the site after a single page view.
datatype: double
max count: 1

path: campaignDailyBudget
name: campaign daily budget
description: Campaign Daily Budget - The daily budget (in cents) for the campaign. Example values: 8000 , 10000 , 15000
datatype: long
max count: 1

path: campaignLifetimeBudget
name: campaign lifetime budget
description: Campaign Lifetime Budget - The lifetime budget (in cents) for the campaign. Example values: 5000 , 10000 , 20000
datatype: long
max count: 1

path: channelReportedConversionValue
name: channel reported conversion value
description: Channel-Reported Conversion Value - Revenue generated from channel-reported conversions (purchases).
datatype: double
max count: 1

path: checkouts
name: checkouts
description: Checkouts Started - The number of checkout processes started.
datatype: double
max count: 1

path: clicks
name: clicks
description: Clicks - Number of channel-reported clicks.
datatype: double
max count: 1

path: cogs
name: cogs
description: Pixel Cost of Goods - The cost of goods for Pixel-reported purchases within the selected time frame (before refunds). Imported from the main sales platform, or edit these in Cost Settings > Cost of Goods. Note that COGS for Pixel data is set at attribution time and does not get updated subsequently, so may vary from COGS data in the Orders table.
datatype: double
max count: 1

path: contacts
name: contacts
description: Add Contact Info - The number of times users submitted contact details during checkout.
datatype: double
max count: 1

path: emailSignups
name: email signups
description: Pixel Email Signups - The Pixel-reported total number of users who signed up for the mailing list during a session.
datatype: double
max count: 1

path: grossProductSales
name: gross product sales
description: Pixel Gross Sales - Pixel-reported gross sales revenue (before shipping, taxes, discounts, or refunds). Gross Sales = Product Price x Units Sold
datatype: double
max count: 1

path: impressions
name: impressions
description: Impressions - Number of channel-reported impressions.
datatype: double
max count: 1

path: keywordCpcBid
name: keyword cpc bid
description: Keyword CPC Bid - The bid amount set for the keyword (cost-per-click). By default shown in the shop's currency. Example values: 1500 , 10,000 , 28,000
datatype: double
max count: 1

path: keywordEffectiveCpcBid
name: keyword effective cpc bid
description: Keyword Effective CPC Bid - The effective CPC bid after platform bid adjustments are applied. By default shown in the shop's currency. Example values: 1500 , 10,000 , 28,000
datatype: double
max count: 1

path: keywordQualityScore
name: keyword quality score
description: Keyword Quality Score - The quality score assigned to the keyword by the ad platform (0 – 10, higher is better).
datatype: double
max count: 1

path: newCustomerCogs
name: new customer cogs
description: Pixel New Customer Cost of Goods - The cost of goods for Pixel-reported purchases by new customers within the selected time frame (before refunds). Imported from the main sales platform, or edit these in Cost Settings > Cost of Goods. Note that COGS for Pixel data is set at attribution time and does not get updated subsequently, so may vary from COGS data in the Orders table. Learn how Triple Whale classifies new/returning customers .
datatype: double
max count: 1

path: newCustomerOrderRevenue
name: new customer order revenue
description: Pixel New Customer Conversion Value - Pixel-reported conversion value (order revenue) derived from New Customers. Learn how Triple Whale classifies new/returning customers .
datatype: double
max count: 1

path: newCustomerOrders
name: new customer orders
description: Pixel New Customer Purchases - Number of Pixel-reported orders placed by New Customers. Learn how Triple Whale classifies new/returning customers .
datatype: double
max count: 1

path: newVisitors
name: new visitors
description: Pixel New Visitors - The Pixel-reported number of first-time visitors to the site.
datatype: double
max count: 1

path: orderRevenue
name: order revenue
description: Pixel Conversion Value (CV) - Pixel-reported conversion value (order revenue) after shipping, taxes, and discounts (before refunds).Order Revenue = Gross Sales + Shipping + Taxes − Discounts Order Revenue = Gross Sales - Discounts + Shipping + Tax
datatype: double
max count: 1

path: ordersQuantity
name: orders quantity
description: Pixel Purchases - The total number of Pixel-reported purchases (orders) within the selected timeframe. Note: This value is calculated based on the attribution model, and may be a fractional number.
datatype: double
max count: 1

path: payments
name: payments
description: Add Payment Info - The number of times users submitted payment details during checkout.
datatype: double
max count: 1

path: productQuantitySoldInOrder
name: product quantity sold in order
description: Units Sold - The total number of individual product units sold in the order.
datatype: double
max count: 1

path: refundMoney
name: refund money
description: Refunds - Total amount returned to customers for refunded sales, refunded taxes, and refunded shipping. Calculated based on the order date. Note that Triple Whale does not track refunds from third-party return management apps (e.g., Loop), so totals may vary from the sales platform. Refunds = Refunded Sales + Refunded Shipping + Refunded Tax
datatype: double
max count: 1

path: sessionPageViews
name: session page views
description: Pixel Session Page Views - The Pixel-reported number of pages viewed during a website session.
datatype: double
max count: 1

path: sessions
name: sessions
description: Pixel Sessions - The Pixel-reported number of online store sessions. Note that Triple Whale defines and tracks sessions differently from the main sales platform so there may be variance between the two. Learn how Triple Whale defines and tracks sessions.
datatype: double
max count: 1

path: shipping
name: shipping
description: Shipping Details Submitted - The number of times users submitted shipping details during checkout.
datatype: double
max count: 1

path: spend
name: spend
description: Ad Spend - Channel-reported ad spend, excluding any custom expenses marked as ad spend.
datatype: double
max count: 1

path: timeOnSite
name: time on site
description: Pixel Time on Site - The Pixel-reported time spent by users on the site during a session, measured in seconds.
datatype: double
max count: 1

path: uniqueVisitors
name: unique visitors
description: Pixel Unique Visitors - The Pixel-reported number of unique visitors to the site.
datatype: double
max count: 1

path: websitePurchases
name: website purchases
description: Website Purchases - The total number of Pixel-reported purchases (orders) during a website session. Excludes recurring subscription purchases.
datatype: double
max count: 1

path: averagePageViewsPerSession
name: average page views per session
description: Pixel Average Page Views Per Session - The average number of pages viewed by users during each session. Pixel Average Page Views Per Session = Session Page Views / Number of Sessions
datatype: string
max count: 1

path: averageSessionDuration
name: average session duration
description: Pixel Average Session Duration - The average time users spend on your site per session. Pixel Average Session Duration (in seconds) = Time on Site / (Number of Sessions - Number of Bounces)
datatype: string
max count: 1

path: bounceRate
name: bounce rate
description: Pixel Bounce Rate - The percentage of single-page visits (bounces) out of total sessions. Pixel Bounce Rate = Number of Bounces / Number of Sessions
datatype: string
max count: 1

path: channelReportedRoas
name: channel reported roas
description: Channel-Reported Return on Ad Spend - Revenue generated per dollar spent on ads, as reported by the channel. Channel-Reported ROAS = Channel-Reported Conversion Value / Ad Spend
datatype: string
max count: 1

path: cpc
name: cpc
description: Cost Per Click (CPC) - The average cost for each ad click. Cost Per Click (CPC) = Ad Spend / Clicks
datatype: string
max count: 1

path: cpm
name: cpm
description: Cost Per Mille (CPM) - The cost for 1,000 ad impressions. Cost Per Mille (CPM) = Ad Spend / Impressions x 1000
datatype: string
max count: 1

path: ctr
name: ctr
description: Click-Through Rate - The percentage of impressions that result in a click. Click-Through Rate (CTR) = Clicks / Impressions
datatype: string
max count: 1

path: emailSignupRate
name: email signup rate
description: Pixel Email Signup Rate - The percentage of sessions that result in email signups. Pixel Email SUR = Number of Email Signups / Number of Sessions
datatype: string
max count: 1

path: iroas
name: iroas
description: Pixel Incremental Return on Ad Spend - The additional revenue generated per dollar spent on advertising by comparing conversions between an exposed group (audience that sees the ad) and a holdout group (control group that does not see the ad). Isolates the incremental ROAS of an ad campaign on driving purchases.
datatype: string
max count: 1

path: ncpa
name: ncpa
description: Pixel New Customer Cost Per Acquisition - The cost to acquire a new customer, as reported by Pixel. Note that Triple Whale classifies all customers as either new or returning, while the main sales platform may leave some unclassified, potentially leading to discrepancies. Pixel NCPA = Blended Ad Spend / Number of New Customer Orders
datatype: string
max count: 1

path: newCustomerRoas
name: new customer roas
description: Pixel New Customer ROAS - Revenue from new customers relative to ad spend. Pixel NC ROAS = New Customer Pixel Conversion Value / Ad Spend Learn how Triple Whale classifies new/returning customers .
datatype: string
max count: 1

path: newCustomersPercent
name: new customers percent
description: Pixel New Customers Percent - The percentage of Pixel-reported purchases made by new customers. Pixel New Customers % = Number of New Customer Pixel Purchases / Total Pixel Purchases Learn how Triple Whale classifies new/returning customers .
datatype: string
max count: 1

path: pixelAov
name: pixel aov
description: Pixel AOV - The Pixel-reported average order value. Pixel AOV = Pixel Conversion Value / Number of Pixel Purchases
datatype: string
max count: 1

path: pixelConversionRate
name: pixel conversion rate
description: Pixel Conversion Rate - The percentage of website sessions that result in purchases, as reported by Pixel. Conversion Rate = Number of Website Purchases / Number of Sessions
datatype: string
max count: 1

path: pixelConversionValueDelta
name: pixel conversion value delta
description: Pixel Conversion Value Delta - The difference between Pixel-reported conversion value and channel-reported conversion value. Pixel CV Delta = Pixel Conversion Value - Channel-Reported Conversion Value
datatype: string
max count: 1

path: pixelCostPerAddToCart
name: pixel cost per add to cart
description: Pixel Cost Per Add To Cart - The cost associated with each add-to-cart action as reported by Pixel. Pixel Cost Per ATC = Ad Spend / Number of Add to Carts
datatype: string
max count: 1

path: pixelCostPerEmailSignup
name: pixel cost per email signup
description: Pixel Cost Per Email Signup - The cost associated with each email signup as reported by Pixel. Pixel Cost Per ESU = Ad Spend / Number of Email Signups
datatype: string
max count: 1

path: pixelCostPerNewVisitor
name: pixel cost per new visitor
description: Pixel Cost Per New Visitor - The cost to acquire a new visitor as reported by Pixel. Pixel Cost Per New Visitor = Ad Spend / Number of New Visitors
datatype: string
max count: 1

path: pixelCostPerVisitor
name: pixel cost per visitor
description: Pixel Cost Per Visitor - The cost to acquire a unique visitor as reported by Pixel. Pixel Cost Per Visitor = Ad Spend / Number of Unique Visitors
datatype: string
max count: 1

path: pixelCpa
name: pixel cpa
description: Pixel Cost Per Acquisition - The cost to acquire a purchase as reported by Pixel. Pixel CPA = Ad Spend / Number of Pixel Purchases
datatype: string
max count: 1

path: pixelNcAov
name: pixel nc aov
description: Pixel New Customer Average Order Value - The average order value for new customers as reported by Pixel. Note that Triple Whale classifies all customers as either new or returning, while the main sales platform may leave some unclassified, potentially leading to discrepancies. Pixel NC AOV = New Customer Pixel Conversion Value / Number of New Customer Pixel Purchases
datatype: string
max count: 1

path: pixelNcConversionRate
name: pixel nc conversion rate
description: Pixel New Customer Conversion Rate - The conversion rate for new customers as reported by Pixel. Note that Triple Whale classifies all customers as either new or returning, while the main sales platform may leave some unclassified, potentially leading to discrepancies. Pixel NC CR = Number of New Customer Pixel Purchases / Number of New Visitors
datatype: string
max count: 1

path: pixelNewVisitorPercent
name: pixel new visitor percent
description: Pixel New Visitor Percent - The percentage of all visitors that are new as reported by Pixel. Pixel New Visitor % = Number of New Visitors / Number of Unique Visitors
datatype: string
max count: 1

path: pixelProfit
name: pixel profit
description: Pixel Profit - The profit calculated as conversion value (order revenue) minus ad spend and cost of goods, as reported by Pixel. Pixel Profit = Pixel Conversion Value - Ad Spend - Pixel COGS
datatype: string
max count: 1

path: pixelRoas
name: pixel roas
description: Pixel Return on Ad Spend - Pixel-reported revenue relative to ad spend. Pixel ROAS = Pixel Conversion Value / Ad Spend
datatype: string
max count: 1

path: returningCustomerOrders
name: returning customer orders
description: Pixel Returning Customer Purchases - Number of Pixel-reported orders placed by Returning Customers. Learn how Triple Whale classifies new/returning customers .
datatype: string
max count: 1

path: returningCustomerRevenue
name: returning customer revenue
description: Pixel Returning Customer Revenue - Pixel-reported conversion value (order revenue) derived from Returning Customers. Learn how Triple Whale classifies new/returning customers .
datatype: string
max count: 1

path: returningCustomersPercent
name: returning customers percent
description: Pixel Returning Customers Percent - The percentage of Pixel-reported purchases made by Returning Customers. Pixel New Customers % = Number of Returning Customer Pixel Purchases / Total Pixel Purchases Learn how Triple Whale classifies new/returning customers .
datatype: string
max count: 1

path: customerId
name: customer id
description: Customer ID - The unique identifier for the customer, assigned by the main sales platform. Example value: 5209503793328
datatype: string
max count: 1

path: customerIdKey
name: customer id key
description: Customer ID Key - Join key for connecting this table to the Customers table. Contains customer_id for Shopify shops and customer_email for non-Shopify shops (e.g., Amazon, BigCommerce, WooCommerce). Example values: 5209503793328 , [email protected]
datatype: string
max count: 1

path: customerLastName
name: customer last name
description: Customer Last Name - The last name of the customer. Example value: Doe
datatype: string
max count: 1

path: customerTags
name: customer tags
description: Customer Tags - Tags associated with the customer, set in the main sales platform. Example values: Active Subscriber , PayPal_user , Login with FB
datatype: string

path: device
name: device
description: Device - The type of device used by the visitor for the session. Example values: mobile , desktop , tablet , wearable
datatype: string
max count: 1

path: discountCode
name: discount code
description: Discount Code - The discount code or promotion name used in the order. Set by the seller in the main sales platform. Example values: WELCOME10 , Replacement for defective item , 807QRWMNK2
datatype: string
max count: 1

path: fulfillmentStatus
name: fulfillment status
description: Fulfillment Status - The fulfillment status of the order. Example values: fulfilled , partial , restocked
datatype: string
max count: 1

path: isFirstOrderInSubscription
name: is first order in subscription
description: Is First Order in Subscription - True if the order is the first in a subscription series. Possible values: true , false
datatype: boolean
max count: 1

path: isNewCustomer
name: is new customer
description: Is New Customer - True if this is the customer's first order. Possible values: true , false Learn how Triple Whale classifies new/returning customers .
datatype: boolean
max count: 1

path: isSubscriptionOrder
name: is subscription order
description: Is Subscription Order - True if the order is part of a subscription. Possible values: true , false
datatype: boolean
max count: 1

path: landingPage
name: landing page
description: Landing Page - The URL path (without query parameters) of the page the visitor landed after clicking on an ad or link, indicating the first page viewed in a session. Example value: /myshop/collections/green_sweater
datatype: string
max count: 1

path: attributionModel
name: attribution model
description: Attribution Model - The attribution model used. By default Triple Attribution . Possible values: Total Impact , Triple Attribution , Triple Attribution + Views , Clicks & Views , Linear All , Linear Paid , First Click , Last Click Note that Total Impact is not available on the Pixel Orders table.
datatype: string
max count: 1

path: orderId
name: order id
description: Order ID - The unique order ID, assigned by the main sales platform. Example value: 4930225799243
datatype: string
max count: 1

path: orderName
name: order name
description: Order Name - The name of the order as assigned by the seller on the main sales platform. Example values: #2188464 , Ex-2163819-9
datatype: string
max count: 1

path: platform
name: platform
description: Sales Platform - The sales platform where the order was processed. Example values: Shopify , Amazon
datatype: string
max count: 1

path: productsInfo
name: products info
description: Products - Details about the products associated with the order (at the level of the variant), including name, product ID, variant ID, type, SKU, etc. Returns the latest product information, not necessarily the data at the time the order was placed.
node: PixelOrderProductsInfoShape
class: PixelOrderProductsInfo
node kind: BlankNodeOrIRI

path: sessionCity
name: session city
description: Session City - The city of the session where the order originated. Example values: San Francisco , Tel Aviv , Kyiv
datatype: string
max count: 1

path: sessionCountry
name: session country
description: Session Country - The country of the session where the order originated. See list of countries . Example values: United States , Canada , United Kingdom
datatype: string
max count: 1

path: sessionId
name: session id
description: Session ID - The unique session ID assigned by Triple Pixel. Note: Only sessions with an order are included in the Pixel Orders table. For data on all sessions, use the Sessions table. Example value: cltlok4y634IRw62AZ_1710700966152
datatype: string
max count: 1

path: shippingCity
name: shipping city
description: Shipping City - The city of the shipping address. Example value: San Francisco
datatype: string
max count: 1

path: shippingCountryCode
name: shipping country code
description: Shipping Country Code - The country code of the shipping address. See list of countries . Example values: US , CA , GB
datatype: string
max count: 1

path: shippingCountryName
name: shipping country name
description: Shipping Country Name - The full name of the shipping country. See list of countries . Example values: United States , Canada , United Kingdom
datatype: string
max count: 1

path: shippingState
name: shipping state
description: Shipping State - The province or state of the shipping address. Example value: California
datatype: string
max count: 1

path: shippingStateCode
name: shipping state code
description: Shipping State Code - The province or state code of the shipping address. Example value: CA
datatype: string
max count: 1

path: shippingZip
name: shipping zip
description: Shipping Zip Code - The zip/postal code of the customer's shipping address. Example values: 48104 , 18235-2239 , CH25 9BH
datatype: string
max count: 1

path: shopId
name: shop id
description: Shop ID - The unique ID of the shop (often corresponds to the shop domain). Can be used to group or filter data by shop in multi-store reports. Example values: example-US.myshopify.com , example-EU.myshopify.com
datatype: string
max count: 1

path: shopName
name: shop name
description: Shop Name - The name of the shop. Can be used to group or filter data by shop in multi-store reports. Example values: example-US , example-EU
datatype: string
max count: 1

path: shopTimezone
name: shop timezone
description: Shop Timezone - The designated timezone of the shop according to the tz database .
datatype: string
max count: 1

path: sourceName
name: source name
description: Source - The origin of the order as designated by the seller on the main sales platform. Example values: web , pos , tiktok
datatype: string
max count: 1

path: tags
name: tags
description: Tags - Tags associated with the order, assigned by the seller in the main sales platform. Example values: Upsell , Order Credits , discount_eligible
datatype: string

path: tripleId
name: triple id
description: Triple Pixel ID - The unique ID assigned by Triple Pixel to track visitors across sessions. Example value: cltlok4y634IRw62AZ
datatype: string
max count: 1

path: utmMedium
name: utm medium
description: UTM Medium - The UTM medium parameter captured by Triple Pixel from the ad URL Example values: sponsored , paid , profile_link
datatype: string
max count: 1

path: utmSource
name: utm source
description: UTM Source - The UTM source parameter captured by Triple Pixel from the ad URL. Example values: web , pos , tiktok , facebook , google , newsletter
datatype: string
max count: 1

path: costOfGoods
name: cost of goods
description: Cost of Goods (COGS) - The cost of goods for Pixel-reported purchases within the selected time frame (before refunds). Imported from the main sales platform, or edit these in Cost Settings > Cost of Goods. Note that COGS for Pixel data is set at attribution time and does not get updated subsequently, so may vary from COGS in the Orders table.
datatype: double
max count: 1

path: currencyRate
name: currency rate
description: Currency Rate - The rate used to convert monetary values to the shop's currency. If no conversion was applied, the value is 1 . To convert back to the original currency, divide by this rate.
datatype: double
max count: 1

path: customExpenses
name: custom expenses
description: Order-Level Custom Expenses - Additional custom expenses associated with individual orders. Import these using the Enrich Orders Data API endpoint.
datatype: double
max count: 1

path: customGrossProfit
name: custom gross profit
description: Custom Gross Profit - Custom gross profit for individual orders. Import using the Enrich Orders Data API endpoint.
datatype: double
max count: 1

path: customGrossSales
name: custom gross sales
description: Custom Gross Sales - Custom gross sales for individual orders. Import using the Enrich Orders Data API endpoint.
datatype: double
max count: 1

path: customNetRevenue
name: custom net revenue
description: Custom Net Revenue - Custom net revenue for individual orders. Import using the Enrich Orders Data API endpoint.
datatype: double
max count: 1

path: customOrdersQuantity
name: custom orders quantity
description: Custom Orders Quantity - The custom-defined quantity of orders to count for the single order_id . Possible values: 0 , 1 Import using the Enrich Orders Data API endpoint.
datatype: double
max count: 1

path: customTotalItemsQuantity
name: custom total items quantity
description: Custom Total Items - The custom-defined total number of items in the order. Import using the Enrich Orders Data API endpoint.
datatype: double
max count: 1

path: discountAmount
name: discount amount
description: Discounts - The total discount amount applied to the order, including shipping discounts.
datatype: double
max count: 1

path: discountAmountForProduct
name: discount amount for product
description: Product Discount Amount - The total product discount amount applied to the order.
datatype: double
max count: 1

path: discountAmountForShipping
name: discount amount for shipping
description: Shipping Discount Amount - The total shipping discount amount applied to the order.
datatype: double
max count: 1

path: grossProductSales
name: gross product sales
description: Gross Sales - Gross sales revenue (before shipping, taxes, discounts, or refunds). Gross Sales = Product Price x Units Sold
datatype: double
max count: 1

path: handlingFees
name: handling fees
description: Handling Fees - Handling fees (e.g. boxing, packaging, or “pick & pack” services) paid by the seller for orders in the selected time frame. Edit these in Cost Settings > Cost of Goods.
datatype: double
max count: 1

path: orderRevenue
name: order revenue
description: Order Revenue - Revenue earned after shipping, taxes, and discounts (before refunds). Order Revenue = Gross Sales + Shipping + Taxes − Discounts
datatype: double
max count: 1

path: ordersQuantity
name: orders quantity
description: Pixel Purchases - The total number of Pixel-reported purchases (orders) within the selected timeframe. Note: This value is calculated based on the attribution model, and may be a fractional number.
datatype: double
max count: 1

path: paymentGatewayCosts
name: payment gateway costs
description: Payment Gateway Costs - Payment processing fees (not including currency conversion fees) paid by the seller. Edit these in Cost Settings > Gateway Costs.
datatype: double
max count: 1

path: productQuantitySoldInOrder
name: product quantity sold in order
description: Units Sold - The total number of individual product units sold in the order.
datatype: double
max count: 1

path: refundMoney
name: refund money
description: Refunds - Total amount returned to customers for refunded sales, refunded taxes, and refunded shipping. Calculated based on the order date. Note that Triple Whale does not track refunds from third-party return management apps (e.g., Loop), so totals may vary from the sales platform. Refunds = Refunded Sales + Refunded Shipping + Refunded Tax
datatype: double
max count: 1

path: shippingCosts
name: shipping costs
description: Shipping Costs - Shipping costs paid by the seller for orders within the select timeframe. Edit these in Cost Settings > Shipping.
datatype: double
max count: 1

path: shippingPrice
name: shipping price
description: Shipping Price - The total shipping price of the order, including shipping taxes and shipping discounts.
datatype: double
max count: 1

path: taxes
name: taxes
description: Taxes - Amount customers paid in taxes (excluding refunded taxes).
datatype: double
max count: 1

path: aov
name: aov
description: Pixel Average Order Value - The Pixel-reported average order value. Pixel AOV = Pixel Conversion Value / Number of Pixel Purchases
datatype: string
max count: 1

path: ltv
name: ltv
description: Lifetime Value - The average order revenue per customer, for orders placed within the selected timeframe. LTV = Order Revenue / Unique Customers
datatype: string
max count: 1

path: newCustomerOrders
name: new customer orders
description: Pixel New Customer Purchases - The total number of orders placed by new customers within the selected time frame. Learn how Triple Whale classifies new/returning customers .
datatype: string
max count: 1

path: newCustomerRevenue
name: new customer revenue
description: Pixel New Customer Revenue - The total revenue derived from orders by new customers. Learn how Triple Whale classifies new/returning customers .
datatype: string
max count: 1

path: newCustomersPercent
name: new customers percent
description: Pixel New Customers Percent - The percentage of Pixel-reported purchases made by new customers. Pixel New Customers % = Number of New Customer Pixel Purchases / Total Pixel Purchases Learn how Triple Whale classifies new/returning customers .
datatype: string
max count: 1

path: ordersWithAmount
name: orders with amount
description: Non-Zero Pixel Purchases - The total number of Pixel-reported purchases with a revenue greater than zero. Non-Zero Pixel Purchases = Count of Pixel Purchases where Order Revenue > $0
datatype: string
max count: 1

path: returningCustomerOrders
name: returning customer orders
description: Pixel Returning Customer Purchases - Number of Pixel-reported orders placed by Returning Customers. Learn how Triple Whale classifies new/returning customers .
datatype: string
max count: 1

path: returningCustomerRevenue
name: returning customer revenue
description: Pixel Returning Customer Revenue - Pixel-reported conversion value (order revenue) derived from Returning Customers. Learn how Triple Whale classifies new/returning customers .
datatype: string
max count: 1

path: returningCustomersPercent
name: returning customers percent
description: Pixel Returning Customers Percent - The percentage of Pixel-reported purchases made by Returning Customers. Pixel New Customers % = Number of Returning Customer Pixel Purchases / Total Pixel Purchases Learn how Triple Whale classifies new/returning customers .
datatype: string
max count: 1

path: trueAov
name: true aov
description: Pixel True Average Order Value - The average non-zero order value (before shipping or taxes), as reported by the sales platform. True AOV = (Order Revenue - Shipping Price - Taxes) / Number of Orders > $0
datatype: string
max count: 1

path: uniqueCustomers
name: unique customers
description: Unique Customers - Number of unique customers who placed orders within the selected timeframe.
datatype: string
max count: 1

path: newCustomerTotalItemsSold
name: new customer total items sold
description: New Customer Units Sold - Total quantity of the product or variant ordered by new customers. Learn how Triple Whale classifies new/returning customers .
datatype: double
max count: 1

path: newCustomerTotalOrderValue
name: new customer total order value
description: New Customer Total Order Value - The total revenue of orders by new customers that contain the product or variant, before shipping, taxes, discounts, or refunds. Learn how Triple Whale classifies new/returning customers .
datatype: double
max count: 1

path: numberOfAds
name: number of ads
description: Ads - Total number of ads contributing to orders containing the product or variant.
datatype: double
max count: 1

path: orders
name: orders
description: Orders - The total number of orders that contain the product or variant.
datatype: double
max count: 1

path: repeatCustomer
name: repeat customer
description: Repeat Customers - Total number of unique customers who purchased the product or variant more than once.
datatype: double
max count: 1

path: returns
name: returns
description: Returns - The total number of product or variant units returned.
datatype: double
max count: 1

path: revenue
name: revenue
description: Product Revenue - The total product-specific revenue from orders that contain the product or variant, after product discounts (before shipping, taxes, or refunds). Product Revenue = (Product Price × Quantity) − Product Discounts
datatype: double
max count: 1

path: spend
name: spend
description: Ad Spend - Total ad spend attributed to the product or variant based on its proportional share of units sold in each ad. This does not include custom ad spend or adjustments for returns. Ad Spend for Product = (Units Sold for Product / Units Sold for Ad) × Ad Spend for Ad, summed across all relevant ads and campaigns.
datatype: double
max count: 1

path: totalItemsSold
name: total items sold
description: Units Sold - The total number of individual units sold for the product or variant.
datatype: double
max count: 1

path: totalOrderValue
name: total order value
description: Total Order Value - The total revenue of orders that contain the product or variant, after shipping, taxes, and discounts. Total Order Value = Order Revenue (Gross Sales + Shipping + Taxes - Discounts) for each order containing the product or variant. Note: The full order amount is counted for each product in that order, even if the order contains multiple products.
datatype: double
max count: 1

path: visits
name: visits
description: Visits - Total number of sessions attributed to the product or variant, based on its share of units sold per ad. Visits for Product = (Units Sold for Product / Units Sold for Ad) × Sessions for Ad, summed across all relevant ads and campaigns.
datatype: double
max count: 1

path: avgPurchasePrice
name: avg purchase price
description: Average Purchase Price - The average price per item sold. Average Purchase Price = Order Revenue / Units Sold
datatype: string
max count: 1

path: contributionMargin
name: contribution margin
description: Contribution Margin - The total profit contribution after subtracting fulfillment costs and ad spend from total revenue. Contribution Margin = Order Revenue - Fulfillment Costs - Ad Spend
datatype: string
max count: 1

path: contributionMarginPerItem
name: contribution margin per item
description: Contribution Margin Per Item - The profit contribution for each item sold. Contribution Margin Per Item = (Order Revenue - Fulfillment Costs - Ad Spend) / Units Sold
datatype: string
max count: 1

path: cpa
name: cpa
description: Cost Per Acquisition (CPA) - The cost to acquire a single order. CPA = Total Ad Spend / Total Orders
datatype: string
max count: 1

path: cpc
name: cpc
description: Cost Per Click (CPC) - The average cost for each click on an ad. CPC = Total Ad Spend / Total Clicks
datatype: string
max count: 1

path: cpm
name: cpm
description: Cost Per Thousand Impressions (CPM) - The cost to reach 1,000 ad impressions. CPM = Total Ad Spend / (Total Impressions / 1,000)
datatype: string
max count: 1

path: ctr
name: ctr
description: Click-Through Rate (CTR) - The percentage of ad impressions that resulted in clicks. CTR = Total Clicks / Total Impressions
datatype: string
max count: 1

path: grossProfit
name: gross profit
description: Gross Profit - The total profit excluding fulfillment costs. Gross Profit = Revenue - Fulfillment Costs
datatype: string
max count: 1

path: newCustomerAov
name: new customer aov
description: New Customer AOV - The average order value for new customers, indicating the average spend per order by new customers. New Customer AOV = New Customer Total Order Value / New Customer Orders Learn how Triple Whale classifies new/returning customers .
datatype: string
max count: 1

path: newCustomerCpa
name: new customer cpa
description: New Customer CPA - The cost to acquire a single new paying customer. New Customer CPA = Total Ad Spend / New Customer Orders Learn how Triple Whale classifies new/returning customers .
datatype: string
max count: 1

path: newCustomerGrossProfit
name: new customer gross profit
description: New Customer Gross Profit - The gross profit generated from new customers. New Customer Gross Profit = New Customer Revenue - New Customer Fulfillment Costs Learn how Triple Whale classifies new/returning customers .
datatype: string
max count: 1

path: newCustomerRoas
name: new customer roas
description: New Customer ROAS - Revenue generated from new customers relative to ad spend. New Customer ROAS = New Customer Revenue / Ad Spend Learn how Triple Whale classifies new/returning customers .
datatype: string
max count: 1

path: pixelConversionRate
name: pixel conversion rate
description: Pixel Conversion Rate - The percentage of visits who made a purchase. Pixel Conversion Rate = Total Orders / Total Visits
datatype: string
max count: 1

path: productAov
name: product aov
description: Product AOV - The average order value for products, representing the average amount spent per order. Product AOV = Total Order Value / Total Orders
datatype: string
max count: 1

path: returnRate
name: return rate
description: Return Rate - The percentage of purchased items that customers return. Return Rate = Returns / Units Sold
datatype: string
max count: 1

path: roas
name: roas
description: Return on Ad Spend (ROAS) - The total revenue generated relative to ad spend. ROAS = Order Revenue / Ad Spend
datatype: string
max count: 1

path: rpr
name: rpr
description: Repeat Purchase Rate - The percent of purchases made by returning customers. RPR = Repeat Customers / Total Orders
datatype: string
max count: 1

path: sessionPageViews
name: session page views
description: Session Page Views - Number of pages viewed during a website session.
datatype: double
max count: 1

path: sessionCount
name: session count
description: Pixel Sessions - The Pixel-reported number of online store sessions. Note that Triple Whale defines and tracks sessions differently from the main sales platform so there may be variance between the two. Learn how Triple Whale defines and tracks sessions.
datatype: string
max count: 1