List conversion events (incremental sync)

use Fetchski\AttractCmsLaravel\Facades\Attract;

$conversionEventPage = Attract::conversionEvents()->listConversionEvents();

{
  "events": [
    {
      "eventId": "b8f2c1de-4f5a-4c1e-9a53-0d6f2b7c1e9a",
      "conversion": {
        "id": "ckq1w2e3r4t5y6u7i8o9p0",
        "key": "quote-request",
        "title": "Quote request"
      },
      "trigger": {
        "type": "form",
        "ref": "ckformid123"
      },
      "source": "browser",
      "occurredAt": "2026-09-21T15:04:05.000Z",
      "recordedAt": "2026-09-21T15:04:05.412Z",
      "updatedAt": "2026-09-21T15:04:07.020Z",
      "page": {
        "url": "https://example.com/contact?gclid=Cj0KCQjw",
        "path": "/contact",
        "referrer": "https://www.google.com"
      },
      "visitorId": "0b8e6a4c-8d2f-4b6e-9a1c-3f5d7e9b1a2c",
      "attribution": {
        "firstTouch": {
          "at": "2026-09-20T09:12:00.000Z",
          "path": "/",
          "landingUrl": "https://example.com/?gclid=Cj0KCQjw",
          "referrerOrigin": "https://www.google.com",
          "adPlatforms": [
            "google"
          ],
          "campaign": {
            "utm_source": "google",
            "utm_campaign": "spring-sale"
          },
          "clickIds": {
            "gclid": "Cj0KCQjw"
          }
        },
        "adPlatforms": [
          "google"
        ],
        "campaign": {
          "utm_source": "google",
          "utm_campaign": "spring-sale"
        },
        "clickIds": {
          "gclid": "Cj0KCQjw"
        },
        "browserIds": {
          "_gcl_au": "1.1.1234567890.1790000000"
        },
        "provenance": {
          "gclid": "ourRecord",
          "_gcl_au": "platformCookie"
        }
      },
      "consent": {
        "categories": {
          "analytics": true,
          "marketing": true
        },
        "mode": "lenient",
        "country": "US",
        "gpc": false,
        "policyVersion": 7
      },
      "value": 50,
      "currency": "USD",
      "userData": {
        "emailSha256": "b4c9a289323b21a01c3e940f150eb9b8c542587f1abfd8f0e1cc1ffc5e475514",
        "phoneSha256": "b4c9a289323b21a01c3e940f150eb9b8c542587f1abfd8f0e1cc1ffc5e475514",
        "phoneDigitsSha256": "b4c9a289323b21a01c3e940f150eb9b8c542587f1abfd8f0e1cc1ffc5e475514"
      },
      "submissionId": "ck9submission1",
      "delivery": {
        "google-ads": {
          "browser": "sent",
          "server": {
            "status": "sent",
            "attempts": 1,
            "sentAt": "2026-09-21T15:04:07.001Z",
            "lastAttemptAt": "2026-09-21T15:04:07.001Z"
          }
        },
        "ga4": {
          "browser": "sent",
          "server": {
            "status": "n/a",
            "attempts": 0
          }
        }
      },
      "status": "active",
      "adjustments": []
    }
  ],
  "nextCursor": "eyJ1IjoiMjAyNi0wOS0yMVQxNTowNDowNy4wMjBaIiwiZSI6ImI4ZjJjMWRlLTRmNWEtNGMxZS05YTUzLTBkNmYyYjdjMWU5YSJ9",
  "hasMore": false
}

use Fetchski\AttractCmsLaravel\Facades\Attract;

$conversionEventPage = Attract::conversionEvents()->listConversionEvents();

{
  "events": [
    {
      "eventId": "b8f2c1de-4f5a-4c1e-9a53-0d6f2b7c1e9a",
      "conversion": {
        "id": "ckq1w2e3r4t5y6u7i8o9p0",
        "key": "quote-request",
        "title": "Quote request"
      },
      "trigger": {
        "type": "form",
        "ref": "ckformid123"
      },
      "source": "browser",
      "occurredAt": "2026-09-21T15:04:05.000Z",
      "recordedAt": "2026-09-21T15:04:05.412Z",
      "updatedAt": "2026-09-21T15:04:07.020Z",
      "page": {
        "url": "https://example.com/contact?gclid=Cj0KCQjw",
        "path": "/contact",
        "referrer": "https://www.google.com"
      },
      "visitorId": "0b8e6a4c-8d2f-4b6e-9a1c-3f5d7e9b1a2c",
      "attribution": {
        "firstTouch": {
          "at": "2026-09-20T09:12:00.000Z",
          "path": "/",
          "landingUrl": "https://example.com/?gclid=Cj0KCQjw",
          "referrerOrigin": "https://www.google.com",
          "adPlatforms": [
            "google"
          ],
          "campaign": {
            "utm_source": "google",
            "utm_campaign": "spring-sale"
          },
          "clickIds": {
            "gclid": "Cj0KCQjw"
          }
        },
        "adPlatforms": [
          "google"
        ],
        "campaign": {
          "utm_source": "google",
          "utm_campaign": "spring-sale"
        },
        "clickIds": {
          "gclid": "Cj0KCQjw"
        },
        "browserIds": {
          "_gcl_au": "1.1.1234567890.1790000000"
        },
        "provenance": {
          "gclid": "ourRecord",
          "_gcl_au": "platformCookie"
        }
      },
      "consent": {
        "categories": {
          "analytics": true,
          "marketing": true
        },
        "mode": "lenient",
        "country": "US",
        "gpc": false,
        "policyVersion": 7
      },
      "value": 50,
      "currency": "USD",
      "userData": {
        "emailSha256": "b4c9a289323b21a01c3e940f150eb9b8c542587f1abfd8f0e1cc1ffc5e475514",
        "phoneSha256": "b4c9a289323b21a01c3e940f150eb9b8c542587f1abfd8f0e1cc1ffc5e475514",
        "phoneDigitsSha256": "b4c9a289323b21a01c3e940f150eb9b8c542587f1abfd8f0e1cc1ffc5e475514"
      },
      "submissionId": "ck9submission1",
      "delivery": {
        "google-ads": {
          "browser": "sent",
          "server": {
            "status": "sent",
            "attempts": 1,
            "sentAt": "2026-09-21T15:04:07.001Z",
            "lastAttemptAt": "2026-09-21T15:04:07.001Z"
          }
        },
        "ga4": {
          "browser": "sent",
          "server": {
            "status": "n/a",
            "attempts": 0
          }
        }
      },
      "status": "active",
      "adjustments": []
    }
  ],
  "nextCursor": "eyJ1IjoiMjAyNi0wOS0yMVQxNTowNDowNy4wMjBaIiwiZSI6ImI4ZjJjMWRlLTRmNWEtNGMxZS05YTUzLTBkNmYyYjdjMWU5YSJ9",
  "hasMore": false
}

In your app

A controller answers a route on your app: it calls listConversionEvents() and returns the answer.

Add the controller

app/Http/Controllers/ListConversionEventsController.php

<?php

declare(strict_types=1);

namespace App\Http\Controllers;

use Fetchski\AttractCmsLaravel\Data\ConversionEventPage;
use Fetchski\AttractCmsLaravel\Facades\Attract;

final class ListConversionEventsController
{
    public function __invoke(): ConversionEventPage
    {
        return Attract::conversionEvents()->listConversionEvents();
    }
}

Add the route

routes/web.php

use App\Http\Controllers\ListConversionEventsController;
use Illuminate\Support\Facades\Route;

Route::get('/conversion-event', ListConversionEventsController::class);

Call it

Terminal

curl http://localhost:8000/conversion-event

With php artisan serve running, it prints its answer as JSON.

To keep the call in an Action instead, this writes app/Actions/Attract/ListConversionEvents.php (an invokable Action that calls listConversionEvents()) and its test under tests/Feature/Actions/Attract/ (Pest when your app has it):

Terminal

php artisan make:attract-action conversionEvents.listConversionEvents

Call it from the terminal

Terminal

php artisan attract:call conversionEvents.listConversionEvents

It calls listConversionEvents() on your default site and prints its answer as JSON. See Call any method from the terminal for every argument type. Keep the response’s nextCursor and send it as since next time: you receive every new event and every later change to one (a delivery outcome, an adjustment) exactly once more. While hasMore is true, fetch again at once. Filters narrow the page; from / to filter on when the conversion happened (occurredAt), since on when it last changed. Fields the visitor’s consent did not allow are absent. The visitor’s IP address and user agent are never returned.

Optional parameters

Named arguments, e.g. listConversionEvents(since: …); leave out the optional ones.

?string

Optional. Leave it out (or pass null) and it isn’t sent: the site’s default applies. The previous page’s nextCursor, or an ISO 8601 time (changes strictly after it). Omit to start from the beginning.

?int

Optional. Leave it out and the site uses 100. Events per page: 1 to 500, 100 when left out (a value outside is refused, 400).

?string

Optional. Leave it out (or pass null) and it isn’t sent: the site’s default applies. A Conversion’s id or key. At most 256 characters.

