Skip to main content

ConversionStatus

The outcome of a trackConversion call.

None of these is an error. An ineligible or consent-withheld caller is a normal response carrying a status — surfacing it as a GraphQL error would put a red toast in the console for a user who simply declined advertising cookies.

enum ConversionStatus {
  RECORDED
  ALREADY_RECORDED
  NOT_ELIGIBLE
  CONSENT_WITHHELD
}

Values​

ConversionStatus.RECORDED​

This call minted the outbox rows — one per configured provider.

Fire the browser twin with eventId when it is non-null. It is NULL when no configured provider has a browser twin: only Meta's Pixel deduplicates against a server-supplied id, so a GA4-only deployment records the conversion and has no id for the page to fire.

ConversionStatus.ALREADY_RECORDED​

Rows for this subject and event already existed; eventId, when non-null, is the WINNER's id, not this call's. Firing the browser twin again is harmless — the vendor deduplicates on the shared id — but there is nothing new to report.

ConversionStatus.NOT_ELIGIBLE​

The subject did not qualify (pre-cutoff account, non-console client, invited teammate, staff address). No row was written and eventId is null.

The caller has not granted advertising consent. No row was written and eventId is null.

Member Of​

TrackConversionResponse object