Release Status Released Supported By Stitch
Availability Free Status Page Google ECommerce Status Page
Default Historical Sync 15 days Default Replication Frequency 30 minutes
Whitelisting Unsupported Destination Incompatibilities None

Connecting Google ECommerce

Connecting your Google ECcommerce data to Stitch is a three-step process:

  1. Add Google ECcommerce as a Stitch data source
  2. Authorize Stitch & select a Google Analytics profile
  3. Define the Replication Frequency

Prerequisites

Before you get started, you should verify that:

  1. The user creating the integration has at least Read & Analyze permissions and that there’s data in the account. If the profile you use to connect doesn’t have these permissions (or there’s no data in the account), you’ll receive an error message like this:

    “Something went wrong. None of the Google Analytics profiles associated with the credentials you’ve supplied contain data that Stitch can access. Please make sure that the credentials you’ve supplied have appropriate access.”

  2. All ad-blocking software you are currently using is paused. Because Google authentication uses pop ups, you may encounter issues if ad blockers aren’t disabled during the setup.
  3. Your account has the Enable ECommerce setting turned on. If you have ECommerce data in your accuont, this setting is already enabled and you can move on.

Add Google ECommerce as a Stitch Data Source

  1. Sign into your Stitch account.
  2. On the Stitch Dashboard page, click the Add Integration button.

  3. Click the Google ECommerce icon.

  4. Click Sign in with Google Analytics.

Authorizing Stitch & Selecting a Google Analytics Profile

  1. Next, you’ll be prompted to log into your Google account and to approve Stitch’s access to your Google ECommerce data. Note that we will only ever read your data.
  2. Click Allow to continue.
  3. After your credentials are validated, you’ll be prompted to select the Google Analytics profile you want to connect to Stitch:

    Selecting a Google Analytics profile.

    Remember: profiles need to have Read & Analyze permissions to be detected by Stitch. If you don’t see the profile you want in this list, we recommend that you double-check the permission settings.

  4. When finished, click Continue to save the integration and complete the setup.

Create a replication schedule

In the Replication Frequency section, you’ll create the integration’s replication schedule. An integration’s replication schedule determines how often Stitch runs a replication job, and the time that job begins.

Stitch offers two methods of creating a replication schedule:

  • Replication Frequency: This method requires selecting the interval you want replication to run for the integration. Start times of replication jobs are based on the start time and duration of the previous job. Refer to the Replication Frequency documentation for more information and examples.
  • Anchor scheduling: Based on the Replication Frequency, or interval, you select, this method “anchors” the start times of this integration’s replication jobs to a time you select to create a predictable schedule. Anchor scheduling is a combination of the Anchor Time and Replication Frequency settings, which must both be defined to use this method. Additionally, note that:

    • A Replication Frequency of at least one hour is required to use anchor scheduling.
    • An initial replication job may not begin immediately after saving the integration, depending on the selected Replication Frequency and Anchor Time. Refer to the Anchor Scheduling documentation for more information.

To help prevent overages, consider setting the integration to replicate less frequently. See the Understanding and Reducing Your Row Usage guide for tips on reducing your usage.

Initial and historical replication jobs

After you finish setting up Google ECommerce, its Sync Status may show as Pending on either the Stitch Dashboard or in the Integration Details page.

For a new integration, a Pending status indicates that Stitch is in the process of scheduling the initial replication job for the integration. This may take some time to complete.

Free historical data loads

The first seven days of replication, beginning when data is first replicated, are free. Rows replicated from the new integration during this time won’t count towards your quota. Stitch offers this as a way of testing new integrations, measuring usage, and ensuring historical data volumes don’t quickly consume your quota.


Replicating Google ECommerce Data

Every time Stitch runs a replication job for Google ECommerce, the last 15 days’ worth of data will be replicated.

This is applicable to all tables in the integration.

Stitch replicates data in this way to account for updates made to existing records within the default attribution window of 15 days, thus ensuring you won’t make decisions based on stale (or false) data. As a result, you may see a higher number of replicated rows than what’s being generated in Google ECommerce.

Setting the Replication Frequency to a higher frequency - like 30 minutes - can result in re-replicating recent data and contribute to high row counts. Selecting a lower frequency can help prevent overages.


Google ECommerce Schema

After the first successful sync of your Google ECommerce data, you’ll see a single table in your data warehouse. The table follows this naming convention:

ecommerce[GA profile id]_integration version

Here’s an example: ecommerce123456789_v2. In this case, the profile ID is 123456789 and the version of the ECommerce integration is 2.

In the section below, you’ll find a list of the attributes in this table, a brief description, and links to Google’s more in-depth documentation.


ecommerce123456789_v2

Replication Method: Key-based Incremental
Primary Key: id
Contains Nested Structures?: No

The ecommerce123456789_v2 table contains your Google ECommerce data.

Table Info & Attributes

Replication & Attribution Windows

Every time a replication job runs for Google ECommerce, the past 15 days' worth of data will be replicated for this table. As a result, you may see a higher number of replicated rows than what's being generated in Google ECommerce.

Stitch replicates data in this way to account for updates made to existing records within Google ECommerce's default attribution window, thus ensuring you won't make decisions based on stale (or false) data.

ecommerce123456789_v2 Attributes

This table will contain the following attributes. For more info, click the links to check out Google’s documentation.

  • ID (id) - This column is a unique identifier generated during replication.

  • accountid - This column contains the account ID associated with your Google Analytics ECommerce account.

  • campaign - This column contains the campaign name (utm_campaign)

  • keyword - This column contains the keyword description (utm_term)

  • medium - This column contains the medium name (utm_medium)

  • profileid - This column contains your Google Analytics profile ID.

  • profilename - This column contains your Google Analytics profile name.

  • socialnetwork - This column contains the name of the social network (e.g. Facebook, YouTube, etc.)

  • source - This column contains the name of the order source. (utm_source)

  • transactionid - This column contains the order ID, which you can use to join the referral data back to your orders data. You can refer to Google’s documentation if you need some background on tracking setup and management.

  • transactions - This column contains the total number of transactions.



Questions? Feedback?

Did this article help? If you have questions or feedback, feel free to submit a pull request with your suggestions, open an issue on GitHub, or reach out to us.