To link your Google Analytics account with the Apostle platform, you need to create a Google Analytics service account, upload a JSON key file, and enter your Property ID. This integration allows Apostle to display analytics insights directly in your dashboard.
⚠️ Important: This is an advanced integration. If you are not familiar with Google Analytics setup, please contact our support team before proceeding.
Step 1: Create your Google Analytics service account
Make sure you are logged into the correct Google account. (You can switch accounts by clicking your avatar in the top right.)
In the left menu, go to APIs & Services.
Click + Enable APIs and Services.
Search for Google Analytics Data API and click it in the marketplace list.
Click Enable.
Go back to the APIs & Services overview by clicking Enabled APIs and services in the left menu.
Click on Google Analytics Data API in the list.
Create your service account
Click Create credentials in the top right corner.
In the dropdown, select Google Analytics API.
Choose Application data as the data type.
When asked if you're using G Suite or domain-wide delegation, choose No, I'm not using them, then click Next.
Either select an existing service account or click Create new service account.
Your service account now appears under the Credentials tab.
💡 Tip: Copy and save the email address of this service account. You'll need it later.Click on the service account name.
Go to the Keys tab.
Click Add key → Create new key.
Choose JSON as the key type and click Create.
A JSON file will be automatically downloaded to your computer.
Note: If you're creating a new service account:
Enter a name and optional description.
Click Create and continue.
Assign the Owner role.
Click Continue, then Done.
Add the JSON key in Apostle
In the Apostle platform, go to Insights.
Scroll to the Google Analytics section and click Add API Key.
Upload the JSON file using the button Upload your JSON file here.
Step 2: Add your Google Analytics Property ID
Go to https://analytics.google.com.
Confirm you're logged in with the same Google account.
Navigate to the Google Analytics property you want to link to Apostle.
Click the Admin gear icon in the bottom left.
Under Property, click Property Access Management.
Click the + icon and select Add users.
Paste the email address of your service account (saved earlier). The role can remain as Viewer, this is sufficient.
Click Add in the top right.
Find and add the Property ID
Look at your browser's address bar. You’ll see a link like:
analytics.google.com/analytics/web/?authuser=1#/p352580133/reports/intelligenthomeCopy only the numbers after the letter "p" (e.g.,
352580133).Go back to Insights in Apostle.
Click Add API Key.
Paste the number into the Property ID field.
Click Save.
Your Google Analytics integration is now active in Apostle.
💡 Tip: If the graph does not appear immediately, try refreshing the page.