What does the following error on the $identify event mean? errAnonDistinctIdNonGUIDForm
Hi Lois, Please stand by as I search the Mixpanel knowledge base for an AI-powered answer. I normally take about 15 seconds or so. In case AI cannot answer your question, feel free to reach out to Mixpanel support at mixpanel.com/get-support. If you have follow-up questions for this thread, please tag me again with your question: @kapa.ai <follow-up question> đź‘‹
Feel free to ask a follow-up question once I've answered by mentioning me with @kapa.ai
The error errAnonDistinctIdNonGUIDForm
occurs when you're trying to use the $identify
event with an $anon_id
that doesn't conform to the UUID v4 format.According to the documentation, when using the Original ID Merge system, the $anon_id
parameter in the $identify
event must be in UUID v4 format: > "A distinct_id to merge with the anon_id must be UUID v4 format and not already merged to an identify event payload is only useful for projects using the Original ID Merge system; it has no functionality in other ID management systems." Create IdentityIf you're using Simplified ID Merge instead of Original ID Merge, you should be using the $device_id
and $user_id
properties rather than the $identify
event. You can check which ID management system your project is using in your project settings.To fix this error, ensure that the $anon_id
you're providing is in the UUID v4 format, which typically looks like: xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx
where x is any hexadecimal digit and y is one of 8, 9, A, or B.
kapa.ai is still learning and improving, please let me know how I did by reacting below.
ℹ️ Tip: Mention @kapa.ai in the thread for follow-ups or DM the app for 1-to-1 help.
Let me check the knowledge base for you again. One moment! 📚
The error errAnonDistinctIdAssignedAlready
occurs when you're trying to use the $identify
event with an $anon_id
that has already been merged with another $identified_id
in Mixpanel's Original ID Merge system.According to the documentation for the Create Identity endpoint, the $anon_id
must not only be in UUID v4 format but also "not already merged to an $identified_id" Create Identity.This error specifically means that the anonymous ID you're trying to merge has already been associated with a different user ID in a previous $identify
call. In the Original ID Merge system, once an anonymous ID has been merged with a user ID, it cannot be reassigned or merged with a different user ID.This is part of how Mixpanel's Original ID Merge system maintains identity clusters, where each anonymous ID can only belong to one identity cluster (limited to 500 distinct IDs per cluster) Migrating to Simplified ID Merge.If you're encountering this error, you may need to: 1. Use a different anonymous ID that hasn't been merged yet
2. Review your implementation to ensure you're not trying to reuse anonymous IDs across different users
3. Consider if your implementation might be calling $identify
multiple times with the same anonymous ID but different user IDsRemember that this error is specific to the Original ID Merge system. If you're using or considering switching to the Simplified ID Merge system, the approach to identity management is completely different and uses $device_id
and $user_id
properties instead of the $identify
event.
kapa.ai is still learning and improving, please let me know how I did by reacting below.
ℹ️ Tip: Mention @kapa.ai in the thread for follow-ups or DM the app for 1-to-1 help.