Skip to main content

Google Analytics - GA4 Component

Manage Google Analytics GA4 accounts and data

Component key: google-analytics-ga4

Description

Google Analytics is Google's platform of analytics tooling. This component allows you to manage Analytics GA4 data.

Connections

Google Analytics OAuth 2.0

The Google Analytics component authenticates requests through Google's OAuth 2.0 service.

To create a Google Analytics developer account and authenticate, follow their Configure OAuth Consent guide

Now, you will have to configure OAuth 2.0 settings in Prismatic. Create a new Google Analytics connection of type OAuth 2.0.

  • For Client ID and Client Secret enter the values that you got from the Google Cloud Platform auth settings.
  • For Scopes choose from the list found on Google's service scopes documentation
InputDefaultNotes
Authorize URL
string
/ Required
Hidden Field
authorizeUrl
https://accounts.google.com/o/oauth2/v2/auth?access_type=offline&prompt=consent
The OAuth 2.0 Authorization URL for Google Calendar
Client ID
string
/ Required
clientId
Provide a string value for the client Id of your OAuth 2.0 application.
Client Secret
password
/ Required
clientSecret
Provide a string value for the client secret of your OAuth 2.0 application.
Scopes
string
/ Required
scopes
https://www.googleapis.com/auth/analytics https://www.googleapis.com/auth/analytics.manage.users https://www.googleapis.com/auth/analytics.edit https://www.googleapis.com/auth/analytics.readonly
A space-delimited set of one or more scopes to get the user's permission to access.
Token URL
string
/ Required
Hidden Field
tokenUrl
https://oauth2.googleapis.com/token
The OAuth 2.0 Token URL for Google Analytics

Data Sources

List Accounts

Return a list of accounts accessible by the caller | key: listAccounts | type: picklist

InputNotes
Connection
connection
/ Required
connection
 

{
"result": [
{
"key": "accounts/000000000",
"label": "My Account 1"
},
{
"key": "accounts/000000001",
"label": "My Account 2"
}
]
}

List Properties

List Google Analytics GA4 properties for an account | key: listProperties | type: picklist

InputNotesExample
Account ID
string
/ Required
accountId
 
accounts/000000000
Connection
connection
/ Required
connection
 
 

Actions

Get Property

Get property by ID | key: getProperty

InputNotesExample
Connection
connection
/ Required
connection
 
 
Property ID
string
/ Required
propertyId
 
properties/111111111

{
"data": {
"name": "properties/111111111",
"parent": "accounts/000000000",
"createTime": "2022-02-02T04:40:59.611Z",
"updateTime": "2022-02-02T04:40:59.611Z",
"displayName": "www.example.com",
"industryCategory": "OTHER",
"timeZone": "America/Chicago",
"currencyCode": "USD",
"serviceLevel": "GOOGLE_ANALYTICS_STANDARD",
"account": "accounts/000000000",
"propertyType": "PROPERTY_TYPE_ORDINARY"
}
}

List Accounts

Return a list of accounts accessible by the caller | key: listAccounts

InputNotes
Connection
connection
/ Required
connection
 

{
"data": {
"accounts": [
{
"name": "accounts/000000000",
"createTime": "2012-11-20T15:12:07.864Z",
"updateTime": "2015-08-11T21:08:55.416Z",
"displayName": "Example Account",
"regionCode": "US"
}
]
}
}

List Properties

List Google Analytics GA4 properties for an account | key: listProperties

InputNotesExample
Account ID
string
/ Required
accountId
 
accounts/000000000
Connection
connection
/ Required
connection
 
 

{
"data": {
"properties": [
{
"name": "properties/111111111",
"parent": "accounts/000000000",
"createTime": "2022-02-02T04:40:59.611Z",
"updateTime": "2022-02-02T04:40:59.611Z",
"displayName": "www.example.com",
"industryCategory": "OTHER",
"timeZone": "America/Chicago",
"currencyCode": "USD",
"serviceLevel": "GOOGLE_ANALYTICS_STANDARD",
"account": "accounts/000000000",
"propertyType": "PROPERTY_TYPE_ORDINARY"
}
]
}
}

