@gravitywelluk/gtag

Gravitywell Gtag

Typed Google gtag.js helper functions that ensures your app won't crash if gtag.js is not instantiated.

Table of Contents

• Table of Contents
• Google GA4 Events
  • Usage
  • Helpers
    • add_payment_info
    • add_shipping_info
    • add_to_cart
    • login
    • sign_up
    • begin_checkout
    • purchase
    • select_item
    • share

Google GA4 Events

Helper functions to track Google Gtag GA4 events.

Usage

import { gtagGa4EventAddToCart } from "@gravitywelluk/gtag";

...

// Track an add_to_cart event
gtagGa4EventAddToCart({
  currency: "GBP",
  value: 215.14,
  items: items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Store",
      coupon: "SUMMER_FUN",
      currency: "USD",
      discount: 2.22,
      index: 5,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "L_12345",
      price: 107.57,
      quantity: 2
    }
  ]
});

...

Helpers

add_payment_info

Tracks an add_payment_info event.

import { gtagGa4EventAddPaymentInfo } from "@gravitywelluk/gtag";

add_shipping_info

Tracks an add_shipping_info event.

import { gtagGa4EventAddShippingInfo } from "@gravitywelluk/gtag";

add_to_cart

Tracks an add_to_cart event.

import { gtagGa4EventAddToCart } from "@gravitywelluk/gtag";

login

Tracks a login event.

import { gtagGa4EventAuth } from "@gravitywelluk/gtag";

sign_up

Tracks a sign_up event.

import { gtagGa4EventAuth } from "@gravitywelluk/gtag";

begin_checkout

Tracks a begin_checkout event.

import { gtagGa4EventBeginCheckout } from "@gravitywelluk/gtag";

purchase

Tracks a purchase event.

import { gtagGa4EventPurchase } from "@gravitywelluk/gtag";

select_item

Tracks a select_item event.

import { gtagGa4EventSelectItem } from "@gravitywelluk/gtag";

share

Tracks a share event.

import { gtagGa4EventShare } from "@gravitywelluk/gtag";