CAPI Hosting: Common Errors and Questions

Errors

1. No events in the CAPIG hub

The Meta Conversions API Gateway relies on data received by the Meta pixel. Whenever the Meta Pixel is triggered, it securely sends events to the Meta Pixel and the Conversions API.

• Meta pixel is tracking that event. The easiest way to check is to use the Meta Pixel Helper tool for the Chrome browser. Install it, then perform actions on your site that should cause the event. If the tool doesn't show the event, it's not being tracked. The first step to fix this is to set up meta pixel tracking. Once that's done, CAPIG will start picking up the event automatically.
• Additional CAPI integration through a third-party vendor. It can be, for example, a Shopify plugin or WordPress app. Ensure no additional integration is configured to send data to Facebook CAPI.
• A domain that sends events is blocked inside the CAPIG hub. To troubleshoot this reason, log in to the CAPIG hub, open the website tab, and check the list of blocked websites. 

2. 404 error after finishing the setup

This error can have multiple causes. Contact our support team at Stape, and we'll assist you.

3. DNS setup could not be completed

Log in to your DNS provider and ensure you’ve set up DNS records correctly. You should configure the CNAME record that points to your CAPIG hub URL, which you can find inside your stape.io account. 

The setup inside the DNS provider should look like the screenshot below. Ensure that the Proxy is set to off. This is an example from Cloudflare. 

The last step is to use a tool like this to verify DNS settings. Add your CAPIG hub subdomain, select CNAME, and check if a record matches the CAPIG hub URL.

4. Can´t connect Pixel to the CAPIG hub

When you click Add data source in the CAPIG hub, the last thing you should do is let the CAPIG hub access your Facebook access token. Ensure you've checked the box that says 'I agree to share my token with this site' and then click Confirm.

If you do not see the pop-up, ensure that pop-ups are not blocked in your browser. 

To enable pop-ups in Chrome, go to Settings →  Privacy and Security →  Site settings →  Pop-ups and redirects. Select Sites can send pop-ups and use redirects or add CAPIG URL to exceptions.

Next, log into your Gateway Hub and try adding the pixel again.

If enabling pop-ups doesn't work, try changing the browser or using incognito mode. 

5. Error net:: ERR_SSL_VERSION_OR_CIPHER_MISMATCH in console after creating a subdomain

If your Gateway Hub has not stopped receiving events after you created a subdomain for your Gateway Hub and you see the following error in the console.Add a CAA record to your primary domain - 0 issue “pki.goog”.

FAQ

1. Are there any restrictions on the CAPIG subscription plans?

We offer three subscription plans that have the following limits: 

• Pay-as-you-go costs $10/month per pixel and includes 10 million events per month per pixel.
• Unlimited costs $100/month plan and includes 200 million events per month. 
• Custom plan is tailored to your specific needs. You can discuss your requirements with us and get a personalized quote.

2. How does the "Pay-as-you-go" subscription work?

With a pay-as-you-go subscription, you can add an unlimited number of pixels. A 7-day free trial is possible only for the first pixel. If you add more pixels, a prorated charge for additional pixels is applied at the end of the billing cycle. You can check the number of pixels and billing cycle inside stape admin.

3. What is the difference between Meta Conversions API Gateway and Conversions API?

The Conversion API Gateway is one way to connect the Conversion API. It has some benefits over other FB CAPI implementations, which are:

• easy setup
• the ability to add multiple pixels and domains in one CAPIG hub
• in most situations, the setup and ongoing costs for CAPIG are lower than those for CAPI

4. Do I have to configure event deduplication when using Meta CAPIG?

You do not need to set up event deduplication for CAPIG. Event deduplication is set up automatically. Event_id deduplication key is automatically generated and propagated to help ensure deduplication between both channels (web and server).

Please keep in mind that event deduplication does not work for test events, since there is no option to add the test event code to Meta CAPI Gateway for server-side testing. You will only see browser-side events when performing tests in Facebook Events Manager.

5. How to improve the event match quality for the Meta Conversions API Gateway?

• Enable Advanced matching inside the CAPIG hub interface. 

• Activate Automatic Advanced Matching when linking your pixel to the CAPIG hub. To specify the user parameters you wish to share with Meta, select "Show customer information parameters" and enable the ones you'd like to share.

6. What CAPIG server locations do you have?

• The United States
• Europe 
• South America 
• Asia Pacific
• Japan

7. How can I structure CAPIG?

Use one CAPIG hub account for all of your clients. In this case, you must connect all pixels to one CAPIG hub and use one custom domain.

You can use an agency account to create accounts for each client with its own CAPIG with their email. This way, you will have a custom domain for each website or pixel.

We also offer an option of a private multi-user Meta Conversions API Gateway hub, which has the following benefits:

• Ensure optimal data routing for each website, enable advanced matching, attribute more conversions, and improve ad relevance.
• Predictable price. Pay a flat fee of $500 monthly for up to 1 billion requests.
• Select from up to 25 server locations.
• Connect an unlimited number of pixels in the different Facebook Business Managers.
• Manage access for each account/website individually.

Please contact our support team for a private multi-user Meta Conversions API Gateway hub.

8. I want to use the same email for all the clients' accounts because I want to have one-centered control over all the client's accounts. Is it possible?

You can use the same CAPI gateway instance for all your clients and connect all pixel IDs. All you have to do is click Add data source. In this case, you can add and use only one subdomain to Gateway Hub.

9. How do I change the names of CAPIGs inside the CAPIG hub?

Go to Accounts, click three dots on the left, and choose Edit name.

10. Can I capture a purchase value via Shopify, Woocommerce, Clickfunnels, etc.?

Yes, if the event is configured through an FB pixel, you can capture any value associated with a purchase.

11. How can I connect new events to fire through the CAPIG?

Meta Conversions API Gateway automatically identifies events set up with an FB pixel and transmits them via the server. Deduplication is also configured automatically.

This documentation explains how to set up and install Meta Pixel.

12. Can I control which domains send events to CAPIG?

To see which domains send data to the CAPIG hub, go to the CAPIG hub, open the sections of the website, and see the list of all domains that send data to CAPIG. Below, you can add websites that you want to block. 

13. Can I control which events the CAPIG hub sends?

Meta Conversions API Gateway monitors server-side events based on the data captured by the Meta pixel. Any event the Meta pixel detects will be automatically tracked via the Meta Conversions API Gateway. Through the gateway's hub, you can control which events get sent using an on-off toggle for each event.

To track new events, standard or custom, through CAPIG, you must set up a pixel to track this event.