Overview
With the introduction of Soft Check in Convertr Connect, lead troubleshooting ownership has shifted.
- Before: Receiving enterprise investigated failed leads
- Now: Sending enterprise (lead provider) initiates the troubleshooting process and must provide full lead details. This allows the partners to be more proactive in the troubleshooting process.
Convertr Connect: Soft Check - New Troubleshooting Workflow
| Step | Workflow | What Happens | Owner | |
| 1 |
Lead is flagged - Soft check fails |
A Lead Flag is generated. It includes the Soft Check reason, Job ID, and Error Label. The lead is NOT delivered. The receiving enterprise cannot see the lead data. |
QA Flags | |
| 2 | Capture error details |
In Convertr, copy: Lead Hash, Job ID and Lead Flag (Soft Check error message & label) |
Sending Enterprise - Lead Provider/Partner | |
| 3 | Review QuickSight Dashboard |
Use the Quicksight dashboard to:
|
Sending Enterprise - Lead Provider/Partner | |
| 4 | Validate against campaign requirements |
Compare what was submitted vs. what the receiving enterprise expects. Check for:
|
Sending Enterprise - Lead Provider/Partner | |
| 5 | Send troubleshooting details to receiving Enterprise |
Proactively reach out and include:
*Provide full context upfront - do not ask the receiving enterprise to look up the lead.* |
Sending Enterprise - Lead Provider/Partner | |
| 6 | Receiving Enterprise reviews and validates |
Using the Job ID, they will:
|
Brand or Agency Platform Contact | |
| 7 | Resolution |
Configuration Issue - Receiving Enterprise updates campaign logic if needed. |
Data Issue - Sending Enterprise correct lead submission values. |
Brand or Agency Platform Contact |
| Sending Enterprise - Lead Provider/Partner | ||||
| 8 | Retest & Confirm |
Resubmit the lead (if applicable) Confirm successful delivery. Monitor for repeat failures. |
Sending Enterprise - Lead Provider/Partner | |
What Happens When a Lead Fails Soft Check
- A Lead Flag is generated in the platform
- The flag includes:
- Soft Check failure reason
- Job ID
- Error label / validation message
- The lead is not delivered to the receiving platform
- The receiving enterprise has no visibility into the lead
- The sending enterprise must initiate and drive resolution
Workflow Process:
1. Identify the Failed Lead
- Locate the lead in Convertr
- Confirm it was flagged due to Soft Check
2. Capture Error Details
Copy the following directly from the platform using the copy icon on the top right of the dialogue box:
- Lead Hash
- Job ID
- Lead Flag (error message + reason)
*If Step 2 produces results, proceed to Step 3.
3. Review QuickSight Dashboard (If necessary) (Refreshed every hour)
It is the Partner’s responsibility to validate against expected campaign logic before reaching out to the customer.
Use the QuickSight dashboard to:
- Identify patterns in failures, rather than looking at leads individually.
- Understand why leads are being rejected
4. Validate Against Campaign Requirements
Compare:
- What was submitted in the lead
vs. - What the receiving enterprise expects
Look for:
- Field mismatches
- Formatting issues
- Missing required values
- Validation rule conflicts
- Value Transforms
- If Value Transforms are the only reason for the failures, push the lead through as best practice.
- How to Reprocess a Lead
5. Send Troubleshooting Details to Receiving Enterprise
The sending enterprise must proactively reach out and include:
Required in communication:
- Lead Hash
- Job ID
- Full Lead Flag / Error Message
- Supporting details (QuickSight export or notes from QA flags)
Note: This replaces the old “Can you check this lead?” approach — the expectation is fully informed troubleshooting context is provided upfront
6. Brand or Agency Main Contact Review
Using the Job ID, the receiving enterprise will:
- Confirm:
- Correct setup, or
- If the values provided indicated in the lead flag details are a mismatch against what was submitted.
- Review job configuration
- Compare against expected campaign logic
7. Resolution Path
Two possible outcomes:
A. Configuration Issue
- Receiving enterprise updates campaign logic if needed
B. Data Issue
- Sending enterprise corrects lead submission values
C. If both A & B are confirmed, please open a support ticket.
8. Retest Lead Flow
- Resubmit leads
- Convertr best practice is to resubmit 1-2 leads, limiting reprocessing
- Confirm successful delivery
-
Monitor for repeat failures as needed
Support Is Available - Convertr Support Team can assist with troubleshooting, validate configurations, and provide guidance. Engage support if the root cause is unclear or if the issue persists.