# Add a New Provider (Browser)

### Introduction

This document explains step by step how to add a provider to the browser side. All the information required for Client-side or Browser-side configuration is fetched from the webpage or browser.

### Procedure

To add a new Provider in Tag Manager, perform the following steps:

**Step 1:** From the left navigation panel, select **Providers**.

<figure><img src="https://2731380315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDMDmegqZUJFhJhF4JQG%2Fuploads%2FcQqu3tn46lzmt5C4AqGD%2Fimage.png?alt=media&#x26;token=11b30842-5c1f-469d-afc5-3acd0d8347a9" alt=""><figcaption></figcaption></figure>

**Step 2:** Select **Add Provider -> For Browser** on the top-right corner of the screen.

<figure><img src="https://2731380315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDMDmegqZUJFhJhF4JQG%2Fuploads%2FkNx5zpo4R8rLuvfoNxFN%2Fimage.png?alt=media&#x26;token=5b15c0d9-b093-4b14-b034-d63e30b8d3b7" alt=""><figcaption></figcaption></figure>

**Step 3:** The **Provider Template** panel opens on the right side and choose a template from the list or use the **Search** bar to find a specific one.

<figure><img src="https://2731380315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDMDmegqZUJFhJhF4JQG%2Fuploads%2FtChaZoUppAg9NwCtr6tY%2Fimage.png?alt=media&#x26;token=12475390-0d38-482b-b85a-e2dc233d4d7a" alt=""><figcaption></figcaption></figure>

Note: In the list, each template includes a label such as *IMG*, *JS*, or *APP*, indicating whether the provider uses an image-based, JavaScript-based, or app-based implementation.

<figure><img src="https://2731380315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDMDmegqZUJFhJhF4JQG%2Fuploads%2FL38fLWRtDaUwYKEne5TZ%2Fimage.png?alt=media&#x26;token=e6d87337-c077-42bf-abdd-470bf737d0cc" alt=""><figcaption></figcaption></figure>

**Step 4:** Let us take an example of the **Facebook JS** provider template.

<figure><img src="https://2731380315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDMDmegqZUJFhJhF4JQG%2Fuploads%2FHrNJU7vVz4Qsx8rVDV6U%2Fimage.png?alt=media&#x26;token=3d9c771d-ebbc-4e01-b970-e6e2dfdd0779" alt=""><figcaption></figcaption></figure>

**Step 5:** Under **Provider Details**, the **Name** and **Description** fields will already be filled in.

<figure><img src="https://2731380315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDMDmegqZUJFhJhF4JQG%2Fuploads%2F1MmLe6W4O653RqE2jBk4%2Fimage.png?alt=media&#x26;token=149f2512-ae97-4c5a-89a8-3d1e1674db40" alt=""><figcaption></figcaption></figure>

**Step 6:** The Script section includes both the Template script and Provider script.

