Help & Documentation

Setup guides and developer reference

JD
WooCommerce Setup Shopify Setup Pixel Setup Pixel Events Cookie Compliance Reports Managing Pixels

Connecting a WooCommerce Store

Connect your WooCommerce store to see orders, products, revenue, and conversion data in your dashboard.

1 Generate API Keys

  1. Log in to your WordPress admin panel
  2. Go to WooCommerce → Settings → Advanced → REST API
  3. Click Add key
  4. Description: Advertool.io
  5. User: Select your admin account
  6. Permissions: Read
  7. Click Generate API key
  8. Copy the Consumer Key (starts with ck_) and Consumer Secret (starts with cs_)
Important: The Consumer Secret is only shown once. Copy it immediately and store it securely.

2 Add the Store in Advertool.io

  1. Go to Settings and click Add Store
  2. Platform: WooCommerce
  3. Store Name: A display name (e.g. "My Shop")
  4. Store URL: Your full site URL (e.g. https://myshop.com)
  5. API Key: Paste the Consumer Key
  6. API Secret: Paste the Consumer Secret
  7. Click Add Store

Your dashboard will begin loading data immediately. Use the store selector in the header to switch between stores.

Connecting a Shopify Store

Connect your Shopify store to see orders, products, revenue, and conversion data alongside your WooCommerce stores.

1 Create a Custom App in the Shopify Developer Dashboard

  1. Go to partners.shopify.com or your Shopify Developer Dashboard
  2. Click Apps → Create app
  3. Name it (e.g. "Advertool.io")
  4. Under Settings → Credentials, note your Client ID and Client Secret

2 Configure API Scopes

Your app needs the following Admin API access scopes:

  • read_orders — required for orders, revenue, and conversion data
  • read_products — required for product rankings
  • read_customers — optional, for customer geographic data

Set these in your app's configuration in the Developer Dashboard before installing.

3 Install the App on Your Store

  1. In the Developer Dashboard, go to your app → Versions
  2. Create a new version if you haven't already
  3. Install the app on your target store (e.g. yourstore.myshopify.com)
Important: The app must be installed on the store before Advertool.io can connect. The Client Credentials flow requires installation to generate access tokens.

4 Add the Store in Advertool.io

  1. Go to Settings and click Add Store
  2. Platform: Shopify
  3. Store Name: A display name (e.g. "My Shopify Store")
  4. Store URL: Your Shopify URL (e.g. https://yourstore.myshopify.com)
  5. Client ID: From the Developer Dashboard
  6. Client Secret: From the Developer Dashboard
  7. Click Add Store

Advertool.io will use the Client Credentials Grant to obtain an access token automatically. Tokens are refreshed every 24 hours in the background.

Shopify and WooCommerce stores appear together in the store selector. All dashboard pages — orders, products, trends, conversion, promo codes, and geographic — work with both platforms.

Tracking Pixel Setup

Advertool.io tracking pixels let you measure page views, clicks, and purchase conversions on any website — including external landing pages and your WooCommerce stores.

1 Create a Pixel

Go to Settings and scroll to the Tracking Pixels section. Click Add Pixel, give it a name (e.g. "Facebook Landing Page"), select the store it belongs to, and click Save.

2 Install the Snippet

After creating the pixel, a code snippet appears on the card. Click Copy Snippet and paste it into the <head> of every page you want to track.

For WordPress/WooCommerce sites, add it to your theme's header.php file or use a header scripts plugin.

The snippet loads asynchronously and won't slow down your page. It automatically tracks page views and all clicks.

3 Track Purchases (Conversions)

To track purchase conversions with dollar amounts, add the following code to your WooCommerce thank-you page template.

Code to add to the thank-you page:

<?php if ($order) : ?> <script> (function checkPixel() { if (typeof AdvPixel !== 'undefined') { AdvPixel.purchase( <?php echo esc_js($order->get_total()); ?>, '<?php echo esc_js($order->get_id()); ?>' ); } else { setTimeout(checkPixel, 200); } })(); </script> <?php endif; ?>
Important: The tracking pixel snippet (from Step 2) must also be installed on the thank-you page for this to work. If it's in your header.php, it's already there.

How it works:

  • When a customer completes checkout, the thank-you page loads
  • The code waits for the pixel script to load, then fires a purchase event
  • The order total and order ID are sent to Advertool.io
  • The data appears on the Pixels reporting page under Conversions and Revenue

Pixel Events Reference

The tracking pixel supports three event types:

Page View

Fires automatically when the page loads. No code needed.

Click

Fires automatically on every click. Captures the element text, link URL, and element type.

Purchase

Fires manually via JavaScript. Use this on your order confirmation / thank-you page.

// Basic usage AdvPixel.purchase(49.99, 'ORD-123'); // With extra metadata AdvPixel.purchase(49.99, 'ORD-123', { currency: 'USD', items: 3 });

Manual Click Event

You can also fire click events manually if needed:

AdvPixel.click('Add to Cart Button');

Manual Page View

For single-page apps where the URL changes without a full reload:

AdvPixel.pageview();

GDPR Cookie Consent (Optional)

By default, the pixel tracks immediately when the page loads. If your site requires cookie consent for GDPR/CCPA compliance, add &consent=1 to the snippet URL:

When consent mode is enabled:

  • A consent banner appears at the bottom of the page
  • No cookies are set and no events are tracked until the visitor clicks Accept
  • If the visitor clicks Decline, no tracking occurs and the banner won't show again
  • The visitor's choice is remembered for 1 year via a consent cookie

Custom Consent Integration

If you already have your own cookie consent banner (e.g. CookieBot, Termly, OneTrust), you can control the pixel programmatically instead:

When using grantConsent() / revokeConsent(), you don't need &consent=1 in the snippet URL. Just load the pixel normally and call these methods from your own consent handler.

Viewing Reports

Go to the Pixels page in the sidebar to see:

  • Total Page Views — how many times tracked pages were loaded
  • Total Clicks — all click events across your pages
  • Conversions — purchase events fired from thank-you pages
  • Revenue — total dollar amount from purchase events
  • Conv. Rate — conversions divided by page views

Use the store selector to filter by store, and the date picker to filter by time period. Click Export CSV to download the data.

Managing Pixels

In Settings → Tracking Pixels, you can:

  • Rename — edit the name field and click Save
  • Pause — temporarily stop recording events (the snippet stays on your site but events are ignored)
  • Activate — resume recording after pausing
  • Delete — permanently remove the pixel and all its event data
  • Copy Snippet — get the installation code for your developers
Pausing a pixel does NOT require removing the snippet from your site. Events are silently ignored while paused.
© 2026 Advertool.io