Custom Proxy Sub Domains

To bypass ad blockers and ensure consistent data tracking, MoEngage utilizes a DNS delegation process. This involves carving out a specific subdomain of your primary domain and authorizing MoEngage to manage the DNS records for that subdomain. This approach ensures reliable data capturing and campaign delivery by appearing as first-party traffic.

Recommendations for Choosing a Subdomain

To maximize the effectiveness of this feature and avoid being flagged by ad-blocking lists, follow these recommendations when selecting your subdomain:

  • Avoid Tracking Keywords: Do not use names like track, ads, or moengage. Many ad blockers use keyword-based filtering.
  • Use Neutral Terms: Consider using random strings or unrelated dictionary words (e.g., cn.example.com, data.example.com, or mx-events.example.com).
  • Keep it Short: Aim for a length of 5–8 characters to maintain efficient URL structures.

The Onboarding Process

Setting up DNS delegation is a collaborative process between your technical team and MoEngage Support.

  1. Select your subdomain: Choose a subdomain based on the recommendations above (for example, xyz.example.com).
  2. Inform MoEngage: Share the chosen subdomain with your MoEngage account team or raise a support ticket.
  3. Receive Name Servers: The MoEngage SRE team will create a DNS Zone and provide you with a list of Name Server (NS) records.
  4. Update Parent Domain: Add the provided NS records to your parent domain's DNS configuration. This action delegates control of the subdomain to MoEngage for traffic routing.
  5. Verification: MoEngage will monitor the delegation status. Once verified, the necessary infrastructure endpoints will be mapped to your custom subdomain.
  6. Configure the SDK: After successful delegation and verification, update your SDK initialization logic to use the custom proxy domain. Refer to the specific implementation guides below:
info

Note on Propagation

DNS changes can take between 24 to 72 hours to propagate globally. You can verify the status of your NS records using online tools like DNSChecker.

Specific Provider Instructions

Most major DNS providers support subdomain delegation via NS records. Refer to your provider's documentation for specific instructions on "NS Record Management" or "Subdomain Delegation":

Was this article helpful?
0 out of 0 found this helpful

How can we improve this article?