Measure how much your Facebook ads lead to real-world outcomes by syncing conversion and product data
Setup
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.
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 "jane@example.com" or ["jane@example.com", "john@example.com"] for match_keys.email. The API rejects comma-separated strings, for example, "jane@example.com, john@example.com". Ensure the mapped field is in the correct format.
Hashing
The following fields will be hashed automatically by Hightouch unless otherwise specified.
emailphonegenderdobydobmdobdlast namefirst namefirst initialcitystatezipcountry