Google Ads

Web Source code Package

Google Ads conversion tracking enables you to track conversions and measure the effectiveness of your Google Ads campaigns. The destination automatically sends events to Google Ads via gtag function. All you need to do is install the destination, and optionally map events to GA4's format. walkerOS takes care of loading the script and the function calls.

Installation

npm install @walkeros/web-destination-gtag

Setup

import { startFlow } from '@walkeros/collector';
import { destinationGtag } from '@walkeros/web-destination-gtag';

const { elb } = await startFlow();

elb('walker destination', destinationGtag, {
  settings: {
    ads: {
      conversionId: 'AW-XXXXXXXXX', // Required
      currency: 'EUR', // Default currency for conversions
    },
  },
  mapping: {
    order: {
      complete: {
        settings: {
          ads: {
            label: 'purchase_conversion', // Conversion label for order complete
          },
        },
      },
    },
  },
});

// Track an order complete event
elb('order complete', {
  id: 'order-123',
  value: 49.99,
  currency: 'EUR',
  items: 2,
});

Configuration reference

Property	Type	Description	More
conversionId*	string	Google Ads conversion ID from your Google Ads account
currency	string	Default currency code for conversion values

* Required fields

Event Mapping

For custom event mapping (mapping.entity.action.settings.ads):

Property	Type	Description	More
label	string	Conversion label for this specific event

Live Demo

Try the Google Ads destination with real events:

Initialize Google Ads

Settings

{
  ads: {
    conversionId: "AW-123456789",
    currency: "EUR"
  }
}

{ ads: { conversionId: "AW-123456789", currency: "EUR" } }

Result

No event yet.

No event yet.

Track a Conversion Event

Event

{
  name: "order complete",
  data: {
    id: "order-123",
    value: 49.99,
    currency: "EUR"
  },
  context: {
    dev: [
      "test",
      1
    ]
  },
  globals: {
    lang: "elb"
  },
  custom: {
    completely: "random"
  },
  user: {
    id: "us3r",
    device: "c00k13",
    session: "s3ss10n"
  },
  nested: [
    {
      entity: "child",
      data: {
        is: "subordinated"
      },
      nested: [],
      context: {
        element: [
          "child",
          0
        ]
      }
    }
  ],
  consent: {
    functional: true
  },
  id: "1760487217000-gr0up-1",
  trigger: "test",
  entity: "order",
  action: "complete",
  timestamp: 1760487217000,
  timing: 3.14,
  group: "gr0up",
  count: 1,
  version: {
    source: "0.2.0",
    tagging: 1
  },
  source: {
    type: "web",
    id: "https://localhost:80",
    previous_id: "http://remotehost:9001"
  }
}

{ name: "order complete", data: { id: "order-123", value: 49.99, currency: "EUR" }, context: { dev: [ "test", 1 ] }, globals: { lang: "elb" }, custom: { completely: "random" }, user: { id: "us3r", device: "c00k13", session: "s3ss10n" }, nested: [ { entity: "child", data: { is: "subordinated" }, nested: [], context: { element: [ "child", 0 ] } } ], consent: { functional: true }, id: "1760487217000-gr0up-1", trigger: "test", entity: "order", action: "complete", timestamp: 1760487217000, timing: 3.14, group: "gr0up", count: 1, version: { source: "0.2.0", tagging: 1 }, source: { type: "web", id: "https://localhost:80", previous_id: "http://remotehost:9001" } }

Mapping

{
  name: "purchase_conversion",
  settings: {
    ads: {}
  }
}

{ name: "purchase_conversion", settings: { ads: {} } }

Result

No event yet.

No event yet.