Integrating AdsPostX with Google Tag Manager is a seamless process that can be completed in just a few simple steps. This document provides a quick guide to walk you through the integration process.

To integrate AdsPostX with Google Tag Manager, you'll need:

Depending on whether your app is a standard website with separate URLs for each page or a single-page application (SPA), your integration steps are slightly different.

Standard page integration is designed for websites with explicit URL structures for the order confirmation page. Follow these steps to integrate AdsPostX with your standard website.

For a smoother integration process, we recommend following the playable demo below and simultaneously implementing the steps on your own.

This section is for websites built as single-page applications (SPAs), where the URL typically remains the same as users navigate different pages. If your website operates this way, please follow the steps outlined below for integrating AdsPostX.

In SPAs, a new HTML element often appears on the page when a user completes an order or confirms a form submission. You need to identify this element along with its ID or class selector. This information is necessary for setting up the AdsPostX tag in Google Tag Manager (GTM). For example, an HTML element that might appear after an order is submitted could look like this:

Or it could have a class like this:

Use the interactive demo to set up the AdsPostX tag in Google Tag Manager (GTM). Follow the steps provided to complete the integration smoothly.

While the basic integration steps are sufficient for integrating AdsPostX with your site, you can further enhance functionality by passing payload parameters. This advanced integration option enables more targeted and personalized Offers.

To enhance targeting and personalization of Offers, you can pass payload values when integrating AdsPostX with your site. Follow these steps for advanced integration, but first, you need to decide what information you want to include in the payload.

Make the payload object available via Javascript on the order confirmation page.

Create a Custom JavaScript Variable named AdpxPayloadand bind it to the page variable. Use the provided JavaScript Custom Variable template.

Once finished, the Custom JavaScript Variable screen should look like this:

Modify the line that defineswindow.AdpxUser in the Custom HTML tag you created earlier to pass the AdpxPayloadparameters.

Publish the changes to your Google Tag Manager container and verify that the AdsPostX tag loads correctly on the designated page.

If payload values were passed, check their acceptance in the AdsPostX dashboard under the Payload Explorer Section.

📢 If you're running into any issues while going through the integration process, feel free to contact us at [email protected].