📘 This article explains how to integrate your Google Analytics 4 data with Botify.
Overview
Google Analytics brings a new dimension to Botify reports. When you integrate your Google Analytics account with Botify, we import your visit data from search engines and social networks. These performance indicators are mapped to SEO indicators from the Botify crawl analysis. Botify reports will identify areas that can be improved, such as the pages that generated organic visits but have duplicate HTML tags or those that did not generate visits because they are deep in the website structure.
GA4 data in Botify reports
When you integrate your Google Analytics 4 data, Botify retrieves your visit, conversion, and Paid Search data. If you have integrated Universal Analytics (UA) data in Botify, we ensure consistency with your data by mapping the data between the two analytics platforms. Google Analytics 4 visit data is available in the following locations in Botify:
The Analytics Overview Page: The funnel on the Overview page uses Google’s data to show a full-funnel view of its organic search performances.
EngagementAnalytics: EngagementAnalytics shows Google’s data daily with trend charts to capture the evolution.
SiteCrawler: GA data is aggregated by default in a 30-day period in SiteCrawler's Visits section, which provides indicators for all search engines, social networks, and the most popular sources: Google, Bing, Yahoo, Twitter, and Facebook. The Visits section also combines visit data with SEO indicators, such as: pages that generate visits vs. those that do not, pages by depth, HTML tags uniqueness, and internal links. You can browse data imported from GA through the URL Explorer, use criteria based on visits as filters in reports, and export results. You can also retrieve visit data in the RealKeywords Keywords Explorer on a selected period.
Visit and conversion dimensions and metrics: Use the dimensions and metrics shown below as filters and report columns for your visit and conversion data:
Refer to the Revenue and Conversion Data in Botify article to learn more about the ROI use case with Google Analytics and Botify.
GA4 fields
The data Botify retrieves from GA is shown below. Use the Botify field names in the visits.dip and conversions.dip collections to pull data from the BQL API.
Google Analytics fields retrieved
The Google Analytics fields retrieved when you integrate your GA data with Botify are shown below.
Botify API Field Name | GA Field Name | Definition |
medium | sessionMedium | The medium that first acquired the user to your website or app. Botify uses the following values: CPC, Organic, Referral. |
source | sessionSource | The source that initiated a session on your website or app (e.g., Google, Baidu). |
sessions | sessions | The number of user sessions that began on your site or app. |
session_duration | userEngagementDuration | The total amount of time (in seconds) your website or app was in the foreground of users' devices. |
device | deviceCategory | The type of device: Desktop, Tablet, or Mobile. |
data_source | Platform | The platform on which your app or website runs (e.g., web, iOS, Android). |
page_views | screenPageViews | The number of app screens or web pages your users viewed. Repeated views of a single page or screen are counted. (screen_view + page_view events) |
new_users | newUsers | The number of sessions marked as a user's first session. |
transactions | transactions | The count of transaction events with purchase revenue. Transaction events include: in_app_purchase, ecommerce_purchase, purchase, app_store_subscription_renew, app_store_subscription_convert, _and _refund. |
revenue | purchaseRevenue | The sum of revenue from purchases made in your app or site. Purchase revenue is specified by the 'value' parameter in tagging. Purchase revenue totals the revenue for the following events: purchase, ecommerce_purchase, in_app_purchase, app_store_subscription_convert, and app_store_subscription_renew. |
google_ads_campaign_id | googleAdsCampaignId | The campaign ID for the Google Ads campaign attributed to the conversion event. |
google_ads_campaign_type | googleAdsCampaignType | The campaign type for the Google Ads campaign attributed to the conversion event. Campaign types determine where customers see your ads and the available settings and options in Google Ads. |
google_ads_ad_group_id | googleAdsAdGroupId | The ad group ID attributed to the conversion event. |
google_ads_creative_id | googleAdsCreativeId | The creative ID attributed to the conversion event. Creative IDs identify individual ads. |
google_ads_ad_network_type | googleAdsAdNetworkType | The advertising network where your ads appear and conversion happens. Botify filters the campaign retrieved only on Google Search network. Other networks include: Search Partners, Google Display Network, Youtube Search, Youtube Videos, Cross-network, Social, and Universal Campaign. |
google_ads_impressions | advertiserAdImpressions | The total number of impressions. Includes impressions from linked integrations (e.g., display & video 360 advertisers). Includes uploaded impressions from data import. |
google_ads_clicks | advertiserAdClicks | Total number of times users clicked on an ad that included this keyword. This number includes uploaded clicks from data import. |
google_ads_cost | advertiserAdCost | The total amount you paid for your ads in your linked Google Ads account. |
google_ads_total_revenue | totalRevenue | The sum of revenue from purchases, subscriptions, and advertising revenue. |
google_ads_cost_per_click | advertiserAdCostPerClick | Ads cost-per-click (CPC) is the ad cost divided by the number of ad clicks. |
Botify computed fields
The following fields are computed by Botify using your integrated GA data. The GA API does not expose these fields.
Botify API Field Name | GA Field Name | Definition |
url | NA | Botify composes the source URL of visits and conversions based on |
bounces | NA | A Bounce in UA is any session with a single event, typically a single page view (i.e., a user visits your website and immediately leaves). Subsequent interactive events prevent a session from counting as a Bounce. Since the "Bounces" event does not exist in GA4, Botify calculates it like this: |
bounce_rate | NA | Bounce rate is the percentage of sessions that were not engaged sessions (i.e., a user visits your website, reviews content on your home page for less than 10 seconds, and then leaves without triggering any events or visiting any other pages or screens). The bounce rate is the inverse of the Engagement rate. Botify calculates the Bounce Rate like this: |
count_urls_visits_dip | NA | The number of unique URLs used to compute different metrics on the Botify Analytics Overview page (e.g., pages not crawled recently by Google with visits). |
count_urls_conversion | NA | The number of unique URLs with at least one key event, used to compute different metrics on the Botify Analytics Overview page. |
goal_completions_all | keyEvents | The count of conversion events. You can mark any event as a conversion in Google Analytics, and some events are marked as conversions by default (e.g., first_open, purchase). |
goal_conversion_rate_all | NA | The percentage of total sessions with goal completions. |
pages_per_session | NA | The total amount of pages per user session. Botify calculates Pages per Session like this: |
average_session_duration | NA | The average time (in seconds) your website or app was in the foreground of users' devices. |
percentage_new_sessions | NA | The percentage of the total number of sessions created by new users. Botify calculates % New Sessions like this: |
google_ads_return_on_ad_spend | returnOnAdSpend | Return On Ad Spend (ROAS) is the total revenue divided by the advertiser ad cost. Botify calculates ROAS like this |
Configuring the GA4 integration
You configure the GA integration within your Botify project settings.
Prerequisites
You must use your personal Google account.
You must have at least viewing access to the Google Analytics account you want to connect to your project.
To configure the GA4 integration:
Navigate to Settings > Data Station > Google Analytics 4.
Click the Add an account button. Follow the prompts to log into your Google account.
From the Account dropdown list, select the name of the GA account to connect to the project.
From the Property dropdown list, select the name of the web property from your GA account.
In the Starting date field, select the date from which Botify will retrieve historical GA4 data. After confirming the start date for historical data, you cannot change it.
Click Save.
Click Confirm to save your historical data start date and launch the integration process.
Connecting another analytics source
Contact your SEO Success Manager (SSM) to integrate analytics from another provider. The integration steps required will vary depending on the provider. Specifically, your SSM can provide you with the integration steps for Adobe or Piano Analytics.
Modifying GA4 settings
After connecting your GA property to a Botify project, you can change the GA account and property associated with the project
❗️Changing the GA account or property associated with a Botify project will reset your visit and conversion data from the new data history start date.
To change the GA account or property, repeat the steps in Configuring the GA4 Integration section.
Disconnecting GA4 from a Botify project
If you no longer want GA4 data included in your project:
Navigate to Settings > Data Sources > Google Analytics 4.
Click the Delete button next to the Google Analytics account to be removed from your project.
Click Remove my account in the confirmation message.
FAQs
The following are frequently asked questions about Google Analytics data in Botify.
How long does it take to retrieve data?
How long does it take to retrieve data?
Depending on your project and the volume of data, synchronization can take up to a few days to fully retrieve your GA4 data. Our synchronization generally takes up to one day to retrieve a full month of data (e.g., if you choose to retrieve six months of history, it will take around six days to retrieve the data fully).
What history of data from GA4 can I backfill?
What history of data from GA4 can I backfill?
Botify can only retrieve historical data for up to 14 months from GA4. As specified by Google, retention of user-level data, including conversions, can be set to a maximum of 14 months for GA4 properties.
How long is data saved in Botify?
How long is data saved in Botify?
Visit and conversion data is stored for up to 36 months in Botify.
See also: