Facebook / Meta Pixel Tracking & Events
Meta no longer requires you to verify your domain or prioritise your web events making it possible to run ads directly to your ScoreApp scorecards more easily.
This article assumes you have already created your Pixel within Meta and have copied your Pixel ID. For more info on this process please refer to Facebook documentation here https://www.facebook.com/business/help/952192354843755
If you're planning on running ads to your Scorecard on Meta you will likely want to ensure that you have correctly setup your tracking pixel on your Scorecard.
ScoreApp makes this process very simple.
The first step is to add your Pixel ID into the tracking settings of your Scorecard
By adding your Pixel ID into the tracking settings as per the above screenshot, your pixel will now be loaded onto every page of your Scorecard with a 'PageView' event including landing pages, questions and result pages.
As well as triggering the 'PageView' event there are several other custom events that will automatically be triggered, making it easy to track the various stages of users flowing through your Scorecard.
Events
| Event Name | Event Type | Description |
| PageView | Standard | As described above, the standard 'PageView' event will be triggered on every page of your Scorecard. This includes all landing pages, the questions page and any result pages. |
| Lead | Standard | This event is triggered straight after the lead form has been completed regardless of the position of your lead form. This is likely the most useful event to optimise towards if lead generation is your key priority. |
| ScoreappLeadDetailsUpdated | Custom | This event is triggered if the lead form is resubmitted with updated details. This may occur when you include the "update details" functionality on a result page. |
| ScoreappQuestionsStarted | Custom | This event is triggered straight after the first main quiz question has been answered regardless of the position of your lead form. |
| ScoreappQuestionsFinished | Custom | This event will be triggered straight after the last main quiz question has been answered. |
* Please note that some of the above event names changed as of 21st October 2024. If you're an existing customer that setup conversion events in FB prior to the above date, please find more information here.
Example flow with lead form before questions
Example flow with lead form after questions
Once you have your first users flow through your Scorecard your pixel event manager should start to show these events like in the below screenshot.
Important: ensure that you are not blocking your Scorecard domains from your facebook pixel events. Within your meta pixel settings, scroll to the bottom and ensure your block list or allow list is configured properly. It may be that you have an allow list configured meaning your Scorecard domains need to be added to this allow list. If you do not do this, you may see events happening within the events manager however they will not be attributed to your ad campaigns properly.
Conversions API
The conversion API is available to Business, Pro and Enterprise customers.
This is not an essential part of the setup to run meta ads but the conversions API will likely make your events tracking slightly more accurate by sending the events on the server side as well as the client side.
You can enable the conversions API by toggling on the setting as per the below screenshot and adding your conversions API access token.
Once enabled the ScorecardStarted, ScorecardFinished and Lead events will automatically be sent server side via the conversions API as well as client side via the pixel implementation.
You can find or generate your token within the meta events manager of your pixel by going to Settings > Conversions API > Setup Manually > Generate access token. More info can be found here https://developers.facebook.com/docs/marketing-api/conversions-api/get-started/
Embedded Scorecards
If you have embedded your Scorecard, you will need to ensure that the Facebook pixel is also installed directly on the page that hosts the embedded Scorecard. ScoreApp will then detect that a pixel is active on the hosting page and fire the same conversion events as mentioned above (with the exception of the PageView) as if those events happened directly on the hosting site. This ensures that tracking is correctly attributed back to the original click within Facebook.