Skip to main content

Documentation Index

Fetch the complete documentation index at: https://moengage-crashes-in-debug-feedback.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

In today’s privacy-focused digital landscape, many users employ ad blockers or private DNS services. These tools often block network requests to known third-party domains, including analytics and engagement platforms. When these requests are blocked, you lose critical data visibility, and your users may not receive in-app messages or push notifications. To ensure reliable campaign delivery and campaign performance, MoEngage offers the Custom Proxy Domain feature. This allows you to route MoEngage SDK traffic through a subdomain of your own primary domain (e.g., data.yourcompany.com). Because the traffic appears as first-party communication, it bypasses common ad-blocking lists.

​
Onboarding Process

Setting up a Custom Proxy Domain requires a one-time DNS delegation process between your team and MoEngage.
PrerequisiteBefore updating your SDK code, you must complete the DNS delegation setup. For a detailed guide on picking a domain and configuring NS records, refer to DNS Delegation.

​
Step 1: Choose a Subdomain

Select a subdomain that is short and does not contain keywords typically flagged by filters (e.g., avoid “tracking”, “ads”, or “moengage”).

​
Step 2: Request DNS Delegation

Contact your MoEngage Customer Success Manager (CSM) or Support Team to initiate the request. Provide your chosen subdomain.

​
Step 3: Configure NS Records

MoEngage will provide you with a list of Name Server (NS) records. You must add these records to your DNS provider’s configuration for the chosen subdomain.

​
Implementation

Once the DNS delegation is verified, update your SDK initialization logic. The SDK will dynamically rewrite all MoEngage endpoints (API calls and CDN assets) to use your custom proxy domain.

​
Update MoEngage Configuration

import MoEngageSDK

let sdkConfig = MoEngageSDKConfig(appId: "YOUR_Workspace_ID", dataCenter: DATA_CENTER)
sdkConfig.customBaseDomain = "CUSTOM_DOMAIN"
#if DEBUG
MoEngage.sharedInstance.initializeDefaultTestInstance(sdkConfig)
#else
MoEngage.sharedInstance.initializeDefaultLiveInstance(sdkConfig)
#endif

​
Best Practices and Validation

  1. Domain Selection: Keep your subdomain string short (5-8 characters).
  2. Network Logs: Verify that requests start with your custom subdomain (e.g., sdk-01.data.example.com).
  3. Asset Loading: Ensure images in campaigns load correctly.