Enums\ListConversionEventsPlatform|string|null

Optional. Leave it out (or pass null) and it isn’t sent: the site’s default applies. Events that report to this platform. One of google-ads, ga4, gtm, meta, tiktok.

?string

Optional. Leave it out (or pass null) and it isn’t sent: the site’s default applies. One visitor’s events. At most 128 characters.

Enums\ConversionEventSource|string|null

Optional. Leave it out (or pass null) and it isn’t sent: the site’s default applies. Where the event was born: the page (browser), this server, or another system (external). One of browser, server, external.

Enums\Status|string|null

Optional. Leave it out (or pass null) and it isn’t sent: the site’s default applies. active, retracted or adjusted (restated). One of active, retracted, adjusted.

?string

Optional. Leave it out (or pass null) and it isn’t sent: the site’s default applies. The utm_campaign of the event’s attribution. At most 256 characters.

\DateTimeInterface|string|null

Optional. Leave it out (or pass null) and it isn’t sent: the site’s default applies. Happened at or after (ISO 8601 date or time). Format: an ISO 8601 date and time.

\DateTimeInterface|string|null

Optional. Leave it out (or pass null) and it isn’t sent: the site’s default applies. Happened before (ISO 8601 date or time). Format: an ISO 8601 date and time.

Returns

A ConversionEventPage (Fetchski\AttractCmsLaravel\Data\ConversionEventPage). A page of events. Read its properties ($conversionEventPage->events): each says whether the site always sends it.

Collection<int, ConversionEvent>

Always sent. A list of ConversionEvent.

Show ConversionEvent (Fetchski\AttractCmsLaravel\Data\ConversionEvent)

One conversion occurrence. Fields the visitor’s consent did not allow are ABSENT, not empty. Never returned: the visitor’s IP address and user agent, outbox lease and retry bookkeeping.

string

Always sent. Opaque, unique per site, stable. The CMS mints a UUID for events it originates; another system mints its own (e.g. tenant-42:order:1234:purchase). Forwarded unchanged to every ad platform as its de-duplication key. Matches ^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$. At most 128 characters.

ConversionEventConversion

Always sent. A ConversionEventConversion. The Conversion it counts for.

Show ConversionEventConversion (Fetchski\AttractCmsLaravel\Data\ConversionEventConversion)

string

Always sent. The Conversion’s id.

string

Always sent. The Conversion’s key when the event was recorded.

?string

Sometimes sent: null when the site leaves it out. The Conversion’s name in the CMS.

Enums\ConversionEventSource|string

Always sent. How it was recorded: browser (the site’s tag), external (posted through the Conversion Data API), or server (the site’s own server; nothing records one yet). One of browser, server, external; a newer site may send others, so keep a fallback.

CarbonImmutable

Always sent. When it happened. Format: an ISO 8601 date and time.

CarbonImmutable

Always sent. Last change (delivery outcome, adjustment) — the sync order. Format: an ISO 8601 date and time.

array<string, DeliveryState>

Always sent. A map of names to DeliveryState. Per destination the Conversion reports to.

Show DeliveryState (Fetchski\AttractCmsLaravel\Data\DeliveryState)

Enums\Browser|string|null

Sometimes sent: null when the site leaves it out. Whether the page fired it at this platform’s tag; n/a when the Conversion sends to this platform from the server only. One of sent, not-sent, n/a; a newer site may send others, so keep a fallback.

?ServerDeliveryState

Sometimes sent: null when the site leaves it out. A ServerDeliveryState. Server-side delivery to this platform’s API (Google Data Manager, GA4 Measurement Protocol, Meta Conversions API, TikTok Events API).

Show ServerDeliveryState (Fetchski\AttractCmsLaravel\Data\ServerDeliveryState)

Enums\ServerDeliveryStateStatus|string

Always sent. queued/retry — owed; sent — delivered (test: true in a platform test mode); failed — attempts used up or a permanent error; not-configured — credentials, pixel, Google tag or conversion action missing; expired — older than the platform accepts (Google Ads 90 days, Meta and TikTok 7, Google Analytics 3); not-sent — retracted first, or nothing the platform can match; no-consent — the visitor did not allow Marketing; n/a — the platform has no server API here. One of queued, retry, sent, failed, not-configured, expired, not-sent, no-consent, n/a; a newer site may send others, so keep a fallback.

int

Always sent. Sends tried so far. At least 0.

?CarbonImmutable

Sometimes sent: null when the site leaves it out. When the platform took it; absent until then. Format: an ISO 8601 date and time.

?CarbonImmutable

Sometimes sent: null when the site leaves it out. The last try; absent before the first. Format: an ISO 8601 date and time.

?CarbonImmutable

Sometimes sent: null when the site leaves it out. Set while status is retry; null otherwise. Format: an ISO 8601 date and time.

?string

Sometimes sent: null when the site leaves it out. Why the last try failed, as the platform said. At most 500 characters.

?string

Sometimes sent: null when the site leaves it out. Why it wasn’t sent, for a status it ended in without trying (e.g. “The event was retracted.”). At most 500 characters.

?bool

Sometimes sent: null when the site leaves it out. Present (true) only when it went to the platform’s test mode. Always true.

?AdjustmentDeliveryState

Sometimes sent: null when the site leaves it out. An AdjustmentDeliveryState. Telling this platform about the latest adjustment, once it had already received the event. Google Ads: the event re-sent with its new value (a retraction is sent as 0 — Google still counts the conversion). Google Analytics: a refund, for purchases only and only to lower the value. Meta, TikTok, Google Tag Manager and browser-only rows cannot be told (unsupported, with what to do instead in detail).

Show AdjustmentDeliveryState (Fetchski\AttractCmsLaravel\Data\AdjustmentDeliveryState)

string

Enums\Action|string

Always sent. retract (withdraw the conversion) or restate (a new value). One of retract, restate; a newer site may send others, so keep a fallback.

Enums\AdjustmentDeliveryStateStatus|string

Always sent. queued/retry — owed; sent — delivered (test: true in a platform test mode); failed — attempts used up or a permanent error; not-configured — credentials or the live Google tag missing; unsupported — the platform cannot be told (detail says why and what to do instead); not-needed — the platform already holds this value. One of queued, retry, sent, failed, not-configured, unsupported, not-needed; a newer site may send others, so keep a fallback.

int

Always sent. Sends tried so far. At least 0.

?float

Sometimes sent: null when the site leaves it out. The value the platform holds once it is sent. At least 0.

?float

Sometimes sent: null when the site leaves it out. Google Analytics: the amount refunded. At least 0.

?string

Sometimes sent: null when the site leaves it out. ISO 4217 code, e.g. USD. Matches ^[A-Z]{3}$.

?CarbonImmutable

Sometimes sent: null when the site leaves it out. When the platform took it; absent until then. Format: an ISO 8601 date and time.

?CarbonImmutable

Sometimes sent: null when the site leaves it out. The last try; absent before the first. Format: an ISO 8601 date and time.

?CarbonImmutable

Sometimes sent: null when the site leaves it out. Set while status is retry; null otherwise. Format: an ISO 8601 date and time.

?string

Sometimes sent: null when the site leaves it out. Why the last try failed, as the platform said. At most 500 characters.

?string

Sometimes sent: null when the site leaves it out. Why it wasn’t sent, for a status it ended in without trying (e.g. “The event was retracted.”). At most 500 characters.

?bool

Sometimes sent: null when the site leaves it out. Present (true) only when it went to the platform’s test mode. Always true.

Enums\Status|string

Always sent. active; retracted (withdrawn by an adjustment) or adjusted (its value restated). One of active, retracted, adjusted; a newer site may send others, so keep a fallback.

Collection<int, Adjustment>

Always sent. A list of Adjustment. Every adjustment, oldest first (empty when none).

Show Adjustment (Fetchski\AttractCmsLaravel\Data\Adjustment)

string

Enums\Action|string

Always sent. retract (withdraw the conversion) or restate (a new value). One of retract, restate; a newer site may send others, so keep a fallback.

CarbonImmutable

Always sent. When the site stored it. Format: an ISO 8601 date and time.

?float

Sometimes sent: null when the site leaves it out. The restated value (restate only). At least 0.

?string

Sometimes sent: null when the site leaves it out. ISO 4217 code of value. Matches ^[A-Z]{3}$.

?string

Sometimes sent: null when the site leaves it out. Why, as the writer gave it. At most 500 characters.

?CarbonImmutable

Sometimes sent: null when the site leaves it out. When the change happened (as the writer said). Format: an ISO 8601 date and time.

?RecordedBy

Sometimes sent: null when the site leaves it out. A RecordedBy. Who wrote it: an API key (its public key ID and label) or an administrator.

Show RecordedBy (Fetchski\AttractCmsLaravel\Data\RecordedBy)

Enums\RecordedByType|string

Always sent. An API key or a signed-in person. One of apiKey, user; a newer site may send others, so keep a fallback.

string

Always sent. The key’s label, or the person’s name.

?string

Sometimes sent: null when the site leaves it out. An API key: its public key id.

?string

Sometimes sent: null when the site leaves it out. A person: their user _id.

?ConversionEventTrigger

Sometimes sent: null when the site leaves it out. A ConversionEventTrigger. What fired it.

Show ConversionEventTrigger (Fetchski\AttractCmsLaravel\Data\ConversionEventTrigger)

Enums\ConversionEventTriggerType|string|null

Sometimes sent: null when the site leaves it out. A form submitted, a page viewed, a link clicked, a chat event, or an external fact. One of form, pageView, linkClick, chat, external; a newer site may send others, so keep a fallback.

?string

Sometimes sent: null when the site leaves it out. What exactly: the form’s aposDocId (form), the page path (pageView), the link rule that matched or outbound:<host> / download:<type> (linkClick), the chat event (chat), or the producer’s reference (external). At most 256 characters.

?CarbonImmutable

Sometimes sent: null when the site leaves it out. When the site stored it. Format: an ISO 8601 date and time.

?ConversionEventPageInfo

Sometimes sent: null when the site leaves it out. A ConversionEventPageInfo. The page it happened on.

Show ConversionEventPageInfo (Fetchski\AttractCmsLaravel\Data\ConversionEventPageInfo)

?string

Sometimes sent: null when the site leaves it out. Analytics or Marketing only. Format: an absolute URL.

?string

Sometimes sent: null when the site leaves it out. Its path.

?string

Sometimes sent: null when the site leaves it out. Origin only.

?string

Sometimes sent: null when the site leaves it out. Analytics or Marketing only.

?EventAttribution

Sometimes sent: null when the site leaves it out. An EventAttribution. The attribution snapshot the event copied when it happened — independent of the visitor record’s later changes or expiry.

Show EventAttribution (Fetchski\AttractCmsLaravel\Data\EventAttribution)

Collection<int, string>

Always sent. The ad platforms whose click ids the visits carried (empty when none).

array<string, string>

Always sent. The campaign parameters in force (utm_*, …); empty when none.

?AttributionTouch

Sometimes sent: null when the site leaves it out. An AttributionTouch. The visitor’s first visit on record; null when unknown.

Show AttributionTouch (Fetchski\AttractCmsLaravel\Data\AttributionTouch)

?CarbonImmutable

Sometimes sent: null when the site leaves it out. When the page view happened. Format: an ISO 8601 date and time.

?string

Sometimes sent: null when the site leaves it out. The page’s path.

?string

Sometimes sent: null when the site leaves it out. The full landing URL. Without Marketing consent its identifier parameters are removed. Format: an absolute URL.

?string

Sometimes sent: null when the site leaves it out. Where the visitor came from; null for a direct visit.

Collection<int, Enums\AdPlatforms|string>|null

Sometimes sent: null when the site leaves it out. Platforms whose ad click ID the URL carried — kept for every visitor, consent or not. Each one of google, meta, tiktok, other.

array<string, string>|null

Sometimes sent: null when the site leaves it out. UTM and campaign parameters (utm_*, gad_source, gad_campaignid, srsltid).

array<string, string>|null

Sometimes sent: null when the site leaves it out. Ad click IDs (gclid, gbraid, wbraid, fbclid, ttclid). Marketing only.

array<string, string>|null

Sometimes sent: null when the site leaves it out. Google’s cross-domain linker value (_gl). Marketing only.

?AttributionTouch

Sometimes sent: null when the site leaves it out. An AttributionTouch. Their last visit with an ad click or campaign parameters; null when none. Its fields are listed under the first AttributionTouch above.

array<string, string>|null

Sometimes sent: null when the site leaves it out. Marketing only.

array<string, string>|null

Sometimes sent: null when the site leaves it out. Ad-platform browser IDs (_gcl_au — the cross-site key — _gcl_aw, _gcl_gb, _gcl_gs, _gcl_dc, _ga, _fbp, _fbc, _ttp). Marketing only.

array<string, string>|null

Sometimes sent: null when the site leaves it out. The visitor’s Google Analytics session per data stream when it happened (from the _ga_<container> cookies), keyed by the measurement ID without its G-. The GA4 server sender joins the event to that session. Marketing only.

array<string, Enums\Provenance|string>|null

Sometimes sent: null when the site leaves it out. Where each identifier came from: the visitor’s attribution record, the page URL, the platform’s own cookie, or the system that posted an external fact.

Sometimes sent: null when the site leaves it out. A ConsentSnapshot. The consent in force when the event happened. For an external fact (origin: producer) the posting system’s flags are recorded as adUserData / adPersonalization / gpc (limited data use).

