AdPage Webhook Client

The AdPage Webhook Client is a server-side Google Tag Manager client that processes incoming webhook data from AdPage plugins (WordPress/Magento) and Shopify orders. It automatically formats the data to work seamlessly with Google Analytics 4 and other measurement tools.

Key Features

• Automatically processes AdPage plugin webhook data
• Native support for Shopify order webhooks
• Formats data to GA4 specifications
• Handles user data securely
• Configurable webhook paths

Installation

1. Download the template.tpl file from this repository
2. In your GTM Server Container, go to Templates > Client templates > New
3. Click on the 3 dots on the top right of the screen and select Import template
4. Select the template.tpl file you downloaded
5. Create a new client configuration using the template
6. Configure the accepted paths (default is /order_created)

Configuration Options

Path Settings

The client allows you to configure which webhook paths it should process:

• Default path: /order_created
• Other paths can be added if needed

Event Model Output

The client automatically processes incoming webhooks and creates a standardized event model with the following data:

Core Parameters

• event_name: Determined from the webhook payload
• client_id: User identifier
• page_location: Landing site URL
• page_referrer: Referring site
• user_agent: Browser information
• ip_override: Client IP address

E-commerce Data

• transaction_id: Order/Transaction identifier
• currency: Transaction currency
• value: Total transaction value
• tax: Tax amount
• shipping: Shipping cost
• items: Array of product data including:
  • item_id
  • item_name
  • price
  • quantity
  • item_variant
  • item_brand

User Data

• email: Customer email
• first_name: Customer first name
• last_name: Customer last name
• phone: Contact number
• address: Shipping/Billing address
• city: City
• state: State/Province
• zip: Postal code
• country: Country
• external_id: Customer ID

Marketing Data

• fbc: Facebook click identifier
• fbp: Facebook browser identifier
• ttclid: TikTok click identifier
• ttp: TikTok pixel identifier
• gclid: Google click identifier
• gbraid: Google browser advertising identifier
• wbraid: Web browser advertising identifier

Event Processing

The client automatically:

1. Receives the webhook payload
2. Extracts relevant data
3. Formats it to GA4 specifications
4. Makes the data available to other GTM server-side tags

This means your GA4 and other measurement tags will automatically receive properly formatted data without additional configuration.

Support

For questions or issues:

• Open an issue in this repository
• Contact AdPage support (support@adpage.io)