- 19 Dec 2024
- 11 Minutes to read
- DarkLight
How to Add TCPA Brand Name Labels
- Updated on 19 Dec 2024
- 11 Minutes to read
- DarkLight
Summary
Summary
The Brand Name labels must be included in your lead form to ensure that our script can capture both the brand names and the consent provided by the consumer for each brand. Below are code samples for each implementation type currently supported for brand names, whether implemented through a single-seller lead form or multi-seller lead forms.
Single Seller Lead Forms
For Single Seller Lead forms, a TCPA label that is specifically for the brand name is not necessary, only a TCPA label for the disclosure is required.
The TCPA disclosure label should be placed around the disclosure text and the disclosure text should contain the (i.e. ONE) brand name. Additionally, the input
element that the TCPA disclosure label is for should specify an id
or name
attribute that is equal to “leadid_tcpa_disclosure”. To support different user experiences, we offer four different options to implement a TCPA label on a single seller lead form. We have included some code examples below of each of the four implementation types we support (see also How to add TCPA Label Tag).
Single Seller Implementation Options:
Multi-Seller Lead Forms
For Multi-Seller lead forms, a TCPA label for the disclosure as well as for each brand name is required.
The TCPA disclosure label should be placed around the disclosure text and the disclosure text should NOT contain any brand names. Additionally, the input
element that the TCPA disclosure label is for should specify an id
(or name
) attribute that is equal to “leadid_tcpa_disclosure”. Although we do offer different options for implementing a TCPA label for a disclosure as documented here.
Recommendation
We recommend that the “No User Interaction” TCPA disclosure implementation option is always used for multi-seller lead forms. For this reason, every TCPA disclosure label in the code examples below have been implemented in this way.
Multi-Seller Implementation Options:
NOTE
The tag [BRAND NAME] in the code samples refers to the brand name in the lead form, which can be explicitly included in the disclosure text (exact match), or dynamically populated using a wildcard.
Single Seller - No User Interaction
This scenario applies when the lead form includes the brand names within the disclosure text, without the presence of checkboxes.
Option A
<label>
<input type="hidden" id="leadid_tcpa_disclosure"/>BY CLICKING "SUBMIT", I PROVIDE MY EXPRESS CONSENT AUTHORIZING [BRAND NAME] TO CONTACT ME BY EMAIL, TELEPHONE, AND/OR TEXT MESSAGES, DELIVERED VIA AUTOMATED TECHNOLOGY TO THE PHONE NUMBER(S) THAT I HAVE PROVIDED ABOVE.
</label>
Option B
<input type="hidden" id="leadid_tcpa_disclosure"/>
<label for="leadid_tcpa_disclosure">BY CLICKING "SUBMIT", I PROVIDE MY EXPRESS CONSENT AUTHORIZING [BRAND NAME] TO CONTACT ME BY EMAIL, TELEPHONE, AND/OR TEXT MESSAGES, DELIVERED VIA AUTOMATED TECHNOLOGY TO THE PHONE NUMBER(S) THAT I HAVE PROVIDED ABOVE.</label>
Single Seller - Checkbox
Option A
<label>
<input type="checkbox" id="leadid_tcpa_disclosure"/>BY CHECKING THIS BOX, I PROVIDE MY EXPRESS CONSENT AUTHORIZING [BRAND NAME] TO CONTACT ME BY EMAIL, TELEPHONE, AND/OR TEXT MESSAGES, DELIVERED VIA AUTOMATED TECHNOLOGY TO THE PHONE NUMBER(S) THAT I HAVE PROVIDED ABOVE.
</label>
Option B
<input type="checkbox" id="leadid_tcpa_disclosure"/>
<label for="leadid_tcpa_disclosure">BY CHECKING THIS BOX, I PROVIDE MY EXPRESS CONSENT AUTHORIZING [BRAND NAME] TO CONTACT ME BY EMAIL, TELEPHONE, AND/OR TEXT MESSAGES, DELIVERED VIA AUTOMATED TECHNOLOGY TO THE PHONE NUMBER(S) THAT I HAVE PROVIDED ABOVE.</label>
Single Seller - Radio Button
Option A
<label>
<input type="radio" id="leadid_tcpa_disclosure"/>BY SELECTING THIS RADIO BUTTON, I PROVIDE MY EXPRESS CONSENT AUTHORIZING [BRAND NAME] TO CONTACT ME BY EMAIL, TELEPHONE, AND/OR TEXT MESSAGES, DELIVERED VIA AUTOMATED TECHNOLOGY TO THE PHONE NUMBER(S) THAT I HAVE PROVIDED ABOVE.
</label>
Option B
<input type="radio" id="leadid_tcpa_disclosure"/>
<label for="leadid_tcpa_disclosure">BY SELECTING THIS RADIO BUTTON, I PROVIDE MY EXPRESS CONSENT AUTHORIZING [BRAND NAME] TO CONTACT ME BY EMAIL, TELEPHONE, AND/OR TEXT MESSAGES, DELIVERED VIA AUTOMATED TECHNOLOGY TO THE PHONE NUMBER(S) THAT I HAVE PROVIDED ABOVE.</label>
Single Seller - Yes/No Dropdown Menu
Option A
<label>BY SELECTING "YES" FROM THIS DROPDOWN MENU, I PROVIDE MY EXPRESS CONSENT AUTHORIZING [BRAND NAME] TO CONTACT ME BY EMAIL, TELEPHONE, AND/OR TEXT MESSAGES, DELIVERED VIA AUTOMATED TECHNOLOGY TO THE PHONE NUMBER(S) THAT I HAVE PROVIDED ABOVE.
<select id="leadid_tcpa_disclosure">
<option value="yes">Yes</option>
<option value="no">No</option>
</select>
</label>
Option B
<select id="leadid_tcpa_disclosure">
<option value="yes">Yes</option>
<option value="no">No</option>
</select>
<label for="leadid_tcpa_disclosure">BY SELECTING "YES" FROM THIS DROPDOWN MENU, I PROVIDE MY EXPRESS CONSENT AUTHORIZING [BRAND NAME] TO CONTACT ME BY EMAIL, TELEPHONE, AND/OR TEXT MESSAGES, DELIVERED VIA AUTOMATED TECHNOLOGY TO THE PHONE NUMBER(S) THAT I HAVE PROVIDED ABOVE.</label>
Multi-Seller Checkbox
Option A
<div>
<label>
<input type="hidden" id="leadid_tcpa_disclosure"/>BY CLICKING "SUBMIT", I PROVIDE MY EXPRESS CONSENT AUTHORIZING THE BRAND(S) I HAVE CHECKED BELOW TO CONTACT ME BY EMAIL, TELEPHONE, AND/OR TEXT MESSAGES, DELIVERED VIA AUTOMATED TECHNOLOGY TO THE PHONE NUMBER(S) THAT I HAVE PROVIDED ABOVE.
</label><br />
<label>
<input type="checkbox" id="leadid_tcpa_brandname_01"/>[BRAND NAME 1]
</label><br />
<label>
<input type="checkbox" id="leadid_tcpa_brandname_02"/>[BRAND NAME 2]
</label><br />
<label>
<input type="checkbox" id="leadid_tcpa_brandname_03"/>[BRAND NAME 3]
</label><br />
</div>
Option B
<div>
<input type="hidden" id="leadid_tcpa_disclosure"/>
<label for="leadid_tcpa_disclosure">BY CLICKING "SUBMIT", I PROVIDE MY EXPRESS CONSENT AUTHORIZING THE BRAND(S) I HAVE CHECKED BELOW TO CONTACT ME BY EMAIL, TELEPHONE, AND/OR TEXT MESSAGES, DELIVERED VIA AUTOMATED TECHNOLOGY TO THE PHONE NUMBER(S) THAT I HAVE PROVIDED ABOVE.</label><br />
<input type="checkbox" id="leadid_tcpa_brandname_01"/>
<label for="leadid_tcpa_brandname_1">[BRAND NAME 1]</label><br />
<input type="checkbox" id="leadid_tcpa_brandname_02"/>
<label for="leadid_tcpa_brandname_2">[BRAND NAME 2]</label><br />
<input type="checkbox" id="leadid_tcpa_brandname_03"/>
<label for="leadid_tcpa_brandname_3">[BRAND NAME 3]</label><br />
</div>
Multi-Seller Radio Button
Option A
<div>
<label>
<input type="hidden" id="leadid_tcpa_disclosure"/>BY CLICKING "SUBMIT", I PROVIDE MY EXPRESS CONSENT AUTHORIZING THE BRAND I HAVE SELECTED THE RADIO BUTTON FOR BELOW TO CONTACT ME BY EMAIL, TELEPHONE, AND/OR TEXT MESSAGES, DELIVERED VIA AUTOMATED TECHNOLOGY TO THE PHONE NUMBER(S) THAT I HAVE PROVIDED ABOVE.
</label>
<fieldset>
<legend>Select one:</legend>
<label>
<input type="radio" id="leadid_tcpa_brandname_01" name="brandname" value="brandname1"/>[BRAND NAME 1]
</label><br />
<label>
<input type="radio" id="leadid_tcpa_brandname_02" name="brandname" value="brandname2"/>[BRAND NAME 2]
</label><br />
<label>
<input type="radio" id="leadid_tcpa_brandname_03" name="brandname" value="brandname3"/>[BRAND NAME 3]
</label><br />
</fieldset>
</div>
Option B
<div>
<input type="hidden" id="leadid_tcpa_disclosure"/>
<label for="leadid_tcpa_disclosure">BY CLICKING "SUBMIT", I PROVIDE MY EXPRESS CONSENT AUTHORIZING THE BRAND I HAVE SELECTED THE RADIO BUTTON FOR BELOW TO CONTACT ME BY EMAIL, TELEPHONE, AND/OR TEXT MESSAGES, DELIVERED VIA AUTOMATED TECHNOLOGY TO THE PHONE NUMBER(S) THAT I HAVE PROVIDED ABOVE.</label><br /><br />
<fieldset>
<legend>Select one:</legend>
<input type="radio" id="leadid_tcpa_brandname_01" name="brandname" value="brandname1"/>
<label for="leadid_tcpa_brandname_1">[BRAND NAME 1]</label><br />
<input type="radio" id="leadid_tcpa_brandname_02" name="brandname" value="brandname2"/>
<label for="leadid_tcpa_brandname_2">[BRAND NAME 2]</label><br />
<input type="radio" id="leadid_tcpa_brandname_03" name="brandname" value="brandname3"/>
<label for="leadid_tcpa_brandname_3">[BRAND NAME 3]</label><br />
</fieldset>
</div>
Multi-Seller Yes/No Dropdown Menu
Option A
<div>
<label>
<input type="hidden" id="leadid_tcpa_disclosure"/>BY CLICKING "SUBMIT", I PROVIDE MY EXPRESS CONSENT AUTHORIZING THE BRAND(S) I HAVE SELECTED "YES" FOR BELOW TO CONTACT ME BY EMAIL, TELEPHONE, AND/OR TEXT MESSAGES, DELIVERED VIA AUTOMATED TECHNOLOGY TO THE PHONE NUMBER(S) THAT I HAVE PROVIDED ABOVE.
</label><br />
<label>[BRAND NAME 1]
<select id="leadid_tcpa_brandname_01">
<option value="no">No</option>
<option value="yes">Yes</option>
</select>
</label><br />
<label>[BRAND NAME 2]
<select id="leadid_tcpa_brandname_02">
<option value="no">No</option>
<option value="yes">Yes</option>
</select>
</label><br />
<label>[BRAND NAME 3]
<select id="leadid_tcpa_brandname_03">
<option value="no">No</option>
<option value="yes">Yes</option>
</select>
</label><br />
</div>
Option B
<div>
<input type="hidden" id="leadid_tcpa_disclosure"/>
<label for="leadid_tcpa_disclosure">BY CLICKING "SUBMIT", I PROVIDE MY EXPRESS CONSENT AUTHORIZING THE BRAND(S) I HAVE SELECTED "YES" FOR BELOW TO CONTACT ME BY EMAIL, TELEPHONE, AND/OR TEXT MESSAGES, DELIVERED VIA AUTOMATED TECHNOLOGY TO THE PHONE NUMBER(S) THAT I HAVE PROVIDED ABOVE.
</label><br />
<select id="leadid_tcpa_brandname_01">
<option value="no">No</option>
<option value="yes">Yes</option>
</select>
<label for="leadid_tcpa_brandname_01">[BRAND NAME 1]</label><br />
<select id="leadid_tcpa_brandname_02">
<option value="no">No</option>
<option value="yes">Yes</option>
</select>
<label for="leadid_tcpa_brandname_02">[BRAND NAME 2]</label><br />
<select id="leadid_tcpa_brandname_03">
<option value="no">No</option>
<option value="yes">Yes</option>
</select>
<label for="leadid_tcpa_brandname_03">[BRAND NAME 3]</label><br />
</div>
Multi-Seller Select All Checkbox Requirements
The “select all” checkbox must have an
id
(orname
) attribute that is equal to ”leadid_tcpa_brandnames_selectall”.The “select all” checkbox must have a
label
with text.Brand name labels must be implemented for checkboxes that are checked/unchecked when the “select all” checkbox is checked/unchecked.
When a “select all” checkbox is checked/unchecked, a synthetic
change
event must be created and dispatched to each brand name checkbox that was checked/unchecked as a result of the “select all” checkbox being checked/unchecked.
Synthetic Change Event in JavaScript Example:
// Get the "Select All" checkbox
const selectAllCheckbox = document.getElementById("leadid_tcpa_brandnames_selectall");
// Get all the checkboxes
const checkboxes = document.querySelectorAll('input[type="checkbox"][name="brandname"]');
// Add an event listener to the "Select All" checkbox
selectAllCheckbox.addEventListener('change', function() {
// Loop through all the checkboxes
checkboxes.forEach(checkbox => {
if (this.checked != checkbox.checked) {
checkbox.checked = this.checked;
checkbox.dispatchEvent(new Event('change'));
}
});
});
Example
<div>
<label>
<input type="hidden" id="leadid_tcpa_disclosure"/>BY CLICKING "SUBMIT", I PROVIDE MY EXPRESS CONSENT AUTHORIZING THE BRAND(S) THAT ARE CHECKED BELOW TO CONTACT ME BY EMAIL, TELEPHONE, AND/OR TEXT MESSAGES, DELIVERED VIA AUTOMATED TECHNOLOGY TO THE PHONE NUMBER(S) THAT I HAVE PROVIDED ABOVE.
</label><br />
<label>
<input type="checkbox" id="leadid_tcpa_brandnames_selectall"/>SELECT ALL
</label><br />
<label>
<input type="checkbox" id="leadid_tcpa_brandname_1" name="brandname"/>[BRAND NAME 1]
</label><br />
<label>
<input type="checkbox" id="leadid_tcpa_brandname_2" name="brandname"/>[BRAND NAME 2]
</label><br />
<label>
<input type="checkbox" id="leadid_tcpa_brandname_3" name="brandname"/>[BRAND NAME 3]
</label><br />
</div>
OR
<div>
<input type="hidden" id="leadid_tcpa_disclosure"/>
<label for="leadid_tcpa_disclosure">BY CLICKING "SUBMIT", I PROVIDE MY EXPRESS CONSENT AUTHORIZING THE BRAND(S) THAT ARE CHECKED BELOW TO CONTACT ME BY EMAIL, TELEPHONE, AND/OR TEXT MESSAGES, DELIVERED VIA AUTOMATED TECHNOLOGY TO THE PHONE NUMBER(S) THAT I HAVE PROVIDED ABOVE.</label><br />
<input type="checkbox" id="leadid_tcpa_brandnames_selectall"/>
<label for="leadid_tcpa_brandnames_selectall">SELECT ALL</label><br />
<input type="checkbox" id="leadid_tcpa_brandname_1" name="brandname"/>
<label for="leadid_tcpa_brandname_1">BRAND NAME 1</label><br />
<input type="checkbox" id="leadid_tcpa_brandname_2" name="brandname"/>
<label for="leadid_tcpa_brandname_2">BRAND NAME 2</label><br />
<input type="checkbox" id="leadid_tcpa_brandname_3" name="brandname"/>
<label for="leadid_tcpa_brandname_3">BRAND NAME 3</label><br />
</div>
For instructions on implementing Multiple TCPA Disclosures, please reference this article.
Brand Name Matching Logic
Letter Case
The case is NOT taken into account during the brand name matching logic.
Spacing
If the removal of a space turns two adjacent words into one word, a mismatch will result.
However, if two adjacent words remain separate, it does not matter how many spaces are between them.
Example
‘Brand Name A’ and ‘BrandNameA’ are seen as different by LeadiD and will result in a mismatch. ‘Brand te Name A’ and ‘Brand Name A’ are seen as identical by TCPA Guardian and will result in a match.
Punctuation
It is the same as Punctuation matching logic used for TCPA Disclosures
Publisher Compliance for TCPA Guardian Brand Names
Publisher Compliance for TCPA Guardian (Disclosures): https://marketing.verisk.com/docs/tcpa-publisher-compliance
How Can I Ensure My TCPA Brand Names Are Visible?
Utilizing this functionality will provide the results from the lead event relating to the brand names that are present in the lead form, including:
What action a consumer took to provide or revoke consent for the brand name in the lead form
The method used in the lead form to obtain consent from the consumer
The results of the test will elicit the default flag settings for the lead event Values (example below). This means they have no relation to the actual settings that a lead purchaser has in their own account settings. Therefore, you may ignore the colored flag results.
To initiate a Self Test follow these instructions:
Log into the Member Portal
Go to Campaigns > My LeadiDs
Enter the LeadiD token or click the token from the My LeadiDs list
Click Search
Click the orange “Test TCPA Brand Name Implementation” button from the upper right corner of the LeadiD’s detail page.
Enter the brand name you want to validate
Click the “Run Test” button next to the text block.
Review the results as noted below.
What the TCPA Self Test Does NOT do
Does not return TCPA Response flags for a specific client's settings or verify if the displayed brand names match the the approved brand names in the Audit profile.
Brand Name Data Responses
The following sections list the additional data points related to brand names (and associated values) received when employing TCPA Guardian (3rd Party) during a lead audit.
Brand Name | ||
---|---|---|
Data Point | Value | Description |
brand_name | {string_name} | Brand name specified in the audit profile. |
Brand Name Present | ||
---|---|---|
Data Point | Value | Description |
brand_name_present | 0 | The specified brand was not present in the lead form. |
1 | A matching brand name was present on the lead form. | |
brand_name_present_rule | # | Returned flag color for 'brand_name_present_rule': 1 - ' Green'; 2 - 'Yellow'; 3 - 'Red' |
Brand Name Consent | ||
---|---|---|
Data Point | Value | Description |
brand_name_consent | 0 | This value is returned when brand_name_present = 0, which is returned when a matching TCPA brand name was not present or visible on the lead form. |
1 | Brand Name Actively Accepted - The consumer selected the consent option for the brand name. | |
2 | Brand Name Passively Accepted - The consent option for the brand name was pre-selected for the consumer. | |
3 | Brand Name Passively Declined - The consent option for the brand name was not pre-selected for the consumer and the consumer did not select the brand name. | |
4 | Brand Name Actively Declined - The consumer removed a pre-selected consent option for the brand name. | |
5 | Brand Name Consent Disclosure - This value is returned when a matching TCPA brand name is present and visible in the disclosure and consent was given via disclosure consent. | |
6 | Brand Name Consent Unknown - The brand name is present and visible on the lead form, but consent could not be determined. This may be indicative of an incorrect implementation. | |
brand_name_consent_rule | # | Returned flag color for 'brand_name_consent_rule': 1 - ' Green'; 2 - 'Yellow'; 3 - 'Red' |
Brand Name Type | ||
---|---|---|
Data Point | Value | Description |
brand_name_type | 0 | Brand Name Not Present - This value is returned when brand_name_present = 0, which is returned when a matching TCPA brand name was not present or visible on the lead form. |
1 | Brand Name Checkbox | |
2 | Brand Name Radio | |
3 | Brand Name Yes/No Dropdown Menu | |
4 | Brand Name Select All Checkbox | |
5 | Brand Name Type Disclosure - This value is returned when brand_name_consent= 5, which is returned when a matching TCPA brand name is present and visible in the disclosure and consent was given via disclosure consent. | |
6 | Brand Name Type Unknown - This value is returned when brand_name_consent = 6, which is when a brand name is present and visible on the lead form, but consent could not be determined. This may be indicative of an incorrect implementation. | |
brand_name_type_rule | # | Returned flag color for 'brand_name_type_rule': 1 - ' Green'; 2 - 'Yellow'; 3 - 'Red' |