Install Meta Conversions API

Configure server container prerequisites

• TAGGRS Setup: Ensure your TAGGRS server container is deployed.

  You can follow our implementation guide to have it done easily.

• Access token: Generate in Meta Events Manager under Conversions API > Settings.
• Pixel ID: Locate in Meta Events Manager under Data Sources.

Create CAPI tag in GTM server container

1.  In GTM server container, create a new HTTP Request tag.
2. Configure settings:
   • URL: https://graph.facebook.com/v19.0/<PIXEL_ID>/events
   • Method: POST
   • Headers:
     Content-Type: application/json
     Authorization: Bearer <ACCESS_TOKEN>
3. Add Request Body using JSON:

   json
{
 "data": [
   {
     "event_name": "{{Event Name}}",
     "event_time": {{Unix Timestamp}},
     "user_data": {
       "em": ["{{Hashed Email}}"],
       "ph": ["{{Hashed Phone}}"]
     },
     "custom_data": {
       "currency": "{{Currency}}",
       "value": {{Value}}
     }
   }
 ]
}

Map data layer variables

Create GTM variables to populate the JSON payload:

Configure trigger

Use Custom Event triggers (e.g., purchase, lead) from your website’s data layer.
Apply filters to fire only for conversion events.

Test and validate

Use GTM Preview Mode to verify payload structure.
Check Meta Events Manager > Test Events for incoming server events.
Validate deduplication by comparing CAPI and Pixel events in reports.

Troubleshooting