> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hightouch.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Ometria

> Ometria is a customer data and marketing platform built for retail brands that want to turn fragmented data into revenue. It unifies customer data in real time, uses AI to predict behavior, and lets you trigger highly personalized campaigns across email, SMS, and onsite—so you can send the right message at the right time without duct-taping multiple tools together.

## Supported syncing

| Type | Description | Supported Sync Modes | API Reference |
| - | - | - | - |
| **Contacts** | Sync data from any source to contacts in Ometria | Upsert | [Contacts docs](https://docs.ometria.com/docs/contacts-endpoint) |
| **Orders** | Sync data from any source to orders in Ometria | Upsert | [Orders docs](https://docs.ometria.com/docs/orders-endpoint) |
| **Products** | Sync data from any source to products in Ometria | Upsert | [Products docs](https://docs.ometria.com/docs/products-product-listings-and-product-variants#products) |
| **Events** | Sync data from any source to events in Ometria | Insert | [Events docs](https://support.ometria.com/hc/en-gb/articles/360011171077-Setting-up-custom-events) |

All sync types use the [push endpoint](https://docs.ometria.com/reference/post_push) to sync data to Ometria.

For more information about sync modes, refer to the [sync modes](https://docs.hightouch.com/syncs/types-and-modes.md#sync-modes) docs.

## Connect to Ometria

Go to the [**Destinations** overview page](https://app.hightouch.com/destinations?from=docs) and click the **Add destination** button. Select **Ometria** and click **Continue**. You can then authenticate Hightouch to **Ometria**.

Enter the following fields into Hightouch:

* **API key:** To create a new API key, refer to Ometria's [API keys docs](https://support.ometria.com/hc/en-gb/articles/9882706389917-Creating-a-new-API-key).

## Sync configuration

Once you've set up your Ometria destination and have a [model](https://docs.hightouch.com/getting-started/concepts.md#models) to pull data from, you can set up your sync configuration to begin syncing data. Go to the [**Syncs** overview page](https://app.hightouch.com/syncs?from=docs) and click the **Add sync** button to begin. Then, select the relevant model and the Ometria destination you want to sync to.

### Syncing contacts, orders, and products

Sync data from any source to contacts, orders, and products in Ometria.

#### Record matching

To match rows from your model to objects in Ometria, you need to select the model column that contains values that match the **ID** field.
Refer to the [record matching docs](https://docs.hightouch.com/syncs/record-matching.md) for more information.

#### Field mapping

Hightouch lets you sync contact fields via [field mapping](https://docs.hightouch.com/syncs/mapping-data.md).
You can map data from any of your model columns to default and custom contact fields.

For orders, Ometria requires the following fields, so you must map them to complete your configuration:

* **Timestamp**
* **Grand total**
* **Subtotal**
* **Currency**

For products, Ometria requires the following fields, so you must map them to complete your configuration:

* **Title**
* **Price**

Ensure your model's columns have the same data types as the fields you want to sync to.

### Syncing events

Sync data from any source to events in Ometria.

> [!WARNING]
>
> To ensure syncs send each event, your event model must use a truly unique [primary key](https://docs.hightouch.com/getting-started/concepts.md#unique-primary-key-requirement). See the [events syncs](https://docs.hightouch.com/syncs/types-and-modes.md#event-syncs) documentation for more information.

#### Record matching

You can match rows from your model to events in Ometria on any column in your model and any field in Ometria. Ensure the data types of the model column and Ometria field you select match.
Refer to the [record matching docs](https://docs.hightouch.com/syncs/record-matching.md) for more information.

#### Field mapping

Hightouch lets you sync event properties via field mapping.

## Tips and troubleshooting

To see the exact API requests and responses from each sync run, use the [live debugger](https://docs.hightouch.com/syncs/debugger.md). To get notified by Slack, PagerDuty, SMS, or email when a sync fails, set up [sync alerts](https://docs.hightouch.com/syncs/alerting.md). If you run into an issue this page doesn't cover, [contact support](#pylon-chat).