![](https://ingest-lab.netlify.app/images/providersimages/script.png)

You can enter the JavaScript in the Provider Script section and click **Save** to save the changes.

**Step 7:** The **Attributes** section lists the Attributes for Data Elements and Transformers. This is an Optional section.

![](https://ingest-lab.netlify.app/images/providersimages/attributes.png)

**Step 7.1:** Click **Choose Data Element.**

<figure><img src="https://2731380315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDMDmegqZUJFhJhF4JQG%2Fuploads%2FZpK6ECBdYqJk7Za1bZoz%2Fimage.png?alt=media&#x26;token=c62e49da-f622-47d1-9bf3-29038762bcc0" alt=""><figcaption></figcaption></figure>

**Step 7.1.1:** The **Select Data Element** panel opens on the right side of the screen.

At the top of this panel, you’ll find a **Search Bar**.

You can either:

* Use the search bar to find a specific Data Element, or
* Choose from the list displayed under the two tabs:
  * User-Defined
  * Default

<figure><img src="https://2731380315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDMDmegqZUJFhJhF4JQG%2Fuploads%2FQMddEPbzPUuIjnZnSd7e%2Fimage.png?alt=media&#x26;token=a6d11101-7e0a-455a-a084-11ac97cfaff0" alt=""><figcaption></figcaption></figure>

**Step Result:** The selected Data Element is visible in the Value section.

<figure><img src="https://2731380315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDMDmegqZUJFhJhF4JQG%2Fuploads%2FyJbYKgCLS53r62pNxMy3%2Fimage.png?alt=media&#x26;token=f68f2bd7-9203-4cf1-93dc-234394023a2c" alt=""><figcaption></figcaption></figure>

**Note:** To cancel the selected Data Element, click the small **x icon** next to the selected item.

<figure><img src="https://2731380315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDMDmegqZUJFhJhF4JQG%2Fuploads%2F4bsSjv3zKWSPOEGxy5Y7%2Fimage.png?alt=media&#x26;token=d1268fb8-9ea0-4469-96f1-3d67cdc895d2" alt=""><figcaption></figcaption></figure>

**Step 7.1.2:** Attribute Settings

Under the Settings section, you can configure the following options for each attribute:

* Mandatory: Select this checkbox to make the value mandatory.
* Fatal: Select this checkbox to stop the process if the value is missing or invalid.
* Ignore If Empty: Select this checkbox to skip this value during processing if it is not set.
* Hash (SHA256): Select this checkbox to securely convert the value into a SHA256 hash before processing.

<figure><img src="https://2731380315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDMDmegqZUJFhJhF4JQG%2Fuploads%2Fvfyh1oH49bk2t2JidpDS%2Fimage.png?alt=media&#x26;token=c56b3fa9-9041-498f-83ba-991bc71e9624" alt=""><figcaption></figcaption></figure>

**Step 7.1.3:** Settings

Click the **Settings** option, the *Attribute Settings* window opens.

<figure><img src="https://2731380315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDMDmegqZUJFhJhF4JQG%2Fuploads%2FQbHP7u1QbMkPuedSPIp8%2Fimage.png?alt=media&#x26;token=6354c593-3127-49a2-89d6-5033d55e6809" alt=""><figcaption></figcaption></figure>

**Note:** All the attributes selected earlier will already be checked. If you want to make changes, you can update them here.

<figure><img src="https://2731380315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDMDmegqZUJFhJhF4JQG%2Fuploads%2FI6F1yJFZZJIQRz4arAyq%2Fimage.png?alt=media&#x26;token=5fabdae3-0f35-42a5-8822-6547afc04718" alt=""><figcaption></figcaption></figure>

Under **Transformers**, you will find the **URL Encode** checkbox.\
Check this box if you want the value to be automatically encoded for safe transmission in a URL.

<figure><img src="https://2731380315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDMDmegqZUJFhJhF4JQG%2Fuploads%2FKAW9Bl95b35Ad9gWngVi%2Fimage.png?alt=media&#x26;token=21eb2cb9-3244-4ddb-835b-1496934a8dbe" alt=""><figcaption></figcaption></figure>

**Step 7.1.4:**&#x44;ata Type Conversion

Click the **Data Type Conversion** drop-down.

The following options are available:

* No Conversion: Indicates that there is no conversion required for the data type.
* Convert to Boolean: Converts the input data to Boolean.
* Convert to Number: Converts the input data to a number.
* Convert to Array: Converts the input data to Array.
* Convert to Object Spread: Converts the JSON attributes under a parent level attribute to the root level attributes.

<figure><img src="https://2731380315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDMDmegqZUJFhJhF4JQG%2Fuploads%2FPfJZNNkJqyaFSSNLBmk0%2Fimage.png?alt=media&#x26;token=b847c772-b670-4e53-9af7-2250cdd6cbf4" alt=""><figcaption></figcaption></figure>

**Step 7.2:** Click **Choose Transformer.**

<figure><img src="https://2731380315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDMDmegqZUJFhJhF4JQG%2Fuploads%2FQtInBXniprNAeegRDhLo%2Fimage.png?alt=media&#x26;token=b6afa17f-94bb-489c-af6e-49e2cca10257" alt=""><figcaption></figcaption></figure>

**Step 7.2.1:** The **Select Transformer** panel opens on the **right side** of the screen.

At the top of the panel, there is a **Search Bar**.\
You can either:

* Use the search bar to quickly find a Transformer, or
* Browse through the list displayed below and select a Transformer manually.

<figure><img src="https://2731380315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDMDmegqZUJFhJhF4JQG%2Fuploads%2Fuh8imHxyKsYLosBzmUPU%2Fimage.png?alt=media&#x26;token=bad20321-d706-4540-b9b7-d6c72ada2faf" alt=""><figcaption></figcaption></figure>

**Step Result:** The selected Transformer is visible in the Value section.

<figure><img src="https://2731380315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDMDmegqZUJFhJhF4JQG%2Fuploads%2FMyfKoCQJygTrJdp5albY%2Fimage.png?alt=media&#x26;token=8d85a725-66f2-434e-9072-c4667f86d4cb" alt=""><figcaption></figcaption></figure>

**Note:** To cancel the selected Transformer, click the small **x icon** next to the selected item.

**Step 7.2.2:** Attribute Settings

Under the Settings section, you can configure the following options for each attribute:

* Mandatory: Select this checkbox to make the value mandatory.
* Fatal: Select this checkbox to stop the process if the value is missing or invalid.
* Ignore If Empty: Select this checkbox to skip this value during processing if it is not set.
* Hash (SHA256): Select this checkbox to securely convert the value into a SHA256 hash before processing.

<figure><img src="https://2731380315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDMDmegqZUJFhJhF4JQG%2Fuploads%2FkHTZCPxHxjhV7pxx8ZwD%2Fimage.png?alt=media&#x26;token=88e3825c-d65c-49ff-8f44-e4f340a4185a" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2731380315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDMDmegqZUJFhJhF4JQG%2Fuploads%2FbHkYlddzPb7FSM2e866r%2Fimage.png?alt=media&#x26;token=92ebb153-ab33-4ca7-a803-61bfb9323b76" alt=""><figcaption></figcaption></figure>

**Step 7.2.3:** Settings

Click the **Settings** option, the *Attribute Settings* window opens.

<figure><img src="https://2731380315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDMDmegqZUJFhJhF4JQG%2Fuploads%2FFFNsZxTiA1EHR4f6VbH7%2Fimage.png?alt=media&#x26;token=eb3e7a21-4699-4340-b33c-6f47ccd40872" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2731380315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDMDmegqZUJFhJhF4JQG%2Fuploads%2FPxH25Z0rLwE4nUTjcOf8%2Fimage.png?alt=media&#x26;token=982fb2d9-bf62-46cd-8869-3bd8d9aa2e85" alt=""><figcaption></figcaption></figure>

**Note:** All the attributes selected earlier will already be checked. If you want to make changes, you can update them here.

Under **Transformers**, you will find the **URL Encode** checkbox.\
Check this box if you want the value to be automatically encoded for safe transmission in a URL.

<figure><img src="https://2731380315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDMDmegqZUJFhJhF4JQG%2Fuploads%2FuzBKOzCiAjLbmaB0wY6W%2Fimage.png?alt=media&#x26;token=c22bc60d-c945-4195-91e4-1859181baf5b" alt=""><figcaption></figcaption></figure>

**Step 7.2.4:** Data Type Conversion

Click the **Data Type Conversion** drop-down.

The following options are available:

* No Conversion: Indicates that there is no conversion required for the data type.
* Convert to Boolean: Converts the input data to Boolean.
* Convert to Number: Converts the input data to a number.
* Convert to Array: Converts the input data to Array.
* Convert to Object Spread: Converts the JSON attributes under a parent level attribute to the root level attributes.

<figure><img src="https://2731380315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDMDmegqZUJFhJhF4JQG%2Fuploads%2FNtCkvzePyrAKWYqk7M26%2Fimage.png?alt=media&#x26;token=d7f370fb-8251-4c2c-91ab-93d88059623e" alt=""><figcaption></figcaption></figure>

**Step 8:** Click **Save** on the top right to save the new Provider (Browser).

![](https://ingest-lab.netlify.app/images/providersimages/cancelandsave.png)

**Note**: The page displays the following success message.

![](https://ingest-lab.netlify.app/images/providersimages/successmessage_provider.png)

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDMDmegqZUJFhJhF4JQG%2Fuploads%2FTUD76VdpKjI5ofS5NGOV%2FAdd%20a%20New%20Provider%20(Browser).mp4?alt=media&token=4aebdd7f-2347-4af8-9dd8-32530966bb02>" %}
