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 in your sGTM container. It works based on the visitor's IP address, and you don’t need any external APIs.

GEO Headers is available on the Free subscription plan and higher. To check your current plan or upgrade, go to your sGTM container settings.

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

1. Log in to your Stape account and select your sGTM container from the dashboard.

2. Go to Power-ups, scroll down to the Data enrichment section, and click on the GEO Headers panel.

4. Toggle the GEO Headers switch on to enable it, and click Save changes.

Once enabled, the following headers are added to the Incoming HTTP Request field inside sGTM:

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

To use these headers, create variables with the type Request Header and enter the exact header names, e.g. X-Geo-Country:

1. 1.
   Go to your sGTM container.
2. 2.
   Create a new User-Defined Variable with the type Request Header and enter the header name.
3. 3.
   Click Save.

1. 1.
   Open your sGTM container in preview mode.
2. 2.
   Go to the Request tab → Incoming HTTP Request.

3. Click Show More under Request Headers.

4. If the X-GEO headers are listed, the power-up is working correctly.

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.

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

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. 

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.