Integrations · Google
Get access to a client's Google Analytics 4 property
Send your client an onboarding link with Google Analytics on it. They sign in with Google and choose the property; Agency Pilot adds your agency's Google login to that property at the role you picked, and GA4 traffic and conversions start appearing in the client's dashboard.
Google Analytics 4 at a glance
- How access is granted
- Automatically. Your Google login is added to the property's access management at the role you chose.
- Roles you can request
- Viewer, Analyst (default), Editor or Administrator.
- What your client needs
- Administrator on the GA4 property (or the account above it).
- Time for your client
- Under a minute, and no Analytics menus to find.
- Feeds into Agency Pilot
- Sessions, users, engagement, key events, channels, cities, devices and top pages in the client dashboard and portal.
- Multiple properties
- If the login can see several properties, the client picks one. Nothing is granted by guesswork.
What your client does
On the onboarding link you send. No password is ever asked for or shared.
- 1
Opens the link and reads which role your agency is asking for on Google Analytics.
- 2
Clicks Connect and signs in with the Google login that manages their Analytics. Google shows its own consent screen listing exactly what Agency Pilot is asking for. The client can read it before agreeing, and every Google product on the link is covered by that one screen.
- 3
Chooses the GA4 property if the login reaches more than one, and clicks Share this one.
- 4
Sees Google Analytics marked Connected.
What happens on your side
- Your agency's Google login is added to the chosen property at the role you picked — the same entry the client could create under Property access management.
- Connected accounts shows Added, or Already had access if your login was already on the property.
- Every Google login you listed for your team is added to the same property, one by one.
- GA4 numbers start appearing on the client's dashboard, with channels, cities, devices and top pages for the period.
GA4 roles
GA4 roles apply at the account or property level. Links grant at the property level — the narrowest place that still gives you the data.
| Role | What it allows | On an Agency Pilot link |
|---|---|---|
| Administrator | Full control, including user management and deleting the property. | Offered — rarely needed |
| Editor | Edit property settings, events, key events and data streams. Cannot manage users. | You can pick it |
| Marketer | Edit audiences, attribution settings and key events, plus everything Analyst can do. | Add by hand if you need it |
| Analyst | Create and share explorations, comparisons and annotations. Cannot change settings. | Offered — the default |
| Viewer | See reports and settings. Cannot create or change anything. | You can pick it |
Doing it by hand in Google Analytics
- 1
Open analytics.google.com and select the property.
- 2
Click Admin (the gear at the bottom left).
- 3
Under Property settings, open Property access management.
- 4
Click the blue plus button and choose Add users.
- 5
Enter the agency's email, pick a role (Analyst is usual) and click Add.
GA4 also lets an administrator hide cost and revenue metrics from a user with the data restriction checkboxes on the same screen. Links don't set restrictions; add them by hand if a client wants them.
What the GA4 connection feeds
- Website sessions, users and engagement rate on the client dashboard, by day, against the previous period.
- Channel split — organic, paid search, direct, referral, social — so you can show where visits come from.
- Top pages, cities and devices for the period.
- Mission Control's website column and the alert when a client's Analytics needs reconnecting.
Exactly what we ask Google Analytics 4 for
A link only requests the permissions the platforms on it need. Nothing here is used for anything other than the reason next to it. More on how we handle access.
| Permission | Why |
|---|---|
| analytics.readonly | Reads traffic, engagement and conversions for the client's dashboard and reports. |
| analytics.manage.users | Only on a link that asks for access: adds your agency's login to the chosen property at the role shown to the client. No other user changes. |
| openid, email, profile | Labels which Google login the connection belongs to. |
Removing access later
- 1
The client removes your agency's user from Admin → Property access management → the row with your email → Remove access.
- 2
The reporting connection ends with the trash icon under Onboarding → Connected accounts, or from the client's Google Account third-party connections.
- 3
Removing the reporting connection does not remove the user access GA4 granted to your team, and vice versa.
If something doesn't work
The property list is empty
The login can see Universal Analytics views but no GA4 properties, or has no Analytics access at all. Universal Analytics no longer collects data; the client needs a GA4 property.
It says the client can't add users
They are Editor or lower on the property. An Administrator needs to open the link, or upgrade them first.
Numbers look different from the GA4 interface
GA4 applies thresholds and sampling in some reports. Agency Pilot reads the Data API for the same date range and time zone as the property; compare like-for-like dates.
The dashboard says Analytics needs reconnecting
The client changed their Google password, removed the app, or lost access to the property. Send them a new link with just Google Analytics on it.
Google Analytics 4: common questions
- Which GA4 role should an agency ask for?
- Analyst covers reporting and explorations without letting anyone change settings. Ask for Editor if you'll be setting up events and key events, and Administrator only if you manage users for the client.
- Does this work with Universal Analytics?
- No. Universal Analytics stopped processing data in 2023 and 2024. Links work with GA4 properties.
- Can I get access to the whole Analytics account instead of one property?
- Links grant at the property level, which is what reporting needs. For account-level access, the client can add you by hand under Admin → Account access management.
- Can the client see what role I'm asking for before they agree?
- Yes. The link page lists every platform and the exact role, and Google's consent screen lists the permissions requested.
- Is GA4 data shared with anyone else?
- No. It's shown only to your agency and, in the client's portal, to that client.
Keep going
Related integrations
Get Google Analytics 4 access without chasing logins
One onboarding link covers every platform your client uses. Start a free trial and send your first link today.
Plan GA4 agency access around the delivery work
An access request is easiest to approve when the client understands the work it enables. For Google Analytics 4, start with the GA4 property that measures the website or app in scope. Write down the first task your team will perform and the person responsible for it. A reporting review, a configuration change and ongoing management can require different permissions. Put that purpose in the onboarding brief before sending the link, so the client has a concrete reason to approve the request and knows who to contact if something is unclear.
The intended recipient is each agency Google login that will use the property directly. Check that identity with the person who will actually do the work. An account name alone can be ambiguous when an agency has several teams or the client has several businesses. Record the intended asset and recipient together. This small preparation step makes a later missing-access question much easier to resolve because both parties can compare what was requested with what was granted. It also helps the next account manager understand why the connection exists.
A practical Google Analytics 4 handover example
Illustrative example: A web agency could receive Analyst access while preparing a monthly traffic review, then request Editor only when commissioned to correct event configuration. Keep the existing property and event naming documented before changes. A new reporting connection should not become an accidental measurement migration.
For the reporting-to-implementation handover, record the chosen property ID, relevant data stream and agency role. The analyst should confirm that the agreed reports are available, while any proposed event changes remain assigned to the measurement owner. If Editor access is later needed, verify the updated role before scheduling that work. Use a known report and date range as the handover reference so the client and agency are comparing the same property rather than two similarly named Analytics accounts.
Separate account access from a successful implementation
Connecting a property does not install a website tag, repair missing events, or change a consent setup. Account-level access and any special data restrictions need separate attention.
After access is available, agree a small, observable first task in Google Analytics 4. For a review engagement, that might be opening the expected account information and documenting what will be assessed. For implementation work, it might be locating the intended setting without changing it yet. Do not test a permission by making an unnecessary live change. If a real change is required, use the client’s agreed approval process and record what you changed, why it was needed and how the result will be checked.
Keep the Google Analytics 4 connection useful after onboarding
Record the property ID, relevant data streams and the meaning of each key event. When a client compares a dashboard with an exploration, align the date range and metric definitions before treating the difference as an error.
Revisit the access arrangement when the scope changes, the client adds another business asset or the delivery team changes. Ask whether the existing permission still matches the work and whether someone who no longer serves the client still has access. Keep the review proportionate: a small one-off project may need only a clear closing check, while ongoing management benefits from a repeatable review point. The useful outcome is a current record of who can do what on the intended Google Analytics 4 asset, with the business owner able to understand that record.
Frequently asked questions
What should I confirm before requesting Google Analytics 4 access?
Confirm the GA4 property that measures the website or app in scope. Ask the client to identify the account they actually use for the work in scope, rather than choosing from a familiar-looking name. Also agree whether the immediate objective is assessment, configuration or ongoing delivery. These details determine which permission is reasonable and what your team will check afterward. If the client is unsure which asset belongs to the project, resolve that ownership or account-selection question before they approve access to an unrelated account.
Who should complete the client side of the request?
The request needs a client with Administrator rights on the property or its parent Analytics account. Send the instructions to that person or ask the client to involve them. A staff member who can read a dashboard may still lack permission to invite an agency. Repeating the same request with the same insufficient role will not fix that distinction. The authorized person should review the requested asset, recipient and permission before proceeding, and retain their own independent access after the agency is added.
Which Google Analytics 4 permission is appropriate for the work?
Viewer supports reading reports, Analyst supports explorations, Editor supports measurement configuration, and Administrator includes user management. The link grants property-level access. Start by naming the actions the agency must carry out, then match the role to those actions. If the team only needs to inspect Google Analytics 4, explain why a viewing role may be sufficient. If a later task requires more authority, make that a deliberate scope decision with the client. Avoid requesting the broadest available role simply to prevent a possible future question; the current engagement should explain the permission being requested.
Is this an automatic grant or a guided client step?
Agency Pilot adds the agency Google login to the property selected by the client. This is a property permission, rather than a request for access to every property under the Analytics account. Read the status in the context of that workflow. An invitation, a client confirmation and usable Google Analytics 4 access are related milestones, but they do not always happen at the same moment. Assign responsibility for the next step before marking delivery as ready. This prevents an agency teammate from arriving at a scheduled task and discovering that a required acceptance or platform action is still outstanding.
Which agency identity should receive access?
Use each agency Google login that will use the property directly. Verify it before creating or sending the onboarding request, especially when the agency works through more than one account. Ask the actual recipient to confirm the identity they will sign in with. A forwarded email or a similar display name is not reliable proof that the correct account has been added. For a staffing change, arrange the replacement person’s appropriate access and remove obsolete assignments through the relevant platform process.
How do we verify that onboarding is complete?
After the platform action, open Analytics with the agency login and confirm the property name and ID against the website or app the client asked you to measure. Record who performed that check and whether any required work remains blocked. Prefer a harmless viewing check over an unnecessary live edit. If a teammate cannot reach the asset, compare the actual recipient and role with the original request before asking the client to start again. Completion should mean the right person can reach the intended asset with the agreed capability, rather than only that a message or notification was received.
Does connecting Google Analytics 4 also connect reporting?
Sessions, users, engagement and channel information appear in Agency Pilot reporting. Validate key events and the property date range before using those numbers to assess a campaign. Keep the client’s reporting expectation explicit in the service brief. If a metric is needed for a report, identify its source, date range and definition before promising that it will appear. A successful access step establishes only the capabilities described for this particular integration. It should not be used as evidence that another platform, a separate dataset or an unrelated source of business results has also been connected.
What should we check if the requested account is unavailable?
An empty property list can mean the client selected the wrong Google login or has no GA4 property available. Missing recent data should be investigated as a measurement question before changing permissions. Start with account identity and authority because those determine what the client can share. Write down the exact stage where the flow stopped rather than repeatedly recreating the same request. If Google Analytics 4 shows an account-specific restriction, the appropriate platform administrator may need to resolve it first. Avoid broadening permissions or switching to another asset just to make a completion indicator appear; verify the intended account instead.
How do we distinguish property access from account access?
The link grants access to the selected GA4 property. A parent Analytics account can contain other properties with different websites, applications or owners. Verify the property ID in the client brief rather than requesting broad account access for convenience. If an account-level arrangement is genuinely required, the client can handle it separately in Analytics and should understand which additional properties become reachable.
Will connecting GA4 install measurement on a new website?
No. Granting access and reading reports do not install a site tag or define events. A new or rebuilt website needs its measurement implementation checked separately. Identify the correct property and stream, agree which actions should be measured and arrange a controlled validation. An empty report on a newly connected property can reflect absent measurement rather than a failed agency permission.
Why might Analytics and advertising lead numbers differ?
First check that both reports describe the same event, time period and population. Sessions, key events, ad-platform conversions and recorded sales measure different things. A comparison should state those definitions before drawing conclusions about tracking quality. If the difference remains unexplained, preserve the exact report context for investigation instead of changing access permissions, which will not resolve a disagreement in metric definitions.
What should we record before editing GA4 events?
Record the property and stream being changed, the existing event definition, the proposed change and the reports or decisions that rely on it. Agree who approves the change and what successful validation will look like. Editor access enables configuration work, but the agency should still preserve a clear before-and-after explanation so the client can understand any break in comparability.
Can an agency request special data restrictions through the link?
The documented link does not set GA4 data restrictions. If the client wants particular cost or revenue restrictions, the administrator should review them directly in Analytics. Discuss that requirement before assessing whether the selected role is sufficient. A role name alone is not a complete description of a customized access arrangement, so include any additional restriction in the handover notes.
How do we end access when the engagement finishes?
Remove the agency user from the relevant property and end the reporting connection separately. Check account-level inherited access if the person can still reach the property afterward. Agree a handover point before removing access that is still needed to finish approved work. Confirm the business retains the people and permissions it needs after the agency leaves. Keep permission removal separate from decisions about delivered work or historical reporting data; those are different questions. Record which Google Analytics 4 assignments were removed and which, if any, remain for an explicitly agreed support period, with a clear owner for the final review.
What is a sensible next step after verifying Google Analytics 4 access?
Review the selected property’s data streams and the key events used in the client’s existing reports. Write down which business action each event is intended to represent before recommending configuration changes. If the website has just been rebuilt, arrange a separate measurement validation with the implementer. Use Search Console alongside Analytics when the question concerns organic search visibility, but explain that search clicks and website sessions are different measures rather than expecting their totals to match.
