How to configure Snapchat Conversions API Gateway

Since Snapchat Conversions API Gateway routes the events your site already sends, you’ll need to set up Snapchat web tracking on your site. 

1. 1.
   Log in to your Stape account and hover over Gateways in the dashboard.
2. 2.
   Click Snap CAPIG.

3. Click Create gateway.

4. Fill in:

• Gateway name – a descriptive label.
• Server location – pick the region closest to the majority of your traffic.

5. Click Create gateway.

6. Select a subscription plan and click Continue.

7. Wait for the gateway status to change to Running.

1. Click Finish Snapchat Gateway setup. If you don't see the button, you can also click the link that you can find under Snapchat Conversions API Gateway settings.

2. Log in to the gateway with your Snapchat account.

3. In Overview, click Add data source.

4. Select your pixels and click Finalise connection.

5. You will see the pixel on your dashboard.

Routing Snapchat Conversions API Gateway through a custom domain on your own site measurably improves match quality and reduces ad-blocker loss.

1. 1.
   Go to Data routing → click Add subdomain.

2. Enter your subdomain, which consists of a prefix (for example, data, events, or gateway) and the root domain of your website (for example, example.com). Click Next.

3. You’ll get the values you have to provide to your DNS provider.

4. In your DNS provider (in our case Cloudflare), add a new record:

• Type - CNAME
• Name - the Record name from step 3.
• Target - the Value from step 3.
• Proxy status - off. If you keep it on, the Stape support team might not see the record and help with debugging.

Click Save.

5. Back in Snapchat Conversions API Gateway, wait until you get an activation confirmation.

6. You can serve the Snapchat Pixel library script through your own first-party subdomain instead of downloading it directly from Snapchat's default servers. This will help you increase the protection of your events from ad blockers. Under Configure Your Pixel Code, copy the script tag and paste it inside your website’s <head> tag.

Domain verification can take up to 72 hours, but it usually happens within 30-60 minutes if your DNS records are correct. If it takes more time for you, there may be a problem with your configurations.

There are the main reasons why a subdomain may not verified:

• Typo in the Name/Host field – some DNS managers automatically append your root domain. If you enter data.yourdomain.com instead of just data, the record might resolve to data.yourdomain.com.yourdomain.com. In some DNS providers, only the prefix (for example, data) should be entered in the Host/Name field.
• Proxy status enabled – if you use Cloudflare, ensure the proxy status for the CNAME record is set to DNS only, not Proxied.
• Target mismatch – ensure the CNAME points to the exact gateway target provided by Stape, with no spaces or typos.
• Conflicting DNS records – ensure there are no existing A, AAAA, or conflicting CNAME records for the exact same subdomain name in your DNS settings.
• Missing SSL – if you configured the custom domain using an Own CDN setup, Stape cannot verify the domain until an active SSL certificate is in place on your side.

You can check your DNS records with the Google Admin Toolbox Dig tool.

1. 1.
   Enter your custom subdomain (for example, data.yourdomain.com, without https:// or trailing slashes).
2. 2.
   Select the CNAME tab.
3. 3.
   Verify that the returned target matches the exact value provided in your Snapchat Conversions API Gateway dashboard.

Check the following:

• Events in the Snapchat Conversions API Gateway. Open Overview, in 30 minutes after triggering the events, you should see them in the dashboard.

• Events in Snapchat Events Manager. Go to Snapchat Events Manager → Event sources → click on your Pixel. Under Overview, check the incoming event timeline. Events routed through the gateway will display an indicator showing they were delivered through the Conversions V3 API.