Back to resources

Custom Data

Agency and custom data connection guide

For agencies, custom sites, and non-Woo systems that need to connect commerce and monitoring data into one model.

Commerce data connection

A source system can prepare orders, products, and customers with agreed fields before sending them to PteroAI reports and assistant analysis.

  • Keep source, external_id, site_id, and sync timestamps.
  • Mask sensitive fields at the source or return them only with permission.
  • Failed imports should enter a queue instead of blocking the UI request.

Monitoring data connection

Page visits and AI UA recognition can arrive through site connectors, middleware, Edge Workers, or custom log collectors.

  • The lightest service can still use active AI mention checks.
  • UA/IP/rDNS evidence must preserve source and confidence notes.
  • Custom sites should still render the same GEO Compass output model.