Google Ads

Source code Package Browser ES5

Google Ads is Google's comprehensive advertising platform. The walker.js Google Ads destination enables seamless integration of your web application with Google Ads.

Installation

TypeScript

Install the destination via npm

npm i @elbwalker/destination-web-google-ads

import { elb } from '@elbwalker/walker.js';
import destinationGoogleAds from '@elbwalker/destination-web-google-ads';

elb('walker destination', destinationGoogleAds, config);

Script

Load the destination via dynamic import

<script>
  // Upload the dist/index.mjs on your own server
  const destination = (
    await import(
      'https://cdn.jsdelivr.net/npm/@elbwalker/destination-web-google-ads/dist/index.mjs'
    )
  ).default;

  elb('walker destination', destination, config);
</script>

Code

Copy the code from the index.browser.js file

(function () {
  'use strict';
  var Destination = (() => {})(); // This is the copied code

  elb('walker destination', Destination.default, config);
})();

Configuration

Configure the Google Ads destination with a Conversion ID and Conversion label.

Custom Config

{
  conversionId: 'AW-123456789', // Required
  currency: 'EUR',
  defaultValue: 1,
}

{ conversionId: 'AW-123456789', // Required currency: 'EUR', defaultValue: 1, }

Result

No event yet.

No event yet.

Custom

Property	Type	Description
conversionId*	string	Google Ads conversion ID, starting with 'AW-'' .
currency	string	Default currency for conversions.
defaultValue	number	Default value used for conversions.

Use name to specify the conversion label and data for other parameters.

Mapping

conversion

Event

{
  event: "order complete",
  data: {
    id: "0rd3r1d",
    currency: "EUR",
    shipping: 5.22,
    taxes: 73.76,
    total: 555
  },
  context: {
    shopping: [
      "complete",
      0
    ]
  },
  globals: {
    pagegroup: "shop"
  },
  custom: {
    completely: "random"
  },
  user: {
    id: "us3r",
    device: "c00k13",
    session: "s3ss10n"
  },
  nested: [
    {
      type: "product",
      data: {
        id: "ers",
        name: "Everyday Ruck Snack",
        color: "black",
        size: "l",
        price: 420
      },
      context: {
        shopping: [
          "complete",
          0
        ]
      },
      nested: []
    },
    {
      type: "product",
      data: {
        id: "cc",
        name: "Cool Cap",
        size: "one size",
        price: 42
      },
      context: {
        shopping: [
          "complete",
          0
        ]
      },
      nested: []
    },
    {
      type: "gift",
      data: {
        name: "Surprise"
      },
      context: {
        shopping: [
          "complete",
          0
        ]
      },
      nested: []
    }
  ],
  consent: {
    functional: true
  },
  id: "1743380017000-gr0up-1",
  trigger: "load",
  entity: "order",
  action: "complete",
  timestamp: 1743380017000,
  timing: 3.14,
  group: "gr0up",
  count: 1,
  version: {
    source: "0.0.7",
    tagging: 1
  },
  source: {
    type: "web",
    id: "https://localhost:80",
    previous_id: "http://remotehost:9001"
  }
}

{ event: "order complete", data: { id: "0rd3r1d", currency: "EUR", shipping: 5.22, taxes: 73.76, total: 555 }, context: { shopping: [ "complete", 0 ] }, globals: { pagegroup: "shop" }, custom: { completely: "random" }, user: { id: "us3r", device: "c00k13", session: "s3ss10n" }, nested: [ { type: "product", data: { id: "ers", name: "Everyday Ruck Snack", color: "black", size: "l", price: 420 }, context: { shopping: [ "complete", 0 ] }, nested: [] }, { type: "product", data: { id: "cc", name: "Cool Cap", size: "one size", price: 42 }, context: { shopping: [ "complete", 0 ] }, nested: [] }, { type: "gift", data: { name: "Surprise" }, context: { shopping: [ "complete", 0 ] }, nested: [] } ], consent: { functional: true }, id: "1743380017000-gr0up-1", trigger: "load", entity: "order", action: "complete", timestamp: 1743380017000, timing: 3.14, group: "gr0up", count: 1, version: { source: "0.0.7", tagging: 1 }, source: { type: "web", id: "https://localhost:80", previous_id: "http://remotehost:9001" } }

Custom Config

{
  name: "labelId",
  data: {
    map: {
      transaction_id: "data.id",
      value: "data.total",
      currency: {
        key: "data.currency",
        value: "EUR"
      }
    }
  }
}

{ name: "labelId", data: { map: { transaction_id: "data.id", value: "data.total", currency: { key: "data.currency", value: "EUR" } } } }

Result

No event yet.

No event yet.

info

If you need professional support with your walkerOS implementation, check out our services.