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
Input | Default | Notes |
---|---|---|
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
Input | Notes |
---|---|
Connection connection / Required connection |
Example Payload for List Accounts
{
"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
Input | Notes | Example |
---|---|---|
Account ID string / Required accountId | accounts/000000000 | |
Connection connection / Required connection |
Actions
Get Property
Get property by ID | key: getProperty
Input | Notes | Example |
---|---|---|
Connection connection / Required connection | ||
Property ID string / Required propertyId | properties/111111111 |
Example Payload for Get Property
{
"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
Input | Notes |
---|---|
Connection connection / Required connection |
Example Payload for List Accounts
{
"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
Input | Notes | Example |
---|---|---|
Account ID string / Required accountId | accounts/000000000 | |
Connection connection / Required connection |
Example Payload for List Properties
{
"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
Input | Default | Notes | Example |
---|---|---|---|
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
Input | Default | Notes | Example |
---|---|---|---|
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. |
Example Payload for Run Report
{
"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
Input | Notes | Example |
---|---|---|
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 |
Example Payload for Send Measurement Protocol Events
{
"data": {
"message": "Event Sent Successfully"
}
}