Connecting Meta (Facebook)

Meta connects via OAuth. After authorization, you configure your Dataset ID so True Conversions knows which pixel/dataset to send conversions to via the Conversions API (CAPI).


Prerequisites

  • A Meta Business account with access to the relevant ad account.
  • A Meta Pixel / Dataset configured in Events Manager.
  • An account already created in True Conversions.

Step 1: Authorize Meta

  1. In your True Conversions dashboard, go to Accounts and select the account.
  2. Click Ad Integrations in the sidebar.
  3. In the Meta (Facebook) card, click Connect Meta.
  4. You'll be redirected to Facebook's authorization page. Log in if prompted.
  5. Select the Business account and ad account you want to connect.
  6. Review the permissions (ads management access) and click Continue.
  7. You'll be redirected back to True Conversions. A success message confirms the connection.

Step 2: Configure the Dataset ID

After connecting, enter your Dataset / Pixel ID:

  1. Go to Meta Events Manager.
  2. Select the pixel/dataset associated with your ad account.
  3. The ID is displayed in the header or URL (a numeric string, e.g., 123456789012345).
  4. Paste the ID into the Dataset / Pixel ID field in True Conversions.
  5. Click Save Configuration.

Note: Meta unified Pixel IDs and Dataset IDs -- they are the same thing. If you see either term in Events Manager, they refer to the same identifier.


How It Works

When True Conversions processes a conversion event from your CRM:

  1. The contact's PII (email, phone, name) is hashed with SHA-256.
  2. If an fbclid (Facebook click ID) is present, it's included for direct click matching.
  3. The hashed data and conversion details (event name, value, currency, timestamp) are sent to Meta via the Conversions API.
  4. Meta matches the conversion to the original ad interaction using the fbclid and/or hashed PII.
  5. This improves your Event Match Quality (EMQ) score in Events Manager.

The match result is stored in True Conversions and visible on the account's Stats page.


Improving Event Match Quality

Meta's Event Match Quality score (1-10) measures how well your server events match to Facebook users. To maximize it:

  • Always include email in conversion events -- it's the strongest identifier.
  • Include phone number when available (formatted with country code).
  • Include first name and last name when available.
  • Capture and pass the fbclid via the GTM tag and hidden form fields (see Getting Started).

Re-authorizing

If the OAuth token expires, the integration status will show expired and a banner will appear on the Ad Integrations page. Click Re-authorize to reconnect. Your Dataset ID setting is preserved.


Disconnecting

Click Disconnect on the Meta card. This removes the stored credentials and configuration from True Conversions. It does not delete or modify anything in your Meta Business account or Events Manager.