# Integration Specifications ## 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](https://developers.google.com/analytics/devguides/reporting/data/v1). 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: * [Dimension & Metrics in GA4](https://developers.google.com/analytics/devguides/reporting/data/v1/api-schema) * [GA4 Dimension & Metric Explorer](https://ga-dev-tools.google/ga4/dimensions-metrics-explorer/) ## **Integration Availability** This integration is available for: * Enterprise * Growth ## API Endpoints The Daasity GA4 extractor is built based on the [Analytics Data API](https://developers.google.com/analytics/devguides/reporting/data/v1). We use the endpoint noted in the [Creating a Report](https://developers.google.com/analytics/devguides/reporting/data/v1/basics) section to extract data from GA4. ## Entity Relationship Diagram (ERD) [Click here to view the ERD for the GA4 via API integration](https://lucid.app/documents/embedded/36649bea-9930-4fff-abd0-e7f4073cb2d6) illustrating the different tables and keys to join across tables. {% @lucid/lucid-component url="" fullWidth="true" %} ## 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](#base-traffic) * [Base Shopping Stage](#base-shopping-stage) * [Base PDP Performance](#base-pdp-performance) * [Base Transactions](#base-transactions) * [Base Transactions DDA](#base-transactions-dda) * [Base Transactions STG 2](#base-transactions-stage-2) * [Base Transactions STG 3](#base-transactions-stage-3) * [Base Transactions STG 4](#base-transactions-stage-4) ### **Base Traffic** * Endpoint: [Creating a Report](https://developers.google.com/analytics/devguides/reporting/data/v1/basics) * 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](https://developers.google.com/analytics/devguides/reporting/data/v1/basics) * 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 | {% hint style="info" %} 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 {% endhint %} ### **Base PDP Performance** * Endpoint: [Creating a Report](https://developers.google.com/analytics/devguides/reporting/data/v1/basics) * 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](https://developers.google.com/analytics/devguides/reporting/data/v1/basics) * Update Method: UPSERT * Table Name: \[`ga4_api.base_transactions`] * Sync Key: \[`streamId + date + transactionId`]
JSON ElementDatabase Column
Daasity: Property entered into the UIPROPERTY_ID
streamIdSTREAM_ID
dateCREATED_ON
transactionIdTRANSACTION_ID
sessionSourceSESSION_SOURCE
sessionMediumSESSION_MEDIUM
sessionCampaignNameSESSION_CAMPAIGN_NAME
sessionDefaultChannelGroupingSESSION_DEFAULT_CHANNEL_GROUPING
sessionManualTermSESSION_MANUAL_TERM
sessionManualAdContentSESSION_MANUAL_AD_CONTENT
N/ASESSION_SOURCE_PLATFORM
N/AFIRST_USER_SOURCE
N/AFIRST_USER_MEDIUM
N/AFIRST_USER_CAMPAIGN_NAME
N/AFIRST_USER_DEFAULT_CHANNEL_GROUPING
N/AFIRST_USER_MANUAL_TERM
N/AFIRST_USER_MANUAL_AD_CONTENT
N/AFIRST_USER_SOURCE_PLATFORM
N/ANEW_VS_RETURNING
N/ADEVICE_CATEGORY
N/ACOUNTRY
N/ACOUNTRY_ID
N/ACITY
N/AREGION
N/ABROWSER
N/AOPERATING_SYSTEM
purchaseRevenuePURCHASE_REVENUE
Daasity: from Channel Mapping Google SheetCHANNEL
Daasity: from Channel Mapping Google SheetVENDOR
Daasity: from Channel Mapping Google SheetSUB_CHANNEL
Daasity: from Channel Mapping Google SheetMEDIA_TYPE
Daasity: Unique ID for IntegrationINTEGRATION_ID
{% hint style="info" %} **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. {% endhint %} ### **Base Transactions DDA** * Endpoint: [Creating a Report](https://developers.google.com/analytics/devguides/reporting/data/v1/basics) * 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](https://developers.google.com/analytics/devguides/reporting/data/v1/basics) * 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](https://developers.google.com/analytics/devguides/reporting/data/v1/basics) * 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](https://developers.google.com/analytics/devguides/reporting/data/v1/basics) * 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 |