@riculum/fb-conversions-api NPM

Facebook Conversions API

A TypeScript package to interact with the Facebook Conversions API, allowing you to send conversion events from your server directly to Facebook.

Installation

Install the package via npm:

npm install @riculum/fb-conversions-api

Setup

Define Environment Variables: Create a .env file in the root of your project and add the following variables:

  FACEBOOK_PIXEL_ID=your_pixel_id
  FACEBOOK_ACCESS_TOKEN=your_access_token

Load Environment Variables: Ensure dotenv is loaded at the start of your script.

Usage

To send an event to the Facebook Conversions API, import the package and call the fbEvent function with your desired parameters.

import 'dotenv/config';
import fbEvent from "@riculum/fb-conversions-api";

// Define the event details
const eventName = 'ViewContent';
const params = {
    event_time: 1731176705,
    action_source: 'website',
    user_data: {
        em: ['fb1a4757f83b74e5a87c1554c8689bab12d09674f9e15db366c3636ab452004c'],
        client_ip_address: '1.2.3.4',
        client_user_agent: 'Mozilla/5.0',
    },
    event_source_url: 'https://example.com/product-page',
    event_id: 'unique-event-id-12345',
};

// Optional test event code for validation in test environments
const testEventCode = 'TESTxxxxx';

const response = await fbEvent(eventName, params, testEventCode);
console.log(response);