Show ConsentSnapshot (Fetchski\AttractCmsLaravel\Data\ConsentSnapshot)

ConsentSnapshotCategories

Always sent. A ConsentSnapshotCategories. What the visitor allowed.

Show ConsentSnapshotCategories (Fetchski\AttractCmsLaravel\Data\ConsentSnapshotCategories)

?bool

Sometimes sent: null when the site leaves it out. Analytics cookies and measurement.

?bool

Sometimes sent: null when the site leaves it out. Marketing: ad platforms and their identifiers.

Enums\ConsentSnapshotMode|string

Always sent. The rule that applied to the visitor: lenient (a notice-only region: non-essential ran unless they declined) or strict (an opt-in region: nothing non-essential until they agreed). One of lenient, strict; a newer site may send others, so keep a fallback.

bool

Always sent. Global Privacy Control, or the producer’s limited-data-use flag.

?string

Sometimes sent: null when the site leaves it out. The visitor’s two-letter country, when known; null otherwise. Matches ^[A-Z]{2}$.

?int

Sometimes sent: null when the site leaves it out. The consent policy version the visitor answered; null when none.

?bool

Sometimes sent: null when the site leaves it out. An external fact: the producer allowed sending user data to ad platforms.

?bool

Sometimes sent: null when the site leaves it out. An external fact: the producer allowed ad personalization.

?string

Sometimes sent: null when the site leaves it out. Present (producer) when the consent came with an external fact. Always producer.

?float

Sometimes sent: null when the site leaves it out. Its value, when the Conversion has one. At least 0.

?float

Sometimes sent: null when the site leaves it out. The latest restated value. At least 0.

?string

Sometimes sent: null when the site leaves it out. ISO 4217 code of value, e.g. USD. Matches ^[A-Z]{3}$.

?UserDataHashes

Sometimes sent: null when the site leaves it out. An UserDataHashes. Hashed contact details. Email: trimmed + lower-cased; emailGoogleSha256 only for a Gmail address with dots (Google drops them). Phone: E.164 — phoneSha256 with the ”+”, phoneDigitsSha256 without (Meta’s form).

Show UserDataHashes (Fetchski\AttractCmsLaravel\Data\UserDataHashes)

?string

Sometimes sent: null when the site leaves it out. Lower-case hex SHA-256 digest. Matches ^[0-9a-f]{64}$.

?string

Sometimes sent: null when the site leaves it out. Lower-case hex SHA-256 digest. Matches ^[0-9a-f]{64}$.

?string

Sometimes sent: null when the site leaves it out. Lower-case hex SHA-256 digest. Matches ^[0-9a-f]{64}$.

?string

Sometimes sent: null when the site leaves it out. Lower-case hex SHA-256 digest. Matches ^[0-9a-f]{64}$.

?string

Sometimes sent: null when the site leaves it out. The form submission a form conversion came from.

?Producer

Sometimes sent: null when the site leaves it out. A Producer. The system that posted an external fact.

Show Producer (Fetchski\AttractCmsLaravel\Data\Producer)

string

Always sent. The system’s name, as it posted it (lowercase, a-z0-9._-, at most 64).

string

Always sent. Fingerprint of the posted fact (idempotency).

RecordedBy

Always sent. A RecordedBy. Who wrote it: an API key (its public key ID and label) or an administrator. Its fields are listed under the first RecordedBy above.

?string

Sometimes sent: null when the site leaves it out. Its own reference for the fact (at most 256 characters), when it gave one.

?ConversionEventJoin

Sometimes sent: null when the site leaves it out. A ConversionEventJoin. How an external fact was joined to a visitor (by: null — no match).

Show ConversionEventJoin (Fetchski\AttractCmsLaravel\Data\ConversionEventJoin)

Enums\By|string|null

Sometimes sent: null when the site leaves it out. The identifier that matched, or null for none. One of visitorId, token, gclAu, gclid, gbraid, wbraid, fbclid, ttclid, emailSha256, phoneSha256; a newer site may send others, so keep a fallback.

?string

Always sent, can be null. Pass as since to continue. When the page is empty it echoes the since you sent — keep polling with it.

bool

Always sent. More changes are waiting right now; fetch again at once.

Errors

Nothing to catch: the SDK retries what is safe, and Laravel logs and renders the rest (see Errors and testing).

400

The request is not valid. data.errors lists each problem with the path of the parameter or body field it concerns.Retried first: No. Read: errors() (field → messages), siteMessage().

401

