Migration tool (GA3 and GTM)

Needed permissions: owner

The migration tool allows you to easily transfer your settings from Google Analytics (GA3/Universal Analytics) and Google Tag Manager (GTM). It lets you import Google Analytics properties, settings, goals and custom dimensions, as well as Google Tag Manager containers, including tags, triggers and variables.

In this article, we’ll show you how to connect Piwik PRO with Google and how to move your settings from Google Analytics and Google Tag Manager to Piwik PRO.

Before you start

Here are some things to know before you start:

  • Needed permissions in Piwik PRO: owner.
  • Needed permissions in Google Analytics (GA3) and Google Tag Manager (GTM): read-only access.
  • After migrating your settings from Google Analytics (GA3), a new site will be created in Piwik PRO automatically. If you want to move your settings from Google Tag Manager without migrating your settings from Google Analytics (GA3), you have to create a new site in Piwik PRO before migration.

Connect Piwik PRO with Google

To connect Piwik PRO with Google, follow these steps:

  1. Log in to Piwik PRO.
  2. Go to Menu > Administration.
  3. Navigate to Account.
  4. On the left, click Migration tool.
    Migration tool in Piwik PRO
  5. Click Sign in with Google.
    migration tool sign in with google
  6. Choose your Google account from the list.
    migration tool - choose account
  7. Click Allow.
    migration tool - click allow
  8. All done! Now your Piwik PRO and Google accounts are connected.
    migration tool - connected with google

Move settings from Google Analytics (GA3)

To move settings from Google Analytics (GA3) to Piwik PRO, follow these steps:

  1. Log in to Piwik PRO.
  2. Go to Menu > Analytics.
  3. Navigate to Account.
  4. On the left, click Migration tool.
    Migration tool in Piwik PRO
  5. In Google Analytics, click Migrate.
    GA migration tool menu connect
  6. Select your Google Analytics account and click Next.
    GA migration tool select account
  7. Select Google Analytics property and click Next.
    migration tool -select-GA-property

    Note: You can choose more than one property and move the settings of all your Google Analytics properties to Piwik PRO at once.

  8. Select all the settings from GA3 you want to move to Piwik PRO and click Next.
    10-migration toolselect-GA-settings
  9. In Summary, click Finish.
    migration tool GA-summary
  10. Voila! You’ve just moved your settings from Google Analytics to Piwik PRO. Piwik PRO has created a new site/app with these settings and you can access it in Menu > Administration > Sites & apps.
    GA migration tool completed
  11. After transferring your settings, you need to install our container (with a tracking code) to start collecting data. You can use one of the listed methods:

    Move settings from Google Tag Manager (GTM)

    To move settings from Google Tag Manager (GTM) to Piwik PRO, follow these steps:

    1. Log in to Piwik PRO.
    2. Go to Menu > Analytics.
    3. Navigate to Account.
    4. On the left, click Migration tool.
      Migration tool in Piwik PRO
    5. In Google Tag Manager, click Migrate.
      Migration tool GTM migrate
    6. Choose your Google Analytics account from which you want to import settings to Piwik PRO and click Next.
      migration tool choode account GTM
    7. Select your Google Tag Manager containers from the list.
      16-migration tool select-GTM-container
    8. Choose your Piwik PRO site or app from the list. This is where you will move tags, triggers and variables from Google Tag Manager.
      17-migration tool select-GTM-website-or-app

      Note: When you’re moving your settings from GTM, you have to choose an existing site or app or create a new one in Menu > Administration > Sites & apps.

    9. Click Next.
      18-migration tool select-GTM-website-next
    10. Select all the tags, triggers and variables that you want to move from Google Tag Manager to Piwik PRO.
      19-migration tool select-GTM-tags
    11. Click Next.
      19-migration tool next-GTM-tags
    12. In Summary, click Finish.
      20-migration tool GTM-summary
    13. Go to Menu > Tag Manager. You’ll need to review and publish your migrated settings.
    14. Choose your site or app name from the list.
      22-migration tool GTM-tag-manager
    15. Review the migrated tags, triggers and variables.
    16. Click Publish.
      23-migration tool GTM-publish-tags
    17. Voila! Your tags, triggers and variables migrated from Google Tag Manager are now live.

    Supported tags, triggers and variables

    Our migration tool lets you import a limited set of tags, triggers and variables because we’re still working on it. Here’s a list of currently supported tags, triggers and variables.

    Tags

    Google Tag Manager (GTM) Piwik PRO
    Custom HTML Custom code (async)
    Custom event Custom event
    Floodlight counter Floodlight counter
    Google Ads Conversion Tracking Google Ads Conversion Tracking
    Google Ads Remarketing Google Ads Remarketing
    LinkedIn Insight LinkedIn Insight

    Triggers

    Google Tag Manager (GTM) Piwik PRO
    Click Click
    Custom event Data layer event
    DOM Ready DOM Ready
    Element visibility Element presence
    FormSubmission Form submission
    History change History change (SPA)
    LinkClick Click / Click Url
    Pageview Page view
    ScrollDepth Page scroll
    WindowLoaded Page load

    Variables

    Google Tag Manager (GTM) Piwik PRO
    Constant Constant
    Datalayer variable Data layer
    Javascript variable Custom JS
    URL Query Variable URL (Query)

    Note: We’ll start supporting more tags, triggers and variables in the upcoming months.

    Was this article helpful?

    Technical support

    If you still have any questions, visit our community.
    There’s always someone happy to help!

    Back to help center