Manually Installing the Facebook Ads CAPI

By Bradley Riley
In:
SMMA
January 4, 2023

Immediately after the onset of iOS14, server-side tracking surged in importance. However, it did take a bit of time for some partners to catch up and provide effective integrations for the CAPI. 

Before the integrations were available, manual implementation had to be used and although some platforms have CAPI integrations, sometimes you need to know how to set up the CAPI manually.

Typically, advertisers create the instructions and developers implement the CAPI, however, this isn’t always possible and you may have to implement it yourself.

So let’s dive into how to install the CAPI manually.

Firstly, when you don’t have the CAPI installed, there should be a prompt to do so in the Events Manager. If this doesn’t show up, you can just head to your Pixel (under the Events Manager still) and click the Settings tab and scroll down to the CAPI section or select Add Events on the main Events Manager area for the appropriate Pixel > Using the Conversions API. Both will take you to the same process.

Under the CAPI subheading of the Settings section, if you started the process this way, there will be an option to ‘Set up manually’, select this.

This will take you to an area where you can progress through the steps. It will ask you to start by reading some overviews about the CAPI.

The next step is to select the events that you want to track. These should be the same as the events you’re tracking on the pixel.

From there, it will ask you what data you want to be part of the tracking. There may be an option to select Recommended parameters but either way, you want to follow best practices by tracking the following options: Event ID, IP address, Email address, First name, Surname, Phone number.

The for the next step, on this page you’ll have to generate and copy the access token for your CAPI (keep this somewhere you won’t delete or forget it.

Then, you’ll want to go to: fb.me/graph-explorer

Replace the Access Token with the one that you just copied.

Then grab your Pixel ID and from the Business Manager and paste it in the text box after GET and the Version drop-downs in the top-left. You’ll want to remove the current content of the text box before you paste the Pixel ID here. Then type “/events”.

Change the GET drop-down to POST.

After this, go back to the implementation tab you have open on the Business Manager and copy the code in the Payload Helper section. (If it isn’t here, you can find it at fb.me/payload-helper).

Back on the graph explorer, change tab from the Params to JSON. After this, remove the default curly braces and paste in the code.

After the last square bracket (]), near the bottom of the code, type a comma and hit return/enter to move to the line below.

From here type the following (including the speech quotes):

“test_event_code”: “”

Open a new tab and open up the Events Manager that you’re working on. From here, navigate to the Test Events tab, filter to Server events or select the Server test. 

Copy the test ID. This usually looks something like TEST1234.

Paste that ID into the empty speech marks that you just wrote in the graph explorer. 

This should now look like:

“test_event_code”: “TEST1234”

The final steps are to verify everything you’ve written is correct and hit the ‘Submit’ button in the top corner of the graph explorer.

You should see a bit of code return in the middle column saying that an event has been received.

Check if you’ve received an event successfully on the Test Events tab.

Finally, check under the Manage Integrations section on the Events Manager (to the right of the graph showing Pixel activity) to ensure it has been implemented and is active and has a green light.

All done!

Hope this helps!

Skyrocket Revenue, Increase Client Retention & Automate Your Agency

How would your agency transform if you had a top 1% media buyer? Our white label fulfilment service will shoot you right to the upper echelon of agencies and service delivery. Want to build an agency that customers rave about while you keep healthy profit margins?
Apply Now

Try Our SMMA Academy Program (400+ Resources)

Learn More