Integration Specifications
This article will help you learn about how Daasity replicates data from Google Analytics 4, limitations to the data we can extract and where the data is stored in the Google Analytics 4 schema.
Integration Overview
Google Analytics 4 is Google's free web analytics service that allows you to analyze in-depth detail about the visitors on your website. It provides valuable insights that can help you to shape the success of your business.
The Daasity GA4 API extractor pulls a standard set of data via the Analytics Data API. Similar to Universal Analytics / GA3 this endpoint has certain limitations on both available dimensions and metrics. More information on what can be extracted is available here:
Integration Availability
This integration is available for:
Enterprise
Growth
API Endpoints
The Daasity GA4 extractor is built based on the Analytics Data API. We use the endpoint noted in the Creating a Report section to extract data from GA4.
Entity Relationship Diagram (ERD)
Click here to view the ERD for the GA4 via API integration illustrating the different tables and keys to join across tables.
Google Analytics 4 Schema
The Daasity GA4 via API extractor creates these tables using the endpoints and replication methods listed. The data is mapped from the source API endpoint to the table based on the mapping logic outlined in each table.
Base Traffic
Endpoint: Creating a Report
Update Method: UPSERT
Table Name: [
ga4_api.base_traffic]Sync Key: [
streamId + date + sessionSource + sessionMedium + sessionCampaignName + sessionDefaultChannelGrouping + newVsReturning + deviceCategory + countryId]
| JSON Element | Database Column |
|---|---|
Daasity: Property entered into the UI | PROPERTY_ID |
streamId | STREAM_ID |
date | CREATED_ON |
sessionSource | SESSION_SOURCE |
sessionMedium | SESSION_MEDIUM |
sessionCampaignName | SESSION_CAMPAIGN_NAME |
sessionDefaultChannelGrouping | SESSION_DEFAULT_CHANNEL_GROUPING |
newVsReturning | NEW_VS_RETURNING |
deviceCategory | DEVICE_CATEGORY |
countryId | COUNTRY_ID |
screenPageviews | SCREEN_PAGEVIEWS |
sessions | SESSIONS |
engagedSessions | ENGAGED_SESSIONS |
transactions | TRANSACTIONS |
userEngagementDuration | USER_ENGAGEMENT_DURATION |
purchaseRevenue | PURCHASE_REVENUE |
Daasity: from Channel Mapping Google Sheet | CHANNEL |
Daasity: from Channel Mapping Google Sheet | VENDOR |
Daasity: from Channel Mapping Google Sheet | SUB_CHANNEL |
Daasity: from Channel Mapping Google Sheet | MEDIA_TYPE |
Daasity: Unique ID for Integration | INTEGRATION_ID |
Base Shopping Stage
Endpoint: Creating a Report
Update Method: UPSERT
Table Name: [
ga4_api.base_shopping_stage]Sync Key: [
streamId + date + sessionSource + sessionMedium + sessionCampaignName + eventName + sessionDefaultChannelGrouping + newVsReturning + deviceCategory]
| JSON Element | Database Column |
|---|---|
Daasity: Property entered into the UI | PROPERTY_ID |
streamId | STREAM_ID |
date | CREATED_ON |
sessionSource | SESSION_SOURCE |
sessionMedium | SESSION_MEDIUM |
sessionCampaignName | SESSION_CAMPAIGN_NAME |
eventName | EVENT_NAME |
sessionDefaultChannelGrouping | SESSION_DEFAULT_CHANNEL_GROUPING |
newVsReturning | NEW_VS_RETURNING |
deviceCategory | DEVICE_CATEGORY |
sessions | SESSIONS |
Daasity: from Channel Mapping Google Sheet | CHANNEL |
Daasity: from Channel Mapping Google Sheet | VENDOR |
Daasity: from Channel Mapping Google Sheet | SUB_CHANNEL |
Daasity: from Channel Mapping Google Sheet | MEDIA_TYPE |
Daasity: Unique ID for Integration | INTEGRATION_ID |
This extraction applies a number of filters to the report:
Event Name on the following
session_start
view_item
add_to_cart
view_cart
begin_checkout
purchase
add_payment_info
add_shipping_info
view_item_list
select_item
Base PDP Performance
Endpoint: Creating a Report
Update Method: UPSERT
Table Name: [
ga4_api.base_pdp_performance]Sync Key: [
streamId + date + itemName + itemID]
| JSON Element | Database Column |
|---|---|
Daasity: Property entered into the UI | PROPERTY_ID |
streamId | STREAM_ID |
date | CREATED_ON |
itemName | ITEM_NAME |
itemId | ITEM_ID |
itemsViewed | ITEM_VIEW_EVENTS |
itemsAddedToCart | ADD_TO_CARTS |
itemsCheckedOut | CHECKOUTS |
itemRevenue | ITEM_REVENUE |
itemsPurchased | ECOMMERCE_PURCHASES |
Daasity: Unique ID for Integration | INTEGRATION_ID |
Base Transactions
Endpoint: Creating a Report
Update Method: UPSERT
Table Name: [
ga4_api.base_transactions]Sync Key: [
streamId + date + transactionId]
| JSON Element | Database Column |
|---|---|
Daasity: Property entered into the UI | PROPERTY_ID |
streamId | STREAM_ID |
date | CREATED_ON |
transactionId | TRANSACTION_ID |
sessionSource | SESSION_SOURCE |
sessionMedium | SESSION_MEDIUM |
sessionCampaignName | SESSION_CAMPAIGN_NAME |
sessionDefaultChannelGrouping | SESSION_DEFAULT_CHANNEL_GROUPING |
sessionManualTerm | SESSION_MANUAL_TERM |
sessionManualAdContent | SESSION_MANUAL_AD_CONTENT |
N/A | SESSION_SOURCE_PLATFORM |
N/A | FIRST_USER_SOURCE |
N/A | FIRST_USER_MEDIUM |
N/A | FIRST_USER_CAMPAIGN_NAME |
N/A | FIRST_USER_DEFAULT_CHANNEL_GROUPING |
N/A | FIRST_USER_MANUAL_TERM |
N/A | FIRST_USER_MANUAL_AD_CONTENT |
N/A | FIRST_USER_SOURCE_PLATFORM |
N/A | NEW_VS_RETURNING |
N/A | DEVICE_CATEGORY |
N/A | COUNTRY |
N/A | COUNTRY_ID |
N/A | CITY |
N/A | REGION |
N/A | BROWSER |
N/A | OPERATING_SYSTEM |
purchaseRevenue | PURCHASE_REVENUE |
Daasity: from Channel Mapping Google Sheet | CHANNEL |
Daasity: from Channel Mapping Google Sheet | VENDOR |
Daasity: from Channel Mapping Google Sheet | SUB_CHANNEL |
Daasity: from Channel Mapping Google Sheet | MEDIA_TYPE |
Daasity: Unique ID for Integration | INTEGRATION_ID |
NOTE: The [base_transactions] table has all the fields across all transactions tables so that a single table can be created. To fully populate this table SQL code needs to be run to update the [base_transactions] table from the staging and DDA transactions table.
Base Transactions DDA
Endpoint: Creating a Report
Update Method: UPSERT
Table Name: [
ga4_api.base_transactions_dda]Sync Key: [
streamId + date + transactionId + source + medium + campaignName + defaultChannelGrouping + manualAdContent + manualTerm]
| JSON Element | Database Column |
|---|---|
Daasity: Property entered into the UI | PROPERTY_ID |
streamId | STREAM_ID |
date | CREATED_ON |
transactionId | TRANSACTION_ID |
source | SOURCE |
medium | MEDIUM |
campaignName | CAMPAIGN_NAME |
defaultChannelGrouping | DEFAULT_CHANNEL_GROUPING |
manualAdContent | MANUAL_AD_CONTENT |
manualTerm | MANUAL_TERM |
purchaseRevenue | PURCHASE_REVENUE |
Daasity: Unique ID for Integration | INTEGRATION_ID |
Base Transactions Stage 2
Endpoint: Creating a Report
Update Method: UPSERT
Table Name: [
ga4_api.base_transactions_stg_2]Sync Key: [
streamId + date + transactionId]
| JSON Element | Database Column |
|---|---|
Daasity: Property entered into the UI | PROPERTY_ID |
streamId | STREAM_ID |
date | CREATED_ON |
transactionId | TRANSACTION_ID |
sessionSourcePlatform | SESSION_SOURCE_PLATFORM |
firstUserSource | FIRST_USER_SOURCE |
firstUserMedium | FIRST_USER_MEDIUM |
firstUserCampaignName | FIRST_USER_CAMPAIGN_NAME |
firstUserDefaultChannelGrouping | FIRST_USER_DEFAULT_CHANNEL_GROUPING |
firstUserManualTerm | FIRST_USER_MANUAL_TERM |
purchaseRevenue | PURCHASE_REVENUE |
Daasity: Unique ID for Integration | INTEGRATION_ID |
Base Transactions Stage 3
Endpoint: Creating a Report
Update Method: UPSERT
Table Name: [
ga4_api.base_transactions_stg_3]Sync Key: [
streamId + date + transactionId]
| JSON Element | Database Column |
|---|---|
Daasity: Property entered into the UI | PROPERTY_ID |
streamId | STREAM_ID |
date | CREATED_ON |
transactionId | TRANSACTION_ID |
firstUserManualAdContent | FIRST_USER_MANUAL_AD_CONTENT |
firstUserSourcePlatform | FIRST_USER_SOURCE_PLATFORM |
newVsReturning | NEW_VS_RETURNING |
deviceCategory | DEVICE_CATEGORY |
purchaseRevenue | PURCHASE_REVENUE |
Daasity: Unique ID for Integration | INTEGRATION_ID |
Base Transactions Stage 4
Endpoint: Creating a Report
Update Method: UPSERT
Table Name: [
ga4_api.base_transactions_stg_4]Sync Key: [
streamId + date + transactionId]
| JSON Element | Database Column |
|---|---|
Daasity: Property entered into the UI | PROPERTY_ID |
streamId | STREAM_ID |
date | CREATED_ON |
transactionId | TRANSACTION_ID |
country | COUNTRY |
countryId | COUNTRY_ID |
city | CITY |
region | REGION |
browser | BROWSER |
operatingSystem | OPERATING_SYSTEM |
purchaseRevenue | PURCHASE_REVENUE |
Daasity: Unique ID for Integration | INTEGRATION_ID |
Last updated