Overview

Meta Conversions API (CAPI) integration with Hardal enables server-side event tracking for improved accuracy and reliability of your Meta Pixel data. This integration provides more reliable conversion tracking for your Facebook/Instagram ads.

Prerequisites

Before setting up the CAPI integration, ensure you have:

  • Completed Hardal setup on your website

  • Access to Hardal Dashboard

  • A Meta Business Manager account

  • A Meta Pixel

You must have admin access privileges in your Meta Business Manager to generate the required access token.

Setup Process

1

Generate Meta Access Token

  1. Log into your Meta Business Manager

  2. Go to Events Manager

  3. Select your Pixel

  4. Navigate to the Settings tab

  5. Find the “Conversions API” section

  6. Click “Generate access token”

  7. Copy the generated token

Keep your access token secure and don’t share it publicly. It provides direct access to your Meta Pixel data.

2

Deploy CAPI Server in Hardal

  1. Log into your Hardal dashboard

  2. Navigate to “Server-Side Hosts”

  3. Click on “Deploy” button to create a CAPI server

  4. If you do not have a Hardal Meta CAPI Dashboard account, request access via here. If you have one, continue to dashboard and process to Step 3

3

Connect Hardal to Meta Pixel

  1. Navigate to Data Pipelines and click to Create Data Pipeline

  2. Choose “Conversions API Gateway Pipeline” and click Create

  3. Continue with Manuel Connection

  4. Insert all information into related spaces

    1. Meta Business ID: This can be found in your Meta dataset’s Settings, under Details > Owner.

    2. Dataset ID: This can be found in your dataset’s Settings, under Details.

    3. Access Token: This was created on Step 1

  5. Click Connect

4

Test the Connection

  1. Open your Meta Events Manager

  2. Check that events are being received via both browser (pixel) and server (CAPI)

If you’ve already set up a custom domain in Hardal, ensure it matches the domain registered with your Meta Pixel.

Event Mapping

Hardal automatically maps standard events to their Meta Pixel equivalents:

Hardal EventMeta Pixel Event
page_viewPageView
add_to_cartAddToCart
purchasePurchase
sign_upCompleteRegistration
view_contentViewContent

Troubleshooting

Common Issues

If events aren’t appearing in your Events Manager:

  1. Verify Access Token:

    • Ensure your access token is valid

    • Check if token has required permissions

    • Generate a new token if needed

  2. Check Domain Configuration:

    • Verify domain matches between Hardal and Meta Pixel

    • Ensure domain is verified in Business Manager

    • Check for any domain-related errors in Hardal logs

  3. Event Configuration:

    • Confirm events are being received by Hardal

    • Check event mapping configuration

    • Verify event parameters match Meta’s requirements

Need Help?

If you need assistance with your Meta CAPI integration: