Meta CAPI for PrestaShop via server GTM

1.1. Open your WEB Google Tag Manager container.

Click Admin. Under the container column, click +

1.2. Type the container name, choose Server, and click Create.

1.3. Choose Manually provision tagging server, copy your container config and paste it in any text editor. We will need it for the next steps.

1.4. Create a stape.io account or log in to your existing one.

1.5. In Stape’s admin dashboard click Create container on the top right. 

1.6. Enter your container details:

• Container name. The name does not necessarily have to be the same as the container name in your server GTM.
• Container configuration - paste Container Config that you copied from your Google Tag Manager Server Container.
• Server location - for best performance, choose the server location that’s closest to where most of your clients are. See the list of available server locations here. If you have traffic from different regions, you can select the Global multi-zone server location option. It will automatically route incoming requests to the nearest available zone based on the user’s IP address.

Then click Create Container.

1.7. Choose a plan for your container. You can start with a Free plan. 

1.8. You will see the status of your container, container config, and plan name. 

It takes around 5 minutes to deploy a server container. Please reload the page to update the status. If the Google Tag Manager server-side setup was done correctly, you should see the status “Running”. 

2.1. Find and copy your WEB GTM ID in GTM. 

To find GTM ID log in to your Google Tag Manager account and open a Web GTM container. In the top right corner (next to the Submit and Preview buttons) you’ll see some short text that starts with "GTM-" and then contains some letters/numbers.

2.2. Select your sGTM container from the dashboard.

2.3. Go to Power-ups and click Use next to the Custom Loader panel.

2.4. Toggle the Custom Loader switch to enable it and click Save changes.

2.5. In the Code & Setup information section, configure the following settings:

• Domain - select one of the domains linked to your container.
• Web GTM ID - enter your web Google Tag Manager ID.
• Enhanced ad blocker protection - when enabled, all requests to your sGTM server are encrypted so ad blockers can’t block them based on request patterns. Learn more about the enhanced ad blocker protection.
• Same Origin Path - if you use the same-origin approach, enter the path here so both GTM and gtag.js load through it.
• Platform - select PrestaShop and click Generate. You’ll get configuration and app installation instructions in the Configuration panel. Follow the app installation guide.

3.1. To start installing, you need to buy the module on the PrestaShop platform.

3.2. Configure settings in three tabs: General Settings, DataLayers, and Webhooks.

3.3. General Settings tab.

This tab contains all the options for configuring the GTM snippet installation on every page of your PrestaShop site.

Add the following data:

• Insert GTM snippet - enable this field to add the GTM snippet to every page on your PrestaShop store. And add the GTM web container ID (you can find it in your GTM account in the tab “Accounts”). The format should be the following: GTM-XXXXXXX.
• GTM server container URL - use the subdomain you created for server-side tracking.

• Stape container identifier - that’s an optional parameter, but we highly recommend adding it as it increases protection against blockers. You can find the container identifier in the container section in Stape’s admin. For more detailed instructions, follow Stape’s guide on how to find the Stape container identifier.
• Cookie Keeper - also optional; if you turn it on, you will minimize the impact of Safari ITP restrictions.

3.4. DataLayer tab.

In this tab, you can find toggles that enable dataLayer events. With their help, you can enrich the data by adding product and user information.

See the list of events that the module will push:

• view_collection
• view_item
• add_to_cart
• view_cart
• remove_from_cart
• begin_checkout
• add_shipping_info
• add_payment_info
• purchase

3.5. Webhooks tab.

In this tab, you can configure the webhooks to be sent to a specified URL for different events, such as purchases and/or refunds.

To activate webhooks configuration, turn on “Send webhooks to server GTM container”. Then you need to add the URL of your server container (format: https://gtm.example.com/data).

Turn on the fields according to the type of event - purchase and/or refund.

Check out the blog posts on using and debugging webhooks:

• What are webhooks, webhook servers, and how to use
• Debug incoming webhooks in Google Tag Manager server preview
• Server-to-server tracking in server Google Tag Manager

4.1. Download GTM templates for PrestaShop on our GitHub.

4.2. You should import the templates in both your web and server container on GTM (process is the same across the two). You need to go Admin → Import Container:

4.3. Select your template file (make sure the template matches the container type - web/server).

4.4. Pick a workspace for this import (you can create a new one for this specific purpose).

4.5. Select Overwrite or Merge.

5.1. Templates are fully built, so triggers, payloads, and event names are all taken care of for you. 

You just need to input your specific destinations, ids, API keys etc. We’ve tried to make it as comfortable as possible, so in both containers (web and server), you will find a folder called “[Stape] _Settings”.

Web

Server

All these variables are already referenced in tags that use them; you just need to give them proper values, for example:

5.2. Pixel ID and API token can found in your pixel settings:

5.3. Once you’ve changed all these variables and saved them, your last step (assuming this a new container) is to add a preview URL in your server container by going to Admin → Container Settings. If the container is not new, just skip this step.

Facebook provides the ability to test Browser and Server events. That is very useful if you set up Facebook pixel using GTM Server for the first time and wish to check that all data tracked correctly.

6.1. First, you need to obtain test_event_code. For this, you need to log into your Facebook manager, choose the data source that you liked to test, and open the tab “Test events”. There you will find the test event code. It can look like this: TEST2120

Note: TEST id will change once in a couple of hours, if your debug sessions are spread in time make sure to check the value you’re using is still valid.

6.2. Fill the LT - Map | Debug Mode → FB Test ID variable, in your server container, with the test event code that you get from the previous step.

This variable is already referenced in all Facebook tags. Variable will also only populate the tag in preview mode, so you don’t necessarily need to remove it before going live.

6.3. Launch preview mode on both your containers (web & server) If done right, you will see both web and server test events on the Facebook Test Event page.