FORGEBOX Enterprise 🚀 - Take your ColdFusion (CFML) Development to Modern Times! Learn More...
A CFML wrapper for the Facebook Conversions API. Record Facebook conversions using their Server-Side API.
Feel free to use the issue tracker to report bugs or suggest improvements!
This project borrows heavily from the API frameworks built by jcberquist. Thanks to John for all the inspiration!
The CFC only has one method, used to send events to Facebook. Here's how you use it, along with the helper component for building events:
fbc = new path.to.fbccfml.facebookconversions( pixelId = 'xxx', accessToken = 'xxx' ); event = new path.to.fbccfml.helpers.fbevent() .name('Lead') .source('website') .url('https://www.your-website.com') .email( '[email protected]') .phone('19999999999') .firstName('Jo') .lastName('McSign') .value(100); res = facebookconversions.sendEvent( event ); writeDump( var='#res#', abort='true' );
To get started with the Facebook Conversions API, you'll need an Pixel ID and Access Token.
Once you have these, you can provide them to this wrapper manually when creating the component, as in the Quick Start example above, or via environment variables named
FACEBOOKCONVERSIONS_ACCESS_TOKEN, which will get picked up automatically. This latter approach is generally preferable, as it keeps hardcoded credentials out of your codebase.
There is only one method:
Send an event to Facebook. The parameter
event expects an instance of the
helpers.fbevent component, but you can construct and provide the struct/json yourself if you prefer.
The reference manual for all public methods in
helpers/fbevent.cfc can be found in the
docs directory, in
Unless indicated, all methods are chainable. To better understand how these work, you'll want to read the documentation regarding Event parameters.
box install fbccfml