You use Tracking Pixels to send information from Ringba to another platform or service. The application triggers the pixel and sends the data according to your configuration. For example, you may want to send Call Data from Ringba to a CRM or Ad Network like Google Ads or Facebook Ads.

When a Tracking Pixel Event is triggered, Ringba will “fire” the pixel and pass whatever information you need into the third party by activating your pixel URL and dynamically inserting whatever data you choose.

Note: Ringba supports both HTTP and HTTPS postback pixels.

Create a Tracking Pixel

To create a Ringba Tracking Pixel:

Click Integrations and then click Pixels in the left navigation panel.
Click the Create Pixel button.
Configure the Tracking Pixel options: Fire Pixel On, URL, and (optional) Tokens.
You can choose to make POST requests if needed as well as use Tag Filters to fire the pixel when specific criteria is met.
Click the Create button to create and save the Tracking Pixel.

Note: Tracking Pixels can also be created directly inside Campaigns.

Add a Tracking Pixel to a Campaign

To add a Tracking Pixel to a Campaign:

Navigate to Manage Campaigns under Campaigns and open the Campaign where you want to add the pixel.
Click Add Pixel under Tracking Pixels.
Select the Tracking Pixel and click Add.

Options for Pixel Fired On

Incoming: The pixel will be fired as soon as the call appears in the the Ringba platform.
Connected (answered): The pixel will be fired when the call is answered by a target.
Completed: The pixel will be fired as soon as the call is finished after connecting to a target.
Converted: The pixel will be fired only if the call is converted.
Note: Payout may occur after conversion, in which case payout information is not yet available to pixels that use this option. If you need to send payout information, choose the Payout option instead.
Error: The pixel will be fired if the call was marked as an error.
Payout: The pixel will be fired if the call was marked to have a payout to a publisher
Finalized: The pixel will be fired when the call ends. It doesn’t matter how (picked up, no answer, etc.)
Recording: The pixel will be fired when the recording is available to listen to. The recording usually takes a few seconds to appear after the call completes so the pixel will only fire when it appears in the call reporting.

Suggestions for Improving Pixel Readability

Add a description for your tokens. For example, you can put “RingbaCallId=” before adding the Call Id token. This way, when the pixel is fired, we know what each piece of information means. Another suggestion is to separate multiple tokens using & to make your pixel more readable. See the example in the following graphic:

Note: To send the parameters with the URL using the GET method, you must add a question mark ("?") between the endpoint URL and the parameters.

Pixels FAQ and Troubleshooting

Why isn't my tracking pixel firing?

If you made the call and the pixel is not showing on your end, you should always first check if the Pixel Fire event shows on your Call Log under the events tag (please keep in mind the pixel fire is queued to be processed and might be registered on the logs after a while the call has completed). If it’s not there, the most probable cause is that the pixel has not been added to the campaign.

The tracking pixel fired but why does it show Fail Reason: Bad Request.

If this happens, you should check the documentation of the platform you are sending the information to. The request is not being accepted by the server as it probably doesn't follow the specifications. If the request Body has an array, make sure to implement the array with double brackets ("[[ ]]"); single brackets ("[ ]") in Ringba means you are opening a macro.

Is it necessary to whitelist any IP addresses when using Pixels?

Our recommendation is to whitelist the IPs described in this link Pixels, Ring trees and Custom Scoring IP whitelist

Is it possible to increase the pixel timeout settings?

No, the pixel timeout cannot be customized. It is set to 10 seconds for all accounts.

What should I do if I need help with Pixels?

If you have any questions or need additional help, please reach out to our support team via chat or email at support@ringba.com.