Set Up GTM (SuiteCommerce Aconcagua and Earlier)

This topic applies to

Applies to

SuiteCommerce Web Stores

This feature is not available on the Denali release of SuiteCommerce Advanced.

Follow these steps to set up GTM:

Sign Up for GTM

When you sign up for your GTM account, Google creates your GTM account and a container to hold your tags, triggers, variables, macros, and rules.

To sign up for a GTM account:

  1. Go to https://www.google.com/analytics/tag-manager/.

  2. Sign in to GTM with your Google ID.

  3. GTM displays the Add a New Account page.

  4. Enter the name for your account. Normally, this will be the site or business name.

  5. Select your country from the dropdown Country selector.

  6. Click Continue.

  7. In the Container Name field, enter your site name, for example www.mysite.com.

  8. For Where to Use Container, click Web to select it.

  9. Click Create.

  10. Agree to the Google Tag Manager Terms of Service.

  11. This displays the Install Google Tag Manager popup window which lists the code that can be placed on your pages. Close this popup window because you do not need the code. The SuiteCommerce Google Tag Manager Module places the code on your pages for you.

  12. On the Workspace tab, your GTM ID is displayed in the submenu header area in the upper right portion of the page. Make note of this ID, you need it for the configuration. See Add Your GTM ID to Your Configuration Record..

  13. Next you need the Account ID. Click on the Admin tab, then click Account Settings. Make note of it. You need it when you create the GTM import JSON file.

    Note

    You can also find the Account ID in the URL.


    See GTM Container Generator.

  14. The final ID you need is the container ID, which is available in the URL. You need this number when you create the GTM import JSON file. See GTM Container Generator. .

Add Your GTM ID to Your Configuration Record.

The next step is to add your GTM ID to your SuiteCommerce Configuration Record. This is necessary to tie your GTM ID to the GTM Integration in NetSuite.

To add your GTM ID to your configuration record:

  1. Go to Setup > SuiteCommerce Advanced > Configuration.

  2. Select your website and domain and then click Continue.

  3. In the SuiteCommerce Configuration record, navigate to the Integrations tab and the Google Tag Manager subtab.

  4. Enter your GTM ID in the Google Tag Manager ID field. Leave the Google Tag Manager Data Name set to the default value of dataLayer.

    For more information, see Google Tag Manager Subtab.

  5. Click Save.

To configure GTM (pre-Vinson):

  1. Create a custom module that includes the SC.Configuration object as a dependency.

    Note

    Do not edit the original SC.Configuration.js source file directly. See Customize and Extend Core SuiteCommerce Advanced Modules for information and best practices on customizing JavaScript.


  2. Redefine the id property for googleTagManager object to the GTM ID. 

GTM Container Generator

To assist you in the process of adding tags to your GTM container, the GTM Container Generator enables you to create a JSON file you can use for importing the tags for the currently supported GTM services. This JSON file can then be imported into your GTM container, eliminating the need for you to manually add tags for supported services.

Note

See Finding IDs for Different Tags for details on finding specific IDs requested by GTM Container Generator.


To create the GTM Import JSON file:

  1. Go to https://developers.suitecommerce.com/google-tag-manager.

  2. In the GTM Account ID field, enter the number you retrieved from the GTM URL.

  3. In the GTM Container ID field, enter the container number you retrieved from the GTM URL.

  4. Select the services you want to add.

  5. Click Download. This creates the JSON file and downloads it to your computer. The file is named SCA.GoogleTagManager.json and it is saved to your browser’s default download location.

Import the JSON file into your GTM Container

After you create your GTM Import JSON file, the next step is to import the JSON file into your GTM container. This creates the tags, triggers and variables for your site.

  1. Log in to your GTM account.

  2. Click the Admin tab.

  3. Click Import Container.

  4. This displays the Import Container page. Click Import Container and browse to the SCA.GoogleTagManager.json file and select it.

    • Select Overwrite if you want to overwrite any existing tags with the new tags in the JSON file.

    • Select Merge if you want to merge the new tags in the JSON file with any existing tags in the container. If you select this option, specify the following sub options

      • Overwrite conflicting tags, triggers, and variables.

      • Rename conflicting tags, triggers, and variables.

  5. Click the Confirm button. This imports the JSON file and lets you preview the tags, triggers, and variables it contains.

  6. Click the Confirm button to complete the import.

    Note

    After you import the JSON file, you must publish the container to make the changes live. See the Publishing, versions, and approvals topic in the Tag Manager Help, for more information.


Finding IDs for Different Tags

When you use the GTM Container Generator to create a GTM JSON file, you are asked to provide certain data elements that will be used when creating the tags for the services you select. The following topics serve as a reference for locating those required data elements.

To find your Google Universal Analytics ID:

Note

Do not implement the Google Universal Analytics module if you are using Google Universal Analytics in Google Tag Manager because this causes duplicate tracking results.


  1. Login to your Google Universal Analytics account at https://www.google.com/analytics/.

  2. Click the Home tab. The UA ID is displayed next to the property name under your account.

To find your Google Ads Conversion ID and Label:

  1. Create a conversion in Tools > Conversions.

  2. Specify your preferences and Google displays your code snippet. It includes the Conversion ID and label.

To find your Bing Ads Conversion ID:

  1. Create a Conversion tracking in Tools > Conversions.

  2. Specify your preferences, and when Bing shows your code snippet, it includes the Conversion ID.

To find your Optimizely Project ID:

  1. When you finish your experiment, the project ID is available in the URL.