Templates is where the Administrator or Manager combines the Patterns and Field Sets to configure the user’s Submission Table. Administrators will also govern the URL output, link validation requirements, and input and output configurations.
For Administrators that need additional information about configuring the prerequisite Template Elements, read the Patterns Overview, Pick Lists Overview, and Field Sets Overview documents.
Creating a Template for Adobe Analytics
- Click Settings on the Navigation menu.
- Click Templates in the Templates Sub-Navigation menu.
The Templates page displays.
- Click
to create a New Template.
The Edit New Template menu displays.
There are 3 steps to create a new submission template:
Step 1 - Setup
Step 2 - Define and Govern
Step 3 - Connect
Step 1 - Setup
- Enter the Template Name of the template (required).
- Enter the Description (optional). It is recommended to enter a description to make it easier to determine the use of the template.
- Select the Folder (or create a new folder) this template is assigned to. Templates within a Folder are immediately available to users of a Group if that Folder is assigned to the Group.
If you create a new Folder, be sure to associate it to the Group so users have access to it.
- Check the box Require Submission Name if users must assign a submission name before being able to submit the data.
You must create a Template Name and Folder before you can save the template.
Step 2- Define and Govern
Define and govern Fields, Patterns, and Link.
Define and Govern Fields
- Click + Select Fields.
- Check the box to select all the fields in the Field Set or click the drop down menu to select individual fields.
Use the Search field to find a specific field name across all Field Sets.
- Click Select Fields. The fields selected are added to the end of the schema. Fields within a Field Set share the same color in the second column for easy reference.
Add a field into an existing Field Set, or create a new Field Set in the +Add Fields menu. If you are using a Target to send data to Adobe, remember to go into the Field Set and assign the Target Mapping.
- Reorder the fields as they should appear in the user's Submission Table.
- Manual: Drag the field into the order you desire.
- Custom: Reorder Mode
allows the administrator to easily order the fields (reorder menu options left to right).
- Move the field to the first position
- Move the field up one position
- Move the field down one position
- Move the field to the last position
- Select the field number to reassign the field order, field number is on the right
- All fields default to Visible. Uncheck the box if you want the field to be hidden from the Submission Table view.
Hide any fields the user does not need to see, such as dependent variables and fields, constant values, autofilled values to reduce the number of columns they do not need to enter a value in.
- If the Required Field governance has not been assigned at the Field Set level, you can check the Required box per field.
- Hover over
to view the Edit options, and click
to remove the field from the template.
- If the Field utilizes a drill down list and needs to be defaulted at the template level (e.g. Global Region needs to be defaulted to “Global North”), hover over
to view the Edit options, and click
and use the drop down menu to Select Filter Value.
- Hover over the Field Type to view the Field Type details. If the field is a List, the list name will be visible. If the field is a drill list and the Filter Value has been set, the list name and default value will be visible.
Define and Govern Patterns
- Click + Select Pattern.
- Check the box to select the Patterns needed on this template.
- Click Select Patterns.
The Parent Pattern field (reflects the final Pattern in the user's Submission Table view) and the Pattern’s Element fields appear automatically at the end of the schema.
The Parent Pattern and Element fields share the same color in the second column for easy reference.
- Define the Pattern to send to Adobe as the Key/Trackingcode. Hover over
to view the Edit options, and click
to Associate Field Set data to the Pattern. This step indicates to Claravine that the output of the Pattern (e.g. SOC_FB_E25F4MOYGL|34) is the Key (aka tracking code, campaign ID, campaign code, CID, etc.) and the values entered in the fields of the Associated Field Set will be sent to Adobe as metadata classifications.
Without this association, no metadata will be sent to Adobe and the classifications will be unspecified.
- If the Pattern Element is a variable it must be defined in the template. The errors icon will indicate a warning that this field must be governed. Hover over
to view the Edit options, and click
to define and govern the Pattern Element variable:
- List: Select the List Name and Column.
- Autofill: Add the Field from the Field Set to autofill from (see Define and Govern Fields). Transform to autofill values into all capitals, all lowercase, remove spaces, or replace spaces.
- Constant: Enter the value.
- Text: Select the Type as Text and add governance.
See more details in Template and Schema Tips help section.
- Click the error icon
to see all errors and warnings on the template. Errors need to be fixed before the template can be saved. Warnings will not block saving the template but should be reviewed to confirm the configuration is accurate.
Define and Govern Link
To add and define a template-generated link:
- Click + Add Link Field.
The Link field is automatically added to the end of the schema.
-
Hover over
to view the Edit options, and click
to edit the Link requirements and parameters.
The Edit Link menu displays.
Link Definition

-
Rename the Link column header as seen in the user's Submission Table (optional).
- Autofill the Link column from another field in the schema (optional). This is helpful if the user is entering a Vanity URL field and does not want to also enter the URL in the Link column.
Customize Link Parameters
- Customize the Link parameters to generate the URL as desired.
- Enter the landing page parameter as designated.
- Select the Pattern or other field to populate with this parameter.
- Check the box to URL Encode if you want the final URL to be UTF encoded. Encoding the URL will convert any special characters to encoded characters ( colon : becomes %3A, spaces become %20).
- Click +Add Parameters to add as many parameters as needed for the URL requirements.
- Confirm the final URL is correct in the Current Configuration line.
Allowed Domains
- Input the domain and click Enter after each domain to restrict the domains that are allowed for this template. Leaving this field open allows any domain to be used (optional).
Link Validations
- Select which Link Validations must be checked when the user enters a domain in the Link column of the user's Submission Table. All Link Validations are defaulted off. Click the box to define the validation checks.
- General Website Validation: Validated general website functionality, the page exists, the Link+Link Parameters will take the consumer to the final destination correctly, tags are firing correctly.
- Adobe Analytics: Validate Adobe Analytics pixels, report suites, and reports are tagged correctly on the landing page. These validations confirm the Link is firing and sending data to the same report suite and report which the Pattern and metadata classifications are sending to.
- Verify Adobe Pixel: Verify that the links submitted by users fire an Adobe Analytics Pixel. This validation ensures that URL parameters trigger the correct Pixels on the page.
- Verify Report Suite>Inherit through a Target: Select a Claravine Target to specify which report suite to check for (rsid). Report is defaulted to the report specified in the Target.
- Verify Report Suite>Explore my Report Suites: Select the Connected Adobe Account and select a report suite to check. Select the report.
- Verify Report Suite>Input by Hand: Enter the rsid manually to check. Enter the eVar manually.
- General Website Validation: Validated general website functionality, the page exists, the Link+Link Parameters will take the consumer to the final destination correctly, tags are firing correctly.
-
- Google Analytics: Validate Google Analytics pixels and Property IDs are tagged correctly on the landing page. These validations confirm the Link is firing and sending data to the same Property that the Pattern and metadata classifications are sending to.
- Verify Google Pixel: Verify that the links submitted by users fire a Google Analytics Pixel. This validation ensures that URL parameters trigger the correct Pixels on the page.
- Verify Property ID>Inherit through a Target: Select a Claravine Target to specify which Property ID to check.
- Verify Property ID>Explore my Properties: Select the Connected Google Analytics Account and select a Property ID to check.
- Verify Property ID>Input by Hand: Enter the Property ID manually to check.
- Google Analytics: Validate Google Analytics pixels and Property IDs are tagged correctly on the landing page. These validations confirm the Link is firing and sending data to the same Property that the Pattern and metadata classifications are sending to.
-
- Add multiple Validation configurations to check for several rsid/eVars or Google Property IDs.
- Add multiple Validation configurations to check for several rsid/eVars or Google Property IDs.
- Click Done.
Step 3- Connect
Connect inbound and outbound integrations for this template.
Inbound Integrations
Map metadata from a Connected Account to fields in this template as an inbound submission. Use the Inbound Integration to map the inbound data fields to the template fields, when new data is found, Claravine will bring that data in as a new submission. Completed inbound data will be found in Submission, inbound data with errors will be found in Pending as Paused-With Errors submissions. Request configuration from your Customer Success Manager.
- Click
to add a new inbound integration.
- Select the Connected Account to map to design the outbound file format to apply to submission data out of Claravine.
- Follow the instructions for each inbound integration type:
Outbound Integrations
Design the outbound file exports, emails, and other outbound metadata from this template.
-
- Click
to add a new outbound integration.
- Select the Connected Account to map to design the outbound file format to apply to submission data out of Claravine.
- Follow the instructions for each inbound integration type:
- SFTP
- AWS S3
- Google Analytics
- Google Cloud Storage
- Box
- Azure Blob
- Facebook Ads Manager
- Google Campaign Manager
- Bitly
- QR Code Monkey
- Click Save to save the template.
- Click
Template and Schema Tips
TOOL TIP
The Description field will show as a tool tip in the user's Submission Table.
ERROR and WARNING
Click on the errors icon at the top of the template schema to view the errors and warnings.
The template cannot be saved with any errors or bad configuration. Errors include a variable Pattern Element that has not been defined, a field used in a concatenation that isn’t included in the schema, etc.
Warnings notify you if there is a potential issue such as not all columns are used from a list.
PREVIEW
Preview how this template will look in the user's Submission Table without having to navigate away from the template page. Preview is only available after a Template Name and Folder have been assigned.
ADD FIELDS and FIELD SET
Add a Field to a Field Set from the Template by clicking . Remember to add Target Mapping on the Field Set if applicable.
Add a Field Set from the Template by clicking +Add Field Set. Find the Field Set and click to add Fields to the Field Set. Remember to add Target Mapping on the Field Set if applicable.
REORDER MODE
Reorder the fields how you want them to appear in user's Submission Table seen by the user:
- Manual: Drag the field into the order you desire.
- Custom: Reorder Mode
allows the administrator to easily order the fields (left to right).
- Move the field to the first position
- Move the field up one position
- Move the field down one position
- Move the field to the last position
- Select the field number to reassign the field order, field number is on the right
VISIBLE
All fields default to Visible. Uncheck the box if you want the field to be hidden from the Submission Table view.
Hide any fields the user does not need to see, such as dependent variables and fields, constant values, autofilled values to reduce the number of columns they do not need to enter a value in.
REQUIRED
If the Required Field governance has not been assigned at the Field Set level, you can check the Required box per field.
DELETE
Hover over to view the Edit options, and click
to delete the field.
FIELD TYPE DETAILS
Hover over the Field Type to view the Field Type details. If the field is a List, the list name will be visible. If the field is a drill list and the Filter Value has been set, the list name and default value will be visible.
PATTERN ELEMENT TYPES
Use the following table to define the Pattern Element variable field type:
Pattern Element Type | Description |
List | Pick lists allow a defined list of allowable entries the user can select from. Select the Pick List from the drop-down menu either by scrolling or begin typing the Pick List name. You can also select "Create New List".![]() ![]() ![]() ![]() ![]() |
Auto Fill | Select the field you want to automatically duplicate. TRANSFORM Options in this section auto-transform entries from the autofilled field.
|
Constant | Specify a constant value that you want to always be populated in this template in the Submission Table. |
Text | Text fields allow users to manually enter values in the user's Submission Table. Specify the following parameters for text fields:
Options in this section auto-transform entries the user enters to gain consistent entries in open text fields.
Define the minimum and maximum length of characters a user is allowed to enter in open text fields. If the field is optional, set the minimum length to 0. If the length of characters is an exact number, set the minimum and maximum to the same number. |
Comments
0 comments
Article is closed for comments.