# Conversions

Send your conversions to AppLovin Axon through its Conversion API, from your backend or your website.

`POST /v1/events` sends your conversions to Axon's Conversion API. The destination is the account's Event Key.

## Send a conversion event

Name the AppLovin account and its Event Key as the destination. Axon needs the visitor's IP address and user agent, the page URL, and one match key on every event:

```bash
curl -X POST "https://zernio.com/api/v1/events" \
  -H "Authorization: Bearer $ZERNIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "profileId": "PROFILE_ID",
    "destinations": [{ "accountId": "ACCOUNT_ID", "destinationId": "AXON_EVENT_KEY" }],
    "events": [{
      "eventName": "Purchase",
      "eventTime": 1798804800,
      "eventId": "order_12345",
      "sourceUrl": "https://shop.example.com/checkout/confirmation",
      "value": 25.99,
      "currency": "USD",
      "user": {
        "email": "customer@example.com",
        "ipAddress": "203.0.113.7",
        "userAgent": "Mozilla/5.0 (iPhone; CPU iPhone OS 18_0 like Mac OS X)",
        "clickIds": { "aleid": "ALEID_FROM_THE_CLICK" }
      }
    }]
  }'
```

To send every event to Axon without naming it each time, create a [forwarding rule](/conversions/create-forwarding-rule) for the account instead.

## Event names

| Zernio event | Sent to Axon as |
|--------------|-----------------|
| `PageView` | `page_view` |
| `ViewContent` | `view_item` |
| `AddToCart` | `add_to_cart` |
| `InitiateCheckout` | `begin_checkout` |
| `AddPaymentInfo` | `add_payment_info` |
| `Purchase` | `purchase` |
| `Lead` | `generate_lead` |
| `CompleteRegistration` | `sign_up` |
| `Search` | `search` |
| `Subscribe` | `subscribe` |

Axon takes only its standard events. Any other name fails for that event and is not sent.

## Match keys

Each event needs at least one of these:

| Field | What it is |
|-------|------------|
| `user.clickIds.aleid` | Axon's click id, the `aleid` URL parameter on the ad click. The best match. |
| `user.clickIds.alart` | Axon's attribution token, the `alart` URL parameter. |
| `user.clickIds.axwrt` | The Axon pixel's browser id, the `_axwrt` cookie. |
| `user.email`, `user.phone`, `user.externalId` | Hashed with SHA-256 before they leave Zernio. |

Zernio's website tag captures `aleid`, `alart` and `_axwrt` for you. Send the Zernio visitor id as `user.visitorId` and Zernio adds them to your backend events.

## How it behaves

- Events go to Axon in batches of up to 100. Axon drops a whole batch when one event is invalid, so Zernio checks each event first and leaves out the ones Axon would refuse.
- A `purchase` needs `value` and `currency`. Zernio fills `transaction_id` from `eventId`, and `shipping` and `tax` with 0 when you do not send them.
- `eventId` is sent as Axon's `dedupe_id`. A pixel event and a server event with the same id count once.
- When the visitor refused ad cookies, Zernio sends the click ids but not the hashed email, phone or external id.

## If it fails

| Error | Cause | Fix |
|-------|-------|-----|
| `Axon has no standard event for "…"` | The event name is not in the table above | Rename it to one of Axon's standard events. |
| `Axon needs the visitor's IP address and user agent on every event.` | `user.ipAddress` or `user.userAgent` is missing | Send both from the visitor's request. |
| `Axon needs the URL where the event happened (sourceUrl).` | `sourceUrl` is missing | Send the page URL. |
| `Axon needs a match key` | The event has no click id, email, phone or external id | Send one of the match keys. |
| `Axon needs value and currency on a purchase.` | A `Purchase` without `value` or `currency` | Add both. |
| `401` with `reconnect_required` | Axon refused the Conversion API key or Event Key | [Connect again](/platforms/applovin/connect) with the keys from Axon Ads Manager. |

## Related

- [Send events](/conversions/send-events)
- [Create a forwarding rule](/conversions/create-forwarding-rule)
- [Send to AppLovin from your website](/products/server-side-tracking/ad-accounts#send-to-applovin)
- [Deduplication](/products/server-side-tracking/deduplication)