# Add a New Data Element (Browser)
## Introduction
For Client-side or Browser-side configuration, all the information is fetched from the webpage or browser.
## Procedure
Perform the following steps to create a Data element for the browser:
**Step 1:** Click the ***Add Data Element*** dropdown and select ***Browser***.
**Step 2:** Under the **Info** section, enter the following details in the respective fields:
| Field Name | Description |
| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Name | Denotes the default Data Element Name. |
| Variable Name |
Denotes the variable name. Note: The Variable name is the same as the Data Element name.
|
| Description | Enter the description of the Data Element. |
| Is a Language Data Element? | The language that must be essentially used in the particular website. There can be only one Language Data Element for a particular Data Element. |
| Is a Privacy Compliance Data Element? | Denotes if the user or customer has provided consent for data collection. There can be only one Privacy Compliance Data Element for a particular Data Element. |
| Choose Data Element Type |
Denotes the data element type. • URL Parameter: Denotes the parameters that are fetched from the URL. • Launch Data Element: This is a reference to the Adobe Launch data element if the client's website has Adobe launch configured and the Adobe launch SDK downloaded on their website. • Custom JavaScript: Includes the Custom Java Script code that the user provides as input. The code must be included in the Custom Java Script section while adding the Data Elements. • Ingest Labs Data Layer: Includes the Data Layer that the Ingest Labs generates. You can specify the path in the Element Name that is a JSON object and provide values.
|
**Step 3:** Under *Data Element Type*, there is a dropdown labeled ***Choose Data Element Type*****.** The available options are:
* URL Parameter
* Launch Data Element
* Custom JavaScript
* Ingest Labs Data Layer
**Step 3.1:** URL Parameter**:**
| Field Name | Description |
| -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Parameter Name | This is a mandatory field. Enter the parameter name. |
| Default value |
Represents the Default Value of the parameter. • Empty String: Denotes that the data element is a string value. • Undefined: If the data element is not supposed to be used then select Undefined. • Null: Denotes the Null data type for the data element. • Custom Value: Denotes the static value for the Data Element.
|
| Case-sensitive | Select the Case-sensitive check box to make the default parameter case-sensitive. Else, clear the check box. |
**Step 3.1.1:** Transformation Function
Enter the following fields in the Transformation Function section.
| Field Name | Description |
| ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Default Functions |
• Clean: Clears and trims any white spaces on the trailing and leading strings after collecting the data value. • Lowercase: Denotes that the string needs to be in the lower-case.
|
| Custom Function | Use Custom Function: For performing other transformations, you can write the code, retrieve or convert the value into a new value, and return the new value in the code using Custom function. |
**Step 3.1.2:** Redaction
Select the Redaction option for the data element if it contains sensitive information.\
When redaction is enabled and a strategy is applied, the backend server will scramble or mask the data when it is used in a tag or provider to maintain privacy.
Data Classification:
Under the Redaction section, click the **Data Classification** dropdown and choose the appropriate classification type based on the data element. The available options are:
* Not Applicable – No redaction strategy is applied.
* Email – Digits in the email are scrambled.
* IP Address – The last octets of the IP address are zeroed out.
* Phone Number – The first 3 digits are retained; the remaining digits are set to 0.
* Date – The month and year are kept; the date is set to 1.
**Step 3.1.3:** Storage Duration
In the Storage Duration field, select how long the data element should be retained. The available options are:
* EVENT – The data is stored only for the duration of the event.
* NONE – The data is not stored.
* SESSION – The data is stored for the duration of the user session.
* VISITOR – The data is stored across multiple sessions for the same visitor.
**Step 3.2:** Launch Data Element
Enter the following fields in the Launch Data section of the screen.
| Field Name | Description |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Element Name | This is a mandatory field. Enter the data element name. |
| Default value |
Represents the Default Value of the data element. • Empty String: Denotes that the data element is a string value. • Undefined: If the data element is not supposed to be used then select Undefined. • Null: Denotes the Null data type for the data element. • Custom Value: Denotes the static value for the Data Element.
|
**Step 3.2.1:** Redaction
Select the Redaction option for the data element if it contains sensitive information.\
When redaction is enabled and a strategy is applied, the backend server will scramble or mask the data when it is used in a tag or provider to maintain privacy.
Data Classification:
Under the Redaction section, click the **Data Classification** dropdown and choose the appropriate classification type based on the data element. The available options are:
* Not Applicable – No redaction strategy is applied.
* Email – Digits in the email are scrambled.
* IP Address – The last octets of the IP address are zeroed out.
* Phone Number – The first 3 digits are retained; the remaining digits are set to 0.
* Date – The month and year are kept; the date is set to 1.
**Step 3.3:** Custom JavaScript
In this field, you can enter a custom JavaScript function to define advanced logic or processing for the data element. Ensure the code is valid and tested before saving.
**Step 3.3.1:** Is Async Function? (Checkbox):\
Check this box if the custom JavaScript function is asynchronous. Enabling this allows the system to correctly handle promises returned by the function.
**Step 3.4:** Ingest Labs Data Layer
Under the **Ingest Labs Data Layer** section, configure the following fields:
**Step 3.4.1:** Element Name:
Enter the name of the data element.
**Step 3.4.2:** Default Value:
Specify a default value for the element, used when no value is received from the data layer.\
The same storage options apply here as in the previous section:
* EVENT – Data is stored only for the duration of the event.
* NONE – Data is not stored.
* SESSION – Data is retained for the user session.
* VISITOR – Data is retained across multiple sessions for the same visitor.
**Note:** Transformation Function, Redaction, and Storage Duration fields follow the same steps as described above.
**Step 3.5:** Click **Save** to save the changes.
{% embed url="" %}
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.ingestlabs.com/tag-manager/data-elements/add-a-new-data-element-browser.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.