Conversions API

The Conversions API is designed to create a connection between an advertiser’s marketing data (such as website events, app events, business messaging events and offline conversions) from an advertiser’s server, website platform, mobile app, or CRM to Meta systems that optimize ad targeting, decrease cost per result and measure outcomes.

Rather than maintaining separate connection points for each data source, advertisers are able to leverage the Conversions API to send multiple event types and simplify their technology stack. In the case of direct integrations, this entails establishing a connection between an advertiser’s server and Meta’s Conversions API endpoint.

Server events are linked to a dataset ID and are processed like events sent using the Meta Pixel, Facebook SDK for iOS or Android, mobile measurement partner SDK, offline event set, or .csv upload. This means that server events may be used in measurement, reporting, or optimization in a similar way as other connection channels. Offline events may be used for attributed offline events measurement, offline custom audience creation or measurement.

For optimal ad performance and measurement, we recommend that advertisers follow the Conversions API best practices.

Recommended Steps

  1. Get Started: Choose the integration method that works best for you, see prerequisites for using the API, and understand where to begin.
  2. Implement the API and start sending requests: Start making POST requests and learn more about dropped events, batch requests, and event transaction time.
  3. Verify your setup: Confirm that we have received your events and that events are deduplicated and matched correctly.

Documentation

API Parameters

Required and optional parameters you can use to improve ads attribution and delivery optimization.

Payload Helper

See how your payload should be structured when it is sent to Facebook from your server.

Troubleshooting

Learn how to handle error codes returned by the Conversions API.

Resources

Meta Pixel Events

Learn more about the Meta Pixel's Standard Events and Custom Events.

Business Help Center

From our Help Center, see About Conversions API and Test Your Server Events.

Playbook and Webinar

View the Direct Integration Playbook for Developers (PDF) and Direct Integration Webinar for Developers.

Data Processing Options

Learn more about the Limited Data Use feature and how to implement it for Conversions API.