GA4 + Google Ads (gtag.js)

Google Tag (gtag.js) is Google's unified tracking script for sending data to Google Analytics 4 (GA4), Google Ads, and Floodlight. It measures user behavior, tracks conversions, and powers Google's advertising ecosystem.

c15t initializes Google Tag with Consent Mode v2 defaults set to denied and automatically updates the consent state when users make choices. You don't need to configure Google Consent Mode yourself.

Info

Use GTM if your team needs centralized tag management in the GTM UI. Use gtag.js if you only need GA4/Google Ads directly in code. Don't run both for the same destination unless intentional, or you may duplicate events.

Choosing the right category:

Use category: 'measurement' for analytics-only tracking (GA4 events)
Use category: 'marketing' for advertising and conversion tracking (Google Ads)

Adding GA4 + Google Ads to c15t

Info

See the integration overview for how to pass scripts to your framework (JavaScript, React, or Next.js).

import { gtag } from '@c15t/scripts/google-tag';

gtag({
  id: 'G-XXXXXXXXXX',
  category: 'measurement', // or 'marketing'
});

Types

GtagOptions

Property

Types

Loading…

Script

Property

Types

Loading…

GA4 + Google Ads (gtag.js)

Adding GA4 + Google Ads to c15t

Types

GtagOptions

categoryThe consent category to use for the gtag script. This is typically marketing (Ads & Floodlight) or measurement (Analytics)requiredAllConsentNames

idYour gtag idrequiredstring

script?Override or extend the default script values. Default values: id: 'gtag' src: https://www.googletagmanager.com/gtag/js?id=${id} async: true alwaysLoad: true Partial<Omit<Script, 'category'>>

Script

anonymizeId?Whether to use an anonymized ID for the script element, this helps ensure the script is not blocked by ad blockersboolean | undefined

async?Whether to use async loadingboolean | undefined

attributes?Additional attributes to add to the script elementRecord<string, string>

categoryConsent category or condition required to load this scriptrequiredHasCondition<AllConsentNames>

defer?Whether to defer script loadingboolean | undefined

fetchPriority?Priority hint for browser resource loading"high" | "low" | "auto" | undefined

iabLegIntPurposes?IAB TCF legitimate interest purpose IDs. These purposes can operate under legitimate interest instead of consent. The script loads if all iabPurposes have consent OR all iabLegIntPurposes have legitimate interest established.{} | undefined

iabPurposes?IAB TCF purpose IDs this script requires consent for. When in IAB mode and no vendorId is set, the script will only load if ALL specified purposes have consent.{} | undefined

iabSpecialFeatures?IAB TCF special feature IDs this script requires. Special features require explicit opt-in: 1: Use precise geolocation data 2: Actively scan device characteristics for identification {} | undefined

idUnique identifier for the scriptrequiredstring

nonce?Content Security Policy noncestring | undefined

onBeforeLoad?Callback executed before the script is loaded((info: ScriptCallbackInfo) => void) | u...

onConsentChange?Callback executed whenever the consent store is changed. This callback only applies to scripts already loaded.((info: ScriptCallbackInfo) => void) | u...

onError?Callback executed if the script fails to load((info: ScriptCallbackInfo) => void) | u...

onLoad?Callback executed when the script loads successfully((info: ScriptCallbackInfo) => void) | u...

persistAfterConsentRevoked?Whether the script should persist after consent is revoked.boolean | undefined

src?URL of the script to loadstring | undefined

textContent?Inline JavaScript code to executestring | undefined

vendorId?IAB TCF vendor ID - links script to a registered vendor. When in IAB mode, the script will only load if this vendor has consent. Takes precedence over category when in IAB mode. Use custom vendor IDs (string or number) to gate non-IAB vendors too.string | number | undefined

categoryThe consent category to use for the gtag script. This is typically marketing (Ads & Floodlight) or measurement (Analytics)requiredAllConsentNames

idYour gtag idrequiredstring

script?Override or extend the default script values. Default values: id: 'gtag' src: https://www.googletagmanager.com/gtag/js?id=${id} async: true alwaysLoad: true Partial<Omit<Script, 'category'>>

anonymizeId?Whether to use an anonymized ID for the script element, this helps ensure the script is not blocked by ad blockersboolean | undefined

async?Whether to use async loadingboolean | undefined

attributes?Additional attributes to add to the script elementRecord<string, string>

categoryConsent category or condition required to load this scriptrequiredHasCondition<AllConsentNames>

defer?Whether to defer script loadingboolean | undefined

fetchPriority?Priority hint for browser resource loading"high" | "low" | "auto" | undefined

iabLegIntPurposes?IAB TCF legitimate interest purpose IDs. These purposes can operate under legitimate interest instead of consent. The script loads if all iabPurposes have consent OR all iabLegIntPurposes have legitimate interest established.{} | undefined

iabPurposes?IAB TCF purpose IDs this script requires consent for. When in IAB mode and no vendorId is set, the script will only load if ALL specified purposes have consent.{} | undefined

iabSpecialFeatures?IAB TCF special feature IDs this script requires. Special features require explicit opt-in: 1: Use precise geolocation data 2: Actively scan device characteristics for identification {} | undefined

idUnique identifier for the scriptrequiredstring

nonce?Content Security Policy noncestring | undefined

onBeforeLoad?Callback executed before the script is loaded((info: ScriptCallbackInfo) => void) | u...

onConsentChange?Callback executed whenever the consent store is changed. This callback only applies to scripts already loaded.((info: ScriptCallbackInfo) => void) | u...

onError?Callback executed if the script fails to load((info: ScriptCallbackInfo) => void) | u...

onLoad?Callback executed when the script loads successfully((info: ScriptCallbackInfo) => void) | u...

persistAfterConsentRevoked?Whether the script should persist after consent is revoked.boolean | undefined

src?URL of the script to loadstring | undefined

textContent?Inline JavaScript code to executestring | undefined

vendorId?IAB TCF vendor ID - links script to a registered vendor. When in IAB mode, the script will only load if this vendor has consent. Takes precedence over category when in IAB mode. Use custom vendor IDs (string or number) to gate non-IAB vendors too.string | number | undefined

consentsThe current consent staterequiredRecord<AllConsentNames, boolean>

element?The script element (for load/error callbacks) Will be undefined for callback-only scriptsHTMLScriptElement

elementIdThe actual DOM element ID used (anonymized if enabled)requiredstring

error?Error information (for error callbacks)Error

hasConsentHas consentrequiredboolean

idThe original script IDrequiredstring

consentsThe current consent staterequiredRecord<AllConsentNames, boolean>

element?The script element (for load/error callbacks) Will be undefined for callback-only scriptsHTMLScriptElement

elementIdThe actual DOM element ID used (anonymized if enabled)requiredstring

error?Error information (for error callbacks)Error

hasConsentHas consentrequiredboolean

idThe original script IDrequiredstring

consentsThe current consent staterequiredRecord<AllConsentNames, boolean>

element?The script element (for load/error callbacks) Will be undefined for callback-only scriptsHTMLScriptElement

elementIdThe actual DOM element ID used (anonymized if enabled)requiredstring

error?Error information (for error callbacks)Error

hasConsentHas consentrequiredboolean

idThe original script IDrequiredstring

consentsThe current consent staterequiredRecord<AllConsentNames, boolean>

element?The script element (for load/error callbacks) Will be undefined for callback-only scriptsHTMLScriptElement

elementIdThe actual DOM element ID used (anonymized if enabled)requiredstring

error?Error information (for error callbacks)Error

hasConsentHas consentrequiredboolean

idThe original script IDrequiredstring