Add a New Provider (Server)
Last updated
Last updated
In server-side configuration, all the required information is collected directly from the server.
To add a new Provider on Ingest Labs, perform the following steps:
Step 1: Select Add Provider -> For Server on the top-right corner of the screen.
Step 2: The Provider Template panel opens on the right side. Select a template from the list or use the Search bar to find a specific one.
Step 3: Let's take an example of the Facebook Conversion API provider template.
Step 4: The Provider Details section is pre-filled automatically based on the selected provider.
Step 5: The Attributes section lists the Attributes for Data Elements and Transformers. This is an Optional section.
Step 5.1: Click Choose Data Element.
Step 5.1.1: The Select Data Element panel opens on the right side of the screen.
At the top of this panel, you will 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
Step Result: The selected Data Element is visible in the Value section.
Note: To cancel the selected Data Element, click the small x icon next to the selected item.
Step 5.2: Click Choose Transformer.
Step 5.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.
Step Result: The selected Transformer is visible in the Value section.
Note: To cancel the selected Transformer, click the small x icon next to the selected item.
Note: You can set the attribute to Mandatory, Ignore If Empty, Fatal, Hash (SHA256).
Mandatory: Mandatory is pre-selected. This value is mandatory.
Fatal: This value is mandatory.
Ignore If Empty: This may be ignored if the value is not set.
HASH (SHA256): The value is converted to HASH format.
Note: You can select multiple attribute options.
Step 6: Attribute Settings
Step 6.1: Click Settings.
The Attribute Settings window opens. The options you selected previously will already be selected here. If you want to make any changes, proceed to the following steps
Step 6.2: Click the Data Type Conversion drop-down menu.
Select the appropriate conversion type from the available options:
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.
Step 6.3: Under the Redaction section:
Two checkboxes are available:
Ignore Redaction: Prevents this attribute from being redacted, even if redaction is enabled.
Exclude from Request Body: Omits this attribute from the data sent in the request body.
Check the box if you want to apply either of these options.
Step 8: To add a new parameter from the Customer Information Parameters, for example, the subscription Id, perform the following steps:
a. In the JSON section, click Add Attribute.
b. Add the exact field name under User Data and configure it with a data element that returns a subscription Id.
Step 9: To modify the settings, click the Settings icon on the bottom-right corner of the screen.
Step 10: Enter the Attribute Settings and click Confirm to save the changes.
The following are the Data Type Conversions for the attributes.
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.
Step 11: To delete the attribute, click the Delete icon.
Step 12: Enter the fields in the HTTP Headers section. This section is optional.
Step 13: Enter the fields in the Connectors section and click Save to save the changes.
Note: Similarly, while adding any other provider template, for example, TikTok Event API Provider, click to create a Pixel Id and Access Token and proceed as given above.