The API key is missing, malformed, unknown, disabled, expired or archived (invalid), or a request that must be signed — by the route, or by the key’s own signing mode — has a missing, stale or wrong signature (an upload signs its SHA-256, declared in X-Fetchski-Content-SHA256, in the body’s place) (unauthorized).Retried first: No. Read: siteMessage(), errorName(), data().

403

The API key lacks the scope this route needs (the message names it), or the key is used from an address outside its allowlist.Retried first: No. Read: siteMessage(), errorName(), data().

404

Nothing with this identifier — or the caller may not use the Data API at all (anonymous visitors and non-admin sessions get 404 so the API is not advertised). A write while conversion tracking is switched off also answers 404.Retried first: No. Read: siteMessage(), errorName(), data().

429

The key used up its reads- or writes-per-minute limit (set per key; defaults 600 / 120). Still, after the client’s own waits and retries.Retried first: Yes: the client waits Retry-After (1 s when absent; over 60 s it gives up at once) and retries, up to retries times (2 by default). Read: retryAfter() (seconds, or null), siteMessage().

5xx

The site failed (or something in front of it did). Its logs say why.Retried first: A 502, 503 or 504: yes, after 0.5 s then 1 s. A 500: no. Read: siteMessage(), errorName(), data().

no answer

No answer: DNS, a refused connection, TLS, or the timeout (15 s per attempt by default).Retried first: Yes, after 0.5 s then 1 s. Read: reason(), neverConnected().

not sent

The client refused to send it (e.g. a path segment of ..); the site never saw it.Retried first: No. Read: reason() (what to change).

any other

Any other status, or a success whose JSON doesn’t match this SDK version’s types (update the SDK).Retried first: No. Read: reason(), status().

setup

Attract::site('acme') named a slug that isn’t under sites in config/fetchski-attract.php.Retried first: No: nothing was sent. Read: getMessage(), $e->slug.

setup

The site’s config entry is wrong: no url, a malformed api_key, a key filed under another slug, or no default site.Retried first: No: nothing was sent. Read: getMessage() (what to fix).

Behavior

Access: an API key with conversions:read — or its group master ads:all, or admin:all — or a signed-in user holding the conversion-events:view permission. Anonymous callers get 404.
Rate limit: the key’s own reads-per-minute limit, set when the key is created (default 600); over it, 429 with Retry-After. The client waits and retries for you; you see RateLimited only if that runs out.
Retries: a read is safe to repeat: the client retries it on no answer, a 502/503/504 and a 429.
Timeout: 15 s per attempt by default; raise timeout in config/fetchski-attract.php for longer.
Paging: one page per call. To walk them all, use listConversionEventsAll() (see More examples): it asks for the next page as you iterate, and stops when hasMore is false.

More examples

listConversionEventsAll() takes listConversionEvents()’s arguments except since.

use Fetchski\AttractCmsLaravel\Facades\Attract;

$conversionEvents = Attract::conversionEvents()->listConversionEventsAll(); // LazyCollection<int, ConversionEvent>: the next page is fetched as you iterate

Test it

It calls the route above with the SDK faked: the fake answers every call with a valid example, so nothing leaves your machine and no config or key is needed. Save it as tests/Feature/ListConversionEventsTest.php, then run your tests:

tests/Feature/ListConversionEventsTest.php

<?php

declare(strict_types=1);

namespace Tests\Feature;

use Fetchski\AttractCmsLaravel\Facades\Attract;
use Tests\TestCase;

final class ListConversionEventsTest extends TestCase
{
    public function test_list_conversion_events(): void
    {
        Attract::fake();

        $this->getJson('/conversion-event')->assertOk();

        Attract::assertCalled('conversionEvents.listConversionEvents');
    }
}

Terminal

php artisan test

Answer with your own values: fake conversionEvents.listConversionEvents with a sequence() of pages, each ConversionEventPage::factory()->make([...]), and walk listConversionEventsAll().

tests/Feature/ListConversionEventsAnswerTest.php

<?php

declare(strict_types=1);

namespace Tests\Feature;

use Fetchski\AttractCmsLaravel\Data\ConversionEventPage;
use Fetchski\AttractCmsLaravel\Facades\Attract;
use Tests\TestCase;

final class ListConversionEventsAnswerTest extends TestCase
{
    public function test_list_conversion_events_answers_your_values(): void
    {
        Attract::fake([
            'conversionEvents.listConversionEvents' => Attract::sequence(
                ConversionEventPage::factory()->make(['hasMore' => true, 'nextCursor' => 'page-2']),
                ConversionEventPage::factory()->make(['hasMore' => false, 'nextCursor' => null]),
            ),
        ]);

        $conversionEvents = Attract::conversionEvents()->listConversionEventsAll();

        $this->assertCount(2, $conversionEvents->all());
    }
}

