Introduction

• GA4 (Google Analytics 4) – Tracks visitor behavior, orders, product views, and more.
• GTM (Google Tag Manager) – Lets you manage and install tracking codes without editing your website’s code directly.
• Trakpilot – Automatically connects and configures GTM + GA4 for your Shopify store, saving you time and avoiding manual setup errors.

PART 1 - First-time Setup (Onboarding)

When to use

• After installing the app the Onboarding screen appears automatically

Setup Onboarding

Get Started -> Continue to next step: Select Account

Select Account

Step 1 - Connect Google Account

• Sign in with a Google account that has:
• • GA4 → Editor or higher access (needed to create properties and data streams).
  • Google Tag Manager (GTM) → Admin access (needed to create a new container).
  • Google Ads (optional) → Admin or Standard access (for conversion tracking).
• Grant all requested permissions.

Step 2 - Select GTM Account

• Pick your GTM account.
• A new GTM container will be created automatically (you can rename it later inside GTM).

Step 3 – Select GA4 Account

Have 2 option:

• Auto – Select a GA4 account where your Google login has Editor (or higher) access. The app will automatically create a new GA4 property and data stream for you.
• Manual – Enter the Measurement ID of an existing GA4 stream.

Use Manual option if:

• You don’t have a GA4 account.
• Your GA4 account doesn’t have sufficient permissions.
• You already have a GA4 data stream and want to connect it by Measurement ID.

Step 4 – (Optional) Connect Google Ads

Select your Google Ads account, click Continue to next step

If no Google Ads account exists, simply click Continue to skip this step.

Step 5 – Confirm and Finish

• Review your selections carefully.
• Click Continue to finish onboarding.

The system will run the setup automatically in the background.

Once onboarding is complete, you can check the results anytime on the GTM–GA4 page.

Setup Tracking

Step 1: Conversion events

• Select the Conversion Events you want to track for GA4, Google Ads

Step 2: Product Identifier & Conversion Value (applies the same to GA4 & Google Ads)

• Product Identifier: Choose how products are identified (e.g., Variant ID, or Product ID) — keep this consistent for easier data matching.
• Conversion Value: Choose the value used for revenue/conversion tracking (e.g., order total, adjusted for discounts/taxes if needed). Make sure the currency matches your store settings

Step 3: Save & Continue

• Click Continue to save your settings and move to the next step.

Customer Events

Follow guide here to setup Customer Events

Complete Setup

PART 2 - Setup or Edit Later (GTM–GA4 Page)

After you finish the onboarding process, you can check the setup results on the GTM & GA4 page.

GTM STATUS:

1. On – GTM has been set up successfully and tracking is working normally.

1. Pending – GTM setup is still in progress (usually takes 10–20 minutes). Click Refresh to update the GTM status once setup is complete.

1. Fail (rare) – GTM setup failed. This can happen if your Google account has reached the API call limit. If this occurs, click Retry to attempt the GTM setup again.

Edit GTM Information:

• Edit your GTM container or GA4 property settings if you want to make changes.

Edit GA4 Information:

• Edit your GA4 property settings if you want to make changes.

Option: Auto setup GA4:

Option: Manual setup:

TROUBLESHOOTING

1. GA4 Creation error

During the onboarding process, at the Select Account step, if you click Continue and see an error like:

"I encountered this error: Error during onboarding setup GA4: Google Analytics 4 does not have permission, please choose another account! . Please support!"

This happens because your Google account does not have sufficient permissions in GA4. You need at least the Editor role to create a new property.

Example:

The account [email protected] only has the Viewer role in the "Support" GA4 account, so it cannot automatically create a new property there.

Solution:

• Request to be granted a higher role (Editor or above), OR
• Choose a different GA4 account that already has the required permissions to continue setup, OR
• use Manual GA4 setup, Enter Measurement ID manual

2. Account Not Found Error

Message shown in chat:

"I encountered this issue: I've already logged into my Google account, but the system couldn't find my GA4, Google Tag Manager, or Google Ads accounts. Please support!

Cause:

This happens when you don’t have a Google Tag Manager account, a GA4 account, or a Google Ads account linked to your Google account.

Solution:

Create the missing account(s) before proceeding with setup:

• GTM Account Create
• GA4 Account Create
• Google Ads Account Create

3. GTM setup failed

Message shown in chat:

"I encountered this error: GTM setup failed. Please support!"

This can happen if your Google account has reached the API call limit. If this occurs, click Retry to attempt the GTM setup again.

Updated on: 15/08/2025