How to set up Drupal module

If you want to use functionalities such as the Custom Loader and Cookie Keeper power-ups, you need to have an sGTM container hosted on Stape. You will also need GA4 or Data tags configured in a web GTM. If you don’t have this, follow the Get started with sGTM hosting instructions.

1. 1.
   Log in to your Drupal account.
2. 2.
   To install the module, select the version you need from the releases page and use one of the installation options.

1. 1.
   Open the module and configure the General Settings tab:

• Active – turn on to automatically add the snippet with JavaScript code to every page on your website.
• Web Container ID – enter your web container ID. 

• Custom Domain – specify the custom domain (optional). In this case requests go through your tagging subdomain, so cookies stay first-party. 
• Custom Loader – specify Stape container identifier (optional). The gtm.js script loads from your domain instead of Google’s, which helps the script get past ad blockers. Custom Loader needs to be turned on in your Stape account to use it. 
• Cookie Keeper – select whether to use the Cookie Keeper. Cookie Keeper needs to be turned on in your Stape account to use them. 

2. Click Save configuration.

1. 1.
   Configure the Data Layer tab: 

• Add ecommerce Data Layer events – add standard ecommerce data layer events to your site.
• Add user data to Data Layer events – add user data layer events to your site.
• Stape Suffix Enabled – adds _stape to event names so they don’t clash with existing dataLayer pushes, potentially triggering your tags twice. When it’s unchecked, event names are pushed as per GA4 schema.
• Product collection limit – controls maximum number of items pushed to data layer on the collection pages.

2. Click Save configuration.

1. 1.
   Configure the Webhooks tab. Webhooks are useful for events outside the website (for example, phone or offline sales). 

• Enable Webhooks.
• Add your GTM Server Container URL.
• Choose the webhooks:

  • Purchase webhook – send a purchase event when a new order is created.
  • Refund webhook – send a refund event when an order is refunded.

2. Click Save configuration.

1. 1.
   Open any site page, open the Developer Tools, and in the Network tab filter by your tagging server URL. If you didn’t set up a custom domain, search by gtm.js. You should see the web GTM script served through that URL, with status 200.

2. In the same Developer Tools, go to Console and do some actions on your site (for example, add to cart). Type in dataLayer and press Enter. Confirm that the dataLayer is being filled.

3. Test in Google Tag Manager:

3.1. Open your sGTM container → click Preview. 

3.2. In a separate tab, open your web GTM container → click Preview and enter your site URL.

3.3. Perform test actions on your website (such as add to cart).

3.4. In the sGTM debug window, verify that incoming requests arrive at your sGTM and are claimed by your Client (GA4 Client or Data Client).