GEO Headers

GEO Headers power-up makes location data available in your sGTM container automatically, without an extra geo API or complex setup. Use it to enrich events and send more complete data to analytics and ad platforms.

GEO Headers power-up is available to all Stape users. You can find it in the Power-ups tab in your Stape account.

Open your Stape account → Choose your recent sGTM container → Click Power-ups → Find GEO Headers and click Use.

.

When a request reaches your sGTM container, GEO Headers checks the visitor’s IP address and adds location details to this request. These details can include country, region, city, IP address, and postal code, so you do not need to connect a separate geo API.

In sGTM, these location details appear as request headers. Their technical names are X-GEO-Country,X-GEO-Country-Name,X-GEO-Region,X-GEO-City, X-GEO-Ipaddress, and X-GEO-PostalCode.

• Improve location-based reporting. Send country, region, or city values to analytics platforms as event parameters or user properties, so you can compare performance across markets.
• Send richer event data to supported ad platforms. Add country or region values to server-side events, so platforms receive more location context for reporting and audience creation.
• Build region-specific tracking logic. Use location data to control tag behavior or request routing, so your tracking setup can follow different business rules for each market.
• Apply consent settings based on visitor location. Use country or region values to trigger the relevant consent logic, so each visitor receives the settings prepared for their region.

Add country, region, city, IP address, or postal code values to server-side events to improve reporting and build tracking logic for different markets.

• How to set up GEO Headers
• How to easily add user agent and geo data to server Google Tag Manager
• Region-specific tags behavior in Google Tag Manager