Search documentation...


Facebook Offline Conversions

Measure how much your Facebook ads lead to real-world outcomes by syncing conversion and product data


Use an access token that has access to the offline event sets. To obtain an access token, follow the instructions listed here in the Facebook for Developers Offline Conversions API for creating an App. Select 'Direct Implementation' for your app type.

Follow the remainder of Facebook's instructions for creating a System User and token. Ensure you have selected ads_management for the scope.

Syncing events

When syncing events, Hightouch treats any records added to your source as new events and sends them to Facebook when your sync runs.

To ensure syncs send each event, use a hash function for the event model's primary key . The hash should combine all columns, including member ID, timestamp, etc. See the event sync documentation for more information.

Track event configuration

In this section, you can enter in the event set that you want to upload to, as well as the upload tag and an optional namespace ID.

Depending on the event name, Hightouch will allow you to map your columns to different fields in Facebook.

Field mappings

Hightouch allows you to pass data to the default properties and the custom event properties of a Facebook offline event. Hightouch expects the event_time to be a standard ISO 8601 format. Hightouch will automatically convert this to the Unix time that Facebook expects.

The Facebook Offline API accepts strings and arrays of strings for match_keys. For example, you can use column values like "" or ["", ""] for The API rejects comma-separated strings, for example, ",". Ensure the mapped field is in the correct format.


The following fields will be hashed automatically by Hightouch unless otherwise specified.

  • email
  • phone
  • gender
  • doby
  • dobm
  • dobd
  • last name
  • first name
  • first initial
  • city
  • state
  • zip
  • country

Ready to get started?

Jump right in or a book a demo. Your first destination is always free.

Book a demoSign upBook a demo

Need help?

Our team is relentlessly focused on your success. Don't hesitate to reach out!

Feature requests?

We'd love to hear your suggestions for integrations and other features.

On this page

SetupSyncing eventsTrack event configurationField mappingsHashing

Was this page helpful?