Dealing with Ad Blockers

1. Register Your Custom Subdomain

Subdomain Guidelines

• The subdomain should be used only for routing requests to Dodgeball.
• The subdomain's root domain should match the domain hosting your application (e.g., safety.mydomain.com where mydomain.com is your app's domain).
• Avoid obvious names like dodgeball.mydomain.com. Use something generic or random like safety.mydomain.com or a1xt.mydomain.com — the more random, the harder it is for blockers to detect.

Adding DNS Records

Add a CNAME record pointing your custom subdomain to Dodgeball servers. For the standard production environment, this is api.dodgeballhq.com.

Using a Sandbox or Single Tenant Environment

If using a Sandbox or Single Tenant environment, point the CNAME to the appropriate domain found in the Developer Center under API Keys. Omit the https:// protocol when entering the CNAME value.

Example for a sandbox environment:

2. Update Your Dodgeball Client SDK

After registering your subdomain, pass the apiUrl option when initializing the Client SDK:

import { Spreedly } from "@spreedly/trust-sdk-client";

const dodgeball = new Dodgeball('public-api-key...', {
  apiUrl: 'https://safety.mydomain.com'
});