Manual / Custom Integration

Use this method when you send events or request recommendations without relying on the frontend SDK to own the integration flow. It covers direct APIs, backend and mobile applications, Pub/Sub, SFTP, and custom browser implementations.

Complete Item synchronization first. Catalog synchronization is shared setup and remains required whether recommendations are later integrated manually or through the frontend SDK.

Integration sequence

  1. Configure authentication for APIs that require OAuth.

  2. Implement manual event tracking before recommendation placements go live.

  3. Implement manual recommendation requests and attribution.

  4. Add specialized integrations such as batch recommendations, audience recommendations, or search when required.

  5. Use the Users API for supported user-record, identity, and privacy/deletion workflows when required.

  6. Validate the result using QA & Monitoring.

Events API calls are unauthenticated. Do not attach an OAuth Authorization header to event requests. Authentication is required only for the Froomle APIs documented as authenticated.

Shared contracts

Manual implementations must follow the same product contracts as SDK integrations: