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:
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:
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.
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.
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.
Last updated