Go to the Destinations overview page and click the Add destination button. Select Facebook Conversions and click Continue. You can then authenticate Hightouch to the Facebook Conversions API by entering the following required fields into Hightouch:
Pixel ID
Access Token
You can find these credentials by going to Facebook's Events Manager and opening the Data Sources tab. Select the pixel you want to send events to and open the Settings tab. The Pixel ID is available under Details.
For the access token, click Generate access token in the Conversions API section.
Once you've set up your Facebook Conversions destination and have a model to pull data from, you can set up your sync configuration to begin syncing data. Go to the Syncs overview page and click the Add sync button to begin. Then, select the relevant model and the Facebook Conversions destination you want to sync to.
Providing an event name is required to send an event to the Conversions API. You can either provide a static value or select to use a column from your model. Hightouch syncs the static or column value as the event_name parameter the Conversions API requires.
You can optionally select a column that contains timestamps of when events occurred. If this field is empty, Hightouch uses the time the event arrives at the server. Hightouch syncs the timestamp as the event_time parameter the Conversions API requires.
If you select a column, it should be in ISO 8601 format. Hightouch automatically converts the data to the format Facebook expects.
Field mapping is where you select which customer information parameters or other event parameters you want to send to the Conversions API.
The Conversions API requires you to include at least one user_data parameter in your event payload, so be sure to map one here. Facebook uses this field to attribute a conversion to a particular user. You can also include any other user data fields you have to help increase event match quality.
The action_source parameter allows you to specify where your conversions occurred, for example, over email, on your website, etc. Knowing where your events took place helps ensure your ads go to the right people. We recommend you include this as part of your field mapping.
In case you haven't mapped this field or know that not all rows in your data include it, you can optionally set a fallback action source.
Test event codes are special codes you can include in your event payload to simulate conversion events. This allows you to test your API implementation without actually recording real conversion data.
You can optionally enter a test event code as part of your sync configuration. You can find your test event code in your Facebook Events Manager in the Test events tab.
Make sure to remove the test event code if you're running a production sync.
To date, our customers haven't experienced any errors while using this destination. If you run into any issues, please don't hesitate to . We're here to help.
Hightouch provides complete visibility into the API calls made during each of your sync runs. We recommend reading our article on debugging tips and tricks to learn more.