Raw Request

Send raw HTTP request to Google Analytics GA4 | key: rawRequest

InputDefaultNotesExample
Base URL
string
/ Required
baseUrl
 
 
Connection
connection
/ Required
connection
 
 
 
Data
string
data
The HTTP body payload to send to the URL.
{"exampleKey": "Example Data"}
Debug Request
boolean
debugRequest
false
Enabling this flag will log out the current request.
 
File Data
string
Key Value List
fileData
File Data to be sent as a multipart form upload.
[{key: "example.txt", value: "My File Contents"}]
Form Data
string
Key Value List
formData
The Form Data to be sent as a multipart form upload.
[{"key": "Example Key", "value": new Buffer("Hello World")}]
Header
string
Key Value List
headers
A list of headers to send with the request.
User-Agent: curl/7.64.1
Max Retry Count
string
maxRetries
0
The maximum number of retries to attempt.
 
Method
string
/ Required
method
The HTTP method to use.
 
Query Parameter
string
Key Value List
queryParams
A list of query parameters to send with the request. This is the portion at the end of the URL similar to ?key1=value1&key2=value2.
 
Response Type
string
/ Required
responseType
json
The type of data you expect in the response. You can request json, text, or binary data.
 
Retry On All Errors
boolean
retryAllErrors
false
If true, retries on all erroneous responses regardless of type.
 
Retry Delay (ms)
string
retryDelayMS
0
The delay in milliseconds between retries.
 
Timeout
string
timeout
The maximum time that a client will await a response to its request
2000
URL
string
/ Required
url
Input the path only (/accounts), the base URL comes from the Base URL input. For example, to connect to <INPUT_BASE_URL>/accounts, only /accounts is entered in this field.
/accounts
Use Exponential Backoff
boolean
useExponentialBackoff
false
Specifies whether to use a pre-defined exponential backoff strategy for retries.
 

Run Report

Run a customized report on your Google Analytics event data | key: runReport

InputDefaultNotesExample
Connection
connection
/ Required
connection
 
 
 
Property ID
string
/ Required
propertyId
 
properties/111111111
Request Body
code
/ Required
requestBody
See https://developers.google.com/analytics/devguides/reporting/data/v1/rest/v1beta/properties/runReport for details on what dimensions, metrics, etc., you can specify.
 

{
"data": {
"dimensionHeaders": [
{
"name": "pageTitle"
}
],
"metricHeaders": [
{
"name": "sessions",
"type": "TYPE_INTEGER"
}
],
"rows": [
{
"dimensionValues": [
{
"value": "My Example Page | My Website"
}
],
"metricValues": [
{
"value": "9"
}
]
},
{
"dimensionValues": [
{
"value": "A blog post | My Blog"
}
],
"metricValues": [
{
"value": "3"
}
]
}
],
"rowCount": 2,
"metadata": {
"currencyCode": "USD",
"timeZone": "America/Chicago"
},
"kind": "analyticsData#runReport"
}
}

Send Measurement Protocol Events

Sends Measurement Protocol Events to your Google Analytics G4 Account | key: sendMeasurementProtocolEvents

InputNotesExample
API Secret
password
/ Required
apiSecret
The API secret for your Google Analytics G4. Generated in the Google Analytics UI
Str5ahciR5SJtWClz1mkRA
App Instance ID
string
/ Required
appInstanceId
Your App's instance ID.
12345678901234567890123456789012
Events To Send
code
/ Required
events
The events to send to Google Analytics
Firebase App ID
string
/ Required
firebaseAppId
The Firebase App ID, found in the Firebase console under Project Settings > General > Your Apps > App ID
1:123456789012:web:1234567890123456789012

{
"data": {
"message": "Event Sent Successfully"
}
}