---
title: "Ometria"
slug: "ometria"
description: "The user manual provides comprehensive guidance on using the Antavo Management UI for managing loyalty programs."
updated: 2026-03-31T09:48:33Z
published: 2026-03-31T09:48:33Z
canonical: "docs.antavo.com/ometria"
---

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

# Ometria

Ometria is a customer data and marketing platform that helps retailers boost revenue from customer relationship management by delivering personalized marketing messages across the entire customer journey.

Integrating Ometria with Antavo can bring several benefits. By merging the customer data gathered by the loyalty platform with Ometria’s marketing capabilities, businesses can craft more personalized and impactful marketing campaigns, tailored to the preferences and behaviors of individual customers.

> [!NOTE]
> This integration supports **one-way synchronization**, meaning data can only be sent **from Antavo to Ometria**, and not the other way around.

This document outlines how to configure the connection between Antavo and Ometria. Additionally, a typical use case will be discussed briefly.

To access the configuration interface, navigate to the Modules menu and search for Ometria integration in the list.

## Configuring the Antavo – Ometria connection

The module configuration requires an API key, which can be found on [Ometria’s platform](https://app.ometria.com/login#3).

Follow these steps to obtain the API key:

- Click the **Antavo → Settings** menu in the upper right corner in Ometria
- Navigate to **API keys** and copy the string to your clipboard
- Paste the copied**string** into the designated field in Antavo's Management UI
- Click **Connect**
- Finally, choose the**list**that you want Antavo to synchronize with

## Field synchronization

Field synchronization defines how customer data is mapped between Antavo and Ometria.

- Click **Add new field +** to create a new mapping
- The **Loyalty fields dropdown lists** the available fields in Antavo, while Remote fields represent the corresponding fields in Ometria
- **Add additional mappings** by inserting new rows at the bottom, then click **Save**

![](https://cdn.document360.io/08a474ca-8fb4-4c3c-9cd8-665242086cd3/Images/Documentation/ometria_legacy(1).png)

#### Creating and syncing custom fields

You can create custom remote fields in Ometria and sync them from Antavo.

Navigate to **Ometria → Antavo Settings**, create the custom field, then return to the Antavo Ometria module and enter the field ID in the **Remote fields** column.

![](https://cdn.document360.io/08a474ca-8fb4-4c3c-9cd8-665242086cd3/Images/Documentation/customf_ometria.png)

### Ometria v2

> [!NOTE]
> v2 integration is not enabled by default. If you would like to use the enhanced synchronization features, please contact the [Antavo Service Desk](https://antavo.atlassian.net/servicedesk/customer/portals).

The enhanced mode introduces an updated payload structure aligned with Ometria’s v2 contact data model and expands the list of selectable Antavo customer fields.

In addition to the fields available in legacy mode, you can now also select:

- **tier-related fields** (customer.tiers.*) introduced by the [Tiers](/engine/docs/tiers) module (e.g., `tiers.basic_structure.next.name)`
- **expiring points fields** introduced by the [Expiring points](/engine/docs/expiring-points) module (e.g., `extensions.expiring_points.total`)
- **multi-account balances** (customer.accounts.*) introduced by the [Multi-accounts](/engine/docs/multi-accounts) module (e.g., `accounts.prestige_balance.earned` )

These fields appear in the Loyalty fields selector and can be mapped in the same way as other fields.

![](https://cdn.document360.io/08a474ca-8fb4-4c3c-9cd8-665242086cd3/Images/Documentation/ometria v1.png)

#### Ometria field placement rules in the v2 integration

Ometria distinguishes between built-in contact fields and custom properties. The v2 integration automatically places synced values in the correct location:

- Mappings to Ometria built-in fields (for example, email or firstname) are sent as top-level fields
- All other mappings are sent under properties

This ensures compatibility with Ometria’s v2 API and prevents invalid payload structures.

## Triggering Ometria campaigns from Antavo events

You can **synchronize Antavo events** with Ometria through the Workflows editor. This example shows how to push an automated email campaign based on a customer’s reward claim by setting up this rule.

You can access workflow management through the Workflows icon on the left sidebar.

- Click**Create new campaign** or **Create new general workflow,** depending on the [type of flow](/v1/docs/basic-concepts) you would like to run
- Fill in the required fields to create the campaign or workflow
- Drag and drop the **Event**trigger node to the empty canvas from the right sidebar
  - Select *Claiming a reward* event from the dropdown menu. This way, whenever someone claims a reward, they will be automatically enrolled in Ometria’s email campaign.
  - Click **Update**
- Drag and drop the **Trigger Marketing Communication** action node to the sheet from the right sidebar This node should appear when the Ometria module is enabled in Antavo’s Management UI.
  - Double-click the node. The payload should include fields (Reward name, Reward description) tagged in Ometria’s email templates.
  - If these tags are present in the emails, then automated campaigns can be set up in Ometria.