Troubleshooting affiliate captures
This guide answers common questions about working with affiliate partners and publishers in Driftrock, and explains how to resolve the most common issues.
Setting up
Do I need a separate Affiliate Capture for each partner?
No. One Affiliate Capture can receive leads from several partners. Add each partner under Affiliates in the Capture, and Driftrock assigns each one a unique Affiliate ID.
Do I need a separate API key for each partner?
Yes. Create one API key per partner in Settings, then API Settings. Separate keys let you see which partner sent each lead and revoke one partner's access without affecting the others.
Who can create API keys?
Only users with Admin permission can see the API Settings page and create or revoke API keys. If you cannot see API Settings, ask an Admin in your account to update your permissions.
Can I add a Lead Type to my Affiliate Capture after it has been created?
No. A Lead Type can only be selected when a Capture is created. To use a Lead Type with an existing source, create a new Capture with the Lead Type selected and stop using the old one.
Can I set up a Capture before the partner is ready to send leads?
Yes. You can complete the Capture setup, including your fields, partners, rules and Destinations, before the partner sends their first lead.
Partners and credentials
What do I need to send a partner?
Each partner needs their API endpoint URL, their API key, their Affiliate ID, the example payload and your acceptance criteria. See Sharing instructions with an affiliate partner for details.
How should I share an API key?
Treat API keys like passwords. Share them using a password-protected file, a password-sharing service or a time-limited link, not by plain email or internal chat.
How do I stop a partner sending leads?
Go to Security, then API Keys, find the partner's key and click Revoke. Requests using that key are no longer accepted. Other partners are not affected.
A partner's API key may have been exposed. What should I do?
Revoke the key in API Keys, create a new key for the partner and share it with them securely.
Leads not arriving
A partner says they are sending leads, but none are appearing. What should I check?
Check the partner is using the correct API key, and that the key has not been revoked.
Check the partner is sending to the correct API endpoint URL and using their own Affiliate ID.
Check that the Capture is active and not paused in Your Captures.
Open the Capture and check the Rejected tab. The leads may be arriving but being rejected.
If the partner sends through the API, ask them for the response Driftrock returned. A 422 response includes a message explaining the problem.
Leads are arriving in Driftrock but not reaching my CRM. Why?
Leads that are rejected are not sent to your Destinations. Check the Rejected tab first. If the leads are accepted but still not in your CRM, check the Failed tab in Your Captures, which shows leads that could not be delivered to a Destination. This is usually caused by a CRM issue, such as a missing mandatory CRM field or expired CRM credentials. Once the issue is fixed, use Retry to resend the leads.
Rejected leads
Why are a partner's leads being rejected?
Open the Affiliate Capture in Your Captures and go to the Rejected tab. It shows each rejected lead and the reason. Common reasons are:
a field marked as Required is missing
the lead failed one of your Acceptance Rules
the lead is a duplicate of one already received within your lookback period
a value was not recognised, such as a vehicle model name that does not match your vehicle list
The partner gets a 422 error. What does it mean?
A 422 response means the request was missing a required field or included a value Driftrock does not accept. The response includes a message naming the value and field. For example, a vehicle model name that does not match your vehicle list returns an error stating that the value is not valid for the vehicle field.
A partner describes vehicle models differently from us. How do we fix rejections?
Add the partner's model names as aliases in your Vehicle Database, so Driftrock matches them to the correct model. Alternatively, ask the partner to use your model names exactly.
A partner's acceptance rate is low. Where do I start?
Check the Rejected tab to see which rule leads fail most often. If most rejections share one reason, it usually points to a data issue on the partner's side, or to a rule that is stricter than intended. Share the reasons with the partner and review your rules.
I changed my Acceptance Rules. Do they apply to earlier leads?
No. Acceptance Rules apply only to leads that arrive after the change is saved.
What does Incomplete mean?
If the Capture uses a Lead Type, leads missing any of the Lead Type's required fields are marked Incomplete. Find them in the Incomplete tab in Your Captures, then compare the Capture's field mapping with the Lead Type's required fields.
Duplicates
Why was a lead marked as a duplicate?
Driftrock checks whether the same email address has already been seen within your lookback period, across all your lead sources. On Affiliate Captures, you can also set custom deduplication rules, such as matching on email and vehicle model over 30 days.
Our test leads are being rejected as duplicates. Why?
If test leads reuse the same email address, later ones are treated as duplicates of earlier ones. Use a new email address for each test lead.
Testing
Do test leads reach my CRM?
Yes. Driftrock processes test leads in the same way as live leads. They are sent to your Destinations and trigger any automations on the Capture, unless you set the Capture up in the Testing automation group of a Lead Type.
How do I check a test lead worked?
Open the Capture in Your Captures and confirm the lead has arrived, with the correct fields and the partner's name as the Source or Campaign value. Then check it arrived in your CRM. If it does not appear, check the Rejected tab.
Reporting
How do I see how each partner is performing?
Each partner's leads carry their name as the Source or Campaign value. Use Reporting to compare sources, or build a dashboard with charts grouped by source. See Measuring affiliate partner performance for details.
Why do my lead counts differ between charts?
Most chart types show total counts, which include duplicates. Only Table charts can show unique counts, which remove duplicates. Check which count each chart uses.
Why can I not group a chart by source?
To group a Timeseries or Table chart by a field, that field must be present on every lead included in the chart. Filter the chart to Captures where the field is always populated.
Can a partner see their own results?
Yes. You can share a dashboard with a partner using a link and a password. Build a separate dashboard for each partner, filtered to their leads only. See Creating and sharing dashboards for affiliate partners.
For partners sending from their own Driftrock account
The brand's Capture does not appear in my list. What should I check?
Check with the brand that they have shared access to their Capture with your account. Only active Captures appear in the list.
Leads are arriving at the brand with unmapped fields. Why?
The brand may have changed their fields after you set up your mapping. Fetch the brand's fields again and update your mapping.