To fake listConversionEventsAll(), answer conversionEvents.listConversionEvents (the walk calls it page by page): a sequence() of answers for several pages.

Get one conversion event

Attract::conversionEvents()->getConversionEvent()

Post a conversion another system saw

Attract::conversionEvents()->createExternalConversionEvent()

Retract or restate a conversion event

Attract::conversionEvents()->adjustConversionEvent()

GET /conversion-event

The endpoint this calls, in the API reference: the HTTP request and answer, and every rule the site checks.

use Fetchski\AttractCmsLaravel\Facades\Attract;

$conversionEventPage = Attract::conversionEvents()->listConversionEvents();

{
  "events": [
    {
      "eventId": "b8f2c1de-4f5a-4c1e-9a53-0d6f2b7c1e9a",
      "conversion": {
        "id": "ckq1w2e3r4t5y6u7i8o9p0",
        "key": "quote-request",
        "title": "Quote request"
      },
      "trigger": {
        "type": "form",
        "ref": "ckformid123"
      },
      "source": "browser",
      "occurredAt": "2026-09-21T15:04:05.000Z",
      "recordedAt": "2026-09-21T15:04:05.412Z",
      "updatedAt": "2026-09-21T15:04:07.020Z",
      "page": {
        "url": "https://example.com/contact?gclid=Cj0KCQjw",
        "path": "/contact",
        "referrer": "https://www.google.com"
      },
      "visitorId": "0b8e6a4c-8d2f-4b6e-9a1c-3f5d7e9b1a2c",
      "attribution": {
        "firstTouch": {
          "at": "2026-09-20T09:12:00.000Z",
          "path": "/",
          "landingUrl": "https://example.com/?gclid=Cj0KCQjw",
          "referrerOrigin": "https://www.google.com",
          "adPlatforms": [
            "google"
          ],
          "campaign": {
            "utm_source": "google",
            "utm_campaign": "spring-sale"
          },
          "clickIds": {
            "gclid": "Cj0KCQjw"
          }
        },
        "adPlatforms": [
          "google"
        ],
        "campaign": {
          "utm_source": "google",
          "utm_campaign": "spring-sale"
        },
        "clickIds": {
          "gclid": "Cj0KCQjw"
        },
        "browserIds": {
          "_gcl_au": "1.1.1234567890.1790000000"
        },
        "provenance": {
          "gclid": "ourRecord",
          "_gcl_au": "platformCookie"
        }
      },
      "consent": {
        "categories": {
          "analytics": true,
          "marketing": true
        },
        "mode": "lenient",
        "country": "US",
        "gpc": false,
        "policyVersion": 7
      },
      "value": 50,
      "currency": "USD",
      "userData": {
        "emailSha256": "b4c9a289323b21a01c3e940f150eb9b8c542587f1abfd8f0e1cc1ffc5e475514",
        "phoneSha256": "b4c9a289323b21a01c3e940f150eb9b8c542587f1abfd8f0e1cc1ffc5e475514",
        "phoneDigitsSha256": "b4c9a289323b21a01c3e940f150eb9b8c542587f1abfd8f0e1cc1ffc5e475514"
      },
      "submissionId": "ck9submission1",
      "delivery": {
        "google-ads": {
          "browser": "sent",
          "server": {
            "status": "sent",
            "attempts": 1,
            "sentAt": "2026-09-21T15:04:07.001Z",
            "lastAttemptAt": "2026-09-21T15:04:07.001Z"
          }
        },
        "ga4": {
          "browser": "sent",
          "server": {
            "status": "n/a",
            "attempts": 0
          }
        }
      },
      "status": "active",
      "adjustments": []
    }
  ],
  "nextCursor": "eyJ1IjoiMjAyNi0wOS0yMVQxNTowNDowNy4wMjBaIiwiZSI6ImI4ZjJjMWRlLTRmNWEtNGMxZS05YTUzLTBkNmYyYjdjMWU5YSJ9",
  "hasMore": false
}

Get started

Using the SDK

Going further

Pages & Site

Content

Media

Forms

Ads & Conversions

Analytics

List conversion events (incremental sync)

In your app

Call it from the terminal

Behavior

More examples

Test it

Get one conversion event

Post a conversion another system saw

Retract or restate a conversion event

GET /conversion-event

In your app

Call it from the terminal

Behavior

More examples

Test it

Related

Get one conversion event

Post a conversion another system saw

Retract or restate a conversion event

GET /conversion-event