Bidyard Logo
DashboardSign In

BidYard Consent Script

Automatically capture consent evidence from your lead forms

Quick Start

1

Get Your Client Key

  1. Log in to your BidYard Dashboard
  2. Navigate to Organization → Settings tab
  3. Under "API Keys", find or create a Client Key
  4. Copy your Client Key (it looks like: ck_abc123...)
2

Add the Script to Your Page

Add this single script tag to your form page's <head> or before the closing </body> tag:

<script src="https://cdn.bidyard.dev/js/form.js" 
        data-client-key="YOUR_CLIENT_KEY_HERE"></script>

Replace YOUR_CLIENT_KEY_HERE with your actual Client Key.

3

Test It

That's it! The script will automatically:

  • Detect forms on your page
  • Track user interactions with consent checkboxes
  • Capture consent evidence
  • Store evidence with your lead submissions

Complete Example

<!DOCTYPE html>
<html>
<head>
  <title>Lead Form</title>
  <!-- BidYard Consent Script -->
  <script src="https://cdn.bidyard.dev/js/form.js" 
          data-client-key="ck_your_key_here"></script>
</head>
<body>
  <form id="leadForm" action="/submit" method="POST">
    <input type="text" name="firstName" placeholder="First Name" required>
    <input type="text" name="lastName" placeholder="Last Name" required>
    <input type="email" name="email" placeholder="Email" required>
    <input type="tel" name="phone" placeholder="Phone" required>
    
    <!-- Consent Checkbox -->
    <label>
      <input type="checkbox" name="consent" required>
      By checking this box, I consent to receive marketing communications 
      via phone, email, or text at the contact information provided. 
      I understand that consent is not required to purchase services.
    </label>
    
    <div style="margin-top: 10px; font-size: 12px;">
      <a href="/privacy-policy" target="_blank">Privacy Policy</a> | 
      <a href="/terms-of-service" target="_blank">Terms of Service</a>
    </div>
    
    <button type="submit">Get Your Free Quote</button>
  </form>
</body>
</html>

What Gets Captured

The BidYard Consent Script automatically captures:

Consent Status

Checkbox state (checked/unchecked)

Timestamp

When consent was given

IP Address

User's IP for verification

User Agent

Browser/device information

Page URL

Where consent was given

User Interactions

Clicks and checkbox interactions

Supported Checkbox Names

The script automatically detects checkboxes with these common names:

consenttcpa_consentmarketing_consentagreeToTermsacceptTermsagree

Custom Configuration

For custom checkbox names, use the data-consent-selector attribute:

<script src="https://cdn.bidyard.dev/js/form.js" 
        data-client-key="ck_your_key"
        data-consent-selector="input[name='custom_name']"></script>

Verification

Check Browser Console

  1. Open Developer Tools (F12)
  2. Look for: [BidYard] Consent script loaded successfully

Check Dashboard

  1. Dashboard → Sources → Your Source → Consent tab
  2. Status should show "Script Active"

Alternative: Legacy Consent Fields

If you cannot install the BidYard Consent Script, you can still send consent evidence using legacy third-party providers:

TrustedForm

{
  "firstName": "John",
  "lastName": "Doe",
  "email": "[email protected]",
  "xxTrustedFormCertUrl": "https://cert.trustedform.com/..."
}

Jornaya LeadID

{
  "firstName": "John",
  "lastName": "Doe",
  "email": "[email protected]",
  "leadid_token": "...",
  "universal_leadid": "..."
}

Note: These legacy methods provide basic compliance but lack the enhanced security and real-time verification of the BidYard Consent Script.

Need Help?