'use strict'; Object.defineProperty(exports, '__esModule', { value: true }); function _interopDefault (ex) { return (ex && (typeof ex === 'object') && 'default' in ex) ? ex['default'] : ex; } var firebase = _interopDefault(require('@firebase/app')); require('@firebase/installations'); var tslib = require('tslib'); var logger$1 = require('@firebase/logger'); var util = require('@firebase/util'); var component = require('@firebase/component'); /** * @license * Copyright 2019 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ var ANALYTICS_ID_FIELD = 'measurementId'; // Key to attach FID to in gtag params. var GA_FID_KEY = 'firebase_id'; var ORIGIN_KEY = 'origin'; var GTAG_URL = 'https://www.googletagmanager.com/gtag/js'; var GtagCommand; (function (GtagCommand) { GtagCommand["EVENT"] = "event"; GtagCommand["SET"] = "set"; GtagCommand["CONFIG"] = "config"; })(GtagCommand || (GtagCommand = {})); /* * Officially recommended event names for gtag.js * Any other string is also allowed. */ var EventName; (function (EventName) { EventName["ADD_SHIPPING_INFO"] = "add_shipping_info"; EventName["ADD_PAYMENT_INFO"] = "add_payment_info"; EventName["ADD_TO_CART"] = "add_to_cart"; EventName["ADD_TO_WISHLIST"] = "add_to_wishlist"; EventName["BEGIN_CHECKOUT"] = "begin_checkout"; /** @deprecated */ EventName["CHECKOUT_PROGRESS"] = "checkout_progress"; EventName["EXCEPTION"] = "exception"; EventName["GENERATE_LEAD"] = "generate_lead"; EventName["LOGIN"] = "login"; EventName["PAGE_VIEW"] = "page_view"; EventName["PURCHASE"] = "purchase"; EventName["REFUND"] = "refund"; EventName["REMOVE_FROM_CART"] = "remove_from_cart"; EventName["SCREEN_VIEW"] = "screen_view"; EventName["SEARCH"] = "search"; EventName["SELECT_CONTENT"] = "select_content"; EventName["SELECT_ITEM"] = "select_item"; EventName["SELECT_PROMOTION"] = "select_promotion"; /** @deprecated */ EventName["SET_CHECKOUT_OPTION"] = "set_checkout_option"; EventName["SHARE"] = "share"; EventName["SIGN_UP"] = "sign_up"; EventName["TIMING_COMPLETE"] = "timing_complete"; EventName["VIEW_CART"] = "view_cart"; EventName["VIEW_ITEM"] = "view_item"; EventName["VIEW_ITEM_LIST"] = "view_item_list"; EventName["VIEW_PROMOTION"] = "view_promotion"; EventName["VIEW_SEARCH_RESULTS"] = "view_search_results"; })(EventName || (EventName = {})); /** * @license * Copyright 2019 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ /** * Logs an analytics event through the Firebase SDK. * * @param gtagFunction Wrapped gtag function that waits for fid to be set before sending an event * @param eventName Google Analytics event name, choose from standard list or use a custom string. * @param eventParams Analytics event parameters. */ function logEvent(gtagFunction, analyticsId, eventName, eventParams, options) { var params = eventParams || {}; if (!options || !options.global) { params = tslib.__assign(tslib.__assign({}, eventParams), { 'send_to': analyticsId }); } // Workaround for http://b/141370449 - third argument cannot be undefined. gtagFunction(GtagCommand.EVENT, eventName, params || {}); } // TODO: Brad is going to add `screen_name` to GA Gold config parameter schema /** * Set screen_name parameter for this Google Analytics ID. * * @param gtagFunction Wrapped gtag function that waits for fid to be set before sending an event * @param screenName Screen name string to set. */ function setCurrentScreen(gtagFunction, analyticsId, screenName, options) { if (options && options.global) { gtagFunction(GtagCommand.SET, { 'screen_name': screenName }); } else { gtagFunction(GtagCommand.CONFIG, analyticsId, { update: true, 'screen_name': screenName }); } } /** * Set user_id parameter for this Google Analytics ID. * * @param gtagFunction Wrapped gtag function that waits for fid to be set before sending an event * @param id User ID string to set */ function setUserId(gtagFunction, analyticsId, id, options) { if (options && options.global) { gtagFunction(GtagCommand.SET, { 'user_id': id }); } else { gtagFunction(GtagCommand.CONFIG, analyticsId, { update: true, 'user_id': id }); } } /** * Set all other user properties other than user_id and screen_name. * * @param gtagFunction Wrapped gtag function that waits for fid to be set before sending an event * @param properties Map of user properties to set */ function setUserProperties(gtagFunction, analyticsId, properties, options) { if (options && options.global) { var flatProperties = {}; for (var _i = 0, _a = Object.keys(properties); _i < _a.length; _i++) { var key = _a[_i]; // use dot notation for merge behavior in gtag.js flatProperties["user_properties." + key] = properties[key]; } gtagFunction(GtagCommand.SET, flatProperties); } else { gtagFunction(GtagCommand.CONFIG, analyticsId, { update: true, 'user_properties': properties }); } } /** * Set whether collection is enabled for this ID. * * @param enabled If true, collection is enabled for this ID. */ function setAnalyticsCollectionEnabled(analyticsId, enabled) { window["ga-disable-" + analyticsId] = !enabled; } /** * @license * Copyright 2019 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ var logger = new logger$1.Logger('@firebase/analytics'); /** * @license * Copyright 2019 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ /** * Initialize the analytics instance in gtag.js by calling config command with fid. * * NOTE: We combine analytics initialization and setting fid together because we want fid to be * part of the `page_view` event that's sent during the initialization * @param app Firebase app * @param gtagCore The gtag function that's not wrapped. */ function initializeGAId(app, installations, gtagCore) { return tslib.__awaiter(this, void 0, void 0, function () { var fid; var _a; return tslib.__generator(this, function (_b) { switch (_b.label) { case 0: return [4 /*yield*/, installations.getId()]; case 1: fid = _b.sent(); // This command initializes gtag.js and only needs to be called once for the entire web app, // but since it is idempotent, we can call it multiple times. // We keep it together with other initialization logic for better code structure. // eslint-disable-next-line @typescript-eslint/no-explicit-any gtagCore('js', new Date()); // It should be the first config command called on this GA-ID // Initialize this GA-ID and set FID on it using the gtag config API. gtagCore(GtagCommand.CONFIG, app.options[ANALYTICS_ID_FIELD], (_a = {}, _a[GA_FID_KEY] = fid, // guard against developers accidentally setting properties with prefix `firebase_` _a[ORIGIN_KEY] = 'firebase', _a.update = true, _a)); return [2 /*return*/]; } }); }); } function insertScriptTag(dataLayerName) { var script = document.createElement('script'); // We are not providing an analyticsId in the URL because it would trigger a `page_view` // without fid. We will initialize ga-id using gtag (config) command together with fid. script.src = GTAG_URL + "?l=" + dataLayerName; script.async = true; document.head.appendChild(script); } /** Get reference to, or create, global datalayer. * @param dataLayerName Name of datalayer (most often the default, "_dataLayer") */ function getOrCreateDataLayer(dataLayerName) { // Check for existing dataLayer and create if needed. var dataLayer = []; if (Array.isArray(window[dataLayerName])) { dataLayer = window[dataLayerName]; } else { window[dataLayerName] = dataLayer; } return dataLayer; } /** * Wraps a standard gtag function with extra code to wait for completion of * relevant initialization promises before sending requests. * * @param gtagCore Basic gtag function that just appends to dataLayer * @param initializedIdPromisesMap Map of gaIds to their initialization promises */ function wrapGtag(gtagCore, initializedIdPromisesMap) { return function (command, idOrNameOrParams, gtagParams) { // If event, check that relevant initialization promises have completed. if (command === GtagCommand.EVENT) { var initializationPromisesToWaitFor = []; // If there's a 'send_to' param, check if any ID specified matches // a FID we have begun a fetch on. if (gtagParams && gtagParams['send_to']) { var gaSendToList = gtagParams['send_to']; // Make it an array if is isn't, so it can be dealt with the same way. if (!Array.isArray(gaSendToList)) { gaSendToList = [gaSendToList]; } for (var _i = 0, gaSendToList_1 = gaSendToList; _i < gaSendToList_1.length; _i++) { var sendToId = gaSendToList_1[_i]; var initializationPromise = initializedIdPromisesMap[sendToId]; // Groups will not be in the map. if (initializationPromise) { initializationPromisesToWaitFor.push(initializationPromise); } else { // There is an item in 'send_to' that is not associated // directly with an FID, possibly a group. Empty this array // and let it get populated below. initializationPromisesToWaitFor = []; break; } } } // This will be unpopulated if there was no 'send_to' field , or // if not all entries in the 'send_to' field could be mapped to // a FID. In these cases, wait on all pending initialization promises. if (initializationPromisesToWaitFor.length === 0) { for (var _a = 0, _b = Object.values(initializedIdPromisesMap); _a < _b.length; _a++) { var idPromise = _b[_a]; initializationPromisesToWaitFor.push(idPromise); } } // Run core gtag function with args after all relevant initialization // promises have been resolved. Promise.all(initializationPromisesToWaitFor) // Workaround for http://b/141370449 - third argument cannot be undefined. .then(function () { return gtagCore(GtagCommand.EVENT, idOrNameOrParams, gtagParams || {}); }) .catch(function (e) { return logger.error(e); }); } else if (command === GtagCommand.CONFIG) { var initializationPromiseToWait = initializedIdPromisesMap[idOrNameOrParams] || Promise.resolve(); initializationPromiseToWait .then(function () { gtagCore(GtagCommand.CONFIG, idOrNameOrParams, gtagParams); }) .catch(function (e) { return logger.error(e); }); } else { // SET command. // Splitting calls for CONFIG and SET to make it clear which signature // Typescript is checking. gtagCore(GtagCommand.SET, idOrNameOrParams); } }; } /** * Creates global gtag function or wraps existing one if found. * This wrapped function attaches Firebase instance ID (FID) to gtag 'config' and * 'event' calls that belong to the GAID associated with this Firebase instance. * * @param initializedIdPromisesMap Map of gaId to initialization promises. * @param dataLayerName Name of global GA datalayer array. * @param gtagFunctionName Name of global gtag function ("gtag" if not user-specified) */ function wrapOrCreateGtag(initializedIdPromisesMap, dataLayerName, gtagFunctionName) { // Create a basic core gtag function var gtagCore = function () { var _args = []; for (var _i = 0; _i < arguments.length; _i++) { _args[_i] = arguments[_i]; } // Must push IArguments object, not an array. window[dataLayerName].push(arguments); }; // Replace it with existing one if found if (window[gtagFunctionName] && typeof window[gtagFunctionName] === 'function') { // @ts-ignore gtagCore = window[gtagFunctionName]; } window[gtagFunctionName] = wrapGtag(gtagCore, initializedIdPromisesMap); return { gtagCore: gtagCore, wrappedGtag: window[gtagFunctionName] }; } /** * Returns first script tag in DOM matching our gtag url pattern. */ function findGtagScriptOnPage() { var scriptTags = window.document.getElementsByTagName('script'); for (var _i = 0, _a = Object.values(scriptTags); _i < _a.length; _i++) { var tag = _a[_i]; if (tag.src && tag.src.includes(GTAG_URL)) { return tag; } } return null; } /** * @license * Copyright 2019 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ var _a; var ERRORS = (_a = {}, _a["no-ga-id" /* NO_GA_ID */] = "\"" + ANALYTICS_ID_FIELD + "\" field is empty in " + 'Firebase config. Firebase Analytics ' + 'requires this field to contain a valid measurement ID.', _a["already-exists" /* ALREADY_EXISTS */] = 'A Firebase Analytics instance with the measurement ID ${id} ' + ' already exists. ' + 'Only one Firebase Analytics instance can be created for each measurement ID.', _a["already-initialized" /* ALREADY_INITIALIZED */] = 'Firebase Analytics has already been initialized.' + 'settings() must be called before initializing any Analytics instance' + 'or it will have no effect.', _a["interop-component-reg-failed" /* INTEROP_COMPONENT_REG_FAILED */] = 'Firebase Analytics Interop Component failed to instantiate', _a); var ERROR_FACTORY = new util.ErrorFactory('analytics', 'Analytics', ERRORS); /** * @license * Copyright 2019 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ /** * Maps gaId to FID fetch promises. */ var initializedIdPromisesMap = {}; /** * Name for window global data layer array used by GA: defaults to 'dataLayer'. */ var dataLayerName = 'dataLayer'; /** * Name for window global gtag function used by GA: defaults to 'gtag'. */ var gtagName = 'gtag'; /** * Reproduction of standard gtag function or reference to existing * gtag function on window object. */ var gtagCoreFunction; /** * Wrapper around gtag function that ensures FID is sent with all * relevant event and config calls. */ var wrappedGtagFunction; /** * Flag to ensure page initialization steps (creation or wrapping of * dataLayer and gtag script) are only run once per page load. */ var globalInitDone = false; /** * For testing */ function resetGlobalVars(newGlobalInitDone, newGaInitializedPromise) { if (newGlobalInitDone === void 0) { newGlobalInitDone = false; } if (newGaInitializedPromise === void 0) { newGaInitializedPromise = {}; } globalInitDone = newGlobalInitDone; initializedIdPromisesMap = newGaInitializedPromise; dataLayerName = 'dataLayer'; gtagName = 'gtag'; } /** * For testing */ function getGlobalVars() { return { initializedIdPromisesMap: initializedIdPromisesMap }; } /** * This must be run before calling firebase.analytics() or it won't * have any effect. * @param options Custom gtag and dataLayer names. */ function settings(options) { if (globalInitDone) { throw ERROR_FACTORY.create("already-initialized" /* ALREADY_INITIALIZED */); } if (options.dataLayerName) { dataLayerName = options.dataLayerName; } if (options.gtagName) { gtagName = options.gtagName; } } function factory(app, installations) { var analyticsId = app.options[ANALYTICS_ID_FIELD]; if (!analyticsId) { throw ERROR_FACTORY.create("no-ga-id" /* NO_GA_ID */); } if (initializedIdPromisesMap[analyticsId] != null) { throw ERROR_FACTORY.create("already-exists" /* ALREADY_EXISTS */, { id: analyticsId }); } if (!globalInitDone) { // Steps here should only be done once per page: creation or wrapping // of dataLayer and global gtag function. // Detect if user has already put the gtag