GEO Headers power-up

The GEO Headers power-up adds geographical information (country, region, city, IP address, and postal code) as headers to incoming requests. This way Stape can identify where a visitor is accessing your site from without relying on separate APIs or external services.

The following headers are added to the Incoming HTTP Request field inside the sGTM:

• X-GEO-Country
• X-GEO-Region
• X-GEO-City
• X-GEO-Ipaddress
• X-GEO-PostalCode

The GEO Headers power-up works based on the IP address of the incoming request. Using a database, suitable data corresponding to this IP address is selected and added to the headers.

This product includes GeoLite2 data created by MaxMind, available from: https://www.maxmind.com.

How to set up the GEO Headers power-up

1. Log in to your stape.io account.

2. Select your sGTM container on the dashboard.

3. Click Power-ups, then click the Use button next to the GEO Headers panel.

4. Toggle the GEO Headers switch.

5. Click the Save changes button.

Note: to use these Request Headers in the server Google Tag Manager, make sure to create a new variable with the variable type Request Header and type Header Name. 

Testing GEO Headers

To verify that the GEO Headers power-up works correctly: open the server Google Tag Manager container preview → go to the Request tab → click on Incoming HTTP Request → click Show More in the Request Headers section. If you see the X-GEO headers, everything is working properly.

GEO Headers use cases

You can use the geo data headers provided by the power-up depending on your needs:

• Analytics: send country/region/city as event parameters or user properties.
• Ad platforms: include country/region fields in server-to-server events.
• Routing: use X-GEO-Country / X-GEO-Region to choose endpoints, apply consent rules (see below), or enrich events.

Set up region-specific consent mode behavior using Stape GEO Headers power-up

Before you begin, make sure that you've enabled the Custom Loader power-up.

Step 1. Region-specific consent mode using the web Google Tag Manager template

1. Open the web GTM container and add the Consent Mode tag template.

2. Ensure that consent mode is enabled by clicking Admin, Container settings, and Enable consent overview checkbox. 

3. Create a new tag with the type Consent Mode tag. Set what type of cookies should be set for each region. The tag will check areas based on the GEO Headers power-up you've enabled in Stape. The trigger should be Consent Initialization - All Pages.

4. Open tag that should listen to the region-specific consent settings and specify which cookies this tag sets. Scroll down to Consent Settings and identify the types of cookies. 

Step 2. Test region-specific tag behavior

Open GTM preview mode and trigger tag that should be using region-specific tag settings. Open the website console, go to Application → Cookies, and check that the cookies' behavior matches the settings in the Consent Mode tag.