- Docs
- API reference
- Endpoints and schemas
- GraphQL
- Selection
BrandCardTransaction
Contains quantitative information about the card transactions processed by the brand.
Selection. This type is a selection. You reach it through a connection, and you choose which of its fields come back.
Contains quantitative information about the card transactions processed by the brand.
Data Sources
Section titled “Data Sources”The card transaction data is derived from a panel of around a third of all U.S. credit and debit card transactions.
Where it appears
Section titled “Where it appears”Shortest path from a primary entity: Brand → cardTransactions → BrandCardTransaction.
Brand.cardTransactions
Fields
Section titled “Fields”| Field | Label | Type | Description |
|---|---|---|---|
rank |
Rank | Int |
Determines the display order of the attribute, with lower values shown first |
quantityType |
Quantity Type | String |
This field indicates the type of quantity represented in the record. See the values. |
period |
Period | String |
This field indicates the length of the time period represented in the record. See the values. |
projectedQuantity |
Projected Quantity | Float |
This field contains the value for the quantity specified in quantity type. |
platformBrandId |
Platform Brand ID | UUID |
This field contains the brand id of the platform that processed the transaction. |
id |
ID | UUID! |
The unique identifier of this object. |
firstObservedDate |
First Observed Date | String |
The earliest date of a source record that supports this attribute or relationship. The source date is, for example, the date when Enigma collected the record or when the source last updated it. Most values have a date, a time, and a UTC offset, but some have the date only. |
lastObservedDate |
Last Observed Date | String |
The latest date of a source record that supports this attribute or relationship. It uses the same source dates and the same format as firstObservedDate. |
periodStartDate |
Period Start Date | Date |
This field contains the start date of the time period represented in the record. |
periodEndDate |
Period End Date | Date |
This field contains the end date of the time period represented in the record. |
internalId |
String |
A numeric identifier that Enigma assigns to this object when it builds its data. On most attribute objects, id is the UUID form of this number. |
|
internalBrandId |
String |
The internalId of the brand that this attribute describes. |
|
internalPlatformBrandId |
String |
The internalId of the platform brand that processed the transactions. The value is null when the quantity is not attributed to a platform. |
quantityType values
Section titled “quantityType values”| Value | Meaning |
|---|---|
avg_transaction_size |
The record is the average transaction size in dollars for the brand for that time period. |
has_transactions |
The record is a 1 if the brand had any transactions in the time period, and 0 otherwise. |
refunds_amount |
The record is the total amount of refunds in dollars for the brand for that time period. |
card_transactions_count |
The record is the total number of card transactions for the brand for that time period. |
card_revenue_amount |
The record is the total sales amount in dollars for the brand for that time period. |
card_customers_average_daily_count |
The record is the average number of unique daily customers for the brand for that time period. |
card_revenue_yoy_growth |
The record is the ratio of the brand’s current period’s revenue to the period one year prior’s revenue. |
card_revenue_prior_period_growth |
The record is the ratio of the brand’s current period’s revenue to the previous period’s revenue. |
card_not_present_revenue_amount |
The record is the total sales amount for card-not-present transactions (e.g. online purchases, phone orders) for the brand. |
card_not_present_revenue_ratio |
The record is the ratio of the brand’s card-not-present revenue to its total card revenue. |
card_not_present_revenue_transaction_count |
The record is the total number of card-not-present transactions for the brand. |
period values
Section titled “period values”| Value | Meaning |
|---|---|
1m |
One month. |
3m |
Three months. |
12m |
Twelve months. |
Math fields
Section titled “Math fields”Every record of this type answers count, countDistinct, has, sum, min, max, avg, collect, minDateTime, maxDateTime. Each takes field and an optional conditions. See Selection.
Example
Section titled “Example”query { search(searchInput: { entityType: BRAND name: "Safeway" conditions: { limit: 1 } }) { ... on Brand { id cardTransactions(first: 1) { edges { node { id rank quantityType period projectedQuantity } } } } }}Response, as returned:
{ "data": { "search": [ { "id": "0f26fbef-3436-4f85-8bcd-31fe12a4f99a", "cardTransactions": { "edges": [ { "node": { "id": "000000f6-0012-5cb6-0000-0a8000000000", "rank": 0, "quantityType": "card_revenue_amount", "period": "12m", "projectedQuantity": 25473359403 } } ] } } ] }}