Quick Checklist
User ID Matching
Attribution requires the same user identifier in both the ad interaction and the purchase.Common Mistakes
Wrong: Different IDs for same userAttribution Windows
Attribution windows are configurable per ad format to match how each format influences customer behavior:
Important: A purchase outside the configured window will not attribute to the ad interaction.
Need different windows? Contact support to configure custom attribution windows for your ad formats.
For more on attribution concepts, see our Glossary.
Halo Attribution
Halo attribution credits a vendor when a user clicks on Product A but purchases Product B from the same vendor. Requirements:vendorIdmust be included in the purchase event- Products must belong to the same vendor
- Within attribution window
Debugging Steps
-
Verify events are arriving
- Check dashboard: Events → Recent Events
- Or query:
GET /public/v1/reporting-service/interactions
-
Check for matching user IDs
- Export click events and purchase events
- Compare
userIdoropaqueUserIdfields
-
Verify timing
- Compare
occurredAttimestamps - Purchase must be within window of click/impression
- Compare
-
Check vendor match
- For halo: verify
vendorIdis sent with purchase - For direct: verify
productIdis in the campaign
- For halo: verify
Still Not Working?
If you’ve verified all the above and attribution still isn’t working:- Export a sample of unattributed purchases
- Export clicks from the same time period
- Contact support with both exports and we’ll trace the specific events