Detailed guide on how Kadoa’s change detection algorithm classifies objects as changed, added, or removed
unchanged
- No notification sent (whitespace differences ignored)
changed
- ID key field matches, so it’s the same object with updates
Key Field Behavior:
isKeyField: true
id
, url
, link
, title
removed
+ added
(not changed
)changed
- Field match ratio exceeds threshold
Important Notes:
added
- Completely new object
removed
- Object no longer exists
Method | When Used | Matching Logic | Advantages |
---|---|---|---|
Key Fields | When isKeyField: true is set on monitored fields (optional) | ALL key fields must match exactly | More reliable, handles major content changes |
Traditional | When no key fields are configured (default) | >50% of fields must match | Works without configuration, good for similar objects |
changed
- ID key field matches despite 0% field name overlap
removed
+ added
- Different ID means different objects
changed
- 3 out of 5 fields match = 60% > 50%
removed
+ added
- 0% field match, treated as separate objects
isKeyField: true
on unique identifiers for more accurate matchingadded
/removed
instead of changed
Solutions:
changed
Solutions: